architectural-review
Installation
SKILL.md
Architectural Review
Use this skill for project-level architecture and refactoring assessments. The active output is plans/in-progress/architectural-review.md; it both records the review and guides a short, behavior-preserving improvement campaign.
There are two modes:
- Author the review when no current architectural review exists.
- Execute the plan when the document exists and the user asks to continue, start, or complete a numbered step.
Read and write the review at plans/in-progress/architectural-review.md. If the repo already keeps a review at a legacy location, continue using that file rather than duplicating it (see project-layout); migrate only when reorganization is in scope.
Mode 1: Author the review
Establish the baseline
Review the repository before making judgments. Record the date, branch, and commit reviewed. Gather evidence such as: