프로젝트 리빙 문서
NOC 리빙 문서를 실행 가능한 프로젝트 메모리로 사용하세요. noc_docs/를 통해 경로를 지정하고, 영향을 받는 문서만 읽은 후, 코드나 의도가 변경되면 리빙 문서를 업데이트하고 CLI로 검증하세요.
트리거
이 스킬은 다음 경우에 사용하세요:
noc_docs/초기화 또는 마이그레이션- 요구사항 논의 후 코드 변경
- 새로운 기능, 버그 수정, 리팩터링, API/데이터/보안/배포 변경
- 코드 변경이 문서 업데이트를 필요로 하는지 확인
- 프로젝트 리빙 문서 조회 또는 감사
프로젝트 메모리, 코드 동작, 요구사항, 가드레일, 테스트 또는 NOC 문서와 관련되지 않은 일반 질문에는 사용하지 마세요.
실행
- 요청, 변경된 경로,
noc_docs/.living-docs/feature-map.json에서 영향을 받는 기능/도메인을 식별합니다. - 코드가 변경될 수 있을 때 작업 계획을 실행합니다:
python scripts/noc.py work /path/to/project --feature <feature> --intent "<합의된 요구사항>"
기능 이름보다 경로가 더 명확한 경우 --path <code/path>를 사용하세요.
- 가장 작은 관련 문서(
agent-guide.md,requirements.md,status.md,guardrails.md,test-record.md및 도메인 가드레일(있는 경우))를 읽습니다. - 확인된 새/변경된 의도를
requirements.md에 기록하고, 불확실한 논의는notes.md에 기록합니다. - 코드를 변경합니다.
- 동작, 검증, 중요 변경 사항 또는 제약 조건이 변경된 경우
status.md,test-record.md,change-record.md,guardrails.md를 업데이트합니다. - 문서, 기능 또는 매핑 변경 후
python scripts/noc.py index <project>를 실행합니다. - Git을 사용할 수 있는 경우 커밋 전에
python scripts/noc.py check <project> --staged --warn-only를 실행합니다.
자세한 워크플로 규칙은 references/workflow.md를 읽으세요.
진행하지 않음
다음 경우에는 코드 편집을 중단하고 사용자에게 물어보세요:
- 요청이
guardrails.md또는 도메인 가드레일과 충돌하는 경우 - 제품 의도가
requirements.md와 충돌하고 의도된 방향이 명확하지 않은 경우 - 영향을 받는 기능/도메인을 식별할 수 없고 변경이 명백히 전역적이지 않은 경우
- 필수 문서가 누락되었고 작업이 알려지지 않은 요구사항이나 제약 조건에 의존하는 경우
- 사용자가 요구사항을 현재 코드와 일치하도록 자동으로 재작성해 달라고 요청하는 경우
- 변경이 보안, 권한, 결제, 데이터 손실, 마이그레이션 또는 공개 API 계약에 영향을 미치고 요청된 동작이 모호한 경우
완료 정의
이 스킬을 사용한 작업은 다음 조건이 모두 충족될 때만 완료됩니다:
- 영향을 받는 문서가 기능 맵, 경로 또는 명시적 기능 이름을 통해 식별되었음
- 필요한 문서를 읽었거나 누락된 문서가 지적되었음
- 코드 변경과 문서 변경이 일치함
requirements.md는 의도된 동작 변경에 대해서만 변경되었음status.md가 코드 변경 후 현재 동작을 반영함test-record.md가 검증을 기록했거나 검증을 실행하지 않은 이유를 설명함change-record.md가 중요한 구현 변경 사항을 기록함- 색인/검사가 가능한 경우 실행되었거나, 이유와 함께 건너뛰었음
최종 응답 형식
다음 형식으로 마칩니다:
NOC 리빙 문서:
- 확인한 문서:
- 업데이트한 문서:
- 의도적으로 변경하지 않은 문서:
- 실행한 명령어:
- 실행한 테스트:
- 남은 위험:
목록을 짧게 유지하세요. 해당되지 않는 범주는 없음을 사용하세요.
참고 자료
references/workflow.md: 모드 선택, 폴백 규칙, 충돌 처리, 작업 루프references/feature-doc-template.md: 각 기능 문서가 포함해야 할 내용references/domain-mode-guide.md: 도메인 모드 사용 시기 및 방법references/codex-prompts.md: Codex 계획/목표/코드 워크플로를 위한 권장 사용자 프롬프트