docs(product): phase-6 relaunch polish

[mmorerasanchez]

Summary

• v3.5.1 CHANGELOG entry documenting the repo split, registry contract build-out, and new product layout
• Stale src/ path fixes across 25 files — src/index.css → tokens/index.css, src/components/<tier>/ → registry/<tier>/ in AGENTS.md, CLAUDE.md, DESIGN.md, CONTRIBUTING.md, all docs/, public/llms*, and skill/democrito/*
• Consumer-context src/index.css references (e.g. "in your project's src/index.css") left unchanged

Test plan

• npm run build passes: counts 11/18/19/7/48, 110 total registry items (verified locally)
• No generated JSON (design-tokens.json, registry.json, public/r/*) changed as hand-edits
• Spot-check: CLAUDE.md, skill/democrito/SKILL.md, public/llms.txt — all reference tokens/index.css and registry/ paths

🤖 Generated with Claude Code

Summary by CodeRabbit

Release Notes

• Documentation
  • Updated internal documentation to reflect repository structure reorganization.

[coderabbitai]

📝 Walkthrough

Walkthrough

Documentation-only update across ~25 files reflecting the v3.5.1 repository restructure: all references to src/index.css are replaced with tokens/index.css as the design-token source of truth, and all src/components/ paths are replaced with registry/ throughout rules, guides, AI tooling docs, pattern references, skill definitions, and public LLM context files.

Changes

Repo-wide path reference update (src/index.css → tokens/index.css, src/components/ → registry/)

Layer / File(s)	Summary
Changelog and root AI context files CHANGELOG.md, AGENTS.md, CLAUDE.md, CONTRIBUTING.md, DESIGN.md	CHANGELOG records the v3.5.1 restructuring. Root AI context files update token source references, atomic-design directory tables, boundary rules, key-files tables, and commit-scope descriptions to use tokens/index.css and registry/.
AI tooling documentation docs/ai/ai-usage.md, docs/ai/claude-design.md, docs/ai/stitch.md	Agent prompts, onboarding setup instructions, workspace knowledge rules, troubleshooting guidance, and MCP session examples are updated to reference tokens/index.css and registry/{atoms,molecules,organisms,ui}/ paths.
Architecture, design system, and theming docs docs/architecture.md, docs/design-system.md, docs/theming.md, docs/tokens.md	Folder-structure trees, shadcn/ui primitive location rows, token source-of-truth table entries, and typography font-stack guidance are updated to registry/ and tokens/index.css.
Component-level and pattern docs docs/components/*.md, docs/patterns/card.md, docs/patterns/form.md	Every "Directory" and "Source" reference updated from src/components/ to registry/; the organisms showcase section removes the src/components/organisms/ai/ path reference and clarifies non-public-registry status.
Getting-started, migration, and PR template docs/guides/getting-started.md, docs/migration.md, .github/PULL_REQUEST_TEMPLATE.md	Manual install copy steps, Tailwind @theme instructions, migration checklist items, Cursor/Windsurf snippets, and the PR template checklist all updated to reference tokens/index.css.
Public LLM files and skill definitions public/llms*.txt, skill/democrito/SKILL.md, skill/democrito/agent-usage.md, skill/democrito/components.md	All atomic-design directory listings and token source references in LLM context files and skill docs updated to registry/ and tokens/index.css.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

• mmorerasanchez/democrito#52: Added AGENTS.md with the token/component boundary rules and "Key Files" table that this PR now updates to tokens/index.css and registry/.
• mmorerasanchez/democrito#57: Updated CONTRIBUTING.md, DESIGN.md, and CLAUDE.md token/@theme location guidance, directly preceding this PR's same-file path corrections.
• mmorerasanchez/democrito#11: Modified CLAUDE.md to establish src/index.css/@theme as the design-token source, which this PR supersedes by pointing to tokens/index.css.

Poem

🐇 Hop, hop, hopping through the docs today,
Old src/index.css paths swept away!
Now tokens/ holds the colors bright,
And registry/ keeps components right.
Every file tidied, every breadcrumb true —
The warren is restructured, shiny and new! ✨

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The PR title 'docs(product): phase-6 relaunch polish' accurately describes the primary change: documentation updates for a phase 6 product relaunch, as evidenced by the CHANGELOG v3.5.1 entry and systematic path updates across 25 documentation files.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch chore/phase-6-product-polish

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}