skills: writing-flows 신규 추가 — 시나리오별 Flow 문서 (use case + 다이어그램 + 분기)

[devstefancho]

요약

서비스가 어떤 순서로, 어떤 케이스에서 어떻게 동작하는지 한눈에 보여주는 Flow 문서를 작성하는 spec-driven 스킬을 추가합니다. spec/task/ADR로는 파악하기 어려운 런타임 동작을 한 문서로 캡처합니다.

• 산출물: flows/<topic>/NN-name.md — 한 문서 = 한 시나리오
• 고정 4섹션: Context / Diagram (Mermaid sequenceDiagram 또는 flowchart 1개) / Steps & Branches / Source (파일 단위 참조, 라인 번호 없음)
• 코드 우선: 코드가 있으면 탐색해서 그리고, 설계 단계면 spec/대화 기반으로 폴백
• 기존 Flow는 절대 자동 수정하지 않음 (diff 제안 → 확인)

구현 상세

스킬 (skills/spec-driven/writing-flows/)

• 3단계 워크플로우(검색 → 작성 → 리포트), 충돌 시에만 AskUserQuestion
• ADR-0001의 Topic 축 채택 — 폐기된 phase 축을 새 스킬에 다시 들이지 않음
• 인덱스 파생 파일(flows/INDEX.md 등) 생성 금지 (writing-tasks SSOT 원칙 동일)

문서

• CONTEXT.md: Flow 용어 등록, Topic–Flow 관계 추가 (Spec과는 구조적 링크 없음)
• AGENTS.md: spec-driven 카테고리 목록 갱신
• .claude-plugin/plugin.json: 스킬 등록 (jq 검증 통과)

Eval (evals/writing-flows/)

• 3개 케이스 + 픽스처: 코드 기반 시퀀스(checkout), 분기 중심 유저 플로우(signup), 스펙 기반 설계 단계(referral)

검증

• 스킬 적용 vs 미적용 비교 실행(케이스당 1회): 적용 21/21 (100%) vs 미적용 12/21 (57.9%)
• 베이스라인 실패는 전부 구조/규약 항목(파일 위치, 4섹션, Source, 리포트) — 스킬이 사는 가치는 일관성
• 토큰 +6%, 실행 시간 차이 없음
• YAML frontmatter 파싱 검증 통과 (description에 콜론 포함 → 따옴표 처리)

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
claude-plugins	Ready	Preview, Comment	Jun 10, 2026 2:34pm