writing-specs

Installation
SKILL.md

Writing Specs

Manage spec files in specs/ with conflict detection and a concise final report.

Hard Rules

  • Template-driven. 네 절(Purpose·Requirements·Approach·Verification)은 templates/spec-template.md 의 순서와 이름 그대로 반드시 있고 각 절의 분량 제한을 지킨다. 앱의 사용자 기능 스펙이면 ## 이벤트 맵과 ## 판정도 채운다(사용자 표준). 그 뒤에 번호 붙인 상세 절을 더하는 것은 다른 세션이 스펙만 보고 구현해야 할 때만 허용하고, 그 경우 Phase 5 보고에 "인계용 상세 절 N개 추가"라고 적는다.
  • Search before write. Never create or update a spec without running Phase 1.
  • One spec = one task. A request spanning multiple concerns becomes multiple specs.
  • Never auto-modify outdated specs. Propose updates in the report; never apply.
  • 이 스킬은 fork 로 돌아 사용자에게 직접 물을 수 없다. Phase 2 결정은 non-interactive.md 기본값을 적용하고, 되돌릴 수 없는 갈림길(기존 스펙 덮어쓰기)만 부모 세션에 SendMessage 로 한 번 묶어 확인한 뒤 진행한다. 포크 19회 실측에서 AskUserQuestion 호출은 0회였다 (skills-internal#25).
  • Always end with the report. No silent operations.

Directory Rules

Installs
6
GitHub Stars
14
First Seen
Jun 10, 2026