decision-capture

Formalize decisions and deviations into structured DEC records with traceable links.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/mattfuster/aisef-setup --skill decision-capture-mattfuster
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: decision-capture
Source: https://github.com/mattfuster/aisef-setup/tree/main/.claude/skills/decision-capture
Command: npx skills add https://github.com/mattfuster/aisef-setup --skill decision-capture-mattfuster

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Capture and formalize product and architectural decisions as structured decision records with full traceability and explicit review pathways.

Core Features & Use Cases

  • Direct decision capture: log decisions that change requirements or strategy with clear context.
  • Deviation protocol: record formal deviations when implementation diverges from blueprints or work orders.
  • Traceability: link decisions to upstream triggers and downstream documents for auditability.

Quick Start

Ask the AI to create a new DEC record for a decision or deviation from a blueprint.

Frequently Asked Questions about decision-capture

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

FAQPage Schema
How do I create a traceable record for architectural decisions and deviations?

To create a traceable decision record, you formalize the decision or deviation into a structured DEC record with frontmatter metadata. This record links upstream triggers to downstream documents, ensuring full auditability for governance workflows.

What is the deviation protocol for logging implementation changes against a blueprint?

A deviation protocol records formal deviations when implementation diverges from blueprints or work orders. It links the deviation trigger to affected documents, capturing the context and ensuring the record is cross-linked for downstream governance audits.

How do decision records ensure traceability across product and architectural governance?

Decision records ensure traceability by using frontmatter metadata and cross-linking to connect upstream triggers with downstream affected documents. This structured linking mechanism guarantees that every formal decision or deviation is auditable.

Do I need existing work orders or blueprints to record a direct product decision?

No, you can log direct decisions that change requirements or strategy independently. You only need existing blueprints or work orders when using the deviation protocol to record formal divergences during implementation.

When should I use a formal deviation record instead of a direct decision record?

Use a deviation record when implementation diverges from an existing blueprint or work order, linking the trigger to affected documents. Use a direct decision record when logging new decisions that change requirements or strategy independently.