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/governance.md

View on GitHub
# Governance: ADR and spec rules

Loaded only when `.agents/config.json` has `governance` (names: `adrDir`, `adrPaths`, `specDir`, `specMap`, see `docs/usage/project-config.md`). Without it planning and refinement are unchanged and this file is not read.

## Decision PBI

An item (planned, or a PBI being refined) needs a decision when it:

- touches a path matching a `governance.adrPaths` glob,
- adds a service (a new top-level folder that no `specMap` glob matches, see `skills/shared/implementation/references/specs.md`),
- adds an external dependency, or
- reverses an accepted ADR.

Such an item gets a separate decision PBI:

- title `docs: ADR <topic>`, label `needs-decision`;
- acceptance criterion `ADR (the next free ADR number) with Status: Proposed`, same wording as `github-issue` `references/decisions.md`; never a fixed ADR number;
- the implementing item lists the decision PBI in `blocked_by` (in a plan: its plan id, for an existing issue: its number).

Open questions of the decision go through `grill-me` first. Answers the user settles in the session go under `## Decisions` of the decision PBI (`<question> — <answer>`); the ADR still carries `Status: Proposed`, the owner accepts it.

## Spec criterion

An item whose files match a `governance.specMap` glob names the spec file in its body (`Spec: <specDir>/<name>.md`) and gets the acceptance criterion (`<spec>` is that spec file):

```markdown
- [ ] spec updated or `no spec change needed: <spec>` noted
```

The wording is exact; CI and `code-review` look for `no spec change needed:`. The wording is exact; CI and `code-review` look for `no spec change needed:`.

## Readiness

A PBI under `adrPaths` without an `ADR (the next free ADR number) with Status: Proposed` criterion, or without a blocking decision PBI in `blocked_by`, is not ready (`references/ready.md`). In `## Refine` the missing point goes to `grill-me` like any other gap, and the decision PBI is created only after approval.
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