define-doneClose the verification dimension by deciding one shared way a body of work will be proven done, and attach it to whatever carries the work — a live planning session, a spec, or a ticket set. Use when grilling has settled problem, shape, and approach, when a spec or tickets still have verification op
domain-modelingBuild and sharpen a project's domain model. Use when the user wants to pin down domain terminology or a ubiquitous language, record an architectural decision, or when another skill needs to maintain the domain model.
grillingGrill the user relentlessly about a plan, decision, or idea until the frontier is empty, maintaining the domain model as you go and ending in a spec or tickets. Use when the user wants to stress-test their thinking, sharpen a design, or work out what to build, or uses any 'grill' trigger phrases.
improve-codebase-architectureScan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
intakeEntry point for work that does not exist yet. Use when the user describes something they want to build, floats an idea, brings a rough or half-formed spec, or asks where to start — before any planning or implementation begins.
principle-block-on-the-humanApply when an open question could be answered by the person in front of you. In an interactive planning session the human is the cheapest resolver of ambiguity - ask, and wait.
principle-close-or-block-the-dimensionApply at the end of any planning session. Every dimension ends either settled or as a named decision ticket - never merely discussed.
principle-name-the-destinationApply before decomposing work into tickets, phases, or a map. State what done looks like before you break anything into parts.
principle-one-way-doors-firstApply when sequencing decisions or ordering a plan. Surface and settle irreversible decisions early, while changing your mind is still cheap.
principle-walk-the-treeApply when interviewing, scoping, or decomposing. Ask the whole frontier of currently-answerable questions at once; never guess at an answer that would unblock a question you have not asked.
principle-write-it-downApply whenever a decision is reached, a term is pinned, or a session ends. A decision that was not recorded did not happen.
prototypeBuild a throwaway prototype to answer a design question. Use when the user wants to sanity-check whether a state model or logic feels right, or explore what a UI should look like.
researchInvestigate a question against high-trust primary sources and capture the findings as a Markdown file in the repo. Use when the user wants a topic researched, docs or API facts gathered, or reading legwork delegated to a background agent.
scoutChart work too big for one agent session as a shared map of decision tickets on the issue tracker, then resolve them one at a time until the way to the destination is clear. Use when intake finds the frontier unmapped, when the work is a rewrite, migration, or other effort whose open questions canno
setup-ph-planConfigure this repo for the engineering skills — set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.
to-questionnaireTurn a decision you can't fully answer into a questionnaire for someone else to fill in.
to-specTurn the current conversation into a spec carrying a settled block and publish it to the project issue tracker — synthesis of what was already discussed, not a new interview. Use when a grilling or planning session has reached shared understanding and should end in a spec, or when the user asks to w
to-ticketsBreak a plan, spec, or the current conversation into tracer-bullet tickets, each declaring its blocking edges, and publish them to the configured tracker. Use when a planning session should end in tickets rather than a spec, when a spec needs splitting into slices an agent can build, or when the use
triageMove issues and external PRs through a state machine of triage roles — categorize, verify, grill if needed, and write agent-ready briefs. Use when intake finds the work already exists as an issue or PR, when the user asks what needs attention or what is ready for an agent, or names an issue or PR to