architecture-reviewer

Review software design packages and route findings to the correct owner before implementation.

2|1|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/AutoByteus/autobyteus-agents --skill architecture-reviewer-autobyteus
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture-reviewer
Source: https://github.com/AutoByteus/autobyteus-agents/tree/main/agent-teams/software-engineering-team/agents/architecture-reviewer/skills/architecture-reviewer
Command: npx skills add https://github.com/AutoByteus/autobyteus-agents --skill architecture-reviewer-autobyteus

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? It prevents weak or ungrounded software designs from reaching implementation by performing a behavior-grounded technical architecture review of the complete solution package and routing every finding to the right owner. ## Core Features & Use Cases - Structured Design Review: Produces a canonical design-review-report.md from a detailed template covering behavior basis, boundaries, interfaces, dependencies, data transitions, and refactor safety. - Revision Tracking: Maintains an architecture-review-revision-record.md with ARCH-REV-* entries so every review round, prior finding resolution, and decision change stays traceable. - Finding Classification and Routing: Classifies issues as Design Impact, Requirement Gap, or Unclear, blocks unsupported premises, and hands off pass/fail results to solution_designer or implementation_engineer. - Use Case: Before a team implements a new feature, run this review on the requirements doc, investigation notes, and design spec to catch boundary violations, unsupported migration assumptions, and missing refactor rationale. ## Quick Start Review the complete solution package in the current task workspace and produce a design review report with a pass, fail, or blocked decision.

Frequently Asked Questions about architecture-reviewer

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

FAQPage Schema
How do I review a software design before implementation?▼

Review the design spec against the approved requirements and investigation notes, trace each behavior through current and target production paths, then record findings in a structured design review report. This skill applies a template covering boundaries, interfaces, dependencies, and data transitions.

What is a design review report in a software engineering workflow?▼

A design review report is the canonical artifact recording the review basis, structural verdicts, findings, and the pass, fail, or blocked decision for a design spec. It stays updated across review rounds while a revision record tracks the chronological history.

When should a design finding be classified as a requirement gap?▼

Classify a finding as a Requirement Gap when the proposed correction would introduce new product behavior, policy, threat model, migration obligation, or operational contract not covered by approved requirements. It routes back for explicit user approval instead of being treated as a design defect.

Can a design pass review with unresolved edge-case concerns?▼

No, not when in-scope fallback, recovery, or lifecycle machinery depends on an unsupported material premise. The premise must be validated as reachable through a product-supported trigger, removed, or routed upstream before the design can pass.

What are the limitations of automated architecture review?▼

The review cannot redefine approved business decisions or invent new requirements, and it depends on complete upstream inputs like requirements docs and investigation notes. Missing evidence produces a Blocked or Unclear result rather than a judgment.