decision-log-guard

Log significant project decisions with conflict checks and template-driven entries.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/MithrilMan/neomithril-ui --skill decision-log-guard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: decision-log-guard
Source: https://github.com/MithrilMan/neomithril-ui/tree/main/.codex/skills/decision-log-guard
Command: npx skills add https://github.com/MithrilMan/neomithril-ui --skill decision-log-guard

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enforce disciplined documentation of significant decisions to keep teams aligned and reduce rework by ensuring decisions across product, architecture, API, data-model, security, dependency, and workflow domains are recorded in the central registry at docs/specs/DECISIONS.md.

Core Features & Use Cases

  • Decision registry: ensures every major choice is logged with context and tradeoffs in docs/specs/DECISIONS.md.
  • Conflict detection: compares new decisions against the existing index to surface potential contradictions before they are written.
  • Template-driven entries: guides users to create decision entries under docs/specs/decisions/entries using standardized filenames and structure.

Quick Start

Log a new decision by following the workflow prompts and creating the entry under docs/specs/decisions/entries.

Frequently Asked Questions about decision-log-guard

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

FAQPage Schema
How do I automatically log project architecture and API decisions to a central registry?

To log project decisions automatically, this Skill guides you through recording context, options, tradeoffs, and consequences into docs/specs/DECISIONS.md. It ensures every significant architecture, API, or workflow choice is documented using a standardized template.

What is a decision log governance workflow and when do I need it for documentation?

A decision log governance workflow enforces disciplined documentation of significant choices to keep teams aligned and reduce rework. You need it when managing product, security, or data-model decisions that require transparent tracking and validation across a project lifecycle.

Can I check new decisions for conflicts against an existing specs registry?

Yes, you can check new decisions for conflicts against the existing index. The Skill compares incoming choices against previously logged entries in docs/specs/DECISIONS.md to surface potential contradictions before they are officially recorded.

How to document tradeoffs and consequences for data-model and security choices?

To document tradeoffs and consequences, follow the workflow prompts to capture required context, final decision statements, and validation evidence. Entries are created under docs/specs/decisions/entries using prescribed templates with reverse chronological updates.

What is the best way to maintain a reverse chronological decision log in markdown?

The best way to maintain a reverse chronological decision log is to append new entries under docs/specs/decisions/entries and update the central index. This Skill automates that process, ensuring standardized filenames and structural consistency across all records.

Do I need a specific template format to record workflow and dependency decisions?

Yes, you need to use the prescribed template format to record workflow and dependency decisions. The Skill enforces a specific structure requiring context, options considered, final statements, consequences, status, validation, and evidence for every logged entry.