template-backend

Add a complete REST endpoint from command to controller route. Use when building new API endpoints.

Summarize the API interface changes made during THIS session for the frontend, then optionally spawn an agent to implement them in the frontend repo. Use after changing endpoints, request/response DTOs, or auth.

One-shot guided session — prunes unused code, scaffolds new entities/endpoints, updates project identity config, and replaces the init migration for a specific project.

Compress natural language memory files (CLAUDE.md, todos, preferences) into caveman format to save input tokens. Preserves all technical substance, code, URLs, and structure. Compressed version overwrites the original file. Human-readable backup saved as FILE.original.md. Trigger: /caveman-compress FILEPATH or "compress memory file"

Implement a change with a pipeline scaled to its complexity. Single entry point for all code changes — auto-detects effort or accepts small|mid|tuff override.

Run a Linear task end-to-end — creates an isolated tmux session + worktree, starts a Claude agent to implement it, opens a PR, and watches for review feedback automatically.

Add a new domain event with its publisher call and background event handler. Use for async side effects.

Add a new command and handler for a use case. Use when adding business logic for an existing entity.

Add an application service for complex business logic shared across handlers. Use when logic is too complex for a single handler or is reused.

Design consultation — explore approaches, trade-offs, and patterns before committing to an implementation. No code written. Outputs a structured comparison and a recommended next step.

Show an overview of this template — what it is, available commands, and how to start.

Answer a quick question about the template using only .claude/ docs — no codebase scan

Diagnose a failing integration or unit test using project-specific recipes. Walks through known failure categories from rules/testing.md before suggesting a fix.

Run integration or unit tests scoped to a domain, file, or category. Faster feedback than `just test`. Reports failures and points to /debug-failing-test.

Add a new domain entity with SQLAlchemy mixins and generate an Alembic migration. Use when defining new database tables.

Add a new external HTTP client with config, endpoints, IO types, and an adapter. Use when integrating a new external API.

Generate and apply an Alembic migration. Use after modifying entities or when schema changes are needed.

Add a new port (Protocol interface) and its adapter implementation with DI wiring. Use when adding external capabilities.

Add a new repository protocol and implementation with gateway registration. Use after creating a new entity.

Produce a detailed implementation plan for a feature. MUST be used before implementing any non-trivial change. Outputs a structured plan — does NOT write code.

Thoroughly investigate a part of the codebase before making changes. Use to understand existing patterns, trace data flows, and find reusable code.

Review and update .claude/ configuration to reflect the current state of the project. Use after adding new domains, patterns, conventions, or when the user corrects an approach.