Skip to content

GravionLabs/elysion / .agents/skills/planner

planner

Verified

Plan an issue one level down with blockers and sizes, grill the open decisions, create the issues; refine <nr> checks readiness. Use for "plan issue #N" or "refine #N".

FileKindSize
SKILL.mdskill md8.4 KB
references/governance.mdmarkdown1.9 KB
references/help.mdmarkdown1.9 KB
references/invariants.mdmarkdown1.2 KB
references/plan-schema.mdmarkdown10.0 KB
references/questions.mdmarkdown1.3 KB
references/ready.mdmarkdown1.3 KB
references/slicing.mdmarkdown1.5 KB
schema/plan.schema.jsonconfig2.3 KB

references/help.md

View on GitHub
# /planner

Plans an issue one level down with blockers and sizes, grills the open decisions, creates the approved issues. `refine <nr>` checks readiness.

## Usage

```text
/planner <nr>
/planner <free description>
/planner refine <nr>
/planner help
```

## Arguments and flags

- `<nr>`: issue number to plan; the input level decides the output level:
  - Epic gives Features
  - Feature gives PBIs
  - PBI or Bug that fits one session: no items (use `refine <nr>`); size L or more than one session: split into sibling PBIs under the same Feature
- `<free description>`: internal steps only, no issues are created
- `refine <nr>`: no plan, no new issues except an approved split; checks the issue against the readiness list of its level, grills the gaps, updates the body (`## Decisions`), sets labels (`needs-refinement` removed when ready, `needs-decision` when a question is open)
- Depth, named in the request: `quick` (~5 key files), `standard` (default), `deep` (call sites, tests, docs of every affected area)
- Interactive session: plan, grill the open decisions round by round (`grill-me`), then you approve granularity, blockers and which items to create (also with zero questions); nothing is created before; the answers go under `## Decisions` of the created issues
- A split of an L-sized PBI is created only after your approval
- Non-interactive (a workflow subagent such as `deliver`): no questions, no issues; the plan with `questions[]` is returned as data
- `help` (also `--help`, `-h`): print this file

## Examples

```text
/planner 42
/planner refine 42
/planner deep plan for #42
/planner add rate limiting to the gateway
/planner help
```

## Config

- `governance` in `.agents/config.json`: switches on the ADR and spec rules (decision PBI `docs: ADR <topic>` that blocks the implementing item, spec criterion); without it planning is unchanged. See `docs/usage/project-config.md`

## See also

- `grill-me`, `github-issue`, `deliver`
- `docs/usage/governance.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