decision-log

Log project decisions into a structured .xlsx decision log with specified fields.

Updated Apr 19, 2026
One-click install
npx skills add https://github.com/kenmulford/PMSkills --skill decision-log-kenmulford
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: decision-log
Source: https://github.com/kenmulford/PMSkills/tree/main/skills/decision-log
Command: npx skills add https://github.com/kenmulford/PMSkills --skill decision-log-kenmulford

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires openpyxl, and includes scripts (resource) components.

What problem does it solve?

Creates a reliable, auditable record of project decisions to prevent misinterpretation and lost rationale.

Core Features & Use Cases

  • One-row-per-decision structure with fields for id, title, date, decision_maker, status, context, options_considered, decision, rationale, consequences, and review_date.
  • Enforces fidelity rules to avoid inventing rationale, invented options, or misattributed decision makers.
  • Generates a shareable .xlsx artifact suitable for governance reviews, ADRs, and audit trails.
  • Supports governance workflows like Phase decisions and superseding previous entries.

Quick Start

Describe the decision scenario in plain language and run the script to render the decision log.

Frequently Asked Questions about decision-log

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

FAQPage Schema
How do I create an auditable decision log for project governance?

To create an auditable decision log, describe your project decisions in plain language and run the script to generate a structured .xlsx file. The log captures id, title, date, decision_maker, status, context, options considered, decision, rationale, consequences, and review_date.

What is an architecture decision record and how is it structured?

An architecture decision record (ADR) is a traceable log capturing project decisions. It is structured into one row per decision with fields for context, options considered, the final decision, rationale, consequences, and a review_date for audit trails.

Does the decision log script invent missing rationale or context for governance records?

No, the decision log script does not invent missing rationale. It enforces a strict no-invent-content rule, ensuring fidelity by only recording user-provided decisions and rendering the final xlsx artifact exactly as specified without fabrication.

Can I use openpyxl to export architectural decisions to an xlsx audit trail?

Yes, you can export architectural decisions to an xlsx audit trail. The script uses the openpyxl dependency to render a verifiable decision log artifact suitable for governance reviews, change governance, and ADRs.

How do I handle superseding previous entries in a project decision log?

To handle superseding previous entries, the decision log supports governance workflows like phase decisions. You update the status of prior records and add new rows to maintain a traceable, verifiable audit trail of evolving architectural decisions.