decision-journal

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

Updated Apr 19, 2026
One-click install
npx skills add https://github.com/marmikcfc/pepper-skills --skill decision-journal-marmikcfc
Or copy as Structured Prompt for Agent▼
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.