decide

Capture ADR-lite decisions with context, options, rationale, and trade-offs in Obsidian vault notes.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/abhattacherjee/obsidian-brain --skill decide-abhattacherjee
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: decide
Source: https://github.com/abhattacherjee/obsidian-brain/tree/main/skills/decide
Command: npx skills add https://github.com/abhattacherjee/obsidian-brain --skill decide-abhattacherjee

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Capture architectural and technical decisions with full context as ADR-lite notes in the Obsidian vault. Each decision records the context, options considered, rationale, and trade-offs accepted.

Core Features & Use Cases

  • ADR-lite note creation during sessions to document decisions with structured sections (Context, Options Considered, Decision, Rationale, Consequences).
  • Automatic generation of metadata and backlinks for easy discovery and navigation within the Obsidian vault.

Quick Start

Run /decide with a concise summary to capture an ADR-lite decision in your vault.

Frequently Asked Questions about decide

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

FAQPage Schema
How do I document architectural decisions in an Obsidian vault?

To document architectural decisions in an Obsidian vault, use the /decide command to generate an ADR-lite note capturing context, options considered, rationale, and trade-offs. It automatically formats the decision note with structured metadata and backlinks for navigation.

What is the ADR-lite format for software architecture decision records?

The ADR-lite format for software architecture decision records is a structured note containing Context, Options Considered, Decision, Rationale, and Consequences sections. It provides a lightweight method to capture why a specific technical choice was made during development sessions.

Can I generate decision rationale notes automatically using Bash tooling?

Yes, you can generate decision rationale notes automatically using Bash and standard tooling. The command creates ADR-lite notes in your vault, applying consistent formatting and generating metadata with backlinks for easy discovery within Obsidian.

When should I use a lightweight decision record instead of full ADR documentation?

Use a lightweight decision record when you need to capture architectural trade-offs and rationale during active sessions without full ADR overhead. It records context and options considered quickly, ensuring technical choices are documented consistently inside your Obsidian vault.

Does capturing ADR-lite decisions require any external dependencies?

Capturing ADR-lite decisions requires no external dependencies. It relies solely on Bash and standard tooling to generate structured notes with metadata and backlinks directly inside your existing Obsidian vault environment.