docs(agents): 스킬 선택과 단계별 책임 규칙을 반영한다
This commit is contained in:
@@ -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`를 참고한다.
|
||||
|
||||
Reference in New Issue
Block a user