decision-memo-writer

Generate structured decision records with context, alternatives, rationale, and consequences.

6|1|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/vibbs/company-os --skill decision-memo-writer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: decision-memo-writer
Source: https://github.com/vibbs/company-os/tree/main/.claude/skills/decision-memo-writer
Command: npx skills add https://github.com/vibbs/company-os --skill decision-memo-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the challenge of losing crucial context and rationale behind past decisions, making it difficult for future team members to understand the "why" behind implemented solutions.

Core Features & Use Cases

  • Structured Decision Records: Creates comprehensive memos detailing context, alternatives, rationale, consequences, and revisit criteria.
  • Enhanced Traceability: Provides a clear audit trail for non-trivial decisions, improving project understanding and knowledge transfer.
  • Use Case: When deciding on a new architectural approach for a feature, use this Skill to document the trade-offs considered, the chosen path, and why, ensuring future developers understand the original intent.

Quick Start

Use the decision-memo-writer skill to create a new decision memo for the context 'Choosing a new CI/CD tool'.

Frequently Asked Questions about decision-memo-writer

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

FAQPage Schema
How do I document the rationale and alternatives considered for a project decision?

To document project decisions, you generate structured decision records capturing context, alternatives, rationale, consequences, and revisit criteria, ensuring future team members understand the intent behind implemented solutions.

Why does my team lose context on past architectural decisions?

Losing context on past architectural decisions happens when rationale isn't documented. Structured decision memos provide an audit trail for non-trivial choices, improving project understanding and knowledge transfer for future developers.

What is the best way to create an audit trail for non-trivial project decisions?

The best way to create an audit trail is generating structured decision memos with specific ID conventions, validating them against predefined criteria to capture context and rationale for critical project governance and knowledge management.

When do I need to use a structured decision memo?

You need a structured decision memo when making non-trivial decisions like choosing a new architectural approach, where documenting trade-offs, chosen paths, and revisit criteria facilitates traceability and knowledge transfer.

Do I need predefined criteria and ID conventions for decision documentation?

Yes, generating decision records requires adherence to specific ID conventions and validation against predefined criteria to ensure the documentation maintains consistency, auditability, and structured knowledge management across the project.