# Goal Loop

Bootstrap a goal-driven self-improving AutoNudge loop from a goal plus an anchor...

- Repository: https://github.com/kirodotdev/KiroCrew (4711 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add kirodotdev/KiroCrew --skill goal-loop -g -a claude-code -y`
Codex: `npx skills add kirodotdev/KiroCrew --skill goal-loop -g -a codex -y`
Cursor: `npx skills add kirodotdev/KiroCrew --skill goal-loop -g -a cursor -y`
Gemini CLI: `npx skills add kirodotdev/KiroCrew --skill goal-loop -g -a gemini-cli -y`

## Description

Bootstrap a goal-driven self-improving AutoNudge loop from a goal plus an anchor directory, then run the board autonomously until the Definition of Done is met.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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](https://github.com/antopolskiy/kanban-md).

Install (pick one):

```bash
# 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

The rest: https://github.com/kirodotdev/KiroCrew/blob/HEAD/skills/goal-loop/SKILL.md