Take one task from its contract to a reviewable pull request, back to back. The proof that the change works is part of the deliverable, not a later phase. Review rounds, /pr-conductor, and local-attest are not steps of this flow: the user runs them on demand.
Trigger: when the user gives a task and asks for it to end in a pull request, in prose or as a contract such as:
{
"goal": "ship the feature",
"inputs": ["issue", "repository", "design"],
"output": "reviewable pull request",
"constraints": ["no schema changes", "preserve public API"],
"done_when": ["tests pass", "visual check passes", "review passes"]
}
Arguments: $ARGUMENTS
<contract> — the task, as JSON or prose.
--draft — open the pull request as a draft.
Consent. Start this skill only when the user's prompt asks for the task to end in a pull request, in words or as the contract's output. That prompt is the consent to push the task's branch and open its pull request, for this one task. A task that does not ask for a pull request gets the same steps up to step 8, and then stops with local commits. This skill never merges: merging stays an explicit instruction, handed to /merge-pr.
1. Read the contract
Normalize the contract to five fields:
| Field |
Meaning |
If absent |
goal |
the change |
ask one question; with no goal there is no task |
inputs |
the issue, design, files, or links to read |
read what the prompt names |
output |
what the run ends with |
a reviewable pull request |
constraints |
what the change must not do |
none beyond the rule floor |
done_when |
the checks that make the task done |
tests pass, the feature runs, review passes |
2. Map every item to a check
Before you write code, give each done_when item and each constraint one mechanical check and the evidence it produces:
| Item |
Check |
Evidence |
| tests pass |
the new tests, plus the existing tests that cover the changed code |
the command and its last lines |
| the feature runs |
step 6 below |
the command and its output |
| visual check passes |
/run the app, open the changed screen, take a screenshot |
the screenshot and what it shows |
| review passes |
step 8 below |
findings found, fixed, answered |
| no schema changes |
git diff --stat origin/main...HEAD -- <schema paths> is empty |
the empty output |
| preserve public API |
the diff of exports, CLI flags, bin entries, and endpoints is empty or only adds |
that diff |
| criteria pass |
dotbabel criteria verify --pr <N> --post |
the evidence comment |
An item you cannot map to a check is not done. Write it in the proof as unverified, with the reason. Never tick it.
3. Ground and isolate
Read the inputs and the code the goal touches. Cite file:line for each claim.
If the contract has two readings that lead to different code, ask one question. Otherwise state the reading you chose and continue.
Create a worktree from the latest origin/main under .claude/worktrees/<slug>/, per the rule floor. Where dotbabel fleet runs, claim the paths you will edit.
From inside the worktree, record the contract, so a later session in that worktree can resume the task. A task record belongs to the worktree it is written from.
dotbabel task new <slug> --goal "<goal>" --done-when "<item>" ... --constraint "<item>" ...
Skip the record when dotbabel is not installed, and say so in the report.
4. Plan
Write at most five bullets in the form Step → verify: <check>. Do not wait for approval: the contract is the approval. Stop only for an ambiguity that changes the result, or for a constraint that the goal cannot meet.
5. Test first, then implement
- Write the tests for each behavior: unit tests, and integration tests where the change crosses a process, file, network, or database boundary. Include a negative case and a boundary case.
- Run them and see them fail for the right reason.
- Implement until they pass. Keep to the constraints.
6. Prove it works
Run the feature the way a user does. Choose by the surface the change has:
| Surface |
Run |
| CLI |
the command with real arguments, in a temporary directory if it writes |
| library |
a short script that calls the public function |
| server, API |
start it, call the endpoint, read the response |
| UI |
/run the app, open the changed screen, take a screenshot |
| docs only |
run each command the changed text shows, and check each link it adds |
| none |
write N/A — <reason>: a pure refactor that the tests already cover |
Record each command and the last ten lines of its output. A run that fails is a bug: fix it, and add the test that would have caught it.
7. Check the constraints
Run the check from step 2 for each constraint. A constraint that fails stops the task: report it rather than weaken it.
8. Review once
Run one review of the branch diff: /code-review on the changed files, or /quality-review where the project has a dotbabel quality policy. Fix each correct finding. Answer each wrong one in the proof, in one line. Do not post review comments, and do not start review rounds: /post-pr-review, /review-pr, and /pr-conductor run only when the user asks.
9. Open the pull request
- Commit with conventional messages. Do not add
[skip ci]: CI on the head is the merge evidence.
- Push the branch once, when the proof is complete, and open the pull request with
gh pr create --body-file <file> (add --draft for --draft). Where CI minutes are metered (a private repository without a self-hosted runner), every push of the head starts a paid run, so push the fixes of step 10 in one batch.
- Write the body with these sections, in this order:
## Summary — one to three bullets.
## Test plan — a checklist; tick only the items you ran.
## Proof — the format below.
## Spec ID or ## No-spec rationale — last, when the project uses specs or the change touches a protected path.
- If a linked spec declares active criteria, run
dotbabel criteria verify --pr <N> --post from the worktree at the pull request head. A failing criterion is a failing done_when item.
The ## Proof section:
## Proof
| done_when | Check | Result |
| ----------------- | ------------------------------------ | ---------------------------- |
| tests pass | `npx vitest run tests/foo.test.mjs` | 14 passed |
| the feature runs | `dotbabel foo --bar baz` | prints `3 items`, exit 0 |
| no schema changes | `git diff --stat main... -- schemas` | empty |
| review passes | `/code-review` on the diff | 3 found, 2 fixed, 1 answered |
<details><summary>Feature run</summary>
```text
$ dotbabel foo --bar baz
...
```
</details>
10. Wait for CI
Run gh pr checks <N> --watch. Fix a red check on the branch with a new commit, and repeat step 6 when the fix changes behavior. After three failed fixes for one check, stop and report it.
11. Report
Give the completion status: the done_when table with each result, the pull request link, and the CI state. Close the task record from the worktree with dotbabel task close <slug>. Name the next step: /merge-pr <N> when the user says merge, or a review the user may want to run on demand.
Rules
- The proof is the contract. Never tick a
done_when item or a test-plan item without evidence in the pull request body.
- One review pass. No review fleet, no comment rounds, no local attestation, unless the user asks.
- Never weaken a test, a check, a constraint, or a threshold to reach done.
- Never add
[skip ci] to the head commit, and never write the marker in any commit message, even to describe it: GitHub matches it anywhere in the message and skips the whole run. Check with git log --format=%B -1 before you push.
- Never merge, and never force-push.
- Stop and ask only for: an ambiguity that changes the result, a constraint the goal cannot meet, a check that stays red after three fixes, or a destructive action.
1---2id: deliver3name: deliver4type: skill5version: 1.0.06domain: [devex]7platform: [github-actions]8task: [testing, review]9maturity: draft10owner: "@kaiohenricunha"11created: 2026-10-1312updated: 2026-10-1313description: >14 Take one task contract (goal, inputs, constraints, done_when) from a prompt to15 a reviewable pull request in one run: test first, implement, prove the change16 works by running it, review the diff once, and open the pull request with the17 proof. CI on the head is the merge evidence. No review rounds, no local18 attestation, no merge. Triggers on: "deliver this", "build this and open a19 PR", "implement this issue and open a PR", "take this task to a PR", or a20 task contract whose output is a pull request.21argument-hint: "<task contract as JSON or prose> [--draft]"22user-invocable: true23disable-model-invocation: false24headless_safe: false25metadata:26 source: https://skillmd.com/skills/kaiohenricunha/deliver27---2829Take one task from its contract to a reviewable pull request, back to back. The proof that the change works is part of the deliverable, not a later phase. Review rounds, `/pr-conductor`, and `local-attest` are not steps of this flow: the user runs them on demand.3031Trigger: when the user gives a task and asks for it to end in a pull request, in prose or as a contract such as:3233```json34{35 "goal": "ship the feature",36 "inputs": ["issue", "repository", "design"],37 "output": "reviewable pull request",38 "constraints": ["no schema changes", "preserve public API"],39 "done_when": ["tests pass", "visual check passes", "review passes"]40}41```4243Arguments: `$ARGUMENTS`4445- `<contract>` — the task, as JSON or prose.46- `--draft` — open the pull request as a draft.4748**Consent.** Start this skill only when the user's prompt asks for the task to end in a pull request, in words or as the contract's `output`. That prompt is the consent to push the task's branch and open its pull request, for this one task. A task that does not ask for a pull request gets the same steps up to step 8, and then stops with local commits. This skill never merges: merging stays an explicit instruction, handed to `/merge-pr`.4950## 1. Read the contract5152Normalize the contract to five fields:5354| Field | Meaning | If absent |55| ------------- | ------------------------------------------ | ------------------------------------------------- |56| `goal` | the change | ask one question; with no goal there is no task |57| `inputs` | the issue, design, files, or links to read | read what the prompt names |58| `output` | what the run ends with | a reviewable pull request |59| `constraints` | what the change must not do | none beyond the rule floor |60| `done_when` | the checks that make the task done | `tests pass`, `the feature runs`, `review passes` |6162## 2. Map every item to a check6364Before you write code, give each `done_when` item and each constraint one mechanical check and the evidence it produces:6566| Item | Check | Evidence |67| ------------------- | ---------------------------------------------------------------------------------- | -------------------------------- |68| tests pass | the new tests, plus the existing tests that cover the changed code | the command and its last lines |69| the feature runs | step 6 below | the command and its output |70| visual check passes | `/run` the app, open the changed screen, take a screenshot | the screenshot and what it shows |71| review passes | step 8 below | findings found, fixed, answered |72| no schema changes | `git diff --stat origin/main...HEAD -- <schema paths>` is empty | the empty output |73| preserve public API | the diff of exports, CLI flags, `bin` entries, and endpoints is empty or only adds | that diff |74| criteria pass | `dotbabel criteria verify --pr <N> --post` | the evidence comment |7576An item you cannot map to a check is not done. Write it in the proof as unverified, with the reason. Never tick it.7778## 3. Ground and isolate79801. Read the inputs and the code the goal touches. Cite `file:line` for each claim.812. If the contract has two readings that lead to different code, ask one question. Otherwise state the reading you chose and continue.823. Create a worktree from the latest `origin/main` under `.claude/worktrees/<slug>/`, per the rule floor. Where `dotbabel fleet` runs, claim the paths you will edit.834. From inside the worktree, record the contract, so a later session in that worktree can resume the task. A task record belongs to the worktree it is written from.8485 ```bash86 dotbabel task new <slug> --goal "<goal>" --done-when "<item>" ... --constraint "<item>" ...87 ```8889 Skip the record when `dotbabel` is not installed, and say so in the report.9091## 4. Plan9293Write at most five bullets in the form `Step → verify: <check>`. Do not wait for approval: the contract is the approval. Stop only for an ambiguity that changes the result, or for a constraint that the goal cannot meet.9495## 5. Test first, then implement96971. Write the tests for each behavior: unit tests, and integration tests where the change crosses a process, file, network, or database boundary. Include a negative case and a boundary case.982. Run them and see them fail for the right reason.993. Implement until they pass. Keep to the constraints.100101## 6. Prove it works102103Run the feature the way a user does. Choose by the surface the change has:104105| Surface | Run |106| ----------- | ---------------------------------------------------------------------- |107| CLI | the command with real arguments, in a temporary directory if it writes |108| library | a short script that calls the public function |109| server, API | start it, call the endpoint, read the response |110| UI | `/run` the app, open the changed screen, take a screenshot |111| docs only | run each command the changed text shows, and check each link it adds |112| none | write `N/A — <reason>`: a pure refactor that the tests already cover |113114Record each command and the last ten lines of its output. A run that fails is a bug: fix it, and add the test that would have caught it.115116## 7. Check the constraints117118Run the check from step 2 for each constraint. A constraint that fails stops the task: report it rather than weaken it.119120## 8. Review once121122Run one review of the branch diff: `/code-review` on the changed files, or `/quality-review` where the project has a dotbabel quality policy. Fix each correct finding. Answer each wrong one in the proof, in one line. Do not post review comments, and do not start review rounds: `/post-pr-review`, `/review-pr`, and `/pr-conductor` run only when the user asks.123124## 9. Open the pull request1251261. Commit with conventional messages. Do not add `[skip ci]`: CI on the head is the merge evidence.1272. Push the branch once, when the proof is complete, and open the pull request with `gh pr create --body-file <file>` (add `--draft` for `--draft`). Where CI minutes are metered (a private repository without a self-hosted runner), every push of the head starts a paid run, so push the fixes of step 10 in one batch.1283. Write the body with these sections, in this order:129 - `## Summary` — one to three bullets.130 - `## Test plan` — a checklist; tick only the items you ran.131 - `## Proof` — the format below.132 - `## Spec ID` or `## No-spec rationale` — last, when the project uses specs or the change touches a protected path.1334. If a linked spec declares active criteria, run `dotbabel criteria verify --pr <N> --post` from the worktree at the pull request head. A failing criterion is a failing `done_when` item.134135The `## Proof` section:136137````markdown138## Proof139140| done_when | Check | Result |141| ----------------- | ------------------------------------ | ---------------------------- |142| tests pass | `npx vitest run tests/foo.test.mjs` | 14 passed |143| the feature runs | `dotbabel foo --bar baz` | prints `3 items`, exit 0 |144| no schema changes | `git diff --stat main... -- schemas` | empty |145| review passes | `/code-review` on the diff | 3 found, 2 fixed, 1 answered |146147<details><summary>Feature run</summary>148149```text150$ dotbabel foo --bar baz151...152```153154</details>155````156157## 10. Wait for CI158159Run `gh pr checks <N> --watch`. Fix a red check on the branch with a new commit, and repeat step 6 when the fix changes behavior. After three failed fixes for one check, stop and report it.160161## 11. Report162163Give the completion status: the `done_when` table with each result, the pull request link, and the CI state. Close the task record from the worktree with `dotbabel task close <slug>`. Name the next step: `/merge-pr <N>` when the user says merge, or a review the user may want to run on demand.164165## Rules166167- The proof is the contract. Never tick a `done_when` item or a test-plan item without evidence in the pull request body.168- One review pass. No review fleet, no comment rounds, no local attestation, unless the user asks.169- Never weaken a test, a check, a constraint, or a threshold to reach done.170- Never add `[skip ci]` to the head commit, and never write the marker in any commit message, even to describe it: GitHub matches it anywhere in the message and skips the whole run. Check with `git log --format=%B -1` before you push.171- Never merge, and never force-push.172- Stop and ask only for: an ambiguity that changes the result, a constraint the goal cannot meet, a check that stays red after three fixes, or a destructive action.