decision-capture

Name: decision-capture
Availability: InStock
Author: velcrafting

Convert software project choices into auditable decisions using a structured template.

1|Updated Jan 13, 2026

Search Tags:#architecture #templates #documentation #governance #risk-management #decision-log #decision-capture

Ready to run

npx skills add https://github.com/velcrafting/codex-skills --skill decision-capture-velcrafting

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: decision-capture
Source: https://github.com/velcrafting/codex-skills/tree/main/skills/meta/decision-capture
Command: npx skills add https://github.com/velcrafting/codex-skills --skill decision-capture-velcrafting

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Capture non-trivial decisions as auditable commitments to prevent drift and hidden tradeoffs in software projects.

Core Features & Use Cases

Structured decision template: captures context, options, consequences, and validation steps.
Propose-only workflow: ensures decisions are not prematurely accepted and are review-ready.
Reusable across projects: standardizes governance for architecture, data model, risk, and policy changes.

Quick Start

Draft a decision using the Proposed Decision template and save it to the project DECISIONS.md.

Frequently Asked Questions about decision-capture

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

FAQPage Schema

What is a decision log template for software architecture governance?▼

A decision log template formalizes high-stake choices by capturing context, alternatives, consequences, and validation steps to prevent drift and hidden tradeoffs in software projects.

How do I document architecture migrations and risk-sensitive bets as auditable decisions?▼

You document architecture migrations by applying a structured decision template that mandates a proposed status, ensuring choices are review-ready before acceptance and capturing explicit rationale.

How do I create a propose-only workflow for data model changes?▼

You create a propose-only workflow by drafting decisions using a template that prevents premature acceptance, saving the structured rationale into a project DECISIONS.md file for review.

Can I use a decision capture template for risk management and policy shifts?▼

Yes, the decision capture template is reusable across projects and standardizes governance for risk management, data model changes, architecture migrations, and policy shifts where explicit rationale is required.

Why does a decision template mandate proposed status rather than accepted?▼

Mandating proposed status ensures high-stake choices are not prematurely accepted, keeping them review-ready and forcing stakeholders to validate context and consequences before committing.