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.