What is a Y-Statement in this skill?

A Y-Statement is a concise format used to record lightweight decisions by summarizing the situation, constraint, choice, and trade-off in a single standardized sentence.

Why use an ADR instead of code comments?

While comments explain how code works, ADRs explain why a specific path was chosen over alternatives, which is vital for maintaining context as a project evolves over many AI sessions.

What happens if I only provide a title for a decision?

The skill will guide you through a series of prompts to gather the necessary context, alternatives, rationale, and consequences to ensure a high-quality record.

Does this skill require the ctx system?

Yes, it is designed to work with the ctx file-based system to persist and structure project context specifically for AI coding assistants.

Can I update or replace previous decisions?

Yes, the skill allows you to supersede older decisions, marking the original as outdated while explicitly referencing the new decision and the lessons learned.

Architectural Decision Recorder

Name: Architectural Decision Recorder
Author: ActiveMemory

byActiveMemory

•

Herramientas de Colaboración

Records and structures architectural decisions to preserve project context and technical rationale across AI development sessions.

The ctx-add-decision skill enables developers and AI assistants to document critical design choices using the Architecture Decision Record (ADR) pattern. By capturing the context, alternatives, and trade-offs of a decision, it ensures that the 'why' behind a codebase is never lost, allowing future AI sessions and human collaborators to understand the project's evolution and avoid repeating past mistakes. This skill supports both lightweight Y-statements for quick updates and comprehensive multi-factor analysis for major structural changes.

Características Principales

01Detailed alternative analysis and rationale gathering

02Integrated quality checklist for technical documentation

03Supports Quick Y-Statement format for lightweight decisions

04Automated decision superseding and cross-referencing

0536 GitHub stars

06Standardized ADR recording using the ctx framework

Casos de Uso

01Capturing trade-offs made during database schema design or migration

02Preserving the rationale for non-obvious workarounds to prevent future regression

03Documenting the transition between different framework or library choices

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add activememory/ctx ctx-add-decision

For use in Claude.ai and ChatGPT

Download Skill