agentleFS
tenforward-audiotenforward-audio/swe-harness/.agents/skills/manage-project-work/SKILL.md

manage-project-work

Skill0 starsChanged 3 months agoMITView on GitHub

List open tickets or review items, summarise status, apply planning-only lifecycle transitions, record acceptance, return, abandon, or close already-recorded work in this project's Markdown queues and boards. Use for filtered work lists, explicit status-only changes, and manual acceptance evidence. Do not use for initial intake, end-to-end delivery, parallel-lane orchestration, technical review, implementation, integration, local cleanup, or releases.

The file

We split this skill into the rules it gives an agent

11 rules. About 0 are common, 6 are distinctive, and 5 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈6

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 5

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Read ../../WORKFLOW.md before changing tracked state.

    line 12
  2. Very specific:

    Use ../../ISSUES.md and ../../FEATURES.md for unselected intake.

    line 18
  3. Very specific:

    Use ../../workboard/PLANNING.md for selected work not started, ../../workboard/IN_PROGRESS.md for the one active parent card, and …

    line 19
  4. Very specific:

    Treat “open tickets” as every unclosed ISSUE-* record across issue intake, Planning, In progress, and Reviewing.

    line 31
  5. Distinctive:

    When the user names a queue, state, type, or identifier, load only the owning source.

    line 37
  6. Distinctive:

    Treat requests to list, inspect, or summarise intake as read-only triage.

    line 50
  7. Very specific:

    Start only an explicitly selected card.

    line 54
  8. Distinctive:

    Create the Reviewing move as a coherent automatic tracking checkpoint on the canonical coordinating branch after working-tree and …

    line 59
  9. Distinctive:

    Never create that checkpoint on the candidate branch.

    line 61
  10. Distinctive:

    After technical review, record durable outcomes in changelog, documentation, or an ADR as appropriate, then remove the card only when the …

    line 63
  11. Distinctive:

    Keep status boards canonical in the coordinating checkout.

    line 85

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “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

Manage Project Work

Execution mode

inline

Read ../../WORKFLOW.md before changing tracked state. It is the canonical source for card fields, statuses, and transition checks; this skill owns the procedure for applying them.

Load only the requested state

  • Use ../../ISSUES.md and ../../FEATURES.md for unselected intake.
  • Use ../../workboard/PLANNING.md for selected work not started, ../../workboard/IN_PROGRESS.md for the one active parent card, and ../../workboard/REVIEWING.md for completed candidates awaiting review.
  • Open only the relevant source. When status is unknown, search the boards by ID and read only the matching file. Load every source only for an explicit overview or migration.
  • For an overview, return one compact line per item: ID — status — outcome — owner branch (if any) — next review action.
  • Move items and cards rather than copying them. Never reuse an identifier.

List filtered work read-only

  • Treat “open tickets” as every unclosed ISSUE-* record across issue intake, Planning, In progress, and Reviewing. Treat “open work” as both issue and feature records across those live states.
  • For “items for review” or equivalent wording, read only REVIEWING.md unless the user explicitly requests candidates or review assignments in another state.
  • When the user names a queue, state, type, or identifier, load only the owning source. Load all queues and boards only for an explicit cross-lifecycle list.
  • Listing is read-only. Do not promote, start, accept, return, close, reorder, or rewrite an item unless the user separately requests that transition.
  • Return a compact filtered list using the overview format above and say plainly when no matching work exists.

Promote and advance deliberately

  • Route requests to work on, start, or implement a recorded identifier through deliver-project-work. Keep explicit wording such as "promote to Planning" or "start without implementing" as a lifecycle-only request in this skill.
  • Treat requests to list, inspect, or summarise intake as read-only triage. Return readiness to plan or the most important missing detail.
  • Promotion requires a deliberate user choice. Move the item to PLANNING.md using the selected card shape and promotion checks in the workflow contract.
  • Start only an explicitly selected card. Keep at most one parent card in IN_PROGRESS.md unless the user changes the work-in-progress policy.
  • Move a completed candidate to REVIEWING.md only after the workflow contract's completion and evidence checks are satisfied. Confirm its branch still points to the exact candidate commit.
  • Create the Reviewing move as a coherent automatic tracking checkpoint on the canonical coordinating branch after working-tree and staged-scope review. Never create that checkpoint on the candidate branch. If the transition cannot be isolated safely, leave the card In progress and report why.
  • After technical review, record durable outcomes in changelog, documentation, or an ADR as appropriate, then remove the card only when the user accepts it. Return it to Planning if material work remains. Close or reject intake only when asked.
  • Abandon selected planning or research only when the user asks. Follow the workflow's preservation rules before removing a card, and do not infer local worktree or branch cleanup from that lifecycle decision.

Keep lifecycle ownership narrow

  • deliver-project-work owns the confirmed end-to-end path from a selected recorded item through Reviewing. This skill performs its lifecycle transitions but not its implementation.
  • coordinate-parallel-work owns lane, common-base, worktree, dependency, and ownership orchestration.
  • review-project-change owns read-only technical assessment and returns evidence without changing lifecycle state.
  • integrate-reviewed-change owns an explicitly authorised integration without inferring acceptance or closure.
  • clean-up-worktree owns explicitly authorised local worktree and branch removal after preservation checks. Acceptance, rejection, closure, or return does not imply cleanup authority.
  • Keep status boards canonical in the coordinating checkout. Background lanes return commits and evidence but never independently promote cards, rewrite queues, or reconcile global state.

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.