citypaul/.dotfiles

citypaul/.dotfiles

Agent Claude Code

This directory contains specifications for specialized Claude Code agents that work together to maintain code quality, documentation, and development workflow.

citypaul/.dotfiles

Agent Claude Code

Use this agent proactively when making significant architectural decisions and reactively to document architectural choices after they're made. Invoke when evaluating technology options, making foundational decisions, or discovering undocumented architectural choices.

citypaul/.dotfiles

Agent Claude Code

Use this agent to create or review maintained developer-facing documentation. It routes document shape, lifecycle, evidence, and ownership through the canonical technical-writing and expectations skills instead of imposing one template on every page.

citypaul/.dotfiles

Agent Claude Code

Use this agent when completed work reveals a durable, non-obvious constraint or practice that may need to be captured. It routes each learning to its actual owner rather than putting every insight in CLAUDE.md.

citypaul/.dotfiles

Agent Claude Code

Tracks progress through significant work using the repository's declared planning workflow, including vertical-slice or explicitly selected reduction-program plans and optional stacked-PR delivery maps. Use at the start of planned work, to update progress, and at the end to merge learnings.

citypaul/.dotfiles

Agent Claude Code

Use this agent to assess bounded refactoring opportunities after GREEN or another passing proportionate preservation baseline. Invoke when that baseline is established or when weighing whether an abstraction adds value. Mutation testing verifies the accumulated result later at the end-of-phase PR-readiness gate.…

citypaul/.dotfiles

Agent Claude Code

Use this agent to verify TDD process compliance for new or changed observable behavior during fast RED-GREEN-REFACTOR increments and the separate end-of-phase mutation gate. Invoke when users plan to implement behavior, when checking that behavior tests preceded implementation, before committing behavior-changing…

citypaul/.dotfiles

Agent Claude Code

Review changed TypeScript for evidence-backed type-safety defects. Use when defining types or schemas, or before committing TypeScript changes. Scope: type safety only; use the TDD or refactoring agents, or the panel-review skill (/panel-review), for their respective concerns.

citypaul/.dotfiles

Agent Claude Code

Read-only audit of an existing deployable service against the applicable Twelve-Factor principles. Use for deployment-readiness or infrastructure reviews; do not apply the method wholesale to libraries, CLIs, desktop apps, or embedded software.

citypaul/.dotfiles

Agent Claude Code

Read-only tracing of a user-facing use case through entry points, policy, domain logic, persistence, integrations, asynchronous work, and observable results. Use to explain an existing flow or find evidence-backed implementation gaps before changing it.