jcosta33/suspec · Archived

sus-task

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.

Installation

$ npx skills add jcosta33/suspec --skill sus-task

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from jcosta33/suspec.

npx skills add jcosta33/suspec

Browse all from jcosta33/suspec

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 1
License LICENSE
Default branch main
Open issues 0
Status Archived

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 6,455 B
  • docs SUMMARY.md 290 B

History

  1. First recorded snapshot · 4 installs

SKILL.md

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.

  1. Enumerate every scoped requirement. When a change plan supplements the spec, enumerate its

preservation guarantees and waves.

  1. 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.

  1. 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.

  1. 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.

  1. Compare every pair of affected areas. Unknown scope conflicts with everything.
  2. 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.

  1. Sequence interface-defining work first. Put the complete run order and this packet's dependency

position in every packet.

  1. 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.