docs: post-split accuracy fixes

[mmorerasanchez]

Summary

• Remove stale src/pages/ references (Pages live in the site repo, not the product registry)
• Remove all barrel index.ts references (shadcn installs components individually; no barrels exist)
• Fix src/test/ → tests/ in contributor workflow (CONTRIBUTING.md, getting-started.md)
• Remove src/examples/prompt-x/ path references from organisms/molecules docs (examples live in democrito-site)
• Fix theming.md rebranding steps: src/index.css → tokens/index.css (democrito's own token file)
• Regenerate skill/democrito/components.md and skill/democrito/agent-usage.md from fixed sources

Files changed

13 files — CLAUDE.md, AGENTS.md, CONTRIBUTING.md, docs/ai/README.md, docs/components/molecules.md, docs/components/organisms.md, docs/guides/getting-started.md, docs/reference/architecture.md, docs/reference/design-system.md, docs/reference/theming.md, skill/democrito/SKILL.md, skill/democrito/agent-usage.md, skill/democrito/components.md

Test plan

• npm run build — clean, counts 11/18/19/7/48, 125 green tests
• git grep -nE "src/pages|src/examples|barrel|index\.ts barrel" — empty (only expected consumer-side ref remains in quick-start-designer.md)
• git grep -nE "src/index\.css" -- 'docs/reference/theming.md' — empty

🤖 Generated with Claude Code

Summary by CodeRabbit

• Documentation
  • Simplified Atomic Design architecture by removing the Pages level from the design system structure.
  • Removed barrel export requirement from the component contribution workflow, streamlining the submission process.
  • Clarified that prompt-x example components are sourced from an external repository and not part of the public registry.
  • Updated file paths and references across guides for consistency.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 02f73be2-fef1-4adf-8d52-585c5ded34a7

📥 Commits

Reviewing files that changed from the base of the PR and between dd751ed and b89ee54.

📒 Files selected for processing (13)

• AGENTS.md
• CLAUDE.md
• CONTRIBUTING.md
• docs/ai/README.md
• docs/components/molecules.md
• docs/components/organisms.md
• docs/guides/getting-started.md
• docs/reference/architecture.md
• docs/reference/design-system.md
• docs/reference/theming.md
• skill/democrito/SKILL.md
• skill/democrito/agent-usage.md
• skill/democrito/components.md

---

📝 Walkthrough

Walkthrough

Documentation-only updates across 12 files removing the Pages level from Atomic Design tables, eliminating barrel index.ts export requirements from all convention/rule references, redirecting prompt-x example component descriptions from src/examples/prompt-x/ to the democrito-site repo, removing the Showcase Pages section from the design-system reference, and updating font token file path references from src/index.css to tokens/index.css.

Changes

Documentation Convention Updates

Layer / File(s)	Summary
Remove Pages level and barrel exports from agent/AI rule files AGENTS.md, CLAUDE.md, skill/democrito/SKILL.md, skill/democrito/agent-usage.md, docs/ai/README.md	Pages row removed from Atomic Design tables; barrel index.ts export guidance removed from rules/conventions sections across all agent and AI compact-token reference files.
Update contribution workflow: remove barrel export step and fix test path CONTRIBUTING.md, docs/guides/getting-started.md	"Update the barrel export" step removed from the contribution workflow; barrel-export and showcase-page checklist items removed; test file path updated from src/test/ to tests/; section numbers adjusted.
Remove barrel index.ts from folder tree and Showcase Pages section from reference docs docs/reference/architecture.md, docs/reference/design-system.md	Per-directory index.ts lines removed from the folder structure example across atoms, molecules, organisms, and templates; the entire Showcase Pages section removed and Changelog renumbered.
Redirect prompt-x examples to democrito-site repo docs/components/molecules.md, docs/components/organisms.md, skill/democrito/components.md	Prompt-x example molecules and organisms now described as sourced from the democrito-site repo and not part of the public registry, replacing src/examples/prompt-x/ path references and barrel-export phrasing.
Update font token file path in theming docs docs/reference/theming.md	Four references to src/index.css updated to tokens/index.css in the Font Families instruction, Example A/B CSS comments, and the rebranding checklist step.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

• mmorerasanchez/democrito#48: Introduced AGENTS.md content for the /ai pages flow, directly tied to the removal of the Pages Atomic Design level and index.ts barrel-export guidance in this PR.

Poem

🐇 No more barrels to roll and fill,
No Pages level climbing up the hill.
The democrito-site holds examples now,
tokens/index.css takes its bow.
Four levels tidy, docs all align —
This rabbit hops forward, feeling just fine! ✨

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/phase-7-accuracy

---

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.}