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:

Installs
10
Repository
jwd83/skills
GitHub Stars
1
First Seen
Jun 12, 2026
architectural-review — jwd83/skills