skills.rest
ActiveMemory
ActiveMemoryOFFICIAL
Explore all skills by this author →
WebsiteGitHub

ctx-add-decision

Record architectural decisions in DECISIONS.md with context, alternatives, rationale, and consequences.

74|14|Updated Jan 20, 2026
Search Tags:#architecture#cli#decision#ctx#record#DECISIONS.md
One-click install
npx skills add https://github.com/ActiveMemory/ctx --skill ctx-add-decision
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ctx-add-decision
Source: https://github.com/ActiveMemory/ctx/tree/main/internal/tpl/claude/skills/ctx-add-decision
Command: npx skills add https://github.com/ActiveMemory/ctx --skill ctx-add-decision

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Recording architectural decisions helps teams avoid repeated debates and preserves rationale for future sessions.

Core Features & Use Cases

  • Quick Format and Full Format decision documentation with Context, Alternatives, Decision, Rationale, and Consequences.
  • Guidance for cross-referencing superseded or related decisions, and templates for CLI usage to add decisions via ctx.
  • Scenarios include documenting trade-offs, design choices, and architectural constraints across projects.

Quick Start

Record an architectural decision by running the ctx add decision command with the appropriate context, rationale, and consequences.

Frequently Asked Questions about ctx-add-decision

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

FAQPage Schema
How do I document architectural decisions in a DECISIONS.md file?▼

This skill records architectural decisions in DECISIONS.md using the ctx add decision command. It supports Quick and Full formats to document context, alternatives, rationale, and consequences for future project sessions.

What is the best way to record design trade-offs and rationale for future sessions?▼

The best way to record design trade-offs is by capturing context, alternatives, and consequences in DECISIONS.md. This preserves your design rationale across projects and prevents repeated debates in future sessions.

Can I use the ctx CLI to quickly add architectural decisions across projects?▼

Yes, you can use the ctx CLI to add architectural decisions across projects. It offers CLI templates for the ctx add decision command, allowing you to quickly document design choices and constraints in either Quick or Full format.

What format should architectural decisions follow when documenting constraints?▼

Architectural decisions should follow a Quick or Full format that includes Context, Alternatives, Decision, Rationale, and Consequences. This structure ensures design constraints and trade-offs are properly captured in DECISIONS.md.

How do I cross-reference superseded or related architectural decisions?▼

To cross-reference superseded or related architectural decisions, use the skill's built-in guidance for linking records within DECISIONS.md. This maintains continuity when updating design choices or documenting new architectural constraints across projects.

Related Skills

Explore More Software Engineering Skills→
mercurjsmercurjs
1.7k

mercur-cli

Automate Mercur project setup and block management via CLI commands.

Official
Basic
luyzkkluyzkk

decision-registry

Record and retrieve architectural decisions in ADR or decisions.md files.

Community
Intermediate
prototypdigitalprototypdigital

docs-upkeep

Update and validate documentation alongside code changes within version control workflows.

Official
Advanced
hgflimahgflima
1

documentation-and-adrs

Create and manage architectural decision records using markdown templates.

Community
Advanced