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/archive.md
View on GitHub# archive Subcommand — Phase Archiving
Marks fully-completed phases as archived in the plan (`harness plan-cli archive <phase-id>`) to keep the active view lean. Archived phases stay in `.claude/harness/plans.json` with `status: archived` — there is **no separate archive markdown file**. A phase is eligible when every task in it has a `cc:done` or `pm:confirmed` marker.
## Flow
1. Query phases via `harness plan-cli list` and identify those where **all** tasks are `cc:done` / `pm:confirmed`.
2. Apply the retention rule below to decide which eligible phases actually archive.
3. For each phase to archive, run `harness plan-cli archive <phase-id>` (sets `status: archived` in plans.json).
4. Verify the result with `harness plan-cli list --status archived`.
## What Stays Active
- Any phase with at least one task that is `cc:TODO`, `cc:WIP`, or `blocked`.
- The **10 most recent completed phases**, even if they are fully `cc:done` / `pm:confirmed`, to maintain recent history and context.
## Archived Phases
Archived phases are soft-deleted: they remain in `.claude/harness/plans.json` with `status: archived` and can be listed with `harness plan-cli list --status archived` (or `--status all`). No external archive markdown file is written.
## References
- [task-fields.md](${CLAUDE_SKILL_DIR}/references/task-fields.md) — field definitions (DoD, Depends, Status markers)
## Agent Delegation
This subcommand can be delegated to the `harness-planner` agent (Haiku, low effort). The agent applies the same retention rule and footer update.
Request shape (`planner-request.v1`):
```json
{
"schema_version": "planner-request.v1",
"operation": "archive"
}
```
When no phases are eligible, the planner returns `status: "skipped"`. See [`harness/agents/harness-planner.md`](${CLAUDE_SKILL_DIR}/../../agents/harness-planner.md).
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 |