architect-refine-critique

Orchestrate three-phase design reviews to generate ADRs and design artifacts.

334|43|Updated Nov 14, 2025
One-click install
npx skills add https://github.com/NTCoding/claude-skillz --skill architect-refine-critique
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architect-refine-critique
Source: https://github.com/NTCoding/claude-skillz/tree/main/architect-refine-critique
Command: npx skills add https://github.com/NTCoding/claude-skillz --skill architect-refine-critique

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill orchestrates a three-phase design-review workflow (Architect → Refiner → Critique) to produce a complete Architecture Decision Record (ADR) and a shared understanding of the system design.

Core Features & Use Cases

  • End-to-end design lifecycle: orchestrates design, refinement, and critique steps to surface decisions and trade-offs.
  • Artifact generation: creates and stores design.md, refinements.md, refined.md, and critique.md under docs/design-reviews/[name]/.
  • Collaboration and governance: enforces structured feedback and creates a traceable ADR that teams can act on.
  • Use Case: a team evaluating a new module can run the arc workflow to capture domain boundaries, concerns, and final decisions.

Quick Start

Start an architecture review with the command: /arc <name> <target>. After three phases complete, run /arc-review <name> to generate the ADR.

Frequently Asked Questions about architect-refine-critique

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

FAQPage Schema
How do I generate an Architecture Decision Record for a new module?

To generate an Architecture Decision Record, you can run a three-phase design review workflow that produces a complete ADR. It orchestrates design, refinement, and critique steps to capture domain boundaries, trade-offs, and final decisions in a traceable document.

What is the best way to run a collaborative design review for software architecture?

A collaborative design review is best run by chaining architect, refiner, and critique subagents. This enforces structured feedback and governance, resulting in a shared architectural understanding and a set of stored artifacts like design.md and critique.md.

Can I apply tactical DDD and separation-of-concerns principles to document architectural trade-offs?

Yes, you can apply tactical DDD and separation-of-concerns principles to document architectural trade-offs. The workflow specifically uses these principles to surface domain decisions, risks, and trade-offs within a governance framework.

How do I structure ADR artifacts when evaluating system design boundaries?

To structure ADR artifacts, the workflow outputs files under a docs/design-reviews/[name]/ directory. This includes design.md, refinements.md, refined.md, critique.md, and the final adr.md to ensure traceable architecture decisions.

Does the design review workflow require any specific dependencies to generate ADRs?

No specific dependencies are required to run the design review workflow and generate ADRs. The skill operates independently to orchestrate the architect, refiner, and critique phases without external tool dependencies.

When do I need a three-phase architecture critique workflow instead of a standard design document?

You need a three-phase architecture critique workflow when your team requires enforced governance and traceable ADRs. It is suited for evaluating new modules where surfacing deep trade-offs, risks, and domain boundaries is critical before finalizing decisions.