Skip to content

docs(ai): per-tool AI docs + warm-default fix#78

Merged
mmorerasanchez merged 1 commit into
mainfrom
chore/phase-7-docs-ai
Jun 18, 2026
Merged

docs(ai): per-tool AI docs + warm-default fix#78
mmorerasanchez merged 1 commit into
mainfrom
chore/phase-7-docs-ai

Conversation

@mmorerasanchez

Copy link
Copy Markdown
Owner

Summary

  • Rename docs/ai/ai-context.mddocs/ai/README.md (now the ai/ index with entry point + compact token reference)
  • Fix stale "dark-first" claim → warm (:root) is the default theme; dark and light are the named variants
  • Decompose docs/ai/ai-usage.md monolith into 4 focused tool files:
    • terminal.md — Claude Code setup, skill install, Cowork planning tool
    • lovable.md — two-tier knowledge architecture, GitHub sync, example prompts
    • replit.md — Replit + v0/Bolt/web tools (paste compact token ref approach)
    • cursor.md — Cursor/Windsurf IDE agent setup
  • Keep claude-design.md and stitch.md unchanged (they're the authoritative deep guides; §2 and §5 in ai-usage were just summaries pointing to them)
  • Update all reference links in CLAUDE.md, AGENTS.md, DESIGN.md, docs/README.md, docs/guides/*, docs/reference/*
  • Fix additional stale docs/tokens.mddocs/reference/tokens.md paths found in DESIGN.md and AGENTS.md (missed in PR1 since those are root-level files, not under docs/)

Test plan

  • npm test — 125 tests passing (4 suites)
  • grep -rn "ai-usage\.md\|ai-context\.md" --include=*.md → empty for public docs
  • All 6 tool files present in docs/ai/: README, terminal, lovable, replit, cursor, claude-design, stitch
  • docs/README.md AI Integration section links to all 7 ai/ files

🤖 Generated with Claude Code

- Rename docs/ai/ai-context.md → docs/ai/README.md (ai context layer index)
- Fix stale dark-first claim → warm is the default theme (:root)
- Move shared AI context layer intro + Compact Token Reference into README
- Add per-tool guide links table to README
- Create docs/ai/terminal.md (Claude Code + Cowork)
- Create docs/ai/lovable.md (two-tier knowledge, GitHub sync, example prompts)
- Create docs/ai/replit.md (Replit + v0/Bolt paste-token approach)
- Create docs/ai/cursor.md (Cursor/Windsurf IDE agents)
- Delete docs/ai/ai-usage.md monolith (§2 Claude Design and §5 Stitch already fully covered by their deep guides)
- Update all reference links in CLAUDE.md, AGENTS.md, DESIGN.md, docs/README.md, docs/guides/*, docs/reference/* to new paths
- Fix additional stale doc paths in DESIGN.md and AGENTS.md (docs/tokens.md → docs/reference/tokens.md etc.)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@mmorerasanchez mmorerasanchez merged commit a175dc3 into main Jun 18, 2026
1 check passed
@mmorerasanchez mmorerasanchez deleted the chore/phase-7-docs-ai branch June 18, 2026 10:46
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