cs-decide

Archive finalized project decisions with rationale and alternatives as timestamped Markdown files.

1.1k|82|Updated Apr 12, 2026
One-click install
npx skills add https://github.com/liuzhengdongfortest/CodeStable --skill cs-decide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cs-decide
Source: https://github.com/liuzhengdongfortest/CodeStable/tree/main/cs-decide
Command: npx skills add https://github.com/liuzhengdongfortest/CodeStable --skill cs-decide

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Teams often lose track of important, decided constraints, architecture choices, tech-stack decisions, and coding conventions, causing rework and misaligned implementations. This Skill provides a durable, centralized mechanism to record what was decided, why it was chosen, and what alternatives were considered, so future work remains grounded in context.

Core Features & Use Cases

  • Decision recording: captures the finalized choices with rationale and alternatives for auditability.
  • Discovery and governance: enables quick references to tech-stack, architecture, constraints, and conventions to guide design and implementation.
  • Onboarding and maintenance: helps new team members understand project decisions and their impacts, reducing ramp-up time.

Quick Start

Create a timestamped decision document at codestable/compound/YYYY-MM-DD-decision-slug.md.

Frequently Asked Questions about cs-decide

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

FAQPage Schema
How do I record architectural decisions and tech-stack choices for my software project?

To record architectural decisions, create a timestamped document at codestable/compound/YYYY-MM-DD-decision-slug.md. This enforces frontmatter fields and slug-based naming to store finalized choices, rationale, and alternatives for future auditability.

What is the best way to document project constraints and coding conventions?

Documenting project constraints and coding conventions requires archiving finalized choices with their rationale. Using a centralized decision record mechanism ensures durable references that guide design, implementation, and future maintenance across the software project.

How does ADR documentation help with team onboarding and governance?

ADR documentation accelerates team onboarding by providing quick references to tech-stack, architecture, and constraints. New members understand project decisions and their impacts, reducing ramp-up time while ensuring governance through durable, centralized records.

Can I use this decision recording mechanism for any software architecture context?

Yes, this decision recording mechanism suits various software architecture contexts. It is applicable to technology choices, architectural decisions, constraints, and conventions, ensuring durable records that guide future work regardless of project scale.

Do I need specific dependencies to archive decisive project choices?

No specific dependencies are required to archive decisive project choices. The mechanism operates independently by enforcing frontmatter fields and a codestable/compound path convention to store only finalized decisions in your repository.

Why should I use a slug-based file naming convention for decision records?

A slug-based file naming convention ensures consistent retrieval of decision records. Combined with enforced frontmatter fields and a timestamped codestable/compound path, it preserves the rationale of finalized choices and prevents misaligned implementations.