القائمة
Use when INCEPTION phase begins, to orchestrate workspace detection, requirements, planning, and design stages.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | aidlc-inception-orchestrator |
| description | Use when INCEPTION phase begins, to orchestrate workspace detection, requirements, planning, and design stages. |
| metadata | {"version":"0.7.0","author":"Jay","category":"ai-dlc-workflow","invoke_mode":"orchestrator-only","return_behavior":"stop-no-gate","skill_nature":"amplification","lifecycle":"active"} |
workspace-detection → [Complexity Gate] → requirements-analysis → [Open Questions Gate]
→ [Pre-Planning Gate] → (user-stories) → (nfr-requirements)
→ workflow-planning → [Approach Proposal Gate]
→ (application-design + NFR Design) → [HELD Revisit Gate] → 완료
아래 순서대로 스테이지를 순회한다. 각 스테이지에서:
devflow-state의 ## Current Stage를 업데이트하고 해당 스킬을 호출한다.
호출 시 필요한 파라미터는 인라인으로 전달한다:
"Complexity: [level]""Depth: [level]"스킬 반환값을 사용자에게 표시하고, devflow-audit에 기록한다. 결정 이유 포함 (session-continuity 규약 참조).
게이트 승인 후 devflow-docs/session-summary.md를 업데이트한다:
_shared/patterns/session-continuity.md의 템플릿 참조)## Completed Work > ### INCEPTION에 완료 스테이지 추가: - [x] [stage-name] — [핵심 결과 한 줄]## Current State의 Stage 필드 업데이트## Key Decisions에 게이트 선택 기록 (결정 이유 포함)**Commit** 필드에 현재 HEAD hash## Traps to Avoid 섹션에 1줄씩 추가 (형식: - [접근 요약]: [이유]로 폐기. 재시도 금지.). 응답이 없으면 섹션을 (없음)으로 유지. 자세한 운영 규칙은 _shared/patterns/session-continuity.md의 "Traps to Avoid 운영 규칙" 참조.아래 게이트 정의에 따라 사용자에게 선택지를 제시한다.
사용자 선택에 따라 다음 스테이지를 결정한다.
스킬 반환값에서 Greenfield/Brownfield 확인.
reverse-engineering 가용성 검사:
시스템 프롬프트의 사용 가능한 스킬 목록에서 reverse-engineering:reverse-engineering이 존재하는지 확인한다.
Greenfield 경로:
[workspace-detection 결과 표시]
A) 경로 수정 → workspace-detection 재호출
B) 확인, 다음 단계 진행 → Complexity Declaration Gate
Brownfield 경로:
reverse-engineering 스킬이 사용 가능한지 확인한다. 사용 가능하면 B 옵션을 포함, 불가능하면 A/B(=C) 2-option으로 표시한다.
[workspace-detection 결과 표시]
A) 분석 범위 수정 → workspace-detection 재호출
B) 코드베이스 심층 분석 (reverse-engineering) → reverse-engineering 호출 → 완료 후 Complexity Declaration Gate
[reverse-engineering 플러그인 설치 시에만 표시]
C) 확인, 다음 단계 진행 → Complexity Declaration Gate
B 선택 시: reverse-engineering 스킬을 호출한다. 완료 후 산출물(reverse-engineering/)이 생성되며, 이후 requirements-analysis 호출 시 참조 컨텍스트로 전달한다: "참조: reverse-engineering/README.md"
workspace-detection 결과를 기반으로 복잡도를 선언.
복잡도: **[Minimal/Standard/Comprehensive]** — [한 줄 이유]
→ 다음 단계로 진행합니다. (이전 단계로 돌아가려면 언제든 말씀해 주세요)
게이트 없이 바로 진행한다. 사용자가 조정을 요청하면 인터럽트 핸들러가 처리.
Complexity 값을 requirements-analysis 호출 시 인라인으로 전달: "Complexity: [level]"
패턴: 열린 질문: [N]개
패턴 매칭 실패 시: LLM이 "없음", "0개", 다른 표현을 사용한 경우 N=0으로 처리하고 표준 gate 진행.
N > 0인 경우:
[requirements-analysis 결과 표시]
A) 미해결 질문 처리 → aidlc-requirements-analysis: QUESTIONS 재호출
B) 현재 가정으로 유지하고 다음 단계로 진행
C) 변경 요청 (예: 요구사항 추가/삭제, 우선순위 변경 등) → requirements-analysis UPDATE 재호출
A) 선택 시: "aidlc-requirements-analysis: QUESTIONS — 기존 분석 유지, 미해결 질문만 처리" 인라인 신호로 재호출 → 반환 → 열린 질문: [N]개 패턴 재확인
C) 선택 시: "aidlc-requirements-analysis: UPDATE — 기존 분석 유지, [사용자 변경 요청 내용] 반영" 인라인 신호로 재호출
N == 0이고 가정 있음:
[requirements-analysis 결과 표시]
가정으로 처리된 항목이 있습니다: [목록]
A) 가정 수정 → requirements-analysis UPDATE 재호출
B) 가정 승인, 다음 단계 진행
A) 선택 시: "aidlc-requirements-analysis: UPDATE — 기존 분석 유지, [사용자 변경 요청 내용] 반영" 인라인 신호로 재호출
N == 0이고 가정 없음:
요구사항 분석 완료 — 열린 질문 없음, 가정 없음.
→ 다음 단계로 진행합니다.
게이트 없이 자동 진행한다. 변경이 필요하면 사용자가 인터럽트(자유 발화)로 요청 가능.
requirements-analysis 게이트 통과 후, workflow-planning 호출 전에 실행.
Pre-Planning은 INCEPTION 내 스테이지 그룹명이며, workflow-plan.md의 ### PRE-PLANNING 섹션에 결과가 기록된다.
Minimal complexity: 안내 없이 workflow-planning으로 직행. devflow-audit에만 "Pre-Planning skipped (Minimal)" 기록.
Comprehensive complexity: 안내 없이 User-Stories 게이트로 직행. devflow-audit에만 "Pre-Planning included (Comprehensive)" 기록.
Standard complexity: 3-option 게이트 제시
요구사항 분석이 완료되었습니다. 다음 단계 전에 추가 분석이 가능합니다:
A) User Stories + NFR 수집 → 두 스테이지 모두 실행
B) NFR 수집만 → nfr-requirements만 실행 (상용 배포 시 권장)
C) 바로 워크플로우 계획으로 → 추가 분석 스킵
A → User-Stories 게이트로 진행 B → NFR-Requirements 게이트로 진행 (user-stories 스킵) C → workflow-planning으로 직행
Pre-Planning Gate에서 user-stories 실행이 결정된 경우에만. aidlc-user-stories 호출 → 결과 게이트:
[user-stories 결과 표시]
A) 변경 요청 (예: 스토리 분할, 수용 기준 수정, 액터 변경 등) → user-stories UPDATE 재호출
B) 승인, 다음 단계 진행 → NFR-Requirements 게이트
H) 보류 (나중에 돌아옴) → HELD 상태 저장, NFR-Requirements 게이트로 진행
A) 선택 시: "aidlc-user-stories: UPDATE — 기존 스토리 유지, [사용자 변경 요청 내용] 반영" 인라인 신호로 재호출
Pre-Planning Gate에서 nfr-requirements 실행이 결정된 경우에만. NFR을 건너뛰려면 Pre-Planning Gate에서 C(워크플로우 직행)를 선택한다.
NFR 요구사항을 어떻게 진행하시겠습니까?
A) Claude가 질문하며 수집 (GENERATE)
B) 이미 작성된 NFR 문서가 있음 (IMPORT)
A → "Mode: GENERATE" 인라인 신호로 aidlc-nfr-requirements 호출
B → "Mode: IMPORT" 인라인 신호로 aidlc-nfr-requirements 호출
스킬 반환 후 결과를 사용자에게 표시한다. 변경 요청은 자유 발화로 처리하고, "승인" 발화 시 workflow-planning으로 진행한다. "보류" 발화 시 HELD 상태 저장 후 workflow-planning으로 진행한다.
1단계: 접근법 선택
[workflow-planning 결과 표시]
[생성된 접근법 2-3개 표시]
A) [A안명] 선택
B) [B안명] 선택
C) [C안명] 선택 (Comprehensive만)
변경이 필요하면 자유 발화로 요청 → 인터럽트 핸들러가 workflow-planning을 재호출한다.
선택 후:
## Selected Approach 업데이트**Selected Approach** 업데이트## Approved Stages를 선택된 접근법 기준으로 업데이트2단계: 개발 환경 설정
개발 환경을 설정합니다.
A) Git worktree로 격리 개발 (main 브랜치 보호)
B) 현재 브랜치에서 바로 시작
devflow-docs/inception/requirements.md의 ## User Intent에서 브랜치 이름을 도출:
정상 도출 시 — 게이트 없이 바로 워크트리 생성 진행:
⏺ 브랜치 이름: feature/[이름]
→ 워크트리를 생성합니다. (변경이 필요하면 말씀해 주세요)
사용자가 이의를 제기하면 변경된 이름으로 재생성한다.
도출 실패 시 (비어 있거나 부적절한 경우):
브랜치 이름을 자동으로 도출하지 못했습니다.
사용할 브랜치 이름을 직접 입력해 주세요 (예: my-feature-name):
입력값에 feature/ 접두사를 자동 적용하고 소문자·하이픈 규칙을 적용한 후 워크트리를 생성한다.
devflow-audit에 브랜치명 확정 이벤트 기록 → "Branch: feature/[이름]" 인라인 신호로 aidlc-using-git-worktrees 호출
aidlc-using-git-worktrees 반환 후:
워크트리 생성 완료.
- 경로: .worktrees/feature-[이름]
- 브랜치: feature/[이름] ([base-commit] 기준)
→ 다음 단계로 진행
⚠️ 베이스라인 테스트 실패 시: A) aidlc-systematic-debugging 먼저 / B) 실패 인지 후 진행
테스트 실패가 없으면 자동 진행한다.
workflow-plan.md의 ## Approved Stages를 읽어 분기:
application-design: included → application-design 게이트 실행 (application-design 완료 후 INCEPTION 완료 체크포인트 실행)application-design: skipped, units-generation: included → INCEPTION 완료 체크포인트 → CONSTRUCTION에서 units-generation부터 시작application-design: skipped, units-generation: skipped → INCEPTION 완료 체크포인트 → CONSTRUCTION에서 code-generation 직행CONSTRUCTION 전환 전에 INCEPTION 결과를 일괄 요약하고 확인한다.
## INCEPTION 완료 — 결과 요약
- 복잡도: [level]
- Units: [N]개 ([unit 목록]) / 단일 unit
- 접근법: [선택된 접근법]
- 설계: [application-design 포함/스킵]
CONSTRUCTION을 시작합니다. 수정이 필요한 항목이 있으면 말씀해 주세요.
진행하려면 엔터를 눌러주세요.
사용자가 수정을 요청하면 해당 INCEPTION 스테이지를 재호출한다.
application-design: included인 경우에만 실행.
[application-design LIST 결과 표시]
→ [Minimal: INCEPTION을 완료합니다 / Standard+: 상세 설계를 진행합니다].
변경이 필요하면 말씀해 주세요. (예: 컴포넌트 추가/삭제, 책임 분리)
진행하려면 엔터를 눌러주세요.
사용자가 변경을 요청하면 application-design을 재호출한다.
[application-design DETAIL 결과 표시]
A) 변경 요청 (예: 인터페이스 수정, 의존성 변경, 데이터 구조 등) → application-design: DETAIL 재호출
B) 승인, INCEPTION 완료
R) 리뷰 요청
R1) 단일 리뷰 (Claude artifact-reviewer) — 기존 동작
R2) Council 리뷰 (Codex + Gemini + Claude 의장)
Ra) 자동 선택 (risk score 기반) ← 기본
R1 선택 시 (기존 동작):
_shared/reviewers/artifact-reviewer-prompt.md를 서브에이전트로 dispatch
devflow-docs/inception/application-design.mdrequirements.md, nfr-requirements.md (있으면), workspace.md_shared/patterns/review-gate-pattern.md 적용:
R2/Ra 선택 시 (Council 리뷰):
_shared/patterns/council-cli-detection.md 절차 실행:
devflow-docs/inception/application-design.mdrequirements.md, nfr-requirements.md (있으면), workspace.mddevflow-docs/inception/design-review-raw/{codex,gemini,synthesis}.md_shared/patterns/review-gate-pattern.md 적용하여 게이트 제시:
DETAIL 호출 시 NFR Design 활성화 판단: 3가지 조건 모두 충족 시 인라인 신호 추가:
devflow-docs/inception/nfr-requirements.md 존재충족 시: "aidlc-application-design: DETAIL — NFR Design 포함"
미충족 시: "aidlc-application-design: DETAIL" (기존대로)
application-design 게이트 통과 후, INCEPTION 완료 직전에 1회 실행.
조건 확인: devflow-state에서 HELD 항목 검색.
user-stories: HELD 또는 nfr-requirements: HELD 항목이 있는지 확인.HELD 항목 없음: 자동 스킵 → INCEPTION 완료로 진행.
HELD 항목 있음: 아래 게이트 표시.
INCEPTION 완료 전, 보류된 항목이 있습니다:
- [HELD 항목 목록 표시]
A) 재방문 → 해당 스킬 재호출 (결과에 따라 HELD 해제 또는 유지)
B) HELD 상태 유지하고 완료 진행
A 선택 시 — 재방문 흐름: HELD 항목이 복수이면, 각 항목을 순차 재호출하며 항목별 서브게이트를 제시한다. 모든 항목 처리 완료 후 최상위 HELD 재방문 게이트는 재표시하지 않는다.
B 선택 시:
재방문 결과 기록 (devflow-state + session-summary):
모든 게이트에서 사용자 응답이 선택지 밖 자유 발화인 경우:
→ _shared/patterns/interrupt-handler.md 참조하여 인터럽트 게이트 프로토콜 실행.
스킬이 예상치 못한 결과를 반환하면: A) 해당 단계 재시도 / B) 단계 스킵 (devflow-state에 skipped 기록)
workflow-plan.md 라우팅 키 형식이 예상과 다르면:
Pre-Planning 스테이지에서 HELD 또는 SKIPPED가 발생하면:
user-stories: HELD 또는 nfr-requirements: SKIPPED### PRE-PLANNING 섹션에 상태 기록스킬이 오케스트레이터 역할을 침범하면:
모든 INCEPTION 스테이지 완료 시:
[INCEPTION 완료]
- 완료된 스테이지: [목록]
- 산출물: devflow-docs/inception/
→ Return to Entry Orchestrator (Phase 전환)
아이디어를 설계로 전환하거나, 새로운 기능을 만들거나, 구현 전 구조화된 설계가 필요한 창의적/탐색적 작업에 사용. Use when turning an idea into a design, creating a new feature, or when any creative/exploratory work needs structured design before implementation.
태스크나 unit 구현이 완료되어 머지 전 코드 리뷰가 필요할 때, 또는 사용자가 명시적으로 코드 리뷰를 요청할 때 사용. Use when a task or unit implementation is complete and needs code review before merging, or when the user explicitly requests a code review on their changes.
설계 문서를 상세 구현 계획으로 변환하거나, "구현 계획 작성", "plan 만들어줘" 요청 시 사용. INCEPTION 워크플로우 계획은 aidlc-workflow-planning 사용. Use when a design document needs to be converted into a detailed implementation plan with task breakdown, or when "구현 계획 작성", "plan 만들어줘" is requested. Not for INCEPTION workflow planning — use aidlc-workflow-planning instead.
Use when user explicitly requests "auto 모드", "자동 모드", "auto mode", or "알아서 만들어줘". 초보자를 위한 완전 자동 devflow. greenfield 전용. 요구사항 입력 → inception → construction → build-test를 자동 진행하며 각 flow 종료 시 멀티에이전트 리뷰 필수.
현재 세션에서 구현 계획을 실행할 때 사용. 독립 태스크별 신규 서브에이전트 컨텍스트 활용. Use when executing an implementation plan in the current session with independent tasks that benefit from fresh subagent context per task.
프로덕션 코드 작성, 버그 수정, 리팩토링 시 사용 — 예외 없이 RED-GREEN-REFACTOR 사이클을 강제. Use when writing any production code, fixing bugs, or refactoring — enforces RED-GREEN-REFACTOR cycle with no exceptions.