wbs-generation
Skill0 starsChanged 2 months agoMITView on GitHub
Generate a traceable implementation Work Breakdown Structure from verified detailed-design artifacts, current source anchors, requirement/TDD traceability, dependencies, and verification obligations. Use only after detailed designs are verified.
In this repository33 other files it gives its agents.
- .github/copilot-instructions.mdCopilot instructions
- adversarial-baseline-auditSkill
- architecture-drift-detectionSkill
- architecture-reconstruction-and-diagramsSkill
- artifact-detailed-designSkill
- baseline-source-of-truth-maintenanceSkill
- claim-verification-and-promotionSkill
- configuration-source-traceSkill
- contract-impact-test-designSkill
- current-state-tdd-synthesisSkill
- design-artifact-decompositionSkill
- design-artifact-decomposition-verificationSkill
- detailed-design-verificationSkill
- full-reverse-engineeringSkill
- implementation-readiness-certificationSkill
- incident-root-cause-analysisSkill
- integration-selection-analysisSkill
- observability-traceability-analysisSkill
- patch-impact-reviewSkill
- persistence-schema-reverse-engineeringSkill
- post-readiness-adversarial-auditSkill
- regression-test-designSkill
- requirement-compliance-reviewSkill
- resolve-high-impact-unknownsSkill
- resume-reverse-engineeringSkill
- reverse-engineering-bootstrapSkill
- reverse-engineering-coverage-auditSkill
- run-engineering-workflowSkill
- runtime-binding-verificationSkill
- runtime-flow-analysisSkill
- technical-design-proposalSkill
- technical-design-verificationSkill
- wbs-verificationSkill
The file
We split this skill into the rules it gives an agent
11 rules. About 0 are common, 9 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈9
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 13
Do not jump from TDD prose directly to generic tasks.
- Distinctive: line 35
test design if available
- Distinctive: line 55
Do not add "nice to have" refactoring.
- Distinctive: line 96
If a WBS task's primary deliverable is a subordinate type, one of these must be true:
- Distinctive: line 99
Do not map a task titled for component/type A to an artifact whose registered responsibility is component/type B unless the artifact …
- Very specific: line 101
If semantic ownership cannot be proven, stop with WBS_BLOCKED_DESIGN_GAP.
- Distinctive: line 104
Before emitting the WBS, create an internal/exposed consistency table:
- Distinctive: line 142
Do not invent ordering solely from file order.
- Distinctive: line 146
Every code-changing task needs a verification path.
- Distinctive: line 162
No verified design artifact may be orphaned.
- Very specific: line 189
Do NOT estimate hours/days/story points in this skill.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Implementation WBS Generation
Purpose
WBS is WHAT must be implemented, not an effort estimate.
Do not jump from TDD prose directly to generic tasks.
Inputs must include VERIFIED detailed designs.
Requirement
→ Gap
→ TDD
→ Design Artifact
→ VERIFIED Detailed Design
→ WBS Task
→ VerificationInputs
- authoritative requirement
- verified gap analysis
- verified TDD
- design artifact registry
- all
DD_VERIFIEDdetailed designs - detailed-design verification reports
- test design if available
- current repository
1. Task Derivation
Derive tasks only from verified design decisions.
Task categories:
- production code
- API/contract
- integration
- data/persistence
- configuration
- migration/compatibility
- tests
- build/deployment
- documentation
- cleanup only if required by approved design
Do not add "nice to have" refactoring.
2. Task Granularity
A task should be small enough to have:
- one clear outcome
- concrete source/design anchors
- explicit dependencies
- verifiable done criteria
But do not split mechanical edits into dozens of meaningless microtasks.
3. Stable IDs
Use:
WBS-001, WBS-002, ...
3A. WBS ↔ Design Semantic Identity
Traceability is not satisfied merely because a WBS row contains an existing Artifact ID.
For every WBS task, identify its primary implementation deliverable and prove that the referenced design artifact(s) own that deliverable.
Required semantic chain:
WBS task title / objective / primary deliverable
↔ registry artifact name + responsibility
↔ VERIFIED DD owned implementation unit(s)
↔ TDD design decisionRules:
- An Artifact ID reference is necessary but not sufficient.
- A type/class/interface being merely mentioned, imported, referenced, or linked from a DD does not prove that the artifact owns that implementation unit.
- If a WBS task's primary deliverable is a subordinate type, one of these must be true:
- the registry/DD explicitly declares that subordinate type inside the owning artifact scope, or
- the design artifact decomposition must be revised to track it separately.
- Do not map a task titled for component/type A to an artifact whose registered responsibility is component/type B unless the artifact explicitly owns A.
- If semantic ownership cannot be proven, stop with
WBS_BLOCKED_DESIGN_GAP; do not manufacture a mapping from nearby TDD prose.
Before emitting the WBS, create an internal/exposed consistency table:
| WBS ID | Primary Deliverable | Referenced Artifact IDs | Registry Responsibility | DD-Owned Unit | Semantic Match? | Evidence |
Required threshold:
WBS ↔ artifact semantic identity = 100%4. WBS Table
| WBS ID | Design Artifact IDs | Task | Existing Source Anchor / Proposed Location | Change Type | Dependencies | Requirement IDs | TDD/DD References | Verification | Done Criteria |
Change Type:
- ADD
- MODIFY
- REMOVE
- CONFIGURE
- MIGRATE
- TEST
- DOCUMENT
- VERIFY
5. Dependency DAG
Derive implementation ordering from artifact dependencies and code/runtime dependencies.
Create:
| WBS ID | Depends On | Dependency Reason | Hard/Soft |
Detect circular dependency.
Do not invent ordering solely from file order.
6. Verification Mapping
Every code-changing task needs a verification path.
Map to:
- existing test to update
- new test ID/viewpoint
- source/build verification
- runtime/integration verification
- manual verification only when automation is not feasible
7. Traceability
Create:
| Requirement ID | Gap ID | TDD Decision ID | Artifact ID | DD | WBS IDs | Test/Verification IDs | Coverage |
No verified design artifact may be orphaned.
8. WBS Gate
Before WBS_READY_FOR_VERIFICATION:
[ ] all DD_VERIFIED artifacts have implementation/verification task coverage
[ ] every WBS task maps back to verified design
[ ] every WBS task primary deliverable semantically matches the responsibility/owned unit of its referenced artifact(s)
[ ] no task relies on a merely-mentioned DD/TDD symbol as proof of artifact ownership
[ ] source anchors/proposed locations are concrete
[ ] dependencies are explicit
[ ] code-changing tasks have done criteria and verification
[ ] config/migration/docs/test work is included when required
[ ] no unapproved architecture/refactoring was added
[ ] no HIGH/CRITICAL source gap is hidden inside a taskStatuses:
- WBS_READY_FOR_VERIFICATION
- WBS_BLOCKED_DESIGN_GAP
- WBS_BLOCKED_SOURCE_GAP
Important
Do NOT estimate hours/days/story points in this skill. Effort estimation is a separate concern.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

