decision-journal

Log strategic decisions with rationale and alternatives to an append-only journal.

Updated Apr 19, 2026

Search Tags:#logging #decision #strategy #governance #journal #auditable

Ready to run

npx skills add https://github.com/marmikcfc/pepper-skills --skill decision-journal-marmikcfc

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: decision-journal
Source: https://github.com/marmikcfc/pepper-skills/tree/main/skills/decision-journal
Command: npx skills add https://github.com/marmikcfc/pepper-skills --skill decision-journal-marmikcfc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Log a strategic decision to the append-only decision journal. It creates a permanent, auditable record of what was decided, what alternatives were considered, the rationale, and the expected outcome, ensuring decisions are not overwritten or lost.

Core Features & Use Cases

Append-only entries that capture the decision, alternatives, rationale, and expected outcomes.
Easy traceability for GTM pivots, pricing bets, hires, and channel changes.
Ownership and date metadata to maintain accountability and context over time.

Quick Start

Create a new entry detailing the decision, alternatives considered, rationale, expected outcome, owner, and date.

Frequently Asked Questions about decision-journal

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

FAQPage Schema

How do I maintain an auditable log of strategic decisions for governance?▼

To maintain an auditable decision log, you can append entries detailing the decision, alternatives considered, rationale, and expected outcomes. This append-only journaling approach ensures strategic choices are preserved permanently and never overwritten or lost.

What is the best way to track rationale and alternatives for pricing bets and GTM pivots?▼

The best way to track rationale for pricing bets and GTM pivots is to log them in an append-only journal. Capturing the decision, alternatives considered, and expected outcome in a permanent record provides easy traceability and context over time.

Do I need any environment variables or secrets to start logging decisions?▼

Yes, you need to set up the PEPPER_EVENT_SECRET and PEPPER_CLOUD_URL environment variables. These are required for authentication and executing state updates when you append a new decision entry to the journal.

Can I use an append-only journal to ensure accountability for hires and channel changes?▼

Yes, you can use an append-only journal to ensure accountability for hires and channel changes. The logging mechanism captures ownership and date metadata alongside the decision rationale, maintaining clear accountability and context.

How does append-only journaling prevent overwritten decision records?▼

Append-only journaling prevents overwritten records by strictly disallowing modifications to existing entries. Once a strategic decision is logged with its rationale and expected outcomes, the entry is permanently preserved, ensuring full traceability for future audits.

What metadata is required when adding a new entry to a decision journal?▼

Adding a new entry requires detailing the decision, alternatives considered, rationale, expected outcome, owner, and date. This metadata ensures the append-only journal maintains accountability and context for strategic decisions.