Sus Task
No independence, no split.
Method
Enter on explicit split request or after the human selects task packets for a Suspec artifact
workflow.
Require exactly status: ready. Read the spec and every named source. A change plan may add wave
context; it cannot replace the spec. Any blocking decision kills dispatch.
Ask required questions through the native picker, or numbered choices plus Other. Put the
recommendation first; offer three genuine options, two if binary; give each one plain reason and
cost.
Use task packets only for:
- independently dispatchable parallel slices;
- one requirement implemented independently per platform or repository; or
- separately dispatchable transformation waves from a change plan that supplements the spec.
Size proves nothing. One source and one implementer earn no packet.
- Enumerate every scoped requirement. When a change plan supplements the spec, enumerate its
preservation guarantees and waves.
- Assign each requirement to exactly one packet. A platform/repository carve-out may repeat one ID
only when each context independently verifies the whole obligation. Assign each preservation
guarantee to every packet whose work could violate it.
- Copy each assigned requirement block and its
Verify with: line verbatim into its
packet. Name the source spec and include its ID
in source; add a change-plan ID only when used. Keep preservation IDs in ## Preservation scope,
never frontmatter scope. Stamp the source state identifier. Re-cut after a material source change.
- Give each packet one concern, exact scope, frozen boundaries, affected write areas, the strongest
available acceptance oracle, one Verify entry per requirement and preservation guarantee, and
agent instructions. For defective behavior, include the original-state failing command, expected
reason, state, and decisive output.
## Verify is the only home for final pasted evidence;
## Run summary cites those entries without duplicating output.
- Compare every pair of affected areas. Unknown scope conflicts with everything.
- Parallelize only when neither packet depends on the other, reads or writes the other's files,
shares a public interface/schema/generated surface, or touches shared build/CI configuration.
- Sequence interface-defining work first. Put the complete run order and this packet's dependency
position in every packet.
- Prove coverage both ways: no obligation missing, duplicated, weakened, or invented.
Force material ambiguity from every missing decision into explicit human selection. Block the split
until selection.
Artifact
Resolve ~/.agents/artifacts/<workspace>/ to an absolute path; derive <workspace> from the
repository or working-directory basename. Write there with linked sidecars beside their governing
packet. On collision or ambiguous workspace, present human-readable name choices. On a blocked
write, offer grant and retry, another agent-neutral user directory, or cancel. Never overwrite or
fall back to a repository, vendor directory, or temporary path.
Write local source references relative to the artifact. Use absolute paths only for runtime handoff.
Write one packet per slice. Carry every artifact by absolute path.
Start each packet with:
---
type: task
id: "TASK-{{slug}}"
source:
- "{{spec-id}}"
- "{{change-plan-id; omit when none}}"
scope: ["{{requirement-id}}"]
status: ready
---
Use # Task: {{title}} and these sections:
## Source: absolute spec and optional change-plan paths, IDs, source state, every scoped
requirement block and Verify with: line verbatim, and the strongest acceptance oracle. For a
defect, record the original state, failing command, numeric exit, expected reason, and decisive
output. The regression must fail on the defect, pass on the repair, exercise production behavior,
and invent no requirement.
## Scope: assigned requirement IDs only.
## Preservation scope: omit without a change plan; otherwise copy every preservation guarantee
the packet could violate with its exact check.
## Do not change: excluded paths, contracts, and behavior.
## Affected areas: every permitted write path.
## Verify: one entry per requirement and preservation guarantee. Record exact command, absolute
working directory, state, numeric exit, and fenced decisive raw output; a CI link or justified
n/a may replace command evidence. ready and running may retain pending evidence;
review-ready and closed may not.
## Agent instructions: reread sources and repository rules; block on source, scope, snapshot, or
preservation drift; reproduce a recorded defect before repair; stop before crossing scope; cite
Verify entries without repeating output; never assess or accept the owner's work.
## Run order: complete order, this packet, Starts after:, and May run with: proven
write-disjoint peers.
## Findings: unresolved defects or None.
## Run summary: status, changed files, Verify references, scope drift, and blocked questions. No
duplicated evidence.
At review-ready, freeze the target for a fresh independent reviewer against the canonical spec.
The implementation owner applies fixes and requests fresh review. Without independent review, stay
review-ready. Close only after findings are reconciled and human acceptance is recorded.
Output
Before handoff, cut repetition, softness, ceremony, and structural bloat without changing contracts,
identifiers, verbatim source text, evidence, or behavior. Rerun applicable checks. Return only
clickable Markdown links for every task and sidecar, with compact ~/.agents/... labels and fully
expanded absolute destinations. Explain only a blocker, failed creation, incomplete verification,
or irreversible-action confirmation.
Close
Once fully actioned and no downstream step needs them, require one human disposition for the
artifacts and sidecars: Delete, Leave, or Promote. Promote moves transient material into
project-owned permanence. Delete every selected path and verify absence; survivors block close.
1---2name: sus-task3description: Split a ready Suspec spec into collision-proof task packets. Use when spec-governed work must be divided into independent parallel slices, repository or platform contexts, or dispatchable transformation waves. Do not use for unspecced work or work with no dispatch boundary.4---56# Sus Task78No independence, no split.910## Method1112Enter on explicit split request or after the human selects task packets for a Suspec artifact13workflow.1415Require exactly `status: ready`. Read the spec and every named source. A change plan may add wave16context; it cannot replace the spec. Any blocking decision kills dispatch.1718Ask required questions through the native picker, or numbered choices plus `Other`. Put the19recommendation first; offer three genuine options, two if binary; give each one plain reason and20cost.2122Use task packets only for:2324- independently dispatchable parallel slices;25- one requirement implemented independently per platform or repository; or26- separately dispatchable transformation waves from a change plan that supplements the spec.2728Size proves nothing. One source and one implementer earn no packet.29301. Enumerate every scoped requirement. When a change plan supplements the spec, enumerate its31 preservation guarantees and waves.322. Assign each requirement to exactly one packet. A platform/repository carve-out may repeat one ID33 only when each context independently verifies the whole obligation. Assign each preservation34 guarantee to every packet whose work could violate it.353. Copy each assigned requirement block and its `Verify with:` line verbatim into its36 packet. Name the source spec and include its ID37 in `source`; add a change-plan ID only when used. Keep preservation IDs in `## Preservation scope`,38 never frontmatter `scope`. Stamp the source state identifier. Re-cut after a material source change.394. Give each packet one concern, exact scope, frozen boundaries, affected write areas, the strongest40 available acceptance oracle, one Verify entry per requirement and preservation guarantee, and41 agent instructions. For defective behavior, include the original-state failing command, expected42 reason, state, and decisive output. `## Verify` is the only home for final pasted evidence;43 `## Run summary` cites those entries without duplicating output.445. Compare every pair of affected areas. Unknown scope conflicts with everything.456. Parallelize only when neither packet depends on the other, reads or writes the other's files,46 shares a public interface/schema/generated surface, or touches shared build/CI configuration.477. Sequence interface-defining work first. Put the complete run order and this packet's dependency48 position in every packet.498. Prove coverage both ways: no obligation missing, duplicated, weakened, or invented.5051Force material ambiguity from every missing decision into explicit human selection. Block the split52until selection.5354## Artifact5556Resolve `~/.agents/artifacts/<workspace>/` to an absolute path; derive `<workspace>` from the57repository or working-directory basename. Write there with linked sidecars beside their governing58packet. On collision or ambiguous workspace, present human-readable name choices. On a blocked59write, offer grant and retry, another agent-neutral user directory, or cancel. Never overwrite or60fall back to a repository, vendor directory, or temporary path.6162Write local source references relative to the artifact. Use absolute paths only for runtime handoff.6364Write one packet per slice. Carry every artifact by absolute path.6566Start each packet with:6768```yaml69---70type: task71id: "TASK-{{slug}}"72source:73 - "{{spec-id}}"74 - "{{change-plan-id; omit when none}}"75scope: ["{{requirement-id}}"]76status: ready77---78```7980Use `# Task: {{title}}` and these sections:8182- `## Source`: absolute spec and optional change-plan paths, IDs, source state, every scoped83 requirement block and `Verify with:` line verbatim, and the strongest acceptance oracle. For a84 defect, record the original state, failing command, numeric exit, expected reason, and decisive85 output. The regression must fail on the defect, pass on the repair, exercise production behavior,86 and invent no requirement.87- `## Scope`: assigned requirement IDs only.88- `## Preservation scope`: omit without a change plan; otherwise copy every preservation guarantee89 the packet could violate with its exact check.90- `## Do not change`: excluded paths, contracts, and behavior.91- `## Affected areas`: every permitted write path.92- `## Verify`: one entry per requirement and preservation guarantee. Record exact command, absolute93 working directory, state, numeric exit, and fenced decisive raw output; a CI link or justified94 `n/a` may replace command evidence. `ready` and `running` may retain pending evidence;95 `review-ready` and `closed` may not.96- `## Agent instructions`: reread sources and repository rules; block on source, scope, snapshot, or97 preservation drift; reproduce a recorded defect before repair; stop before crossing scope; cite98 Verify entries without repeating output; never assess or accept the owner's work.99- `## Run order`: complete order, this packet, `Starts after:`, and `May run with:` proven100 write-disjoint peers.101- `## Findings`: unresolved defects or `None`.102- `## Run summary`: status, changed files, Verify references, scope drift, and blocked questions. No103 duplicated evidence.104105At `review-ready`, freeze the target for a fresh independent reviewer against the canonical spec.106The implementation owner applies fixes and requests fresh review. Without independent review, stay107`review-ready`. Close only after findings are reconciled and human acceptance is recorded.108109## Output110111Before handoff, cut repetition, softness, ceremony, and structural bloat without changing contracts,112identifiers, verbatim source text, evidence, or behavior. Rerun applicable checks. Return only113clickable Markdown links for every task and sidecar, with compact `~/.agents/...` labels and fully114expanded absolute destinations. Explain only a blocker, failed creation, incomplete verification,115or irreversible-action confirmation.116117## Close118119Once fully actioned and no downstream step needs them, require one human disposition for the120artifacts and sidecars: Delete, Leave, or Promote. Promote moves transient material into121project-owned permanence. Delete every selected path and verify absence; survivors block close.