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
+17 -4
View File
@@ -7,7 +7,7 @@
- 코드 식별자, 경로, 명령어는 원문(영문) 그대로 유지한다.
## CORE EXECUTION PRINCIPLES (andrej-karpathy-skills)
These principles override plugin behavior, skill behavior, workflow behavior, and default model behavior unless the user's direct instruction explicitly says otherwise.
These principles guide project work alongside the applicable harness instructions. System/platform instructions, explicit user requests, and actual permissions take precedence; skill routing below selects workflow roles, not instruction-loading hierarchy.
Behavioral guidelines to reduce common LLM coding mistakes. Merge with project-specific instructions as needed.
@@ -83,7 +83,8 @@ Strong success criteria let you loop independently. Weak criteria ("make it work
### 확장 모드
- 사용자가 명시적으로 요청한 경우에만 사용한다.
- 대규모 리팩토링, 브레인스토밍, 다중 에이전트 실행, 병렬 workflow를 허용한다.
- 대규모 리팩토링, 다중 에이전트 실행, 병렬 workflow는 사용자의 명시적 범위·실행 방식 승인이 있을 때만 허용한다.
- 일반적인 신규 기능·동작 설계의 brainstorming과, 실행을 바꿀 중요한 요구사항이 실제로 모호할 때 필요한 deep-interview는 기본 모드에서 허용한다. 이를 이유로 대규모 변경이나 병렬 작업까지 승인된 것으로 보지 않는다.
### 에이전트 동작 원칙
- 추측하지 말고 근거 파일을 읽고 결정한다.
@@ -104,8 +105,8 @@ Strong success criteria let you loop independently. Weak criteria ("make it work
## 작업 절차 핵심 규칙
- 모든 구현 작업은 PRD 문서와 구현 계획/TASK 문서가 모두 준비된 뒤에 시작한다.
- 사용자의 프롬프트를 받으면 먼저 PRD 문서를 작성한다.
- PRD 작성 중 애매하거나 더 필요한 내용, 결정해야 하는 사항이 있으면 애매한 사항이 없어질 때까지 사용자와 인터뷰한다.
- 구현 작업 요청을 받으면 먼저 PRD 문서를 작성한다. 일반 질문·읽기 전용 조사는 불필요한 PRD·구현 계획을 새로 만들지 않는다.
- 실행 방향을 바꿀 목표·범위·제약·완료 기준의 중요한 불확실성이 있을 때만 사용자와 인터뷰한다. 코드베이스에서 확인할 수 있는 사실은 직접 조사하고, 이미 명확하거나 승인된 결정은 다시 열지 않는다.
- 인터뷰 내용을 PRD에 반영한 뒤, PRD를 기준으로 계획/TASK 문서를 작성하고 그 문서에 따라 필요한 내용만 최소 구현한다.
- 문서는 `docs/[날짜]_구현할내용한글/` 아래에 `prd.md`, `plan-task.md`로 만든다.
- `docs/[날짜]_구현할내용한글/prd.md`
@@ -140,6 +141,18 @@ Strong success criteria let you loop independently. Weak criteria ("make it work
## Agent skills
### 스킬 선택과 작업 단계
- Superpowers가 사용 가능하면 기본 개발 프로세스로 사용한다. 스킬은 작업 유형을 분류한 뒤 프로세스 담당을 먼저 정하고, 필요한 도메인 전문 스킬만 해당 단계에 보완한다. 매 단계 담당은 하나로 유지한다.
- 하네스가 지침을 어떻게 불러오는지는 플랫폼이 정한다. 이 순서는 작업 단계의 역할 순서이며, 자동 선택이나 호출을 보장하지 않는다. 현재 설치된 스킬 정의·메타데이터·권한·호출 가능성을 확인하고, 사용할 스킬의 실제 지침을 읽는다.
- using-superpowers의 진입 지침이 이미 로드되었다면 다시 로드하지 않는다. 명확한 질문·조사는 읽기 전용으로 답한다. 신규 설계는 brainstorming, 구현 전 계획은 writing-plans, 버그는 systematic-debugging 후 test-driven-development(TDD), 구현 단계 테스트는 TDD, 완료 판정은 verification-before-completion, 요청된 코드 리뷰는 requesting-code-review가 담당한다.
- 요구사항 인터뷰는 목표·범위·제약·완료 기준의 중요한 불확실성이 남을 때만 deep-interview로 분리한다. 코드베이스에서 확인할 수 있는 사실은 직접 조사한다. 설계가 승인되었거나 이미 명확하면 다시 열지 않는다.
- 도메인 용어·용어집·ADR 변경은 domain-modeling이 담당한다. 신규 모듈 설계에는 codebase-design, 공개 API 계약에는 api-and-interface-design, 보안 설계·구현·리뷰에는 security-and-hardening을 해당 Superpowers 단계에서 보완한다.
- 기존 의존성 설계 검토는 requesting-code-review와 codebase-design, 개선 후보 탐색은 읽기 전용 조사와 codebase-design으로 한다. grilling은 사용자가 구체적 결정의 스트레스 테스트를 요청하거나 승인된 개선 흐름의 후보를 선택한 경우에만 연결한다.
- improve-codebase-architecture와 setup-matt-pocock-skills는 사용자가 해당 스킬을 명시 선택한 경우에만 실행한다. 일반 아키텍처·설정 요청이나 접근 권한 승인을 명시 호출로 간주하지 않는다.
- 계획 실행은 executing-plans와 subagent-driven-development 중 실제 전제와 승인된 실행 방식에 맞는 하나만 선택한다. 격리·도구·권한·스크립트 전제를 먼저 확인하고 승인 없는 다중 에이전트·커밋·게시를 실행하지 않는다.
- 비구현 작업은 필요한 문서·검증만 적용한다. 후속 작업은 기존 PRD와 계획을 읽고 첫 미완료 Task부터 재개한다.
- 작업 분류, 기본 경로, 스킬 중복, 플랫폼별 호출 제약은 [docs/agents/skill-routing.md](docs/agents/skill-routing.md)를 읽는다. 이 Markdown 링크는 자동 지침 확장이 아니므로 비단순 작업 분류나 역할 중복 해소 시 직접 읽는다.
### Issue tracker
이슈는 `.scratch/<feature-slug>/`의 로컬 Markdown으로 관리한다.
상세 규칙은 `docs/agents/issue-tracker.md`를 참고한다.