architect-critics

Analyze architecture proposals from two practitioner perspectives and produce a structured critique document.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/ryan-mahoney/ryan-llm-skills --skill architect-critics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architect-critics
Source: https://github.com/ryan-mahoney/ryan-llm-skills/tree/main/skills/architect-critics
Command: npx skills add https://github.com/ryan-mahoney/ryan-llm-skills --skill architect-critics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams uncover flaws, blind spots, and over-engineering in proposed architectures by applying two real practitioners' perspectives, preventing costly downstream mistakes.

Core Features & Use Cases

  • Select two complementary expert perspectives and apply them to a proposal.
  • Extract explicit claims, identify gaps, and surface tradeoffs with grounded reasoning.
  • Produce a formal Architecture Critique document with issue-specific recommendations and risk notes.

Quick Start

Provide a formal critique for a given architecture proposal and output the results as a structured Architecture Critique document.

Frequently Asked Questions about architect-critics

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

FAQPage Schema
How do I critique a proposed system design to uncover flaws and tradeoffs?

To critique a system design, you can apply two complementary expert perspectives to a formal proposal, extracting explicit claims and surfacing tradeoffs to produce a standardized Architecture Critique document.

What is the best way to review an architecture document for blind spots?

Reviewing an architecture document for blind spots is best achieved by applying a structured critique workflow with grounded reasoning from two real practitioners' perspectives to reveal over-engineering and flaws.

Does an architecture critique require a formal proposal to work?

Yes, an architecture critique requires a formal proposal, architecture document, or design plan shared in conversation to extract explicit claims and identify gaps for the critique workflow.

How do I generate an Architecture Critique document from a design plan?

To generate an Architecture Critique document, select two complementary expert perspectives, apply them to your design plan, and output the structured results with issue-specific recommendations and risk notes.

When should I not use a two-expert architecture critique?

You should not use a two-expert architecture critique when you lack a formal proposal or publicly verifiable expert lenses, as the structured critique workflow requires these to produce grounded reasoning.