--- name: feature-workflow description: | 일반적인 기능 구현을 위한 단계별 워크플로우를 제공합니다. .ai\/tasks\/ 디렉토리 구조를 사용하여 작업을 체계적으로 관리합니다. 새 기능 구현 시: - 워크플로우를 이용, 기능 구현, 기능 개발, 기능 추가, 새 기능, 신규 개발 - 기능 구현해줘, 기능 개발해줘, 구현해줘 - feature, implement, new feature, add feature 작업 재개 시 (티켓 번호 패턴: XXXX-NNN 형식): - TASK-001 이어서, AI-TOOLKIT-001 진행, PROJ-001 계속, FEAT-123 시작 - 작업 이어서, 작업 계속, 작업 진행, 다음 단계, 이어서 해줘 - resume, continue, proceed, next step .ai\/tasks 관련: - .ai\/tasks 확인, 작업 상태, task status, 진행 상황 license: MIT metadata: author: ai-toolkit version: "1.0.0" category: workflow allowed-tools: Bash Read Write Edit Glob Grep --- # Feature Workflow Implementation 기능 구현을 체계적으로 진행하는 5단계 워크플로우입니다. ## 핵심 원칙 1. **Context Isolation**: 각 Step은 새 대화에서 실행 권장 2. **Human in the Loop**: 사용자 입력 확인 후 진행 3. **Document as Interface**: Step 간 통신은 문서로 수행 4. **Git as History**: 각 Step 완료 시 커밋으로 체크포인트 생성 ## 규칙 로드 **각 Step 시작 시 반드시 규칙을 로드하세요:** 1. [assets\/rules\/AGENTS.md](assets\/rules\/AGENTS.md) 읽기 (규칙 인덱스) 2. **필수 규칙**: `MUST\/workflow-rule.md` 항상 로드 3. **도메인 규칙**: 작업 컨텍스트에 따라 동적 로드 ``` Step 시작 │ ├─→ MUST\/workflow-rule.md (항상) │ └─→ 작업 컨텍스트에 따라: ├─ React 작업 → react\/AGENTS.md ├─ 테스트 작업 → testing\/AGENTS.md ├─ API 작업 → api\/AGENTS.md └─ (디렉토리 없으면 건너뛰기) ``` ## 워크플로우 개요 ``` Step 1: Requirements → 요구사항 분석 및 정리 Step 2: System Design → 설계 및 구현 계획 수립 Step 3: Task Analysis → 구현 작업 분해 및 병렬화 계획 Step 4: Implementation → 코드 구현 및 테스트 Step 5: Review → 검토 및 문서화 ``` | Step | 역할 | 입력 | 출력 | 상세 | |------|------|------|------|------| | 1 | Requirements Analyst | 00-user-prompt.md | 10-output-plan.md | [references\/step-1.md](references\/step-1.md) | | 2 | System Designer | 10-output-plan.md | 20-output-system-design.md | [references\/step-2.md](references\/step-2.md) | | 3 | Task Analyzer | 10+20 | 30-output-task.md + todos\/ | [references\/step-3.md](references\/step-3.md) | | 4 | Developer | 20-output-system-design.md | 40-output-implementation.md | [references\/step-4.md](references\/step-4.md) | | 5 | Reviewer | 40-output-implementation.md | 50-output-review.md | [references\/step-5.md](references\/step-5.md) | --- ## 시작하기 ### 새 작업 시작 1. **Task ID 결정**: 사용자에게 요청 (예: `PROJ-001`) 2. **Task 초기화**: `.\/scripts\/task.sh init ` 3. **입력 작성**: `.ai\/tasks\/\/00-user-prompt.md` 편집 4. **규칙 로드**: [assets\/rules\/AGENTS.md](assets\/rules\/AGENTS.md) 읽기 5. **Step 1 실행**: [references\/step-1.md](references\/step-1.md) 참조 ### 작업 재개 **사용자가 `.ai\/tasks\/\/` 경로를 언급하거나 "작업 이어서" 요청 시:** 1. **status.yaml 읽기**: ```bash cat .ai\/tasks\/\/status.yaml ``` 2. **현재 상태 파악**: - `current_step`: 현재 진행 중인 Step - `steps..status`: 각 Step의 상태 (pending\/in_progress\/completed) 3. **규칙 로드**: - [assets\/rules\/AGENTS.md](assets\/rules\/AGENTS.md) 읽기 - 해당 Step의 필수 규칙 섹션 로드 4. **다음 동작 결정**: - 현재 Step의 status가 `pending` → 해당 Step 시작 - 현재 Step의 status가 `in_progress` → 계속 진행 - 현재 Step의 status가 `completed` → 다음 Step으로 이동 5. **사용자에게 안내**: ``` 📍 현재 상태: Step X (상태) 📋 완료된 Step: Step 1, Step 2, ... ▶️ 다음 Step: Step Y Step Y를 시작하시겠습니까? ``` **수동 재개 명령어**: ``` " 작업 이어서 진행해줘" " Step 2 시작" " 다음 단계 계속" ``` --- ## Step 상세 가이드 각 Step의 상세 내용은 아래 참조 문서를 확인하세요: ### Step 1: Requirements Analysis - **역할**: Requirements Analyst - **목표**: 사용자 요구사항을 명확히 이해하고 구조화된 문서로 정리 - **입력**: `.ai\/tasks\/\/00-user-prompt.md` - **출력**: `.ai\/tasks\/\/10-output-plan.md` - **완료 조건**: 출력 파일 생성 + Git 커밋 - **상세**: [references\/step-1.md](references\/step-1.md) ### Step 2: Design & Planning - **역할**: System Designer - **목표**: 요구사항을 기반으로 구현 가능한 설계 및 계획 수립 - **입력**: `.ai\/tasks\/\/10-output-plan.md` - **출력**: `.ai\/tasks\/\/20-output-system-design.md` - **완료 조건**: 출력 파일 생성 + Git 커밋 - **상세**: [references\/step-2.md](references\/step-2.md) ### Step 3: Task Analysis - **역할**: Task Analyzer - **목표**: 설계를 작은 구현 작업으로 분해하고 병렬화 계획 수립 - **입력**: - `.ai\/tasks\/\/10-output-plan.md` (요구사항) - `.ai\/tasks\/\/20-output-system-design.md` (설계) - **출력**: - `.ai\/tasks\/\/30-output-task.md` - `.ai\/tasks\/\/todos\/00-TASK_MASTER.md` - `.ai\/tasks\/\/todos\/01-TASK.md`, `02-TASK.md`, ... - **완료 조건**: 모든 출력 파일 생성 + Git 커밋 - **상세**: [references\/step-3.md](references\/step-3.md) ### Step 4: Implementation - **역할**: Coordinator (Task Executor Agent 조율) - **목표**: Task Executor Agent를 활용하여 설계에 따라 코드를 구현하고 테스트 - **입력**: - `.ai\/tasks\/\/20-output-system-design.md` - `.ai\/tasks\/\/30-output-task.md` - `.ai\/tasks\/\/todos\/*.md` - **출력**: `.ai\/tasks\/\/40-output-implementation.md` + 실제 코드 - **완료 조건**: 1. `todos\/` 내 모든 서브태스크 completed 2. `40-output-implementation.md` 생성됨 3. Git 커밋 완료 - **상세**: [references\/step-4.md](references\/step-4.md) ### Step 5: Review & Documentation - **역할**: Reviewer - **목표**: 구현 결과 검토, 문서화, PR 준비 - **입력**: `.ai\/tasks\/\/40-output-implementation.md` - **출력**: `.ai\/tasks\/\/50-output-review.md` - **완료 조건**: 출력 파일 생성 + PR 생성\/준비 + Git 커밋 - **상세**: [references\/step-5.md](references\/step-5.md) --- ## 진행 상태 확인 ```bash .\/scripts\/task.sh status .\/scripts\/task.sh list ``` --- ## 템플릿 및 리소스 - **출력 템플릿**: [assets\/templates\/](assets\/templates\/) - `00-user-prompt.md` - 초기 요구사항 입력 - `10-output-plan.md` - Step 1 출력 - `20-output-system-design.md` - Step 2 출력 - `30-output-task.md` - Step 3 출력 - `40-output-implementation.md` - Step 4 출력 - `50-output-review.md` - Step 5 출력 - `TASK_MASTER.md` - 전체 조율 문서 템플릿 - `TASK.md` - 개별 서브태스크 템플릿 - **실행 스크립트**: [scripts\/task.sh](scripts\/task.sh) - `init ` - 작업 초기화 - `status ` - 상태 확인 - `list` - 모든 작업 목록