Skip to content

docs(ai): AI context layer consistency fixes#81

Merged
mmorerasanchez merged 1 commit into
mainfrom
docs/ai-context-consistency
Jun 18, 2026
Merged

docs(ai): AI context layer consistency fixes#81
mmorerasanchez merged 1 commit into
mainfrom
docs/ai-context-consistency

Conversation

@mmorerasanchez

Copy link
Copy Markdown
Owner

Summary

  • Fix 1 (skill install): Replace nonexistent /skills add command with cp -R skill/democrito ~/.claude/skills/ in docs/ai/README.md and docs/ai/terminal.md
  • Fix 2 (git workflow): Rewrite CLAUDE.md git-workflow section — remove "Internal changes commit directly to main", align with AGENTS.md branch+PR+review policy (never self-merge)
  • Fix 3 (DESIGN.md links): Fix broken ../DESIGN.md../../DESIGN.md in docs/ai/claude-design.md and docs/ai/stitch.md (resolves to nonexistent docs/DESIGN.md)
  • Fix 4 (example drift): Complete atom example lists to all 11 (Code, CodeBlock, CopyButton, Heading, Kbd, Link, Logo, Spinner, StatusBadge, Tag, Text) in CLAUDE.md and SKILL.md; align molecule/organism/template examples between both files; remove hardcoded 11/18/19/7 count from terminal.md
  • Fix 5 (AGENTS.md missing): Add AGENTS.md row to context-layer table in docs/ai/README.md plus a CLAUDE.md-vs-AGENTS.md precedence note
  • Fix 6 (warm/dark ambiguity): Add explicit precedence line to DESIGN.md "A note on theme identity" — code default = Warm (:root); demo/screenshot default = Dark; when unsure, Warm
  • Fix 7 (light background drift): Correct stale light --background value 30 5% 96%30 6% 93% in two places in DESIGN.md (aligns with tokens/index.css line 418)

Skill files regenerated from sources (skill/democrito/agent-usage.md updated via npm run build).

Test plan

  • npm run build — regenerates skill files, all counts pass (11/18/19/7/48)
  • npm test — 125 tests green
  • git grep "/skills add" -- '*.md' → empty
  • git grep "\(\.\./DESIGN\.md\)" -- 'docs/ai/*.md' → empty
  • git grep "30 5% 96" -- 'DESIGN.md' → empty
  • CLAUDE.md Git Workflow section no longer contains the permissive "commit directly to main" instruction

🤖 Generated with Claude Code

…GN.md links, count/example drift

- Fix 1: replace nonexistent `/skills add` with `cp -R skill/democrito ~/.claude/skills/` in README.md and terminal.md
- Fix 2: rewrite CLAUDE.md git-workflow section — remove "commit directly to main", align with AGENTS.md branch+PR policy
- Fix 3: correct broken `../DESIGN.md` → `../../DESIGN.md` in docs/ai/claude-design.md and docs/ai/stitch.md
- Fix 4: complete atom lists to all 11 (Code, CodeBlock, CopyButton, Heading, Kbd, Link, Logo, Spinner, StatusBadge, Tag, Text) in CLAUDE.md and SKILL.md; align molecule/organism/template examples between files; remove hardcoded 11/18/19/7 count from terminal.md
- Fix 5: add AGENTS.md row to context-layer table in docs/ai/README.md + precedence note
- Fix 6: add explicit warm/dark/unsure precedence line to DESIGN.md "A note on theme identity"
- Fix 7: correct stale light --background value 30 5% 96% → 30 6% 93% (matches tokens/index.css) in two places in DESIGN.md
- Regenerate skill/democrito/agent-usage.md from updated docs/ai/ sources

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Jun 18, 2026

Copy link
Copy Markdown

Warning

Review limit reached

@mmorerasanchez, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 37 minutes and 8 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based credits.

🚦 How do rate limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan refill rate.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, the refill rate gradually slows as usage increases. The highest same-day bursts are limited more strictly.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 0907f839-b214-47d4-819d-e0a70e041451

📥 Commits

Reviewing files that changed from the base of the PR and between 222679b and 7315c74.

📒 Files selected for processing (8)
  • CLAUDE.md
  • DESIGN.md
  • docs/ai/README.md
  • docs/ai/claude-design.md
  • docs/ai/stitch.md
  • docs/ai/terminal.md
  • skill/democrito/SKILL.md
  • skill/democrito/agent-usage.md
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/ai-context-consistency

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

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

@mmorerasanchez mmorerasanchez merged commit b4e7201 into main Jun 18, 2026
2 checks passed
@mmorerasanchez mmorerasanchez deleted the docs/ai-context-consistency branch June 18, 2026 12:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant