architecture-review

Solid

Conducts a comprehensive multi-perspective architecture review using ALL architecture team members. Use when the user requests "Start architecture review", "Full architecture review", "Review architecture for version X.Y.Z", "Conduct comprehensive review", or when they want assessment from multiple perspectives. Do NOT use for single-specialist reviews (use specialist-review instead) or for status checks (use architecture-status instead).

Code & Development 73 stars 11 forks Updated 4 days ago

Install

View on GitHub

Quality Score: 78/100

Stars 20%
62
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
0
Description 5%
100

Skill Content

# Architecture Review (orchestrator) Comprehensive multi-perspective architecture review. This skill is an **orchestrator** — it dispatches one subagent invocation per active team member in parallel, then aggregates the returned reviews into a consolidated document. The deep-perspective work happens in the subagents (`agents/<id>.md`), not in this skill's main thread. See [ADR-013](../../.architecture/decisions/adrs/ADR-013-skill-orchestrator-subagent-delegation.md) for the rationale. ## Process ### 1. Determine scope Identify the review target from the user's request: - **Version** — "version 2.0.0" → filename `2-0-0.md` - **Feature** — "authentication feature" → filename `feature-authentication.md` - **Component** — "payments module" → filename `component-payments-module.md` Apply input sanitization from [`../_patterns.md`](../_patterns.md). If the scope is ambiguous, ask one clarifying question and stop. ### 2. Load team and config Read `.architecture/config.yml` and `.architecture/members.yml`: - `config.yml.pragmatic_mode.enabled` decides whether to include the `pragmatic_enforcer` subagent. - `members.yml.members[]` is the list of subagents to dispatch. Each member's `id` (e.g., `security_specialist`) maps to `agents/<kebab-id>.md` (e.g., `agents/security-specialist.md`). The drift check in CI guarantees these files exist and are in sync. **Active set**: every member in `members.yml`, **excluding** `pragmatic_enforcer` if `config.yml.pragmatic_mode.enabled ==...

Details

Author
codenamev
Repository
codenamev/ai-software-architect
Created
1 years ago
Last Updated
4 days ago
Language
JavaScript
License
None

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

design-architecture

Reviews the current codebase architecture and proposes improvements using four parallel specialist subagents: System Architect, Software Architect, Data Architect, and an Adversarial Architect that red-teams failure paths, LLM adversarial output scenarios, silent corruption risks, and invariant bypasses. Each subagent independently analyzes the codebase from their domain perspective, then their findings are consolidated into a living `architecture.md` file with a tracked to-do list and change log. Use this skill whenever the user asks to review, analyze, audit, or improve the architecture — or when they ask questions like "what should we change structurally?", "how is the system organized?", "what are our architecture problems?", "can you do an architecture review?", or "let's redesign X". Also trigger when the user mentions technical debt, structural improvements, security concerns, failure modes, vulnerabilities, or wants a second opinion on design decisions, even if they don't use the word "architecture".

58 Updated 2 days ago
SenolIsci
AI & Automation Listed

lead-architect-agent

Senior architectural decision-making, system design, and clean-architecture layer review for a feature or service. Use when designing a new feature's architecture before implementation, choosing a stack or database, reviewing layer boundaries (domain / application / infrastructure / interface), writing an ADR, planning a refactor or service split, or handing a design off to builder/backend/integration/QA roles. Triggers: "architecture review", "how should I structure this", "clean architecture", "which database", "design the API", "should this be microservices", "write an ADR".

5 Updated 2 days ago
nxtg-ai
Code & Development Solid

architecture-review

Validates completeness and consistency of the project architecture against all GDDs. Builds a traceability matrix mapping every GDD technical requirement to ADRs, identifies coverage gaps, detects cross-ADR conflicts, verifies engine compatibility consistency across all decisions, and produces a PASS/CONCERNS/FAIL verdict. The architecture equivalent of /design-review.

65 Updated 3 days ago
striderZA