cs-decide

Archive finalized technical decisions as permanent decision documents with frontmatter metadata.

Updated Jun 8, 2026
One-click install
npx skills add https://github.com/wildlily1021/XW_Software --skill cs-decide-wildlily1021
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cs-decide
Source: https://github.com/wildlily1021/XW_Software/tree/main/.agents/skills/cs-decide
Command: npx skills add https://github.com/wildlily1021/XW_Software --skill cs-decide-wildlily1021

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Technical choices, architecture decisions, long-term constraints, and coding conventions are easily lost once made, causing repeated debates, AI suggestions that conflict with project rules, and untraceable rationale when constraints need revisiting. This Skill archives every finalized decision with its context, rationale, alternatives, and consequences. ## Core Features & Use Cases - Four Decision Categories: Classify each record as tech-stack, architecture, constraint, or convention via frontmatter for targeted retrieval. - Guided Interview Workflow: Extract background, rationale, rejected alternatives, and consequences through one-question-at-a-time prompts, then draft a complete document for user review. - Overlap Detection and Supersede Handling: Search existing decisions before writing, update in place for additions, or mark old documents superseded with links to replacements. - Use Case: After choosing Pinia over Vuex for state management, record the decision so future contributors and AI assistants see why the choice was made and what alternatives were rejected. ## Quick Start Tell the AI to record the decision you just made about your technology stack or architecture as a permanent decision document.

Frequently Asked Questions about cs-decide

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

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

State the finalized decision to the AI and answer a short guided interview covering background, rationale, alternatives, and consequences. The Skill drafts a complete Markdown document with YAML frontmatter and archives it under codestable/compound with a dated filename.

What types of decisions can be archived with this workflow?▼

Four categories are supported: tech-stack for tool and framework choices, architecture for system structure decisions, constraint for hard prohibitions, and convention for agreed coding standards. Each is tagged in the frontmatter category field.

Should I archive a decision that is still under discussion?▼

No. The workflow only archives finalized decisions, because archiving an unsettled option misleads future readers into treating it as decided. Finish the discussion first, then record the outcome.

What happens when an old decision is replaced by a new one?▼

The old document is marked status superseded with a superseded-by link to the new document, preserving the original text for historical traceability. Conclusions are never overwritten in place.

How do I search existing decision documents before creating a new one?▼

Use the search-yaml.py tool with filters like doc_type=decision, category, and status to list active decisions, or run a keyword query to find overlapping records before archiving.