# Goal Ledger Abandon

> >-

- **Type:** Skill
- **Install:** `agentstack add skill-jpbaking-goal-ledger-goal-ledger-abandon`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [jpbaking](https://agentstack.voostack.com/s/jpbaking)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** 0BSD
- **Upstream author:** [jpbaking](https://github.com/jpbaking)
- **Source:** https://github.com/jpbaking/goal-ledger/tree/main/skills/shared/goal-ledger-abandon

## Install

```sh
agentstack add skill-jpbaking-goal-ledger-goal-ledger-abandon
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Goal Ledger — abandon without erasing history

Abandonment is a durable terminal state, not deletion. Preserve the ledger and work so the decision can be understood or reversed later.

## 1. Load and summarize

Read sections 1–3 of the sibling `goal-ledger` skill. If there is no ledger, say so and stop. If status is already `completed` or `abandoned`, report it and stop.

Show the Goal ID, Outcome, strategy and work branch, phase counts, blockers, matching goal commits, and dirty worktree state. Explain that abandonment will keep the ledger, commits, and code changes.

## 2. Confirm abandonment

Ask explicitly: "Mark this goal abandoned while preserving its ledger and work?" Anything short of a clear yes changes nothing.

On confirmation:

1. Set Goal status `abandoned`.
2. Update Handoff: current position `abandoned`, next action `none`, and blockers with the user's reason when provided.
3. Append an abandonment log entry. Do not change phase statuses merely to make them terminal.
4. Run the validator bundled with the sibling `goal-ledger` skill as `scripts/validate_goal_ledger.py --root `. Repair ledger-format errors before preserving the state; warnings do not prevent abandonment. If Python 3 is unavailable, check the format manually.

## 3. Preserve Git state

When `Repository: yes`:

- If Git preparation never completed (`Strategy: none`, missing baseline, or no approval commit), do not create or switch branches merely to abandon a draft. Save the abandoned ledger locally; commit it only if the user separately asks to record it on the current branch.
- After Git preparation, if the worktree contains partial goal work, ask separately whether to checkpoint those goal-owned changes in the abandonment commit. Default No. Never stage unrelated files.
- After Git preparation, whether or not partial code is included, stage `.goal-ledger/GOAL.md` and create `goal-ledger(abandon): ` with the matching Goal ID trailer. If partial work is not included, leave it untouched and report it as uncommitted.
- Never reset, revert, delete the work branch, or rewrite history.
- For an isolated branch with a clean tree, offer to switch back to `Starting branch`; require explicit permission and keep the goal branch intact.
- If partial work remains dirty because checkpointing was declined, stay on the goal branch. Offer a separately authorized checkpoint or recoverable stash, or leave it in place; never carry it onto the starting branch or discard it automatically.
- On `current-branch`, remain on that branch and warn that goal commits are part of its history.

Without Git, save the ledger state and report any remaining files.

## 4. Report

State what was marked abandoned, which files or partial changes were committed, what remains uncommitted, the current branch, and how to recover the record later. Do not offer deletion as routine cleanup.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [jpbaking](https://github.com/jpbaking)
- **Source:** [jpbaking/goal-ledger](https://github.com/jpbaking/goal-ledger)
- **License:** 0BSD

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-jpbaking-goal-ledger-goal-ledger-abandon
- Seller: https://agentstack.voostack.com/s/jpbaking
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.