skills.rest
mikestopcontinues
mikestopcontinuesCOMMUNITY
Explore all skills by this author →
Website𝕏@stopcontinuesGitHub

create-decision

Writes captain-locked decisions as numbered dNN markdown files in project or global scopes.

Updated Mar 21, 2026
Search Tags:#project management#documentation#markdown#decision record#adr#scaffolding#cli
One-click install
npx skills add https://github.com/mikestopcontinues/agent-skills --skill create-decision-mikestopcontinues
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-decision
Source: https://github.com/mikestopcontinues/agent-skills/tree/main/claude/skills/create-decision
Command: npx skills add https://github.com/mikestopcontinues/agent-skills --skill create-decision-mikestopcontinues

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Important architectural and product decisions made during conversations are easily lost. This Skill persists a captain-locked answer as a numbered, schema-conformant decision record so it outlives the conversation and can be referenced by later work. ## Core Features & Use Cases - Scoped decision capture: Writes dNN-<name>.md files into a project's decisions/ directory or top-level docs/decisions/ with --global, with per-scope sequential numbering delegated to the yolo CLI. - Canonical schema enforcement: Populates frontmatter (status, blocks, supersedes) and sections for Question, Context, Options, Recommendation, and Decision. - Supersede mechanics: When a new decision replaces prior ones, it flips the prior decisions' status to archived in the same operation without editing their append-only bodies. - Use Case: After /grill-me or /lock-decisions resolves a cross-cutting question like an OAuth refresh strategy, invoke this Skill to persist the captain's answer as d14-oauth-refresh-strategy.md and archive the decision it supersedes. ## Quick Start Ask the agent to create a decision named oauth-refresh-strategy in the current project scope with the captain's locked answer as the decision body.

Frequently Asked Questions about create-decision

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

FAQPage Schema
How do I record an architecture decision in a project?▼

Invoke the skill with a kebab-case name and the captain's answer text. It scaffolds a numbered dNN file via the yolo CLI in the project's decisions directory and populates the canonical schema with Question, Context, Options, Recommendation, and Decision sections.

How do I supersede an existing decision record?▼

Pass the prior decision IDs in the supersedes input, such as [d05]. The skill writes the new decision and flips each named prior decision's status from active to archived in the same operation, without editing the archived bodies.

Can I edit an archived decision document?▼

No. Archived decisions are append-only per the project-organization rules. Instead of editing, create a new superseding decision that references the prior one, which is then archived automatically.

What is the difference between project scope and --global decisions?▼

Project scope writes to the loaded project's decisions directory, while --global writes to top-level docs/decisions. Numbering is sequential per scope, so the same dNN can exist in both without collision.

Why does decision creation fail with a collision error?▼

The yolo CLI returns a collision error when a decision with the same name already exists in that scope. The skill surfaces the CLI's JSON message verbatim; choose a different name or supersede the existing decision.

When should I use create-note instead of create-decision?▼

Use create-note for exploratory context or open questions that are not yet resolved. Use create-decision only after the captain has actually locked an answer, typically following grill-me or lock-decisions.

Related Skills

Explore More Product & Management Skills→
shaahyshaahy

grill-with-docs

Interrogates a plan or design through structured questioning while generating ADRs and a glossary.

Community
Basic
felipelobomotta-blipfelipelobomotta-blip
92

manuscript-manager

Maintain persistent project state across multi-session book generation runs.

Community
Advanced
m2ai-portfoliom2ai-portfolio
4

reasoning-extractor

Extract decision reasoning using a four-question framework into audit-ready records.

Official
Intermediate
21StarkCom21StarkCom

stark-adr

Create, list, and supersede MADR-lite Architecture Decision Records in a repository's docs/adr directory.

Official
Basic