Breakdown tasks
Skill hungv47/meta-skills/forsvn-dev/skills/meta/breakdown-tasks
Decomposes a spec or architecture into buildable tasks with acceptance criteria, dependencies, and risk-first implementation order, for AI agents or human engineers. Produces `docs/forsvn/artifacts/meta/tasks.md`. Use once requirements are clear and you need an execution plan. Not for clarifying unclear requirements (use discover) or designing architecture (use architect-system). For code review after building, see review-work.From its SKILL.md
npx -y skills add hungv47/meta-skills --skill breakdown-tasksAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 14 stars14 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
6.3 KB, ~1.4k tokens by cl100k_base, as published. Nobody here has run it
Task Breakdown — Orchestrator
Productivity — multi-agent orchestration. Break architecture into executable tasks; consumers implement one at a time.
Core Question: "Can an engineer pick up any single task and ship it independently?"
Methodology (risk-first, vertical slices, stable IDs, multi-agent rationale), principles, when NOT to use:
references/playbook.md[PLAYBOOK].
Capabilities surfaced: decompose, task-breakdown, sprint-plan, work-breakdown, acceptance criteria, task dependencies, implementation order, risk-first ordering.
Critical Gates
Critic-agent verifies ALL before delivery:
- Every task has exactly ONE acceptance test
- No task depends on something not yet defined
- Risky/uncertain work is front-loaded
- All external config is in Prerequisites, not buried in tasks
- A junior dev could verify each acceptance criterion
- No task requires unstated knowledge
- Tasks are vertical slices (each delivers a testable increment through all layers); horizontal-only needs explicit justification
On fail: critic names the agent; orchestrator re-dispatches with feedback. Max 2 rounds; round >2 → DONE_WITH_CONCERNS.
Before Starting
Apply references/_shared/before-starting-check.md [PLAYBOOK]:
| # | Action |
|---|---|
| 0 | Mode resolve per references/_shared/mode-resolver.md. Default standard. Downgrade to fast (<10 tasks, single feature, no upstream) → Single-Agent Fallback. Escalate to deep for multi-feature roadmaps with cross-feature deps. |
| 1 | Read implementation-roadmap/canonical-paths.md if present. |
| 2 | Read architecture/system-architecture.md + docs/forsvn/artifacts/meta/specs/*.md + docs/forsvn/artifacts/product/flow/*.md. None + no source in chat → recommend /discover or /architect-system. |
| 3 | Read existing docs/forsvn/artifacts/meta/tasks.md — re-run behavior in references/task-format.md §"Re-run behavior". |
| 4 | No experience/ read — project-specific. |
Pre-Dispatch
Per references/_shared/pre-dispatch-protocol.md [PROCEDURE]. Warm/Cold Start prompts, dimensions, write-back: references/procedures/pre-dispatch.md [PROCEDURE].
Session execution profile (single-vs-multi): inherit per references/_shared/execution-policy.md.
Multi-Agent Architecture
5 agents, 2 layers (decomposer + dependency-mapper parallel → ordering → acceptance → critic). Agent Roster, Execution Layers, 6-step Dispatch Protocol, Routing Rules, Single-Agent Fallback: references/procedures/multi-agent-dispatch.md [PROCEDURE].
Artifact Contract
- Path:
docs/forsvn/artifacts/meta/tasks.md(single file; edited in place; full re-decomposition snapshots prior totasks.v[N].md) - Lifecycle:
pipeline - Frontmatter:
skill,version,date,status,stack(=meta),review_surface(=md),decision_state,review_tool,reviewed_at,reviewer. Schema + Status Index + Shared Context + task-block format:references/task-format.md[PROCEDURE]. - Required sections: Status Index (source-of-truth for resume), Shared Context (decisions every task references), Tasks (sibling
###blocks, stable IDs). - Consumed by: fresh engineering sessions running Resume Protocol from
references/execution-protocol.md; orchestrators batching AFK; operator; fresh-eyes.
Execution Hand-off
Planner, not runner. After tasks.md ships, the next consumer owns execution. Do not re-run this skill to implement. Operating manual: references/execution-protocol.md (Resume, Per-Task, Update/Remove/Reopen, Concurrency, Staleness, Coding Rules).
Anti-Patterns
references/anti-patterns.md [ANTI-PATTERN] — re-read before any task that smells off.
Worked Example
references/examples/decompose-walkthrough.md [EXAMPLE] — Todo app, end-to-end Layer 1 + Layer 2 + critic PASS.
Durable Rules (protected)
<!-- SLOW_UPDATE_START --> <!-- No pinned rules yet. Populate via the slow-update workflow (see references/slow-update-fence.md). Each pinned rule must (a) be procedural not instance-specific, (b) be earned from a regression or critic-flagged failure, (c) cite the artifact / decision record that justified pinning. --> <!-- SLOW_UPDATE_END -->Completion Status
Every run ends with explicit status:
- DONE — tasks decomposed, sized, ordered, deps + criteria written; critic PASS round 1 or 2
- DONE_WITH_CONCERNS — complete but sizing/dep/criteria ambiguity, or critic FAILed round 2
- BLOCKED — work too large/under-specified; needs scope reduction or further discovery
- NEEDS_CONTEXT — missing spec/architecture/product-context; recommend
discoverorarchitect-system
Next Step
Hand off tasks.md to implementing agent/dev with the Resume Protocol pointer. Do not re-invoke for the same scope unless re-decomposing.
References
references/:playbook.md[PLAYBOOK],task-format.md[PROCEDURE],execution-protocol.md,anti-patterns.md[ANTI-PATTERN],{sizing-examples, dependency-patterns, acceptance-criteria}.mdreferences/procedures/{multi-agent-dispatch, pre-dispatch}.md[PROCEDURE]references/examples/decompose-walkthrough.md[EXAMPLE]references/_shared/{before-starting-check, mode-resolver, pre-dispatch-protocol}.md
What ships with it: 27 files
213.8 KB alongside SKILL.md, 6 of them executable
agents/
- acceptance-agent.md4.3 KB
- critic-agent.md4.7 KB
- decomposer-agent.md4.8 KB
- dependency-mapper-agent.md5.1 KB
- ordering-agent.md4.6 KB
- _template.md2.4 KB
references/
- acceptance-criteria.md11.1 KB
- anti-patterns.md4.1 KB
- dependency-patterns.md7.5 KB
- examples/decompose-walkthrough.md3.9 KB
- execution-protocol.md7.4 KB
- playbook.md7.7 KB
- procedures/multi-agent-dispatch.md3.3 KB
- procedures/pre-dispatch.md1.5 KB
- _shared/before-starting-check.md9.8 KB
- _shared/execution-policy.md7.0 KB
- _shared/mode-resolver.md11.0 KB
- _shared/pre-dispatch-protocol.md20.2 KB
- sizing-examples.md8.0 KB
- task-format.md7.8 KB
scripts/
- append-loop-result.tsruns7.4 KB
- bootstrap-experience.tsruns3.6 KB
- lib/path-parser.tsruns11.6 KB
- manifest-sync.tsruns33.1 KB
- scaffold-eval-loop.tsruns9.5 KB
- update-quality-dashboard.tsruns9.6 KB
- routing.yaml2.7 KB