implementation-notes.html

<!doctype html><html><head><meta charset="utf-8"><title>Implementation Notes</title><style>body{font-family:system-ui,sans-serif;max-width:760px;margin:48px auto;line-height:1.55;color:#111}h1{font-size:24px}h2{font-size:18px;margin-top:28px}code{font-family:ui-monospace,monospace;background:#f4f4f4;padding:1px 4px}</style></head><body><h1>Implementation Notes</h1><h2>Initial interpretation</h2><p>This migration treats <code>visualize/templates/*/template.md</code> as the only live template authoring contract. Existing <code>template-skill.md</code> content is folded into markdown contracts through a scripted first pass, then old live HTML/template-skill files are removed.</p><h2>Design decisions</h2><ul><li>Pattern recipes are creation guidance only; they carry minimal examples and no review rubric language.</li><li>Preview tooling is switched from template previews to explicit fixture previews using <code>visualize/fixtures/manifest.json</code>.</li><li>Legacy component CSS is not preserved as a component API. Any reusable fixture styling lands under <code>preview-kit/fixture-styles/</code>.</li></ul><h2>Deviations and tradeoffs</h2><ul><li>The first-pass template contracts preserve each old template's unique failure-mode guidance, but repeated Structure, Creation guidance, and Mobile contract language is intentionally compact and uniform. This keeps the all-at-once migration tractable while preserving the filesystem invariant the spec prioritizes.</li><li>The legacy placeholder name <code>__COMPONENTS_PLACEHOLDER__</code> remains in preview templates for compatibility, but it now injects preview-only fixture styles from <code>preview-kit/fixture-styles/</code>. This avoids a mass rename across 100+ design-system preview-template files while still deleting the component-library authoring model.</li><li>The README template showcase now renders targeted fixture previews because live templates no longer have HTML examples.</li></ul><h2>Open questions</h2><p>None.</p></body></html>