goal

Persist decisions, validations, and progress in a GOAL.md and implementation-notes.html ledger.

71|5|Updated May 19, 2026
One-click install
npx skills add https://github.com/kingbootoshi/goal-ledger --skill goal-kingbootoshi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: goal
Source: https://github.com/kingbootoshi/goal-ledger/tree/main/plugins/goal-ledger/skills/goal
Command: npx skills add https://github.com/kingbootoshi/goal-ledger --skill goal-kingbootoshi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Keeps a durable, auditable memory of decisions, validations, blockers, and next actions for long-running agent work, surviving interruptions and handoffs.

Core Features & Use Cases

  • Canonical live-state file: uses a single implementation-notes.html as the authoritative progress and history surface.
  • Contract-and-cadence: GOAL.md acts as the formal contract and supports chaining, escaping, and recovery.
  • Runtime coupling: when available, can couple the ledger to native goal tools to align automated work with the active objective.

Quick Start

Run the init script to scaffold a new goal ledger and begin the goal workflow.

Frequently Asked Questions about goal

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

FAQPage Schema
How do I persist agent decisions and progress across long-running coding sessions?

To persist agent decisions across sessions, use a durable goal ledger that maintains an authoritative implementation-notes.html file and a formal GOAL.md contract to record validations, blockers, and next actions.

What is the best way to recover agent state after context compaction?

Recovering agent state after compaction requires a durable goal ledger that uses a canonical live-state file to restore the active objective, ensuring continuity and preserving the history of validations and progress.

How do I scaffold a goal ledger to track codebase status and chained goals?

You scaffold a goal ledger by running the initialization script, which sets up the canonical GOAL.md contract and implementation-notes.html surface to begin tracking chained goals and codebase status.

Can I couple a durable goal ledger to native runtime goal tools?

Yes, when runtime goal tools are available, the goal ledger couples to them to align automated work directly with the active objective, synchronizing the live state with the native environment.

When do I need a formal GOAL.md contract for agent state persistence?

A formal GOAL.md contract is needed for long-running coding work, chained goals, and compaction recovery where auditable memory of decisions, validations, and progress must survive interruptions and handoffs.