dotfiles

Use when refactoring code to improve testability, separate side effects, remove hidden dependencies, or introduce dependency injection.

Use when the user proposes a technical solution, asks for architectural feedback, asks whether an approach is good, or wants a Staff+/Principal-level engineering review. Do not use for small mechanical edits.

Use when creating a human-facing report, implementation plan, architecture comparison, codebase review, PR review, migration analysis, testability audit, performance investigation, or stakeholder summary where visual structure, diagrams, tables, or collapsible sections make the result easier to review. Do not use for canonical repository documentation, small answers, README files, AGENTS.md, SKILL.md, or files intended for clean git diffs.

Use when a task spans multiple logical changes and the user wants the working tree prepared for review or later commits.

Use when writing, updating, or reviewing automated tests. Use for unit tests, behavior changes, regression tests, and testability refactors.