agentleFS
rikilamadridrikilamadrid/pathfinder/skills/to-tickets/SKILL.md

to-tickets

Skill1 starsChanged 45 days agoMITView on GitHub

Decompose one approved Feature spec into small, blocker-linked tickets.

193 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use setup-ts-deep-modules, to-questionnaire and 9 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • liufeng1976Skill

    setup-ts-deep-modules

    Wire dependency-cruiser into a TypeScript repo so each package is a deep module — implementation hidden in subfolders, reachable only through its entry-point files. User-invoked.

    Also in 43 projects that use this

  • AWSSkill

    to-questionnaire

    Turn a decision you can't fully answer into a questionnaire for someone else to fill in.

    Also in 89 projects that use this

  • ryotaroh180105Skill

    claude-handoff

    Hand the current conversation off to a fresh background agent that picks up the work immediately.

    Also in 40 projects that use this

  • RoentekSkill

    loop-me

    Grill me about specs for the workflows I want to build, within this workspace.

    Also in 47 projects that use this

  • AWSSkill

    implement-spec

    Implement the result of /to-spec and /to-tickets in code.

    Also in 69 projects that use this

  • LesaniSkill

    writing-beats

    Shape an article as a journey of beats, choose-your-own-adventure style. The user picks a starting beat from the raw material, you write only that beat, then offer options for where to pivot next, beat by beat, until the article reaches a natural end. Use when the user has raw material and wants to assemble it as a narrative rather than an argument.

    Also in 43 projects that use this

  • +2 more from aws

The file

Show its rules and text

We split this skill into the rules it gives an agent

13 rules. 0 are common, 9 are distinctive, and 4 are very specific to this project.

  • 0

    Common

    Most of the 181 edited versions we read keep these.

  • 9

    Distinctive

    This author's own choices. Worth a look.

  • 4

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Read the Feature spec named by the human.

    line 22
  2. Very specific:

    Stop if the Feature still carries an unresolved human decision or a TBD.

    line 24
  3. Very specific:

    Read only the source the Feature's ## Context names, and only enough of it to size the work honestly.

    line 25
  4. Very specific:

    Create each ticket in that store, from templates/ticket.template.md, with the key and title the store carries — see Identity below.

    line 29
  5. Distinctive:

    leave the project working when it lands

    line 57
  6. Distinctive:

    Do not slice by layer, by file, or by phase.

    line 62
  7. Distinctive:

    Prefer fewer, larger tickets over many small dependent ones.

    line 65
  8. Distinctive:

    Never write an edge to a ticket of another Feature that does not exist yet.

    line 76
  9. Very specific:

    Do not invent unresolved decisions or resolve a TBD.

    line 94
  10. Distinctive:

    Do not plan beyond the Feature you were given.

    line 95
  11. Distinctive:

    Do not rewrite the Feature spec.

    line 96
  12. Distinctive:

    Do not add metadata the ticket template does not carry.

    line 97
  13. Distinctive:

    Do not scan unrelated repository areas.

    line 98

“Common” is measured: kept by at least 6 in 10 of the 181 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

To Tickets

Turn one approved Feature into the tickets that execute it.

A Feature is the planning outcome. A ticket is the executable unit of work: one vertical slice a fresh session can implement, verify, and hand back with the project still working.

Assumed role

Unless the human explicitly activated a role, assume planner for this invocation: read roles/planner.md and follow it. An explicit role overrides this default. A role narrows responsibility and never grants human authority.

Process

  1. Read the Feature spec named by the human. If none was named, list the specs in the spec source and stop.
  2. Stop if the Feature still carries an unresolved human decision or a TBD.
  3. Read only the source the Feature's ## Context names, and only enough of it to size the work honestly.
  4. Decide the slices. See Slicing below.
  5. Resolve the ticket store. Read skills/ticket/store.md and follow it.
  6. Create each ticket in that store, from templates/ticket.template.md, with the key and title the store carries — see Identity below.
  7. Record blockers as ticket keys under each ticket's ## Blocked by. Verify the edges form a directed acyclic graph before creating anything. A cycle is a slicing mistake, not a ticket to write.
  8. Present the tickets, the blocker graph, and which tickets are ready now.

Identity

A ticket's key is NN.TT. NN is the parent Feature's number, taken from its spec filename. TT is the next unused ticket number within that Feature, counting every ticket already in the store whatever its status.

In the local Markdown store that key is the filename — context/tickets/ holds NN.TT-slug.md, for example context/tickets/27.3-csv-download-endpoint.md. In another store it is carried the way context/tracker.md says. Either way, skills/ticket/store.md is where identity is defined; read it there.

Keys are never reused and never renumbered, because blocker edges are matched on them.

Slicing

A ticket is a tracer bullet, not a layer.

Each one must:

  • deliver an observable change, end to end, however thin
  • leave the project working when it lands
  • be implementable by one session that reads the ticket, its parent Feature, and nothing else
  • be verifiable by a command to run or a behavior to observe

Do not slice by layer, by file, or by phase. "Add the schema", "wire the UI", and "write the tests" are three halves of one ticket.

Prefer fewer, larger tickets over many small dependent ones. Every blocker edge is a session that has to wait.

Split when the work has genuinely separate outcomes, needs meaningfully different context, or has a real dependency between its parts.

Blockers

An edge means the later ticket cannot start until the earlier one is Complete.

  • Name only real dependencies. Preferred order is not a blocker.
  • Never write an edge to a ticket of another Feature that does not exist yet.
  • Two tickets that only touch the same file are not blocked; they are a merge the human resolves.

Status

A ticket's ## Status is its durable lifecycle state:

Proposed → Ready → In Progress → Complete

Cancelled and Superseded are terminal alternatives.

This skill writes Proposed and nothing else. Promotion belongs to the execution loop.

Rules

  • Do not implement.
  • Do not invent unresolved decisions or resolve a TBD.
  • Do not plan beyond the Feature you were given.
  • Do not rewrite the Feature spec. Report a Feature too vague to slice, and stop.
  • Do not add metadata the ticket template does not carry.
  • Do not scan unrelated repository areas.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.