Claude Skills by yknnv

Turn an approved spec.md into design.md — the technical approach, the blast radius of the change, contract changes, failure handling, and migration path. Use after /brownspec:spec, or when the user asks how to build something already specified, or says /brownspec:design.

How Brownspec reads an existing codebase — the project map, the conventions sample, and the blast radius. Use when another Brownspec skill needs repository facts, or when the user asks what a change touches, who calls a symbol, or what this project's conventions are.

Start or resume a specification for a change to this codebase. Interviews the user one question at a time, writes spec.md to disk, then separately lists the organizational policies the change touches. Use when the user asks to spec out a change, write requirements, plan a feature before coding, or says /brownspec:spec.

Bootstrap or refresh .brownspec/ for this repository — project-map.json and conventions.md derived from the code, plus a policies.md stub for humans to fill in. Use on first run in a new repo, when conventions have drifted, or when the user says /brownspec:init.

Break an approved design.md into an ordered, reviewable task list, and seed trace.json so drift can be detected later. Use after /brownspec:design, when the user asks to break work into tasks or tickets, or says /brownspec:tasks.