alt/agent-ops/skills/common/_templates/agent-spec/index-template.md

1.2 KiB

spec_doc_type status
index 활성

구현 스펙 색인

목적

이 디렉터리는 사람과 agent가 함께 보는 현재 구현 기능 living spec을 관리한다. 로드맵 완료 이력, SDD, 계약 원문, 사람용 docs를 대체하지 않는다.

읽기 규칙

  • 필요한 작업에서만 이 index를 읽고, 매칭되는 spec 문서만 읽는다.
  • archive/**는 과거 비교, 복원, 특정 근거 확인 요청이 있을 때만 읽는다.
  • API, wire protocol, config/event schema, 프로세스 간 계약 원문은 agent-contract/를 따른다.
  • 코드 배치, 구현 진입점, 도메인 간 상세 책임 경계는 domain rule을 따른다.

Spec Map

id 상태 언제 읽나 path 주요 근거
없음 없음 없음 없음 없음

작성 규칙

  • 현재 구현 기준으로 작성한다.
  • 기능 목록과 주요 흐름을 먼저 파악할 수 있게 작성한다.
  • 코드/계약/테스트 evidence를 우선한다.
  • 계약 원문은 복제하지 않고 링크한다.
  • 코드 진입점과 도메인룰 성격의 상세 경계는 반복하지 않는다.
  • 불확실한 내용은 불명확으로 남긴다.