Skip to content

docs: add CLAUDE.md codebase guide - #6

Open
HeadyMe wants to merge 1 commit into
mainfrom
claude/claude-md-docs-rib1gy
Open

docs: add CLAUDE.md codebase guide#6
HeadyMe wants to merge 1 commit into
mainfrom
claude/claude-md-docs-rib1gy

Conversation

@HeadyMe

@HeadyMe HeadyMe commented Jul 9, 2026

Copy link
Copy Markdown
Collaborator

Adds a concise CLAUDE.md (40 lines) documenting this static GitHub Pages site for AI assistants. Every claim was verified against the actual files:

  • Identity: plain HTML/CSS/JS site serving heady-ai.com (from CNAME) — no framework, build step, or CI.
  • Layout: table covering index.html, the self-contained docs/index.html, shared/css/heady-base.css (phi-scaled shared design system), JS stubs, robots.txt, sitemap.xml — including a note that two sitemap entries (/experiments, /products) have no corresponding files.
  • Runtime integrations: Sentry SDK, __HEADY_SITE_META__/__HEADY_AUTH_CONFIG__ globals, auth widget (auth.headysystems.com), HeadyBuddy chat FAB (manager.headysystems.com), plus the HEA-231 regression guard (CSS :hover only — no inline onmouseover in innerHTML).
  • Conventions: canonical hyphenated domain heady-ai.com, root-absolute /shared/... asset paths, keep sitemap/canonical/OG/JSON-LD in sync.
  • Editing/testing: serve repo root with any static server; deploys automatically via GitHub Pages.

🤖 Generated with Claude Code

https://claude.ai/code/session_01573PzxAEmKYg2P165FgKJn


Generated by Claude Code

Documents what the repo is (static GitHub Pages site for heady-ai.com),
the file layout (index.html landing page, self-contained docs page,
shared phi-based design system CSS and JS stubs), runtime integrations
(Sentry, Heady auth widget, HeadyBuddy chat FAB), and editing
conventions (canonical hyphenated domain, sitemap sync, no build step).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01573PzxAEmKYg2P165FgKJn
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.

2 participants