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 읽기:

   bashCopy

   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. 사용자에게 안내:

   Copy

   📍 현재 상태: 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 - 모든 작업 목록