48 lines
2.6 KiB
YAML
48 lines
2.6 KiB
YAML
schema-version: 1
|
|
project-profile:
|
|
primary: library
|
|
secondary: [documentation-tooling]
|
|
audiences:
|
|
primary:
|
|
- 저장소 README를 만들거나 갱신하는 개발자
|
|
secondary:
|
|
- 결정론적 게이트와 도구 어댑터를 확장하는 기여자
|
|
reader-outcomes:
|
|
- 프로젝트가 만드는 결과와 안전 경계를 30초 안에 설명한다.
|
|
- 의존성을 설치하고 전체 테스트로 개발 환경을 확인한다.
|
|
- 네 가지 모드 중 자기 작업에 맞는 경로를 선택한다.
|
|
- 후보를 검증하고 패치를 준비한 뒤 명시적으로 적용한다.
|
|
project-story:
|
|
value-proposition: 저장소 코드와 사용자 요구를 근거로 README 후보를 만들고 검증 가능한 패치로 전달한다.
|
|
problem: README 자동 작성은 실행 명령과 구조 설명이 실제 저장소와 어긋나거나 기존 문서를 훼손하기 쉽다.
|
|
target-reader: README를 새로 만들거나 안전하게 갱신하려는 개발자
|
|
notable-traits:
|
|
- text: 저장소 사실과 사용자 의도를 분리하고 고위험 주장을 근거에 연결한다.
|
|
fact-ids: [F-PROJECT-001, F-STATE-001]
|
|
- text: 포함한 그림은 개요 결정부터 실제 소스 또는 자산까지 교차 검증한다.
|
|
fact-ids: [F-VISUAL-001]
|
|
- text: 품질 심사 근거는 실제 README 줄 범위와 해시에 묶인다.
|
|
fact-ids: [F-REVIEW-001]
|
|
- text: 패치 준비와 대상 README 적용이 분리되고 적용 직전에 상태와 해시를 다시 검사한다.
|
|
fact-ids: [F-APPLY-001]
|
|
maturity: Codex 경로의 네 모드 드라이버는 구현됐으나 후보 작성은 LLM 경계에 있고 도구 간 동등성은 아직 검증하지 않았다.
|
|
limitations:
|
|
- 후보 작성 자체는 결정론적 코드가 아니라 LLM 파이프라인이 담당한다.
|
|
- Claude와 Antigravity의 런타임 동등성은 Phase 4 전에는 주장하지 않는다.
|
|
narrative-variant: library
|
|
reader-journey:
|
|
- reader-question: 무엇을 만들고 어떤 문제를 막습니까?
|
|
section-id: overview
|
|
- reader-question: 로컬에서 설치와 테스트를 어떻게 확인합니까?
|
|
section-id: quick-start
|
|
- reader-question: 내 작업에는 어떤 모드를 선택해야 합니까?
|
|
section-id: usage
|
|
- reader-question: 저장소 분석부터 적용까지 어떤 흐름으로 동작합니까?
|
|
section-id: architecture
|
|
- reader-question: 어떤 오류와 문서 훼손을 차단합니까?
|
|
section-id: safeguards
|
|
- reader-question: 기여 전에 무엇을 검증해야 합니까?
|
|
section-id: tests
|
|
- reader-question: 상세 계약은 어디에서 확인합니까?
|
|
section-id: documentation
|