dev-workflow

# Dev Workflow - Ouroboros + Superpowers 통합 ## 트리거별 시작점 | 트리거 | 시작 | 끝 | 용도 | |--------|------|-----|------| | "우로보로스", "ouroboros" | Phase 1 | Phase 2 | 스펙만 정리 | | "슈퍼파워", "superpowers" | Phase 3 | Phase 5 | 계획+실행 (스펙 있을 때) | | "스펙부터", "풀플로우", "전체" | Phase 1 | Phase 5 | 처음부터 끝까지 | --- ## 전체 플로우 ``` [Phase 1-2: Ouroboros] [Phase 3-5: Superpowers] 질문 → 스펙 계획 → 실행 → 검증 ``` --- ## Phase 1: 소크라테스 인터뷰 (Ouroboros) **목표:** 숨겨진 가정을 노출하고 모호성을 제거 ### 규칙 - 한 번에 질문 하나만 - "~하면 되죠?"가 아닌 "~는 무엇인가요?" (존재론적 질문) - 객관식 선호, 필요시 주관식 - 최소 3-5개 질문으로 핵심 파악 ### 질문 프레임워크 1. **본질 (Essence):** "이것의 본질은 무엇인가요?" 2. **근본 원인 (Root Cause):** "이게 근본 원인인가요, 증상인가요?" 3. **전제 조건 (Prerequisites):** "이를 위해 먼저 존재해야 하는 것은?" 4. **숨겨진 가정 (Hidden Assumptions):** "우리가 당연시하는 가정은?" ### 모호성 점수 (Ambiguity Score) 인터뷰가 끝나면 내부적으로 평가: - 목표 명확성 (Goal): 40% - 제약 조건 명확성 (Constraints): 30% - 성공 기준 명확성 (Success Criteria): 30% **Ambiguity ≤ 0.2** 일 때만 다음 단계로 진행. (80% 이상 명확해야 스펙 작성 가능) --- ## Phase 2: 스펙 결정화 (Seed) 인터뷰 결과를 불변 스펙으로 결정화: ```markdown # [기능명] 스펙 ## 목표 [한 문장으로 정의] ## 범위 ### 포함 - ... ### 제외 (YAGNI) - ... ## 핵심 컴포넌트 1. [컴포넌트]: [책임] 2. ... ## 데이터 흐름 [입력] → [처리] → [출력] ## 성공 기준 - [ ] ... - [ ] ... ## 제약 조건 - ... ## 열린 질문 (있다면) - ... ``` **저장 위치:** `docs/specs/YYYY-MM-DD-<topic>.md` --- ## Phase 3: 구현 계획 (Plan) 스펙을 바이트 사이즈 태스크로 분해: ### 태스크 원칙 - 각 태스크는 2-5분 분량 - TDD: 테스트 작성 → 실패 확인 → 구현 → 통과 확인 → 커밋 - 정확한 파일 경로와 코드 포함 - DRY, YAGNI 준수 ### 계획 구조 ```markdown # [기능명] 구현 계획 **목표:** [한 문장] **아키텍처:** [2-3문장] --- ### Task 1: [컴포넌트명] **파일:** - 생성: `path/to/file.ts` - 테스트: `tests/path/to/test.ts` - [ ] Step 1: 실패하는 테스트 작성 - [ ] Step 2: 테스트 실행, 실패 확인 - [ ] Step 3: 최소 구현 - [ ] Step 4: 테스트 통과 확인 - [ ] Step 5: 커밋 ``` **저장 위치:** `docs/plans/YYYY-MM-DD-<topic>.md` --- ## Phase 4: 실행 (Execute) 두 가지 모드 제공: ### A. 서브에이전트 모드 (권장) 태스크당 새 서브에이전트 파견: 1. 구현 서브에이전트 → 태스크 실행 2. 스펙 리뷰 서브에이전트 → 스펙 준수 확인 3. 코드 품질 리뷰 서브에이전트 → 품질 확인 4. 다음 태스크로 ### B. 인라인 모드 현재 세션에서 직접 실행: - 3-5개 태스크마다 체크포인트 - 사용자 확인 후 진행 --- ## Phase 5: 검증 (Evaluate) 3단계 검증: 1. **기계적 검증:** 테스트 통과, 린트 통과, 빌드 성공 2. **의미론적 검증:** 스펙의 성공 기준 충족 여부 3. **합의 검증:** 사용자 확인 --- ## 빠른 시작 사용자가 개발 요청을 하면: ``` 1. "몇 가지 질문으로 시작하겠습니다." 2. 소크라테스 인터뷰 (3-5개 질문) 3. "스펙을 정리하겠습니다." → 스펙 제시 → 승인 요청 4. "구현 계획을 세우겠습니다." → 계획 제시 → 승인 요청 5. "실행 모드를 선택해주세요: [서브에이전트/인라인]" 6. 실행 → 검증 → 완료 ``` --- ## 단축 모드 간단한 작업은 풀 프로세스가 과할 수 있음. **단축 조건:** - 단일 파일 수정 - 명확한 요구사항 (모호성 낮음) - 사용자가 "빨리" 또는 "간단히" 요청 **단축 시:** - 질문 1-2개로 축소 - 스펙 없이 바로 계획 - 계획도 간소화 가능 --- ## 참고 자료 원본 저장소: - `ouroboros-ref/` - Ouroboros 원본 - `superpowers-ref/` - Superpowers 원본 ### 에이전트 역할 (Ouroboros) - **Socratic Interviewer:** 질문만 함, 구현 약속 금지 - **Ontologist:** 본질/근본원인/전제조건/가정 분석 - **Seed Architect:** 대화를 스펙으로 결정화 - **Evaluator:** 3단계 검증 ### 스킬 (Superpowers) - **brainstorming:** 디자인 도출 - **writing-plans:** 바이트 사이즈 계획 - **subagent-driven-development:** 서브에이전트 실행 - **test-driven-development:** RED-GREEN-REFACTOR - **systematic-debugging:** 체계적 디버깅