Skill not invoked — Claude codes without writing proposal.md

Use one of the trigger phrases exactly: 'spec-flow', 'spec mode', 'need a plan', '写个方案'.

SKILL.md frontmatter wrong

Re-clone the repo; description is what drives auto-activation.

spec-flow (Claude Skill) — 설치 & 라이브 데모

왜 쓰나요

핵심 기능

Five-phase workflow: Proposal → Requirements (EARS format) → Design → Tasks → Implementation
Each phase writes a Markdown doc into .spec-flow/ so decisions are auditable
Gated transitions — Claude pauses for confirmation before advancing
Multilingual triggers: English plus Chinese ('写个方案', '做个规划')
Escape hatches: --fast skips gates, --skip-design suits simpler features

라이브 데모

실제 사용 모습

spec-flow-skill.replay ▶ 준비됨

0/0

설치

작성자 저장소 · Claude Skills 공식 문서

사용 사례

실전 활용법: spec-flow

Turn a vague feature idea into a documented spec and implementation

👤 Engineers pushing back against 'just start coding' ⏱ ~60 min intermediate

언제 쓸까: PM handed you a one-liner and you'd rather spend 20 minutes writing a spec than 2 days writing the wrong code.

흐름

Invoke the workflow

spec-flow: add multi-region failover to our billing service.✓ 복사됨

→ Claude writes .spec-flow/proposal.md and waits for confirmation
Confirm or edit each phase

Proposal looks good — proceed to requirements.✓ 복사됨

→ requirements.md appears with EARS-format statements
Implement from the task list

Start the implementation phase. Work through tasks.md top-to-bottom.✓ 복사됨

→ Code changes that map 1:1 to task checkboxes

결과: A feature ships with the spec still alive in .spec-flow/ — future you can see why every decision happened.

함정

You're hacking a 10-minute fix and the skill adds 4 gates — Use --fast or just skip the skill for trivial work

함께 쓰기: github · filesystem

Reverse-engineer a spec for existing code before refactoring

👤 Engineers inheriting undocumented modules ⏱ ~45 min intermediate

언제 쓸까: About to refactor something nobody wrote a spec for.

흐름

Ask Spec-Flow to backfill

spec-flow --skip-design: backfill proposal and requirements.md for the existing src/auth module.✓ 복사됨

→ Clean EARS requirements extracted from actual code behavior
Use the spec as refactor target

Now design phase — how would we restructure while preserving these requirements?✓ 복사됨

→ design.md that maps new architecture to existing requirements

결과: A refactor grounded in a written contract instead of tribal knowledge.

함께 쓰기: filesystem

조합

다른 MCP와 조합해 10배 효율

spec-flow-skill + github

Commit .spec-flow/ artifacts alongside code so the spec lives in the repo history

After implementation, commit .spec-flow/ + src/ changes in one PR titled after the proposal.✓ 복사됨

spec-flow-skill + planning-with-files

Spec-Flow drives phase structure; planning-with-files keeps cross-session progress memory

Use spec-flow for the phases and planning-with-files for progress.md tracking across days.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출
proposal_phase	feature description	Start of a new feature
requirements_phase	approved proposal	After proposal confirmed
design_phase	approved requirements	After requirements confirmed; skippable with --skip-design
tasks_phase	approved design	Before implementation
implementation_phase	approved tasks	Final phase — actually build it

비용 및 제한

운영 비용

API 쿼터: None
호출당 토큰: Each phase re-reads prior .spec-flow/ docs, so context grows across phases
금액: Free — skills are local files
팁: Use --fast on simple features; gates only earn their keep on 2+ day work.

보안

권한, 시크릿, 파급범위

자격 증명 저장: No credentials — pure prompts

데이터 외부 송신: None — .spec-flow/ stays in your working directory

.spec-flow/ files will be committed unless you .gitignore them; most teams want them committed.

문제 해결

자주 발생하는 오류와 해결

Wrong trigger keywords — Claude skips phases

Don't say '--fast' unintentionally. If you want full gates, omit flags and say 'spec-flow'.

대안

spec-flow 다른 것과 비교

대안	언제 쓰나	단점/장점
planning-with-files	You want durable memory across sessions rather than phase gating	Different axis — complementary, not competing
Freeform dev	Feature is 1-2 hours of work	Faster, but no audit trail

spec-flow