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.