ns-sdd-version-partitioner
(NS) Partition a large master requirements.md into executable subversions with version-roadmap.md and slice requirements excerpts — without generating tasks. Use when a version has too many features for one planning cycle or the user asks to split a version — after Gate 1 requirements confirmed. Do NOT generate task-NNN files (planning per slice comes later).
How do I install this agent skill?
npx skills add https://github.com/nextstage-brasil/skills --skill ns-sdd-version-partitionerIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a documentation-only utility designed to partition large requirements files into smaller sub-versions. No security risks, malicious patterns, or unsafe external dependencies were identified during the analysis.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Version Partitioner
Split master requirements.md into subversions for sequential planning.
Harness discovery
See ../ns-harness/references/artifact-layout.md and ../ns-harness/references/harness-discovery.md. Read core-subversions rule from harness when present.
Scope
- Read only: master
{product_root}/docs/versions/{version_san}/requirements.md - Do not: generate tasks, execution-handoff, or re-run Gate 1
- Do not load product backend/frontend rules — structural partition only
Algorithm
- Parse master — Features, precedences, data model hints, layer tags
- Build DAG — default order: schema → API → FE → tests; honor explicit precedence
- Group by bounded context — cluster by domain/entity
- Split oversized groups when:
- > 12 features with cross-dependencies, or
- ~50 estimated tasks, or
- ~600k token heuristic
- Consolidate undersized — merge adjacent slices below ~4 tasks when safe; target 4–7 tasks per subversion
- Topological sort — folders
01-slug,02-slug, … - Emit artifacts:
version-roadmap.mdat version rootsubversions/{subversion_san}/requirements.md— excerpt + link to master../requirements.md#Feature-ID- Empty
subversions/{subversion_san}/tasks/per slice
Roadmap table columns
| NN | slug | Features | deps | tasks est. | tokens est. | status |
Start status as pending.
Output checklist
-
version-roadmap.mdsaved - All subversion folders with excerpt requirements + empty
tasks/ - No
task-*.mdcreated - Human can review before slice planning loop
References
| File | When |
|---|---|
references/version-roadmap.template.md | Roadmap structure |
references/partition-workflow.md | Orchestrator loop after partition |
Integration
After partition → Gate Roadmap (human confirms) → plan each slice (Gates 2–3, tasks) without repeating Gate 1.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/nextstage-brasil/skills/ns-sdd-version-partitioner">View ns-sdd-version-partitioner on skillZs</a>