GravionLabs/elysion / .agents/skills/planner
planner
VerifiedPlan 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".
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.4 KB |
| references/governance.md | markdown | 1.9 KB |
| references/help.md | markdown | 1.9 KB |
| references/invariants.md | markdown | 1.2 KB |
| references/plan-schema.md | markdown | 10.0 KB |
| references/questions.md | markdown | 1.3 KB |
| references/ready.md | markdown | 1.3 KB |
| references/slicing.md | markdown | 1.5 KB |
| schema/plan.schema.json | config | 2.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.
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 |