sum-worker

Executes one approved task brief, verifies results, and submits structured handoff reports.

Updated Sep 5, 2026
One-click install
npx skills add https://github.com/douglasjarquin/sum --skill sum-worker-douglasjarquin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sum-worker
Source: https://github.com/douglasjarquin/sum/tree/main/skills/sum-worker
Command: npx skills add https://github.com/douglasjarquin/sum --skill sum-worker-douglasjarquin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? In a multi-agent coding setup, a dispatched worker agent needs strict operating rules so it completes exactly one approved task without drifting into coordination, scope creep, or unverified claims. This Skill defines that worker role: it constrains the agent to its brief, enforces verification discipline, and standardizes how results, questions, and evidence are reported back. ## Core Features & Use Cases - Scoped task execution: Implements only the approved brief, distinguishing investigation (scout) tasks from change (ship) tasks, and stopping after two failed internal repair iterations. - Verification contract handling: Runs the repository's standardized verify runner when present, captures evidence artifacts such as before/after comparisons, and records actual commands with exit codes. - Structured reporting and questions: Submits bounded JSON handoffs with outcome, candidate SHA, checks, and artifacts, and persists blocking questions via sumctl instead of deciding unilaterally. - Use Case: A coordinator dispatches a worker to fix a failing login test in a separate worktree; the worker reads the brief, fixes the bug, runs the project's verification, captures evidence, and reports a handoff for independent review. ## Quick Start Read your supplied task brief, implement the approved change in your checkout, run the repository's verification commands, and submit the result with the brief's sumctl report command.

Frequently Asked Questions about sum-worker

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I execute a task as a sum worker agent?

Read your supplied task brief, stay within its approved scope, implement or investigate in your own checkout, run the repository's verification commands, and submit results with the brief's sumctl report command including a structured handoff JSON.

How does the worker verification contract work?

When the brief marks the checkout as standardized, commit your candidate and run the verify runner script with the base SHA, then attach the run.json fields to your handoff. Non-standardized checkouts list each verification command with its exit code under checks.

Can a sum worker create or merge pull requests?

No, PR publication is the coordinator's operation. A worker only creates or merges a PR when the coordinator explicitly delegates it, and it never uploads media or edits PR bodies itself.

What happens when a worker receives a brief revision refresh?

Finish the current step safely, read the requested revision with sumctl brief list, adopt it with sumctl brief adopt, and continue from existing progress. A revision is not a new task and does not reset commits or repair counts.

What are the limits of a worker's repair attempts?

A worker stops after two unsuccessful internal repair iterations and saves a question or report. Only the coordinator can grant additional allowance through repair extend, and the worker never resets its own count.