speckit-architecture-guard-architecture-review

Validate implementation alignment against architecture specs and governance rules.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/B0yZ4kr14/OrthoPlus-Enterprise --skill speckit-architecture-guard-architecture-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-architecture-guard-architecture-review
Source: https://github.com/B0yZ4kr14/OrthoPlus-Enterprise/tree/main/.specify-backups/20260518-141826/_agents/skills/speckit-architecture-guard-architecture-review
Command: npx skills add https://github.com/B0yZ4kr14/OrthoPlus-Enterprise --skill speckit-architecture-guard-architecture-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams prevent and detect architecture drift by performing an evidence-based review that validates implementation alignment against architecture specs and governance rules.

Core Features & Use Cases

  • Evidence-Based Architecture Review: Produces a structured report where each violation cites concrete implementation evidence (file paths, line numbers, or observable patterns) or explicitly notes critical absence.
  • Framework-Agnostic Governance Checks: Applies boundary, contract fidelity, layering, and constitution principles independent of the tech stack, with optional framework-aware vocabulary when presets exist.
  • Hybrid Scope & Optional Deep Scans: Automatically scopes analysis to changed files and can optionally run SonarLint-based architecture-correlated checks in architecture mode.
  • Refactor Task Generation: Converts confirmed violations into non-blocking, actionable refactor tasks with priorities and suggested fixes.

Quick Start

Use the speckit architecture review to audit the repository’s changed implementation against its architecture spec and governance constitution.

Frequently Asked Questions about speckit-architecture-guard-architecture-review

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

FAQPage Schema
How do I detect architecture drift in my codebase?

Architecture drift is detected by performing an evidence-based review that validates implementation alignment against architecture specs, plans, and governance constitutions. This process automatically scopes analysis to changed files and cites concrete implementation evidence like file paths and line numbers for each violation.

What is evidence-based architecture review?

Evidence-based architecture review is a validation method that produces structured reports where each violation cites concrete implementation evidence, such as file paths, line numbers, or observable patterns. It explicitly notes critical absences and converts confirmed violations into actionable refactor tasks with priorities.

Can I run architecture governance checks independent of my tech stack?

Yes, you can apply framework-agnostic governance checks for boundary integrity, contract fidelity, and layering independent of your tech stack. It optionally applies framework-aware vocabulary when presets exist and can run SonarLint-based checks to correlate code quality risks with architecture violations.

How do I generate refactor tasks from architecture violations?

Refactor tasks are generated by converting confirmed architecture violations into non-blocking, actionable items with priorities and suggested fixes. This occurs automatically as part of the structured output during an architecture review that checks implementation alignment against governing constitutions.

Does architecture review modify my source files during analysis?

No, architecture review requires strict read-only behavior during analysis. It performs governance checks using progressive context loading and changed-file detection to validate implementation alignment without modifying your source files.