agentsclimarketplace

Subagent driven development with verdicts

Skill ProductOfAmerica/cairn/skills/subagent-driven-development-with-verdicts

Use when executing an implementation plan inside a cairn-tracked repo. Composition over superpowers:subagent-driven-development — same dispatch flow, with cairn task claim / evidence / verdict / complete checkpoints inserted at named steps.From its SKILL.md

Install
npx -y skills add ProductOfAmerica/cairn --skill subagent-driven-development-with-verdicts

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

4.1 KB, as published. Nobody here has run it

1. Preamble

Follow superpowers:subagent-driven-development exactly. Layer these cairn calls at the listed checkpoints. The checkpoint ids reference numbered steps in the SP skill. If SP renumbers in a future version, this table WILL break at invocation time, which is correct — reconcile explicitly rather than drifting silently.

2. Checkpoint table (greppable, auditable)

SP SDD step (verbatim anchor)Cairn additionCommand
Before "Read plan, extract all tasks"Materialize plan tasks in cairncairn spec validate && cairn task plan
"Dispatch implementer subagent" (per-task)Acquire claimcairn task claim <task_id> --agent <subagent-id> --ttl 30m --op-id <op>
Implementer reports DONENo cairn call. Capture gate output to /tmp/cairn-gate-<run_id>-<gate_id>.out for later.(capture only)
Spec reviewer approvesNo cairn call.—
Code quality reviewer approvesBind test-gate verdicts for every required test gatecairn evidence put <captured-output> && cairn verdict report --gate <id> --run <run_id> --status pass --evidence <captured-output> --producer-hash <placeholder> --inputs-hash <placeholder>
(during quality review)Bind rubric-gate verdicts via code-reviewer-pattern.md(see spoke)
"Mark task complete in TodoWrite"Complete the cairn claimcairn task complete <claim_id> --op-id <op>
Implementer reports BLOCKEDRelease claimcairn task release <claim_id> --op-id <op>
After "all tasks complete"Sanity check event trailcairn events since <session-start>

3. Verdict-binding timing rationale

Verdict = pass/fail claim with evidence, bound only after BOTH review passes. Work that spec-review or quality-review rejects never gets a pass verdict in the log. Append-only + latest-wins semantics preserved — no inconclusive placeholder needed.

If test gate output indicates failure (non-zero exit), implementer reports DONE_WITH_CONCERNS or BLOCKED, not DONE. No pass verdict ever binds for failing work.

4. Gate output capture lifetime

Between "Implementer reports DONE" (capture) and "Code quality reviewer approves" (verdict bind), captured output lives at /tmp/cairn-gate-<run_id>-<gate_id>.out.

5. Non-reuse rule on crash-reclaim

If the orchestrator crashes after capture but before verdict binding, the captured file MAY exist on disk but MUST NOT be reused. On reclaim (next agent picks up the task after the claim expires and gets re-claimed), the agent MUST re-run the gate to produce fresh output. Enforcement: verdict-binding step MUST parse the captured file's embedded <run_id> from its filename and compare to active run_id; mismatch → re-run gate, overwrite capture with current run_id, proceed.

6. Hash placeholders

Compute per hash-placeholders.md spoke. Do not improvise.

7. Failure modes

  • cairn task claim returns conflict (another agent holds claim) → re-dispatch with exponential backoff OR escalate to human.
  • cairn verdict report returns validation with kind: evidence_invalidated → evidence was invalidated by a prior reconcile (Ship 2 §5.10 surface 1). Re-capture evidence, retry.
  • cairn task complete returns validation with kind: gate_not_fresh → at least one required gate's latest verdict is stale. Re-run gate, bind fresh verdict, retry complete.

8. Red flags (delta from SP original)

ThoughtReality
"Claim was held by another agent — proceed anyway"NEVER. Conflict means two agents will step on each other.
"Gate failed but the test is wrong"Don't bind a pass verdict. Fix the gate definition in the prose spec, regenerate YAML, re-run.
"The captured output file exists on disk — reuse it"NEVER. Check run_id embedded in filename; mismatch = stale, re-run the gate.

Keep looking

Skills are one crate of 627,801. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.