to-spec

Installation
SKILL.md

Synthesize established decisions from the current context and any completed Wayfinder map into a specification. A specification is a system representation: it describes the intended system but does not make it real. Work from established decisions. Ask only to confirm proposed proof seams; return every other material gap to planning.

Apply thinking-in-systems to preserve the accepted goal and use the language in its references/CONTEXT.md. Let the other focused systems skills load when their descriptions match the work. Keep their guidance in its owning skill; the specification records the resulting decisions.

When a material decision is missing, return the exact gap to planning instead of inventing an answer.

Turn decisions into a specification

  1. Explore the current system and its authoritative records to understand its state. For software, inspect the repository. Use the established domain vocabulary throughout the specification and respect accepted decision records.

Continue when the current state and every authoritative decision in scope are known.

  1. Apply representing-systems to make the intended system traceable, then apply designing-interfaces and sketch the proof seams where the required behavior will be evaluated. Prefer existing seams to new ones and use the highest system boundary possible. If a new seam is needed, propose it at the highest point that exposes the behavior. Fewer seams are better; the ideal is one when one can prove the required behavior.

Check with the user that these seams match their expectations. If the answer exposes a material undecided seam, return that gap to planning.

Continue when the proof seams are accepted or the exact gap has returned to planning.

  1. Write the specification using the template below, then publish it to the effort's work tracker. If no tracker is available, use local Markdown. Mark it ready-for-agent only when another actor can act from it without inventing a material decision. No additional triage is needed.
Installs
9
GitHub Stars
3
First Seen
Aug 9, 2026