arch-decision

Extract and audit architectural hypotheses from PRDs using the Quint First Principles Framework.

5|Updated Apr 18, 2026
One-click install
npx skills add https://github.com/russosalv/NONoise --skill arch-decision
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: arch-decision
Source: https://github.com/russosalv/NONoise/tree/main/packages/skills/arch-decision
Command: npx skills add https://github.com/russosalv/NONoise --skill arch-decision

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns an informal or draft PRD into an evidence-backed architectural verdict by extracting hypotheses from the decision story, running a disciplined abduction→deduction→induction cycle, and producing a transparent audit trail so architects can decide or iterate with confidence.

Core Features & Use Cases

  • Hypothesis extraction: Reads the PRD decision story and enumerates chosen options and missing alternatives to ensure structural diversity.
  • Quint FPF workflow: Guides the PRD through Abduction, Deduction, Induction, Audit (R_eff via WLNK), and Decision phases with checkpoints and user confirmations.
  • Artifact output: Writes a full markdown audit report in docs/prd/<area>/audit, updates PRD frontmatter to validated/rejected when approved, and produces a concrete checklist of impacts for manual updates to docs/architecture.
  • Use case: An architect who finished a draft PRD can run this Skill to verify design choices, surface weak evidence, and obtain a reproducible justification for promoting the PRD to a sprint.

Quick Start

Run arch-decision on the target PRD path to perform a Quint FPF audit and produce an audit report.

Frequently Asked Questions about arch-decision

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

FAQPage Schema
How do I validate architectural hypotheses in a product requirements document?

To validate architectural hypotheses in a PRD, you can extract chosen options and missing alternatives from the decision story, then run them through abduction, deduction, and induction phases to produce an evidence-backed audit trail.

What is the Quint First Principles Framework for architectural reviews?

The Quint First Principles Framework is a disciplined workflow that guides PRD validation through abduction, deduction, induction, audit, and decision phases to compute an effectiveness score using the weakest-link method.

How do I audit a PRD to surface weak architectural evidence before promoting it to a sprint?

Auditing a PRD to surface weak architectural evidence involves running the decision story through an abduction, deduction, and induction cycle to generate a transparent audit report with a reproducible justification.

Can I compute an effectiveness score for my PRD architecture using the weakest-link method?

Yes, you can compute an effectiveness score for your PRD architecture using the weakest-link WLNK method during the audit phase, which evaluates the structural diversity and evidence quality of extracted hypotheses.

Does PRD validation update the frontmatter status automatically?

PRD validation updates the document frontmatter with a validated or rejected status upon approval, while also generating a concrete checklist of impacts for manual updates to your architecture documentation.

When should I not use First Principles Framework validation for my architecture decisions?

You should avoid First Principles Framework validation when your PRD lacks a structured decision story, as the process requires extracting chosen options and missing alternatives to perform the abduction, deduction, and induction cycle.