To Spec

Forvandler den samtale, du allerede har haft, til en repo-aware spec i .plan/

Af rengwu · rengwu/wayfinder-maps

Virker med opsætning ★ 8.8/10

To Spec — Forvandler den samtale, du allerede har haft, til en repo-aware spec i .plan/

Hvad det gør

Syntetiserer den aktuelle samtale og kodebasen til en spec (PRD) skrevet til .plan/<slug>/spec.md, uden interviewtrin. Den tvinger en test-seam-skitse før skrivning og et fast sæt sektioner: problem, løsning, en udtømmende brugerhistorieliste, implementeringsbeslutninger, testbeslutninger og out-of-scope. Kaldes ved at skrive /to-spec, når du er færdig med at diskutere en funktion.

Testrapport

Kørte den mod en ægte 25-linjers Python CLI plus en funktionssamtale og differentierede resultatet med en no-skill spec: 21 brugerhistorier mod nul, og 0 filsti- eller kodereferencer mod 4, der ville rådne ved den første refactoring. Seam-trinnet er, hvor den tjener sit brød – den drev testplanen ind på det eksisterende main(argv)-indgangspunkt og markerede, at notefilen skal kunne omdirigeres per test, et hul baseline-spec'en overså, og som vi bekræftede ved udførelse (et test-stil kald skrev direkte ind i $HOME/.notes.json). Den fangede også fire adfærd, som baseline droppede, herunder hvad en omdøbning af en ikke-eksisterende label skulle gøre. Haken er, at frontmatter bærer disable-model-invocation, så den aktiveres aldrig fra en formulering som 'write this up as a spec' – du skal skrive /to-spec, hvilket repoets egen skills/README dokumenterer ærligt. Den lever under skills/.optional/, en skjult mappe, du ikke vil opdage ved at browse repoet på GitHub.

Testet: 2026-07-28 · Claude Code 2.x (agent harness)

Installation

git clone https://github.com/rengwu/wayfinder-maps.git
mkdir -p ~/.claude/skills
cd wayfinder-maps && cp -r skills/.optional/to-spec ~/.claude/skills/to-spec

Kommandoer og eksempelprompter

  • /to-specForvandler den samtale, du allerede har haft, til en repo-aware spec i .plan/

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen aktiverer prompter som disse skillen (på engelsk):

  • /to-spec turn what we just discussed about tagging into a written PRD
  • Save a spec to .plan for the notes feature we just finished designing
  • Write a PRD from this conversation with an exhaustive user story list