dev-process-toolkit

Manage the project best-practices manifest at `specs/best-practices.yaml`. Add, edit, delete, or list entries cataloguing house best-practices docs with scope globs and topics that feed guidance retrieval into planning and implementation.

Socratic design session for greenfield features with open solution spaces. Clarifies goals one question at a time, proposes 2-3 approaches with tradeoffs, gets design approval, then feeds into /spec-write.

Full delivery pipeline orchestrator — takes a feature request from idea through specs to shipped, merged milestones by chaining the toolkit's phase skills end-to-end.

Manage the sibling-package dependency manifest at `specs/deps.yaml`. Add, edit, delete, list, or sync entries that feed topic-aware retrieval into /brainstorm and /spec-write via the deps-researcher fork.

Internal research fork — invoked exclusively by /brainstorm and /spec-write via context:fork pairing with the deps-researcher subagent. Returns topic-aware sibling-package retrieval as a ≤25-line block. Do not invoke directly.

Generate or update project docs (requires /setup --docs first). One of --quick, --commit, --full. `--quick` stages a fragment per FR; `--commit` merges staged fragments with human approval; `--full` regenerates the canonical docs/ tree from scratch.

Run the project gate checks and report results. Use after completing any feature, before creating a PR, or to verify project health.

Implement a feature or fix end-to-end. Analyzes the request, builds in TDD order, runs gate checks, self-reviews with bounded loops, and reports for human approval before committing.

Create a pull request with conventional format. Use when asked to create a PR, open a pull request, or push changes for review.

Capture a structured bug report — narrative + redacted curated context (and optional session transcript) — and publish to a secret GitHub gist for triage by the maintainer or self-debug via /brainstorm.

Set up SDD/TDD development process for the current project. Creates CLAUDE.md, configures settings, and optionally creates spec files. Use when starting a new project or adding process to an existing one.

Internal template-source setup child — dispatched exclusively by /setup --template. Analyzes a template project, walks reuse selection, and lands the copied config into the current project. Do not invoke directly; stays model-invocable for the dispatching parent.

Bundle the Release Checklist + /docs --commit --full into one atomic, human-approved release commit. Reads specs/plan/M<N>.md, bumps the four release files, regenerates docs, prompts once for approval, commits on `y`, does not push.

Review changed code for reuse, quality, and efficiency, then fix any issues found. Use after completing a feature to clean up.

Manually archive user-selected FRs or milestones by `git mv` into `specs/frs/archive/` (and optionally `specs/plan/archive/`) with a diff approval gate. Accepts ULID, tracker ID/URL, or `M<N>`. Escape hatch for /implement Phase 4 auto-archival gaps.

Internal research fork — invoked exclusively by /brainstorm and /spec-write via context:fork pairing with the spec-researcher subagent. Returns related-FR retrieval as a ≤25-line block. Do not invoke directly.

Review implementation against specs to find deviations, missing features, or inconsistencies. Delegates to the `spec-review-audit` fork + `spec-reviewer` subagent.

Internal spec-review audit fork — invoked exclusively by /dev-process-toolkit:spec-review via context:fork pairing with the spec-reviewer subagent. Audits the FR's specs against shipped code (read-only) and emits a spec-review-result fenced block. Do not invoke directly.

Guide the user through writing or completing spec files (requirements, technical spec, testing spec, plan). Use after /setup to fill in specs before implementation, or to update existing specs.

Multi-agent TDD orchestrator. Runs RED → GREEN → REFACTOR → AUDIT for one FR via four forked subagents (test-writer / implementer / refactorer / spec-reviewer) with a strict tdd-result hand-off contract, bounded retries, and a deterministic halt path. Replaces the previous single-context /tdd.

Internal TDD implementer fork — invoked exclusively by /dev-process-toolkit:tdd via context:fork pairing with the tdd-implementer subagent, once per AC. Implements the minimum code to turn one AC's failing test GREEN. Do not invoke directly.

Internal TDD refactorer fork — invoked exclusively by /dev-process-toolkit:tdd via context:fork pairing with the tdd-refactorer subagent, exactly once at end of FR after all ACs are GREEN. Do not invoke directly.

Internal TDD spec-review fork — invoked exclusively by /dev-process-toolkit:tdd via context:fork pairing with the tdd-spec-reviewer subagent, exactly once at the end of an FR after REFACTOR is GREEN. Audits the FR's ACs (read-only) and emits a tdd-spec-review-result fenced block. Do not invoke directly.

Internal TDD test-writer fork — invoked exclusively by /dev-process-toolkit:tdd via context:fork pairing with the tdd-test-writer subagent. Writes failing tests for the full AC list of one FR. Do not invoke directly.

Bring an already-bootstrapped project up to current toolkit conventions. Walks the version-ordered migration registry, previews every change, and applies the scripted fixes in one approved commit.

Visually verify web UI using a rubber duck MCP with Chrome browser tools. Use after building or modifying web UI components.