Decision Log

SkillMonitoring & ops

Record and track organizational decisions using the RAPID framework. Captures decision context, options analysis, RAPID roles, risk assessment, and communication plan. Use when making cross-functional decisions, documenting governance choices, or building an auditable decision trail.

Use Decision Log in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add Decision Log and connect your AI. About a minute.

Also: Claude Code · Cursor · Codex

Then ask your AI: use the Decision Log skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Add Ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Decision LogStart free

What this skill tells your AI

The instructions your AI receives, as published by hoavdc/codexkit in skills/codexkit-decision-log/SKILL.md and read by Ahel’s review.

When to Use

  • When a decision affects multiple teams or has lasting consequences
  • When leadership needs an auditable trail of why choices were made
  • When recurring decisions need a consistent framework
  • When decisions stall due to unclear ownership or roles

Procedure

Step 1 — Frame the Decision

ElementDescription
Decision IDDEC-YYYY-NNN
TitleOne-line description
CategoryStrategic / Tactical / Operational
UrgencyCritical (24h) / High (1 week) / Normal (2 weeks) / Low
ReversibilityEasy / Moderate / Difficult / Irreversible
ScopeWho and what is affected

Step 2 — RAPID Roles

Assign clear decision roles:

RolePersonResponsibility
R — Recommend[Name]Researches, proposes recommendation
A — Agree[Names]Must agree before approval (has veto)
P — Perform[Names]Implements the decision
I — Input[Names]Provides data/perspective (no veto)
D — Decide[Name]Makes the final call (ONE person)

Rule: Exactly one D. Multiple A/P/I are fine.

Step 3 — Options Analysis

CriterionOption AOption BOption C (Status Quo)
Cost$50K$30K$0
Time to implement3 months6 months—
RiskLowMediumHigh (doing nothing)
Alignment with strategyHighMediumLow

Step 4 — Risk Assessment

OptionRiskProbabilityImpactMitigation
AVendor lock-inMediumHighContractual exit clause
BTeam capacityHighMediumPhase rollout

Step 5 — Decision Record

Decision: We will proceed with Option A
Rationale: Best alignment with strategy, acceptable cost, low risk
Trade-offs accepted: Higher cost than Option B
Conditions: Must complete vendor contract review by [date]
Review date: [6 months from now]

Step 6 — Communication Plan

AudienceChannelTimingMessage
LeadershipEmail summaryDay 1Decision + rationale
Affected teamsTeam meetingDay 2Impact + timeline
Broader orgSlack / NewsletterDay 5High-level announcement

Inputs

InputRequiredFormat
Decision topicYesWhat is being decided
OptionsYesAt least 2 including status quo
StakeholdersYesWho is affected / involved
ConstraintsRecommendedTimeline, budget, dependencies

Output

## Decision Record — DEC-2024-012

### Migrate Primary Database to PostgreSQL
**Status:** Accepted | **Date:** 2024-03-15
**Decided by:** CTO | **Recommended by:** Platform Lead

### RAPID
[Roles table]

### Options Considered
[Comparison matrix]

### Decision
We will migrate to PostgreSQL 16 managed on AWS RDS.

### Rationale
- Team expertise (8/10 engineers proficient)
- 40% cost reduction vs current Oracle license
- Acceptable migration risk with phased approach

### Communication Plan
[Audience → Channel → Timing table]

Definition of Done

  • Decision clearly framed with category and urgency
  • RAPID roles assigned (exactly one D)
  • Options compared including status quo
  • Risks identified per option
  • Decision recorded with rationale
  • Communication plan defined

Quality Criteria

  • All claims reference specific frameworks, standards, or quantifiable data
  • Content matches the stated audience's expertise level
  • Recommendations are actionable — each includes a concrete next step
  • No unsupported assertions or generic filler language

Verification (4C)

CheckQuestion
CorrectnessDo referenced frameworks and standards match their official definitions?
CompletenessAre all key concepts covered without significant gaps for the stated audience?
Context-fitWould this be useful for someone new to this domain, or is it too advanced/too basic?
ConsequenceIf a stakeholder acted on this immediately, what could they misinterpret?

Edge Cases

  • Conflicting frameworks — State which framework takes precedence and why. Document the trade-off explicitly.
  • Rapidly changing domain — Note information currency date. Flag sections likely to need updates.
  • Audience has mixed expertise levels — Provide a glossary and mark advanced sections as optional.

Changelog

  • v1.0.0 — Initial release

Signals

GitHub stars
25
Forks
13
Last commit
Oct 2026
Advanced
Item type
skill
Key
codexkit-decision-log
Source
github.com/hoavdc/codexkit