structured-intake

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을 실행합니다.

• AIDLC Inception을 신규 프로젝트·feature 단위로 시작할 때, 첫 발화가 자유 형식으로 들어온 경우 구조화된 템플릿으로 전환하는 진입점이 필요할 때
• 이해관계자·성공 기준·제약이 흩어져 있어 요구사항 분석(requirements-analysis) 전에 사실 관계를 정렬해야 할 때
• 고객·사내 다팀 워크숍에서 공통 입력 양식으로 프로젝트 배경을 수집할 때

다음 상황에서는 사용하지 않습니다.

• 단일 버그 픽스·문서 오타 수정 — 구조화된 intake가 과도합니다. requirements-analysis Simple 모드로 직행합니다.
• 이미 project-info.md가 승인된 상태에서 재실행 — 덮어쓰면 히스토리가 사라집니다. 변경은 별도 PR로 진행합니다.

전제 조건

• .omao/plans/ 디렉토리 쓰기 권한. 본 skill이 .omao/plans/<slug>/ 하위 산출물을 생성합니다.
• 프로젝트 slug(kebab-case) 결정. 이후 모든 AIDLC 아티팩트가 이 slug를 공유합니다.
• 의사결정 권한을 가진 이해관계자 최소 1명 식별(승인자, 예산 결정권자 등).
• Kiro 레포 MIT-0 라이선스의 prompts/1-as-is-analysis, prompts/2-requirement-analysis 구조를 참조하여 OMA 경어체로 한국어화된 템플릿 사용.

실행 절차

Step 1: 템플릿 복사

본 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 입력 값을 채웁니다.

Step 2: 사용자와 빈칸 채우기

project-info.md의 6개 섹션을 사용자와 대화하며 순서대로 채웁니다.

섹션	질문 예시	금지 표현
배경	어떤 문제를 해결하려고 합니까	"편리하게", "쉽게"
목표	3개월·6개월 단위 성공 기준은 무엇입니까	수치 없는 선언
제약	예산·마감·규제·기술 스택 제약이 있습니까	"가능하면"
이해관계자	의사결정자·사용자·리뷰어는 누구입니까	역할 없이 이름만
타임라인	Phase 단위 마일스톤을 언제로 잡습니까	"빠르게"
성공 기준	측정 가능한 KPI·SLO는 무엇입니까	주관적 표현

각 섹션은 최소 3문장 이상으로 작성합니다. 사용자 응답이 모호하면 구체적인 수치·이름·날짜를 요구하는 재질문을 실시합니다.

Step 3: requirements 템플릿 초안 생성

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개 이상
• frontmatter created·last_update.date가 오늘 날짜
• 이해관계자 섹션에 의사결정자 최소 1명 실명

좋은 예시 vs 나쁜 예시

Good — 배경 섹션이 사실 기반 단정형으로 서술됩니다.

"현재 RAG QA 시스템은 p95 응답 지연 4.2초이며, 2026 Q1 사용자 설문 결과 NPS -12점으로 관측되었습니다. 주 원인은 재랭킹 단계 부재로 분석됩니다."

Bad — 배경이 감정 표현·수사로 채워져 검증 불가합니다.

"사용자들이 매우 답답해하고 있어서 정말 빠르게 개선해야 합니다."

Good — 성공 기준이 수치·측정 지표를 포함합니다.

"p95 응답 지연 < 1.5초, faithfulness ≥ 0.88, 월간 인프라 비용 < $2,400 이하를 동시에 만족해야 합니다."

Bad — 성공 기준이 주관적입니다.

"사용자가 만족할 만한 수준까지 성능을 높입니다."

참고 자료

공식 문서

• awslabs/aidlc-workflows — Inception stage — AIDLC Inception 공식 규약
• aws-samples/sample-ai-driven-modernization-with-kiro — prompts — MIT-0 Kiro intake 프롬프트 원본

관련 문서 (내부)

• ../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 산출물을 위험 탐지 입력으로 사용