arch-review-ops

Reviews code changes against Operations architecture lenses and reports findings with severity.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Reviewing code changes for operational concerns like credentials, alarms, scale-out, cost, and environments is easy to skip or do inconsistently. This Skill applies a fixed catalog of Operations review lenses to a change so every review checks the same rules and produces a structured, evidence-backed report. ## Core Features & Use Cases - Scoped review: Reviews the current branch change, a commit, a range, a path, or the whole repository, reading files from git history when the scope is not checked out. - Static checker integration: Runs the bundled arch-check tool first, adopts its fully covered lens decisions, and judges the remaining lenses by reading the code. - Structured report: Outputs findings ordered by severity with file and line evidence, plus deviations backed by ADRs, passed, unverified, and not-applicable lenses. - Use Case: Before merging a pull request that adds a new alarm and changes deployment configuration, run this review to confirm the change satisfies the Operations lenses and to catch missing credential handling or undocumented environments. ## Quick Start Ask the assistant to run an Operations architecture review of the current branch change and report any findings with severity and file locations.

Frequently Asked Questions about arch-review-ops

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

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

Invoke the review with no argument to check the current branch change against the default branch, or pass a commit, range, path, or the word all. The skill reads the lens file, runs the static checker, judges remaining lenses, and reports findings with file and line evidence.

What does the Operations architecture review check?▼

It checks the lenses defined in the Operations lens file: roles, credentials, ops skills, alarms, scale-out, cost, environments, traffic, and READMEs. It only flags what a lens in that file names and never borrows rules from other review groups.

Can I review a commit or range that is not checked out?▼

Yes. Pass a commit SHA, tag, branch, or a range like main..HEAD, and the skill reads each file at that point in history using git show. The static checker is skipped for historical scopes and every lens is judged by reading the code.

What happens when the static checker cannot run?▼

If the checker fails, for example on a Python older than 3.11 or exit code 2, the review notes this in the Scope line and judges every lens manually. The review acts as the checker's fallback, so coverage is not lost.

How are documented exceptions and ADRs handled in the review?▼

A breach whose ADR quotes the rule and is cited next to the code is recorded as a deviation on one line, not a finding. The lens is then decided on the rest of the scope, and an ADR never lowers a finding's severity.