architecture-review

Review PRDs and technical intent for architectural alignment before coding.

5|1|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/jstoup111/ai-conductor --skill architecture-review-jstoup111
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-review
Source: https://github.com/jstoup111/ai-conductor/tree/main/skills/architecture-review
Command: npx skills add https://github.com/jstoup111/ai-conductor --skill architecture-review-jstoup111

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires verify-claims, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill prevents technical debt and ensures architectural alignment by conducting a review before implementation, catching infeasibility, drift, and domain violations early.

Core Features & Use Cases

  • Technical Feasibility: Assess stack compatibility, prerequisites, and integration surface.
  • Complexity Assessment: Determine the level of complexity to guide the depth of review.
  • Architectural Alignment: Check against documented architecture, including boundaries and patterns.
  • Domain Integrity Pre-Check: Ensure domain modeling principles are followed.
  • Risk Register: Identify potential risks and mitigation strategies.
  • ADR Creation: Generate and approve Architecture Decision Records for significant changes.
  • Output: Provide a summary of the review's findings and a clear verdict.

Quick Start

Run the architecture-review skill to review your architectural plan before implementation.

Frequently Asked Questions about architecture-review

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

FAQPage Schema
How do I conduct an architectural review before coding to prevent technical debt?

An architectural review assesses technical feasibility, complexity, and alignment before coding. It prevents technical debt by catching infeasibility, drift, and domain violations early through a structured evaluation of your technical intent and prerequisites.

What is an Architecture Decision Record and when do I need one for a design review?

An Architecture Decision Record (ADR) is a document that captures significant technical decisions made during an architectural review. You need an approved ADR to proceed with any architectural change, ensuring that stack compatibility and integration risks are formally addressed.

How do I assess technical feasibility and domain integrity for a new software project?

To assess technical feasibility and domain integrity, you review the PRD against documented architecture, checking stack compatibility, boundaries, and domain modeling principles. This pre-implementation check identifies potential risks and ensures the design aligns with established patterns.

Can I use architecture review to check if my technical claims and assumptions are valid?

Yes, architecture review explicitly identifies and verifies technical claims and assumptions found in your PRDs and technical intent. It validates these claims against prerequisites and documented architecture to ensure the proposed integration surface is viable.

What's the best way to document architectural risks and mitigation strategies before implementation?

The best way to document architectural risks is to generate a Risk Register during the design review, outlining potential risks alongside their mitigation strategies, which then feeds into the final review summary and verdict before any coding begins.

Do I need to submit a PRD for a technical feasibility assessment?

Yes, a Product Requirements Document (PRD) or equivalent technical intent is required for a technical feasibility assessment. The review process relies on these documents to evaluate stack compatibility, complexity, and architectural alignment.