// AIDLC Inception 시작 시 자유 형식 발화 대신 구조화된 템플릿으로 프로젝트 정보를 수집한다. project-info 템플릿과 requirements 템플릿을 순차 생성하여 후속 workspace-detection·requirements-analysis·user-stories skill이 소비할 단일 진실원을 제공한다.
| name | structured-intake |
| description | AIDLC Inception 시작 시 자유 형식 발화 대신 구조화된 템플릿으로 프로젝트 정보를 수집한다. project-info 템플릿과 requirements 템플릿을 순차 생성하여 후속 workspace-detection·requirements-analysis·user-stories skill이 소비할 단일 진실원을 제공한다. |
| argument-hint | [project slug — e.g., rag-qa, inference-gateway] |
| user-invocable | true |
| model | claude-sonnet-4-6 |
| allowed-tools | Read,Write,Bash |
다음 상황에서 본 skill을 실행합니다.
requirements-analysis) 전에 사실 관계를 정렬해야 할 때다음 상황에서는 사용하지 않습니다.
requirements-analysis Simple 모드로 직행합니다.project-info.md가 승인된 상태에서 재실행 — 덮어쓰면 히스토리가 사라집니다. 변경은 별도 PR로 진행합니다..omao/plans/ 디렉토리 쓰기 권한. 본 skill이 .omao/plans/<slug>/ 하위 산출물을 생성합니다.prompts/1-as-is-analysis, prompts/2-requirement-analysis 구조를 참조하여 OMA 경어체로 한국어화된 템플릿 사용.본 skill 디렉토리의 템플릿 2개를 프로젝트 slug 하위로 복사합니다.
SLUG="${1:?usage: structured-intake <project-slug>}"
SKILL_DIR="$(dirname "$0")" # or CLAUDE_PLUGIN_ROOT
TARGET=".omao/plans/${SLUG}"
mkdir -p "$TARGET"
test -f "$TARGET/project-info.md" && { echo "project-info.md already exists — edit via PR"; exit 1; }
cp "$SKILL_DIR/templates/project-info.template.md" "$TARGET/project-info.md"
cp "$SKILL_DIR/templates/requirements.template.md" "$TARGET/requirements.md"
템플릿 복사 후 frontmatter의 created, last_update.date를 오늘 날짜로 갱신합니다. slug 필드에 Step 입력 값을 채웁니다.
project-info.md의 6개 섹션을 사용자와 대화하며 순서대로 채웁니다.
| 섹션 | 질문 예시 | 금지 표현 |
|---|---|---|
| 배경 | 어떤 문제를 해결하려고 합니까 | "편리하게", "쉽게" |
| 목표 | 3개월·6개월 단위 성공 기준은 무엇입니까 | 수치 없는 선언 |
| 제약 | 예산·마감·규제·기술 스택 제약이 있습니까 | "가능하면" |
| 이해관계자 | 의사결정자·사용자·리뷰어는 누구입니까 | 역할 없이 이름만 |
| 타임라인 | Phase 단위 마일스톤을 언제로 잡습니까 | "빠르게" |
| 성공 기준 | 측정 가능한 KPI·SLO는 무엇입니까 | 주관적 표현 |
각 섹션은 최소 3문장 이상으로 작성합니다. 사용자 응답이 모호하면 구체적인 수치·이름·날짜를 요구하는 재질문을 실시합니다.
project-info.md가 완성되면 requirements.md의 REQ-ID 표에 기능·비기능 요구사항 3~5개를 초안으로 채웁니다. 이 초안은 후속 requirements-analysis skill이 정제할 입력입니다.
echo "[$(date -Iseconds)] structured-intake completed for ${SLUG}" \
>> .omao/state/audit/${SLUG}.log 2>/dev/null || true
산출물 체크리스트:
.omao/plans/<slug>/project-info.md 6개 섹션 모두 채워짐.omao/plans/<slug>/requirements.md REQ-ID 초안 3개 이상created·last_update.date가 오늘 날짜Good — 배경 섹션이 사실 기반 단정형으로 서술됩니다.
"현재 RAG QA 시스템은 p95 응답 지연 4.2초이며, 2026 Q1 사용자 설문 결과 NPS -12점으로 관측되었습니다. 주 원인은 재랭킹 단계 부재로 분석됩니다."
Bad — 배경이 감정 표현·수사로 채워져 검증 불가합니다.
"사용자들이 매우 답답해하고 있어서 정말 빠르게 개선해야 합니다."
Good — 성공 기준이 수치·측정 지표를 포함합니다.
"p95 응답 지연 < 1.5초, faithfulness ≥ 0.88, 월간 인프라 비용 < $2,400 이하를 동시에 만족해야 합니다."
Bad — 성공 기준이 주관적입니다.
"사용자가 만족할 만한 수준까지 성능을 높입니다."
../workspace-detection/SKILL.md — intake 완료 후 코드베이스 스캔을 수행하는 후행 skill../requirements-analysis/SKILL.md — requirements.md 초안을 REQ-ID 구조로 정제../user-stories/SKILL.md — 성공 기준·이해관계자 정보를 소비../../construction/risk-discovery/SKILL.md — Construction 진입 시 intake 산출물을 위험 탐지 입력으로 사용모든 사용자 발화·agent 행동·phase 전환·gate 판정을 ISO 8601 타임스탬프와 함께 감사 로그에 기록한다. 사용자 입력은 축약·요약 없이 verbatim blockquote로 보존하며, SOC2·ISMS-P 감사 요구사항에 매핑되는 보존 정책(30·90·365일)을 프로젝트별로 선택한다. 모든 AIDLC skill이 호출 가능한 공통 감사 계층을 제공한다.
Enforce Input/Output Guardrails at the LLM Gateway layer — PII redaction, Prompt Injection defense, Jailbreak detection, Toxicity filter, and Tool Allow-list. Integrates Bedrock Guardrails, NeMo Guardrails, Llama Guard 3, and regex/regex-ML policies on Bifrost/LiteLLM with Langfuse audit trail.
Inception 아티팩트(requirements, user-stories, workflow-plan)를 입력으로 받아 agentic 시스템의 컴포넌트 경계·인터페이스 계약·데이터 모델을 설계하고 `.omao/plans/construction/design.md`를 생성한다. Agent·Tool·Memory·Gateway 경계를 명확히 나누고 후속 code-generation·test-strategy skill의 단일 진실원 역할을 한다.
AIDLC 각 phase 종료 시점에 필수 gate 체크리스트를 강제한다. Inception gate는 요구사항·사용자 스토리·워크플로우 계획 서명을, Construction gate는 설계·코드·테스트 전수 통과와 risk-discovery PASS를, Operations gate는 continuous-eval 24시간 green과 cost-governance budget OK를 요구한다. 미통과 시 `.omao/state/gates/<phase>.json`에 blocked 상태를 기록하고 다음 phase 진입을 차단한다.
Construction 단계 실행 직전, Inception 아티팩트와 설계 문서를 교차 분석하여 12개 카테고리 기반 위험 체크포인트를 탐지한다. 비즈니스 연속성·보안·외부 통합·데이터 일관성·비용·성능·규제·가용성·장애 전파 반경·운영 복잡도·의존성 취약점·롤백 가능성을 각각 PASS/WARN/BLOCK으로 판정하고 BLOCK 항목은 다음 phase 진입을 차단한다.
Conditionally generate user stories in As-a/I-want/So-that format only when changes are user-facing. Skips story generation for pure infrastructure or internal refactor work. Produces stories with acceptance criteria linked back to REQ-IDs.