Skip to main content

Skip docs navigation
manual page/ Start here

Execution

sourceSource: suspec/docs/07-running-agents.mdModified: 2026-07-14

Suspec ships no custom agents. Give a native worker or human a spec, or a task when the spec was split, by explicit absolute path.

example.txt

file
Read ~/.agents/artifacts/shop-api/spec-checkout.md and implement AC-001.

Read ~/.agents/artifacts/shop-api/task-checkout-expiry.md and do what it says.

A task adds slice scope, excluded areas, verification, and standing instructions. A change plan may add wave or preservation context. Neither replaces the spec.

Separation

  • The author defines intent and decomposition.
  • The implementer changes code without changing requirements.
  • An independent reviewer assesses the result without editing the target.
  • The orchestrator dispatches methods and applies supported fixes.
  • The human owns material decisions and acceptance.

The author may review only when they did not implement. Read-only subagent or research output is evidence to inspect, not implementation to merge.

Isolation

Parallel workers need isolated file state. Review needs the judged state preserved until final. Branches and worktrees remain project-owned Git practice; Suspec does not create or clean them.

Worktrees are not force fields. They do not isolate services, ports, databases, or credentials. Configure those separately. Exclude worktree directories from tools that ignore .gitignore, including test runners and linters, to prevent duplicate tests and phantom errors.

Return

Record under the source spec's ## Execution, or in the task when split:

  • every verification as passed or blocked;
  • decisive output once, or a stable evidence-receipt link;
  • changed and out-of-scope files;
  • blocked questions;
  • findings;
  • useful delegation provenance: sources, loaded guide, worker identity, and isolation mode.

A claim such as Tests passed is still a claim. Use pasted output, a labeled CI URL, or a named manual observation. Task CI evidence starts with CI: or CI link:. Missing evidence becomes Unverified.

The implementer may fix defects found during self-review. Self-review cannot manufacture independence or a human decision. Keep the judged tree available until review and follow-up finish.

Next: review. Previous: tasks.

Need a starting point? Install the skills