decision-journal

Extracts DIFF and CJK CJK CJK CJK CJK CJK CJK CJK CJK CJK CJK CJK CJK CJK CJK CJK CJK CJK CJK CJK CJK CJK CJK CJK CJK CJK CJK CJK CJK CJK CJK CJK CJK CJK CJK CJK.

6|2|Updated Dec 19, 2025
One-click install
npx skills add https://github.com/synaptiai/synapti-marketplace --skill decision-journal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: decision-journal
Source: https://github.com/synaptiai/synapti-marketplace/tree/main/plugins/gh-workflow/skills/decision-journal
Command: npx skills add https://github.com/synaptiai/synapti-marketplace --skill decision-journal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Captures, structures, and persists significant decisions made during AI-driven workflow execution. This enables post-hoc review, explicit gate detection, and PR-body ready summaries.

Core Features & Use Cases

  • Extract and structure decisions from completed diffs and issue context for traceability
  • Detect gate triggers for high-stakes changes and log them for human review
  • Generate machine-parseable journal entries and concise PR summaries that document rationale

Quick Start

Initialize a journal for your issue and log decisions as you progress through gh-start, gh-commit, or gh-address.

Frequently Asked Questions about decision-journal

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

FAQPage Schema
How do I capture and structure development decisions from git diffs?

To capture and structure development decisions from git diffs, you can use a structured decision journal that parses completed diffs and issue context to generate machine-parseable entries documenting rationale. This enables post-hoc review and traceability for AI-driven workflows.

What is a decision journal in AI-driven git workflows?

A decision journal in AI-driven git workflows is a structured log that persists significant development decisions extracted from diffs and issue context. It detects gate triggers for high-stakes changes, enabling explicit human review and generating concise PR summaries.

How do I generate PR summaries that document the rationale behind code changes?

You generate PR summaries that document rationale by logging decisions through workflow modes like init and summarize, which extract structured entries from completed diffs and issue context to create concise, PR-body ready documentation.

Can I detect gate triggers for high-stakes code changes automatically?

Yes, you can detect gate triggers for high-stakes code changes automatically by applying a decision journal to your AI-driven git workflow, which identifies significant modifications from diffs and logs them explicitly for human review.

Does decision logging work with standard git commit and PR generation workflows?

Decision logging works across standard AI-driven git workflows including gh-start, gh-commit, and gh-address, applying mode routing to extract decisions from diffs and issue context during PR generation.

When do I need structured decision logging for my codebase?

You need structured decision logging for your codebase when executing AI-driven git workflows that require post-hoc review, gate detection for high-stakes changes, and machine-parseable traceability of development rationale.