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/slicing.md
View on GitHub# Slicing rules
Adapted from `to-tickets` in [mattpocock/skills](https://github.com/mattpocock/skills) (MIT License, Matt Pocock). Reworded for this hub.
## Vertical slices
- Each item delivers one thin end-to-end behavior and is verifiable alone: a test, command or visible result proves it without the other items.
- Each item fits one fresh session: a reader can finish it from its body without re-exploring. Too big for that → split; too small to verify alone → merge.
- Slice by behavior, not by layer. "Add column", "add endpoint", "add UI" as three items is a horizontal split; one item per user-visible behavior is the target.
- Order by risk and dependency: unknowns and shared foundations first, each `blocked_by` only what it truly needs, so independent items can run in parallel.
## Wide refactors
A change touching many call sites is never one item. Plan it as:
1. **Expand**: add the new API or shape next to the old one; everything still passes.
2. **Migrate**: batches of call sites, each batch one item (`blocked_by` the expand item), each green on its own.
3. **Contract**: remove the old API once the last batch landed (`blocked_by` every migrate batch).
## Sizing
| Size | Meaning |
| :--- | :------------------------------------------------------------- |
| S | a few files, one concern, minutes of work |
| M | one module or component with its tests, one session |
| L | at the edge of one session; split it unless it cannot be split |
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 |