detailed-design-verification
Skill0 starsChanged 2 months agoMITView on GitHub
Independently verify one artifact detailed design against current source, verified TDD, artifact registry, requirement/gap traceability, provenance/exposure evidence, dependencies, compatibility constraints, and implementability. Use before marking a design artifact implementation-ready.
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
- 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-generationSkill
- wbs-verificationSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
19 rules. About 0 are common, 14 are distinctive, and 5 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈14
Distinctive · estimate
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 11
Verify one detailed-design artifact independently.
- Distinctive: line 13
Do not merely check internal consistency of the document.
- Distinctive: line 48
all material exposure paths
- Distinctive: line 52
Do not approve a design because the signatures "look plausible".
- Distinctive: line 81
Do not trust the section title.
- Distinctive: line 94
If a section labeled CURRENT contains a PROPOSED component or relationship as though it already exists, record:
- Very specific: line 101
if the TDD remains valid and the defect is in DD representation/state labeling: DD_PARTIALLY_VERIFIED
- Very specific: line 103
if the DD asserts materially false CURRENT behavior contradicted by source: DD_CONTRADICTED_BY_SOURCE
- Very specific: line 105
if source cannot resolve the classification: DD_BLOCKED_SOURCE_GAP
- Distinctive: line 112
Do not certify subjective labels by repetition.
- Distinctive: line 130
If a qualitative/zero-risk claim lacks measurable definition or evidence, record:
- Distinctive: line 153
If implementers would need to invent a material design decision:
- Very specific: line 163
search model/version/config branches
- Distinctive: line 164
search earlier conditional retrieval/mapping
- Distinctive: line 165
search error/fallback paths
- Distinctive: line 166
search tests contradicting the design
- Very specific: line 190
Only DD_VERIFIED may advance to WBS generation.
- Distinctive: line 192
Update the design artifact registry status accordingly.
- Distinctive: line 196
Use the active workflow-declared DD verification output path under the current run root.
≈ “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
Detailed Design Verification
Mission
Verify one detailed-design artifact independently.
Do not merely check internal consistency of the document.
Requirement
→ Gap
→ Verified TDD
→ Registry Artifact
→ Detailed Design
↕
Current Source / Runtime Evidence1. Traceability Verification
Verify:
| Check | Expected |
| Artifact ID | exists in registry |
| Requirement IDs | match registry/TDD |
| Gap IDs | verified gaps only |
| TDD Decision IDs | verified decisions |
| Existing anchors | exist and have claimed role |
| Proposed items | explicitly proposed |
2. Source / Runtime Verification
Check:
- caller/callee assumptions
- ownership/lifecycle
- configuration/binding
- data/state source
- result/error semantics
- integration boundaries
- all material exposure paths
- field/data provenance
- sibling operations/counterexamples
Do not approve a design because the signatures "look plausible".
3. Design Drift Verification
Detect:
- new behavior not approved by TDD
- missing TDD behavior
- changed requirement scope
- added validation/defaults
- omitted MUST-NOT / non-goal behavior
- invented shared abstraction
- unnecessary restructuring
- hidden migration/compatibility effects
3A. Architecture State Separation Gate
This gate is mandatory whenever the DD contains architecture/component/relationship diagrams or architecture prose.
Independently enumerate every architecture view and classify every material node/relationship as:
CURRENT
PROPOSED
UNKNOWNDo not trust the section title.
Required checks:
| Check | Required |
| Every CURRENT node exists in current source/evidence | 100% |
| Every CURRENT relationship is source/evidence-backed | 100% |
| PROPOSED nodes shown in a CURRENT-only view | 0 |
| PROPOSED relationships shown as CURRENT | 0 |
| UNKNOWN items promoted to CURRENT | 0 |
| Diagram title/state labels/prose agree | 100% |
If a section labeled CURRENT contains a PROPOSED component or relationship as though it already exists, record:
CURRENT_PROPOSED_ARCHITECTURE_CONTAMINATION
Routing:
- if the TDD remains valid and the defect is in DD representation/state labeling:
DD_PARTIALLY_VERIFIED - if the DD asserts materially false CURRENT behavior contradicted by source:
DD_CONTRADICTED_BY_SOURCE - if source cannot resolve the classification:
DD_BLOCKED_SOURCE_GAP
DD_VERIFIED is forbidden while any such finding remains.
3B. Quantified Risk / Confidence Claim Gate
Do not certify subjective labels by repetition.
Claims such as:
Regression Risk: NONE
Risk: LOW
Confidence: HIGHmust have explicit measurable criteria and supporting closure evidence.
Regression Risk: NONE requires evidence that all materially affected compatibility/exposure paths
were enumerated and no regression mechanism remains in the verified scope.
For constructor/signature/lifecycle changes, verify all material construction/wiring sites before accepting a zero-risk claim.
If a qualitative/zero-risk claim lacks measurable definition or evidence, record:
UNSUPPORTED_QUALITATIVE_RISK_CLAIM
and do not return DD_VERIFIED until the claim is removed, made evidence-backed, or expressed as an
explicit unresolved risk.
4. Implementability Verification
The design must be concrete enough that implementation tasks can be derived without guessing.
Check:
- exact existing source anchors
- proposed new artifact names/locations where needed
- interfaces/contracts
- branch/flow behavior
- data model/config changes
- dependency ordering
- error/failure semantics
- verification expectations
If implementers would need to invent a material design decision:
DD_INCOMPLETE_IMPLEMENTATION_DETAIL
5. Adversarial Counterexample Search
Before approval:
- search alternate callers
- search alternate implementations
- search model/version/config branches
- search earlier conditional retrieval/mapping
- search error/fallback paths
- search tests contradicting the design
6. Verdict Matrix
| DD Claim / Decision | Source/TDD Evidence | Counterevidence | Verdict | Required Correction |
Verdicts:
- VERIFIED
- PARTIALLY_VERIFIED
- CONTRADICTED
- SOURCE_NOT_RESOLVED
- OUT_OF_TDD_SCOPE
7. Gate
Overall:
- DD_VERIFIED
- DD_PARTIALLY_VERIFIED
- DD_CONTRADICTED_BY_SOURCE
- DD_BLOCKED_SOURCE_GAP
Only DD_VERIFIED may advance to WBS generation.
Update the design artifact registry status accordingly.
Output
Use the active workflow-declared DD verification output path under the current run root.
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.

