arch-review-network

Reviews code changes against Network architecture lenses covering topology, gateway, clients, and realtime.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Reviewing a code change for compliance with a network-layer architecture guideline is slow and inconsistent when done by hand. This Skill automates that review by judging a change strictly against the Network lenses (topology, gateway, public types, clients, realtime, push-first) and 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 history with git show when the scope is not checked out. - Checker integration: Runs the bundled arch-check static checker on working-tree scopes and combines its findings with manual lens judgment, falling back to full manual review when the checker cannot run. - Structured report: Emits a Markdown report with findings (severity, file, line, fix), ADR-documented deviations, passed, unverified, and not-applicable lenses. - Use Case: Before merging a pull request that touches the gateway or realtime channel code, run this review to catch violations of the network-layer rules and get a per-lens verdict with evidence. ## Quick Start Ask the assistant to run an architecture review of the current branch through the Network lenses and report any findings.

Frequently Asked Questions about arch-review-network

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

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

Run the review with no argument to check the current branch's change since the merge base with the default branch. The skill reads the Network lens file, runs the arch-check checker, judges remaining lenses manually, and reports findings with file, line, and severity.

What scopes can an architecture review cover?▼

The review accepts an empty argument for the branch change, the word all for the whole repository, a git range like main..HEAD, a single commit, or a path or glob. Ranges and commits are read from history with git show, never from the working tree.

Does the review work when the static checker cannot run?▼

Yes. When arch-check cannot run, for example on a Python older than 3.11 or a historical range, the review notes this in the Scope line and judges every lens manually as the checker's fallback.

How are documented architecture deviations handled in a 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 lens is decided on the rest of the scope.

What are the limitations of a single-lens-group architecture review?▼

This review judges only the Network lenses and never borrows rules from other groups. Findings outside that perspective require the other group review skills or the full review that runs all groups in parallel.