docs(agents): 스킬 선택과 단계별 책임 규칙을 반영한다

This commit is contained in:
2026-10-19 16:15:00 +09:00
parent 99c5002991
commit a35a038720
3 changed files with 84 additions and 6 deletions
+5 -2
View File
@@ -12,10 +12,13 @@
## 작업 계획 문서 규칙 (docs)
- 모든 구현 작업은 PRD 문서와 구현 계획/TASK 문서가 모두 준비된 뒤에 시작한다.
- 사용자가 프롬프트를 입력하면 먼저 PRD 문서를 작성한다.
- PRD 작성 중 애매하거나 더 필요한 내용, 결정해야 하는 사항이 있으면 애매한 사항이 없어질 때까지 사용자와 인터뷰한다.
- 구현 작업 요청을 받으면 먼저 PRD 문서를 작성한다. 일반 질문·읽기 전용 조사는 불필요한 PRD·구현 계획을 새로 만들지 않는다.
- 실행 방향을 바꿀 목표·범위·제약·완료 기준의 중요한 불확실성이 있을 때만 deep-interview로 한 번에 한 질문씩 확인한다. 코드베이스에서 알 수 있는 사실은 직접 조사하고, 이미 명확하거나 승인된 결정은 다시 열지 않는다.
- 인터뷰로 확정한 내용을 PRD 문서에 보강한 뒤, 해당 PRD를 기준으로 구현 계획/TASK 문서를 작성한다.
- 구현은 계획/TASK 문서를 기준으로 필요한 내용만 최소 범위로 진행한다.
- Superpowers brainstorming/plan의 기본 문서 경로 대신 이 저장소의 `docs/YYYYMMDD_작업명/prd.md`와 `plan-task.md`를 정식 문서로 사용한다. 승인된 결정을 보존하고 별도 설계·계획 사본이나 자동 커밋을 만들지 않는다.
- 후속 작업은 기존 PRD와 계획/TASK를 읽고 첫 미완료 Task부터 재개한다. 범위가 바뀌었을 때만 계획을 갱신하고, 계획이 없거나 바뀐 경우에만 writing-plans를 선택한다.
- 각 단계의 책임자, 결정사항, 남은 질문, 정식 문서 경로, 테스트·증거를 다음 단계에 인계한다. 실행 방식은 사용자가 정한 방식과 실제 하네스 기능을 따른다.
### 기준 샘플
- 문서 샘플의 기준 위치는 `docs/sample/`이다.