deliver-project-work
Skill0 starsChanged 3 months agoMITView on GitHub
Take an explicitly selected recorded issue or feature from its current queue through confirmation, Planning, In progress, implementation, checks, and Reviewing. Use when the user says to work on, start, or implement an ISSUE-* or FEATURE-* item as one end-to-end action. Do not use for initial intake, listing, planning-only transitions, acceptance, technical review, integration, releases, or unrecorded changes.
In this repository11 other files it gives its agents.
- AGENTS.mdAGENTS.md
- capture-project-intakeSkill
- clean-up-worktreeSkill
- coordinate-parallel-workSkill
- develop-projectSkill
- integrate-reviewed-changeSkill
- investigate-projectSkill
- manage-project-workSkill
- map-project-planningSkill
- release-projectSkill
- review-project-changeSkill
The file
We split this skill into the rules it gives an agent
11 rules. About 0 are common, 7 are distinctive, and 4 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈7
Distinctive · estimate
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
- Distinctive: line 14
Read the root AGENTS.md, the canonical workflow, the contributing guide, and the one queue or board that contains the selected identifier.
- Distinctive: line 26
Ask for explicit confirmation before moving the card, creating a branch or worktree, or changing product files.
- Distinctive: line 32
If another parent card already occupies In progress, do not start a second one.
- Distinctive: line 38
If the request names more than one tracked identifier, ask the user to choose one as the parent outcome.
- Very specific: line 45
Follow manage-project-work to satisfy the promotion and start checks, then move the selected identifier through Planning into In progress …
- Very specific: line 52
Create codex/<id>-<description> from the exact In progress checkpoint as the durable implementation branch.
- Very specific: line 63
Follow develop-project to implement the confirmed scope and run its focused and full verification gates.
- Distinctive: line 72
If required checks fail or the outcome is incomplete, keep the card In progress, record the evidence and one next action, and report the …
- Very specific: line 74
If implementation and required checks pass, follow manage-project-work to move the card to Reviewing with the exact candidate commit and …
- Distinctive: line 81
If the canonical coordinating branch cannot be restored or updated safely, leave its card In progress, keep the candidate branch pinned, …
- Distinctive: line 84
Never accept the card automatically.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 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.
Files
Deliver Project Work
Execution mode
inline
Confirm one execution plan
- Read the root
AGENTS.md, the canonical workflow, the contributing guide, and the one queue or board that contains the selected identifier. - Resolve the item's current status. Stop if the identifier is missing, duplicated, already Reviewing, or otherwise ambiguous.
- Prepare one concise confirmation containing:
- outcome, scope, constraints, and explicit exclusions
- exit checks and manual acceptance
- canonical coordinating branch, implementation branch, and whether an additional worktree or confirmed clean branch switches are needed
- the lifecycle moves needed to reach In progress
- Ask for explicit confirmation before moving the card, creating a branch or
worktree, or changing product files. Treat planning-only wording such as
"promote to Planning" as a lifecycle request owned by
manage-project-work, not as authority to begin implementation.
If another parent card already occupies In progress, do not start a second one. Offer to leave the selected item in Planning, finish the active card first, or use explicitly approved parallel lanes when the outcomes can be coordinated under one parent. Never silently combine independent cards or change the WIP policy.
If the request names more than one tracked identifier, ask the user to choose one as the parent outcome. Do not turn a second tracked identifier into an implementation lane or move it from its current lifecycle location implicitly. Parallel lanes are bounded parts of the one selected parent, not extra cards.
Advance and implement after confirmation
- Follow
manage-project-workto satisfy the promotion and start checks, then move the selected identifier through Planning into In progress without copying it. Checkpoint the In progress state on the canonical coordinating branch before implementation branches diverge. - Record the owner branch and next action on the In progress card. Keep canonical queue and board changes on the canonical coordinating branch.
- Create
codex/<id>-<description>from the exact In progress checkpoint as the durable implementation branch.- For one mutating lane, the coordinating checkout may switch to that branch and later return to the canonical branch when both switches were confirmed and the checkout is clean. Do not add a worktree merely to avoid a safe, authorised switch.
- For explicitly requested concurrent mutation, follow
coordinate-parallel-work: keep one parent card, record bounded lanes and their common base, and give each mutating lane a separate worktree checked out on its own branch. - Let read-only lanes share a checkout.
- Follow
develop-projectto implement the confirmed scope and run its focused and full verification gates.
Confirmation authorises only the described lifecycle moves, isolation, and implementation. It does not authorise integration, worktree removal, push, publication, release, or history rewriting.
Finish at Reviewing
- If required checks fail or the outcome is incomplete, keep the card In progress, record the evidence and one next action, and report the blocker.
- If implementation and required checks pass, follow
manage-project-workto move the card to Reviewing with the exact candidate commit and observed or unobserved evidence. The candidate branch must remain pinned to that commit. Return the clean coordinating checkout to the canonical branch, or use its already separate worktree, and create the Reviewing tracking checkpoint there. Never commit the Reviewing transition on the candidate branch. - If the canonical coordinating branch cannot be restored or updated safely, leave its card In progress, keep the candidate branch pinned, and report the exact blocker instead of creating ambiguous review state.
- Never accept the card automatically. User acceptance, technical review, integration, push, and release remain separate explicit actions.
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
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.

