Skip to content

tim-hub/powerball-harness / harness/skills/harness-plan

harness-plan

Verified

Plans and tracks tasks in .claude/harness/plans.json. Use when creating plans, adding tasks, updating markers, checking progress, or brainstorming an idea into tasks.

FileKindSize
SKILL.mdskill md8.0 KB
references/add.mdmarkdown2.7 KB
references/archive.mdmarkdown1.8 KB
references/brainstorm.mdmarkdown3.5 KB
references/create.mdmarkdown15.6 KB
references/planning-quality.mdmarkdown7.6 KB
references/ralph-tasks.mdmarkdown2.8 KB
references/sync.mdmarkdown6.4 KB
references/task-fields.mdmarkdown2.1 KB
references/update.mdmarkdown2.3 KB
templates/plans-md-template.mdmarkdown1.4 KB

references/task-fields.md

View on GitHub
# Task Fields and Markers

Semantic definitions for fields and markers used in `.claude/harness/plans.json`.

---

## Field Definitions

### DoD (Definition of Done)

Must be a verifiable yes/no condition. Banned phrases: "looks good", "works properly", "is done", "is complete".

### Depends

Use `-` for no dependency, `N.1` for a single task, `N.1, N.2` for multiple, `Phase N` for a full phase dependency.

---

## Status Markers

| Marker | `--status` value | Meaning |
|--------|-----------------|---------|
| `cc:TODO` | `cc:TODO` | Not started |
| `cc:WIP` | `cc:WIP` | In progress |
| `cc:done [hash]` | `cc:done` | Worker completed — include a short git hash via `--hash` when a commit can be attributed |
| `pm:requested` | `pm:requested` | Requested by PM |
| `pm:confirmed` | `pm:confirmed` | PM review confirmed |
| `blocked` | `blocked` | Blocked — **always supply a one-line reason via `--reason`** |

---

## Quality Markers

Quality markers appear inline in the task `description` field at creation time.

| Marker | Meaning |
|--------|---------|
| `[needs-spike]` | High Impact × High Risk — spike task required before implementation |
| `[skip:tdd]` | Skip TDD phase (docs, config, style, trivial changes) |
| `[feature:security]` | Auth, login, payment tasks — security review required |
| `[feature:a11y]` | UI/screen/component tasks — accessibility review required |
| `[bugfix:reproduce-first]` | Bug tasks — must reproduce before fixing |
| `[ralph]` | Iterative loop task — executed by `harness-ralph-loop` (see below) |

---

## `[ralph]` Task Format

`[ralph]` tasks carry two extra fields in the `ralph` sub-object in plans.json:

- **`verify`** (required) — bash command that must exit 0 for the loop to succeed. Auto-inferred from project type if omitted at creation.
- **`maxIter`** (optional) — max worker iterations. Default: 10.

See [ralph-tasks.md](${CLAUDE_SKILL_DIR}/references/ralph-tasks.md) for full format and serialization rules.

---

## Task Status SSOT

`.claude/harness/plans.json` is the sole source of truth for task status. The native Claude Code task list is not mirrored.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall