tim-hub/powerball-harness / harness/skills/harness-plan
harness-plan
VerifiedPlans and tracks tasks in .claude/harness/plans.json. Use when creating plans, adding tasks, updating markers, checking progress, or brainstorming an idea into tasks.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.0 KB |
| references/add.md | markdown | 2.7 KB |
| references/archive.md | markdown | 1.8 KB |
| references/brainstorm.md | markdown | 3.5 KB |
| references/create.md | markdown | 15.6 KB |
| references/planning-quality.md | markdown | 7.6 KB |
| references/ralph-tasks.md | markdown | 2.8 KB |
| references/sync.md | markdown | 6.4 KB |
| references/task-fields.md | markdown | 2.1 KB |
| references/update.md | markdown | 2.3 KB |
| templates/plans-md-template.md | markdown | 1.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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |