architect-review

Critique architecture artifacts against engineering rubrics with severity-tagged findings.

Updated Jun 29, 2026
One-click install
npx skills add https://github.com/phanijapps/engram --skill architect-review-phanijapps
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architect-review
Source: https://github.com/phanijapps/engram/tree/main/.agents/skills/architect-review
Command: npx skills add https://github.com/phanijapps/engram --skill architect-review-phanijapps

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

This Skill provides rigorous, rubric-based critiques of architecture artifacts, preventing costly design flaws and ensuring structural integrity before implementation begins.

Core Features & Use Cases

  • Genre-Aware Rubrics: Automatically applies specific evaluation criteria for design docs, C4 diagrams, sequence diagrams, and more.
  • Well-Architected Lens: Evaluates designs against pillar-based standards (Reliability, Security, Cost, etc.) with mechanical and judgment-based risk tagging.
  • Use Case: When a team submits a new system design document, this Skill identifies missing trust boundaries, ungrounded load-bearing claims, and operational risks, providing a clear verdict and actionable improvement plan.

Quick Start

Use the architect-review skill to critique the design document I have pasted below.

Frequently Asked Questions about architect-review

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

FAQPage Schema
How do I critique a system design document against well-architected standards?▼

To critique a system design document against well-architected standards, submit your RFCs or design docs for a rubric-based evaluation. The review identifies missing trust boundaries and ungrounded load-bearing claims, returning severity-tagged findings and actionable improvement plans.

What is the best way to review C4 diagrams and sequence diagrams for operational risks?▼

Reviewing C4 and sequence diagrams for operational risks is best handled through genre-aware rubrics. The analysis applies specific evaluation criteria for each artifact type to detect structural viability issues and tag mechanical or judgment-based risks.

Can I use an automated architecture review for design docs and RFCs?▼

Yes, you can use an automated architecture review for design docs and RFCs. The process validates load-bearing claims against internal knowledge surfaces, evaluates reliability and security pillars, and ensures structural integrity before implementation begins.

How do architecture critiques identify missing trust boundaries in a system design?▼

Architecture critiques identify missing trust boundaries by applying rigorous rubric-based analysis to the submitted design. The review evaluates the structural viability of the workload class, flags ungrounded claims, and provides a clear verdict on the system's design.

What are the limitations of rubric-based architecture reviews for engineering artifacts?▼

Rubric-based architecture reviews are limited by the artifact types provided, focusing strictly on design documents, C4 diagrams, and sequence diagrams. The evaluation relies on validating load-bearing claims against available internal knowledge surfaces.

When do I need a well-architected lens review for my workload?▼

You need a well-architected lens review when submitting a new system design to prevent costly flaws. It evaluates your specific workload class against pillar-based standards like Reliability, Security, and Cost to ensure structural viability before implementation.