arch-decision

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.