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/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).
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