decision-journal

Record project decisions with context, rationale, and revisit triggers.

3|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/gavinmcfall/agentic-config --skill decision-journal-gavinmcfall
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: decision-journal
Source: https://github.com/gavinmcfall/agentic-config/tree/main/config/skills/game-dev/decision-journal
Command: npx skills add https://github.com/gavinmcfall/agentic-config --skill decision-journal-gavinmcfall

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill prevents "decision amnesia" and costly re-evaluation by ensuring that all significant project decisions are recorded with their context, rationale, and revisit triggers.

Core Features & Use Cases

  • Decision Recording: Captures the what, why, and when-to-revisit for critical project choices.
  • Contextual Rationale: Documents the reasoning behind a decision, aiding future understanding.
  • Revisit Triggers: Defines specific conditions under which a decision should be reconsidered, preventing arbitrary re-evaluation.
  • Use Case: When choosing a game engine, record the decision, the reasons for choosing Godot over Unity, and a trigger like "revisit if Godot drops C# support."

Quick Start

Record the decision to use Godot as the game engine, noting the rationale and a revisit trigger.

Frequently Asked Questions about decision-journal

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

FAQPage Schema
How do I document project decisions to prevent re-evaluation loops?

To prevent re-evaluation loops, record each project decision with its context, rationale, and a specific revisit trigger. This approach prevents decision amnesia by ensuring future teams understand why choices like selecting a game engine were made.

What is a revisit trigger in project decision documentation?

A revisit trigger is a specific condition that prompts reconsidering a previously decided project choice. For example, when choosing a game engine, you might set a trigger to revisit the decision if the engine drops support for a required programming language.

How do I track the state of project decisions during game development?

Track project decision states using categories like 'decided', 'exploring', and 'superseded'. This lifecycle management approach ensures choices regarding game development constraints such as engine, genre, and art style are monitored effectively.

Why does my team keep re-evaluating the same game engine choice?

Teams re-evaluate the game engine choice due to decision amnesia, lacking a record of the original rationale. Documenting the decision with context and explicit revisit triggers stops arbitrary re-evaluation by defining exactly when to reconsider.

Can I record rationale for critical game development choices like art style?

Yes, you can record rationale for critical game development choices like art style. The documentation process captures the what, why, and when-to-revisit for any significant project constraint, ensuring the contextual reasoning is preserved for future reference.