decisions

Installation
SKILL.md

Decisions

Overview

This skill maintains a chronological record of significant project decisions in docs/decisions.md. It captures important architectural and design decisions, especially those involving tradeoffs, to create a permanent record of why key choices were made.

When to Use This Skill

Proactive (Conservative): Suggest recording decisions only when there is a clearly significant architectural choice, such as:

  • Choosing between database systems (e.g., SQLite vs PostgreSQL)
  • Selecting major frameworks or libraries
  • Deciding on core architectural patterns (e.g., monolith vs microservices, rendering approach)
  • Making fundamental design choices that will shape the project long-term
Installs
48
Repository
maragudk/skills
GitHub Stars
48
First Seen
Jan 24, 2026
decisions — maragudk/skills