goal-loop

Thin orchestration skill on top of self-nudge-loop. One extra file (GOAL.md) and one extra script (scaffold.sh) that calls the underlying self-nudge-loop scaffold and appends goal-specific conventions.

What you get

After running this skill's scaffold.sh, the anchor directory contains:

<anchor>/
├── GOAL.md        ← your goal statement + issue-discovery rules (this skill)
├── LOOP.md        ← DoD placeholder + REST arming recipe (from self-nudge-loop)
├── README.md      ← directory map (from self-nudge-loop)
└── board/         ← kanban-md board, 6 columns (only when kanban-md is installed)

The loop agent re-reads GOAL.md + LOOP.md every cycle, but only because the nudge you arm tells it to (step 4 under "Run it"): LOOP.md's own nudge never names GOAL.md. That's the "mission briefing", everything else is session state.

When to use

• User sets a concrete, verifiable goal ("get this test suite to 100% pass", "migrate all callers off module X", "drain DLQ Y").
• You want the agent to discover issues itself (grep TODO/FIXME, failed tests, open tickets) and convert them to board cards.
• You trust the agent to run for 10+ cycles autonomously without human per-step review.

When NOT to use

• One-off fix → just use the agent directly
• Already-defined backlog → use self-nudge-loop/scaffold.sh directly
• Goal cannot be expressed as ≤5 shell-checkable DoD criteria → split the goal first

Prerequisites

kanban-md CLI, required for the board operations the loop agent runs every cycle (its list, pick, create, move, edit and handoff subcommands). It is a single-binary Go tool from github.com/antopolskiy/kanban-md.

Install (pick one):

# Homebrew (macOS/Linux), recommended, auto-updates
brew install antopolskiy/tap/kanban-md

# Go (if you already have Go on PATH)
go install github.com/antopolskiy/kanban-md/cmd/kanban-md@latest