arch-review-storage

Reviews code changes against storage architecture lenses covering tables, translation, roles, and migrations.

89|10|Updated Sep 15, 2026
One-click install
npx skills add https://github.com/baristaze/swe_guidelines --skill arch-review-storage-baristaze
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: arch-review-storage
Source: https://github.com/baristaze/swe_guidelines/tree/main/skills/arch-review-storage
Command: npx skills add https://github.com/baristaze/swe_guidelines --skill arch-review-storage-baristaze

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Reviewing a code change for compliance with a project's storage-layer architecture rules is slow and inconsistent when done by hand. This Skill automates that review by judging a change strictly against the Storage lenses of the swe_guidelines architecture guideline, producing a structured findings report. ## Core Features & Use Cases - Scoped review: Reviews the current branch's change, a commit, a range, a path, or the whole repository, reading files from the working tree or from git history as appropriate. - Checker integration: Runs the bundled arch-check static checker first, adopts its fully covered lens decisions, and judges the remaining lenses by reading the code. - Structured report: Emits a Markdown report with findings ordered by severity, deviations backed by ADRs, and pass/unverified/not-applicable decisions for every lens. - Use Case: Before merging a pull request that adds a new table and migration, run the review on the branch to catch violations of storage principles, translation rules, and migration conventions with file-and-line evidence. ## Quick Start Ask the assistant to run an architecture review of the current branch's changes through the Storage lenses.

Frequently Asked Questions about arch-review-storage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review a code change against storage architecture rules?▼

Run the review with no argument to check the current branch's change since the merge base with the default branch. It reads the Storage lens file, runs the arch-check checker, judges remaining lenses against the code, and reports findings with file and line.

What does the arch-review-storage skill check?▼

It checks the Storage Layer and Identifiers lenses: storage principles, tables, translation, roles, and migrations. It flags only what a lens in that file names and never borrows rules from other review perspectives.

Can I review a specific commit or path instead of a branch?▼

Yes. Pass a commit SHA, tag, or branch to review that commit's change, a range like main..HEAD, a path or glob for files as they are now, or the word all for the whole repository.

Does the storage review require Python to run?▼

Python 3.11 is needed only for the bundled arch-check static checker, which runs on working-tree scopes. If the checker cannot run, the review falls back to judging every lens manually and notes this in the report's Scope line.

How are documented architecture deviations handled in the review?▼

A breach backed by an ADR that quotes the rule and is cited next to the code is recorded as a deviation, not a finding. It appears on one line under Deviations, and the ADR never lowers a finding's severity.

Will the review modify or commit my code?▼

No. The skill only reads and reports. It never edits, stages, or commits anything in the repository under review.