code-reviewReviews a branch diff on two axes: Standards (does the code follow the team's standards and the repository's?) and Spec (does it do what the ticket asked?). The reviewer fixes and commits what violates the standards and reports what needs a decision. Use when an implementation is finished, before op
demoBuilds a working demo of a feature inside the real codebase, on a demo branch, so a real user can use it before any hardening. Use after a grill, when a feature has to prove its value before the technical plan, or when someone asks to see the whole idea working.
dev-startSession entry point for someone who develops: asks once what the person wants to do and takes them to the right skill in the flow. Use when someone is about to start dev work without saying at which stage.
implement-specImplements a whole spec: walks the slices of the parent issue in blocker order, with one implementer per slice, and delivers one reviewed PR per repository. Use when a parent issue with slices exists and someone asks to implement the spec, the whole feature or all the slices. For a single slice or a
implementImplements a single slice or a small change: dispatches the right implementer, verifies the repository's checks, closes with the review and updates the issue in Linear. Use for an isolated ticket, an adjustment or a bug, whenever the work is writing or changing production code, before writing the fi
pm-startSession entry point for someone who looks after product: asks once what the person wants to do and takes them to the right skill, from the idea to the spec in Linear. Use when a PM is about to start work without saying at which stage.
prototypeBuilds a throwaway prototype to answer a design question. Use when someone wants to feel whether a business rule or a state machine is right, compare options for a screen, or see what happens in an exchange of events between services when something goes wrong.
refinement-docProduces the technical refinement document of a ticket or feature as an HTML page in a standard structure (before × after, closed decisions, flow, entity-relationship, contracts, changes per repository, edge cases, rollout, rollback and verification), with the same visual semantics for new × existin
tddTest-first reference: what a good test is, where it lives and the rules of the red and green cycle. Use when implementing a feature or fixing a bug, and when someone mentions TDD, red-green or integration tests.
to-specTurns what has already been decided into a spec published on the Linear parent issue, anchored in the current code. After a demo, it cuts the v1 from it. Use after a demo that proved its value, after a grill when the only open doubt is how to build, or when there is a call transcript with decisions,
to-ticketsCuts a spec into vertical slices in Linear, each with the repositories it touches and the blockers between them. Use after to-spec, or when someone asks to break an issue or a plan into tasks.