skills.rest
velcrafting
velcraftingCOMMUNITY
Explore all skills by this author →
Website𝕏@VelcraftingGitHub

decision-capture

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
One-click install
npx skills add https://github.com/velcrafting/codex-skills --skill decision-capture-velcrafting
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
abdullah1854abdullah1854
1

session-handoff

Generate Markdown Architectural Decision Records from structured inputs.

Community
Intermediate
joestumpjoestump
30

status

Update status fields in ADR and spec YAML frontmatter.

Community
Intermediate
handsomelong922handsomelong922

self-improvement

Log learnings and corrections to .learnings markdown files for future sessions.

Community
Advanced
kv0906kv0906
134

decide

Log project decisions with context, alternatives, and rationale in Markdown.

Community
Basic