You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
fix(docs): 'docs build' shouldn't dump empty 571-line boilerplate when no CSpecs exist #16
Running `bridge-ds docs build` on a fresh-scaffolded repo (KB extracted, zero CSpecs) produces ~571 lines of doc per component × 92 components = a forest of empty Handlebars sections ("How to use", "When NOT to use", "Props", "Variants", "Do/Don't", "Accessibility" — all blank placeholders).
The user has no signal that the docs are empty by design. They ship boilerplate that has to be wiped.
Root cause
The docs renderer falls back to "dump everything generic" when no CSpec is bound to a component. CSpecs are produced organically via the `make` / `fix` / `done` cycle, so on day one of a fresh repo there are zero of them.
Fix (proposed)
Hard-fail with guidance when zero CSpecs exist:
```
$ bridge-ds docs build
Error: No CSpecs found in knowledge-base/cspecs/
Bridge docs grow organically as you design. To document a component:
bridge make Button → produces a CSpec + Figma output
bridge done → ships + archives the CSpec
bridge-ds docs build → renders docs for that component
Run 'bridge make ' first.
```
Skip components without a CSpec when at least one exists. The output should only contain components that have a CSpec. No template dumps.
Activity
docs(v6): elevate hard rules to <IRON-LAW> markers (superpowers borro…
v6.0.0 — cleanup release (#17)