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 읽기 (규칙 인덱스)
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          → 검토 및 문서화

시작하기

새 작업 시작

1. Task ID 결정: 사용자에게 요청 (예: PROJ-001)
2. Task 초기화: ./scripts/task.sh init <TASK_ID>
3. 입력 작성: .ai/tasks/<TASK_ID>/00-user-prompt.md 편집
4. 규칙 로드: assets/rules/AGENTS.md 읽기
5. Step 1 실행: references/step-1.md 참조

작업 재개

사용자가 .ai/tasks/<TASK_ID>/ 경로를 언급하거나 "작업 이어서" 요청 시:

1. status.yaml 읽기:

   cat .ai/tasks/<TASK_ID>/status.yaml
   

2. 현재 상태 파악:

   • current_step: 현재 진행 중인 Step
   • steps.<step-N>.status: 각 Step의 상태 (pending/in_progress/completed)

3. 규칙 로드:

   • 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를 시작하시겠습니까?
   

수동 재개 명령어:

"<TASK_ID> 작업 이어서 진행해줘"
"<TASK_ID> Step 2 시작"
"<TASK_ID> 다음 단계 계속"

Step 상세 가이드

각 Step의 상세 내용은 아래 참조 문서를 확인하세요:

Step 1: Requirements Analysis

• 역할: Requirements Analyst
• 목표: 사용자 요구사항을 명확히 이해하고 구조화된 문서로 정리
• 입력: .ai/tasks/<TASK_ID>/00-user-prompt.md
• 출력: .ai/tasks/<TASK_ID>/10-output-plan.md
• 완료 조건: 출력 파일 생성 + Git 커밋
• 상세: references/step-1.md

Step 2: Design & Planning

• 역할: System Designer
• 목표: 요구사항을 기반으로 구현 가능한 설계 및 계획 수립
• 입력: .ai/tasks/<TASK_ID>/10-output-plan.md
• 출력: .ai/tasks/<TASK_ID>/20-output-system-design.md
• 완료 조건: 출력 파일 생성 + Git 커밋
• 상세: references/step-2.md

Step 3: Task Analysis

• 역할: Task Analyzer
• 목표: 설계를 작은 구현 작업으로 분해하고 병렬화 계획 수립
• 입력:
  • .ai/tasks/<TASK_ID>/10-output-plan.md (요구사항)
  • .ai/tasks/<TASK_ID>/20-output-system-design.md (설계)
• 출력:
  • .ai/tasks/<TASK_ID>/30-output-task.md
  • .ai/tasks/<TASK_ID>/todos/00-TASK_MASTER.md
  • .ai/tasks/<TASK_ID>/todos/01-TASK.md, 02-TASK.md, ...
• 완료 조건: 모든 출력 파일 생성 + Git 커밋
• 상세: references/step-3.md

Step 4: Implementation

• 역할: Coordinator (Task Executor Agent 조율)
• 목표: Task Executor Agent를 활용하여 설계에 따라 코드를 구현하고 테스트
• 입력:
  • .ai/tasks/<TASK_ID>/20-output-system-design.md
  • .ai/tasks/<TASK_ID>/30-output-task.md
  • .ai/tasks/<TASK_ID>/todos/*.md
• 출력: .ai/tasks/<TASK_ID>/40-output-implementation.md + 실제 코드
• 완료 조건:
  1. todos/ 내 모든 서브태스크 completed
  2. 40-output-implementation.md 생성됨
  3. Git 커밋 완료
• 상세: references/step-4.md

Step 5: Review & Documentation

• 역할: Reviewer
• 목표: 구현 결과 검토, 문서화, PR 준비
• 입력: .ai/tasks/<TASK_ID>/40-output-implementation.md
• 출력: .ai/tasks/<TASK_ID>/50-output-review.md
• 완료 조건: 출력 파일 생성 + PR 생성/준비 + Git 커밋
• 상세: references/step-5.md

진행 상태 확인

./scripts/task.sh status <TASK_ID>
./scripts/task.sh list

템플릿 및 리소스

• 출력 템플릿: 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

  • init <TASK_ID> - 작업 초기화
  • status <TASK_ID> - 상태 확인
  • list - 모든 작업 목록