Ainova Systems 지능형 개발 팩

스펙 기반 문서 하위 시스템 초기화

저장소의 공유 지식 기반(사람과 에이전트 모두 읽는 레이어)을 구축하여, 나머지 스펙 팩(spec-create, spec-execute)이 기록할 장소를 확보합니다. 안전하고 추가적입니다. 아무것도 삭제되지 않으며, 초안은 확인될 때까지 '추정' 상태로 유지되고, 소유자가 승인하기 전까지는 어떤 것도 권위적이지 않습니다.

대상 구조 결정 (학습 → 프로필 → 기본값 순서) - 절대 강요하지 않음

1. 먼저 프로젝트에서 학습합니다. 저장소에 이미 문서 구조(docs/, Documentation/, 문서 규칙, 관련 기능 문서)가 있다면 그것을 채택합니다 - 먼저 검색하고, 관련 문서 두 개를 읽은 후, 모방하되 새로 만들지 마십시오. 성숙한 기존 구조가 기본값보다 우선합니다. 이미 잘 작동하는 구조를 재구성하지 마십시오.
2. 프로필은 경로가 모호할 때 고정합니다: specs_dir, features_dir, rules_dir, decisions_dir, spec_grouping.
3. 초기 설정(Greenfield) 기본값 = AI 우선 문서 트리(references/docs-tree.md 참조): docs/ 디렉토리 아래 model.md, glossary.md, rules/R-NNN-*.md, features/<feature>.md, specs/NNN-<feature>/{requirements,plan,tasks}.md, decisions/NNNN-*.md, architecture/, guides/, _inbox/.

계층 모델 (이 스킬이 소유하는 영역)

각 계층이 에이전트를 제약하는 강도 순서: 에이전트는 일반 텍스트보다 실행 가능한 검사를 더 신뢰성 있게 따릅니다.

• 계층 A - 실행 가능한 제약 조건(린트/경계/계약 테스트 설정, tests/): 가장 강력함. 여기서는 범위 밖 - 별도로 설정하세요.
• 계층 B - 기계가 읽을 수 있는 규칙 및 아키텍처 지식(규칙-계약 rules/R-NNN, 의존성 맵, 결정 로그). spec-init이 이러한 문서를 구조화합니다; 에이전트 진입 라우터(AGENTS.md)는 동기화 엔진이 소유하므로 이 스킬은 문서 트리를 가리키도록만 하고 덮어쓰지 않습니다.
• 계층 C - 공유 지식 기반(모델, 용어집, 기능 문서, 스펙, 아키텍처, 가이드). spec-init이 구조화하고 시드합니다.

단계

1. 기존 문서 인벤토리 작성: 모든 *.md, 위키 내보내기, 다이어그램, 흩어진 노트. 각각을 모델 / 용어집 / 기능-동작 / 흐름 / 결정 / 아키텍처 / 가이드 / 미분류로 분류합니다.
2. 결정된 트리 구조 생성: 누락된 것만 생성합니다(폴더 + docs/README.md 인덱스). 기존 문서를 절대 덮어쓰지 않습니다.
3. 안전하게 마이그레이션 - 먼저 격리합니다. 기존의 미분류 또는 레거시 콘텐츠를 모두 _inbox/(격리 장소)로 이동하여 새 구조만 권위적으로 보이도록 한 후, 소유자 검토와 함께 항목을 하나씩 재분류합니다: "X 작동 방식" 노트 -> features/, 흐름 다이어그램 -> architecture/diagrams/, 결정 -> decisions/. 아무것도 삭제되지 않습니다; 재분류는 하나씩, 절대 대량 자동으로 하지 않습니다.
4. 코드에서 핵심 문서 초안 작성: confirmed / inferred로 표시: 도메인 모델(model.md)과 용어집(glossary.md)은 타입과 필드 이름에서, 기능 동작 기준(features/)은 오늘날 코드의 실제 동작 + EARS 수용 기준에서, 의존성 맵은 실제 임포트에서, 코드가 이미 적용하는 후보 번호 규칙(rules/R-NNN)을 추출합니다.
5. 명명 원칙 적용. 문서 루트 아래의 모든 것은 소문자 kebab-case입니다; 정렬된 시리즈는 제로 패딩 접두사(NNNN- ADR, NNN- 스펙)를 사용합니다; 하나의 개념, 하나의 이름, 동의어 없음. 대문자 파일은 루트의 AGENTS.md와 README.md뿐입니다(외부 표준이 해당 이름을 요구함).
6. 소유자 게이트. 구조화된 트리, 재분류 대기 중인 _inbox/ 내용, 초안 작성된 문서를 제시합니다. 소유자가 각 초안을 확인할 때까지 어떤 것도 권위적이지 않습니다; 모든 것은 그때까지 inferred 상태로 유지됩니다.

검증

• 결정된 트리가 존재합니다. 인덱스가 그것을 나열합니다. 모든 기존 파일은 재분류되었거나 _inbox/에 있습니다(분실 없음). 각 초안 문서는 confirmed/inferred로 표시되었습니다. AGENTS.md는 덮어쓰지 않았습니다.

범위 / 핸드오프

• 구조화된 specs/ 내에서 변경 스펙 생성 - spec-create.
• 계층 A 실행 가능한 제약 조건(린트, 경계, 계약 테스트) - 범위 밖; 별도 설정.
• 이후 코드와 문서 동기화 유지 - spec-audit-docs.

중요 사항

• 기존 문서를 절대 삭제하거나 덮어쓰지 마십시오 - _inbox/로 격리하고, 하나씩 재분류하며, 소유자가 검토합니다.
• 작동하는 프로젝트 구조 위에 기본값 트리를 절대 강요하지 마십시오 - 먼저 학습하고 채택하십시오.
• 출력에 명시할 정직한 주의 사항: 이것은 코드에 이미 구조화된 것만 고정합니다. 설정, 데이터베이스 행 또는 런타임에 등록된 확장에 있는 비즈니스 규칙은 정적 초안 작성에 보이지 않습니다 - 기능 테스트나 점진적인 코드 이동을 위해 플래그를 지정하십시오; 코드가 보여주지 않는 규칙을 절대 만들어내지 마십시오.