Claude
|
8d1f2dec97
|
feat(markdown-html): add v2.10.0 foundation — orchestrator + design-system
Operationalizes Shihipar's "Claude Code HTML output" essay (Medium, 2026):
markdown collapses past ~100 lines for agent-generated artifacts; HTML
restores density, clarity, shareability, and lightweight interaction.
This foundation PR ships 2 of 5 planned skills:
- markdown-html-orchestrator (context: fork): deterministic doctype
classifier scoring filename hints + content signals across DOCUMENT /
REVIEW / SLIDES; silent-routes above two-signal threshold; refuses
inputs < 100 lines per Shihipar; refuses without design-system
onboarding. 3 stdlib tools: doctype_classifier.py, route_explainer.py
(the never-silently-chain enforcer + onboarding gate), and
output_path_resolver.py (kebab slug + collision suffix).
- design-system: one-time onboarding wizard (10 questions for brand
primary/accent HEX + heading + body Google Fonts + editorial/technical/
minimal/playful style + default output dir + syntax theme + TOC
behavior + optional logo/company). WCAG-AA-validated 12 CSS custom
properties derived in HSL space; refuses to save if body-text or link
contrast fails 4.5:1, or if the output dir is unwritable. Pattern
lifted from research-ops/skills/clinical-research/scripts/ (onboard.py
+ config_loader.py shape) and marketing/landing/scripts/
(brand_palette_validator.py WCAG + HSL math). Precedence: project >
global > defaults; MARKDOWN_HTML_NO_CONFIG=1 bypasses.
Plus cs-markdown-html-orchestrator agent, 3 slash commands
(/cs:markdown-html router, /cs:grill-markdown-html 5-question grill,
/cs:design-system onboarding surface), 6 reference docs each citing 5-7
authoritative sources (Tufte, Shihipar, Bret Victor, Maggie Appleton,
Bartosz Ciechanowski, Amelia Wattenberger; WCAG 2.2, Ellen Lupton,
Adobe Spectrum, Sara Soueidan, Material Design 3), 1 JSON schema asset,
domain README + CLAUDE.md.
Converter sub-skills (md-document, md-review, md-slides) land in v2.10.1
follow-up PRs. All three will import design-system/scripts/config_loader.py
for shared brand tokens.
Repo-level updates: scripts/sync-codex-skills.py SKILL_DOMAINS adds
markdown-html → documentation category; .claude-plugin/marketplace.json
adds markdown-html-skills plugin entry (63 → 64 plugins, 16 → 17
domains); root CLAUDE.md gets nav-map row, structure-tree entry, and
v2.10.0 release-notes block.
Validation:
- check_plugin_json.py → OK
- sync-codex-skills.py --dry-run → 2 new symlinks, total 338 → 340
- skill_description_validator.py → PASS on both SKILL.md files
- skill_review_checklist_runner.py → 5/6 PASS (under-100-lines advisory
fires; same as research-ops orchestrator)
- All 6 Python tools smoke-tested with --help and --sample
- End-to-end onboarding round-trip works (--defaults, --set, --reset)
- WCAG-fail hard refusal fires correctly on impossible color combos
- Classifier on the repo's own CLAUDE.md correctly returns
needs-clarification (15 vs 13 — document signals tie with slides
signals because of multiple --- HRs); orchestrator asks rather than
silently chains.
Distinct from Anthropic's official Playground plugin (interactive
prompt-tuning controls with sliders/knobs/prompt-copy-back) and from
marketing/landing/ (landing-page generator from scratch).
https://claude.ai/code/session_01BK2KoQot1U7J5oSosrCQdc
|
2026-05-29 14:19:06 +00:00 |
|