Skip to content

docs: refresh CLAUDE.md files against current code and add project skills#61

Open
phil-scott-78 wants to merge 1 commit into
mainfrom
claude/claude-md-skills-review-ude6sh
Open

docs: refresh CLAUDE.md files against current code and add project skills#61
phil-scott-78 wants to merge 1 commit into
mainfrom
claude/claude-md-skills-review-ude6sh

Conversation

@phil-scott-78

Copy link
Copy Markdown
Contributor

The CLAUDE.md files had drifted behind roughly three weeks of feature
work. Refresh every stale claim against the code as it stands:

  • Root: add the five undocumented projects (ApiMetadata,
    ApiMetadata.Reflection, DocSite.Api, TranslationAudit, Templates),
    the five new core namespaces (Data, Head, Favicon, SocialCards,
    StandardSite), docs/cloudflare and the BeyondCookFormat test project;
    rewrite the LlmsTxt entry for the {route}.md Markdown twins and
    .llms.md llms-only pages; complete the diag verb list (books,
    standard-site); extend DI wiring with the new Add
    entry points.
  • src/: drop the deleted scripts/migrate_docs_ordering.py reference,
    add IStandardSiteDocument to the capability list, remove
    BlogSiteContentService from the file-watched examples (it is a
    singleton), note the trailing-edge filewatch debounce.
  • tests/: document the three newer test projects and how their fixture
    shapes diverge from CreateTestService/MockFileSystem.
  • examples/: split the merged BeyondLocale/BeyondTreeSitter table row
    and add the missing EventMicrositeExample row.
  • DocSite: remove the nonexistent DocSiteArticleSlotRenderer, add the
    footer/Pages/blog-integration components, describe ColorTheme.
  • BlogSite: add ContentLayout/ContentWithProseLayout/Pages, mention
    ColorTheme.
  • Docs site: document the *.llms.md agent-only page convention.

Also seed .claude/skills/ (allowlisted in .gitignore) with the first
two project skills: new-example (scaffold + wire an example, including
the docs-coupling and index-table steps) and docs-page (Diataxis
quadrant workflow with front-matter, xref, and :symbol verification
steps).

Co-Authored-By: Claude Fable 5 noreply@anthropic.com
Claude-Session: https://claude.ai/code/session_013iZTT4CmZybHUCsGU38tNn

…ills

The CLAUDE.md files had drifted behind roughly three weeks of feature
work. Refresh every stale claim against the code as it stands:

- Root: add the five undocumented projects (ApiMetadata,
  ApiMetadata.Reflection, DocSite.Api, TranslationAudit, Templates),
  the five new core namespaces (Data, Head, Favicon, SocialCards,
  StandardSite), docs/cloudflare and the BeyondCookFormat test project;
  rewrite the LlmsTxt entry for the {route}.md Markdown twins and
  *.llms.md llms-only pages; complete the diag verb list (books,
  standard-site); extend DI wiring with the new Add* entry points.
- src/: drop the deleted scripts/migrate_docs_ordering.py reference,
  add IStandardSiteDocument to the capability list, remove
  BlogSiteContentService from the file-watched examples (it is a
  singleton), note the trailing-edge filewatch debounce.
- tests/: document the three newer test projects and how their fixture
  shapes diverge from CreateTestService/MockFileSystem.
- examples/: split the merged BeyondLocale/BeyondTreeSitter table row
  and add the missing EventMicrositeExample row.
- DocSite: remove the nonexistent DocSiteArticleSlotRenderer, add the
  footer/Pages/blog-integration components, describe ColorTheme.
- BlogSite: add ContentLayout/ContentWithProseLayout/Pages, mention
  ColorTheme.
- Docs site: document the *.llms.md agent-only page convention.

Also seed .claude/skills/ (allowlisted in .gitignore) with the first
two project skills: new-example (scaffold + wire an example, including
the docs-coupling and index-table steps) and docs-page (Diataxis
quadrant workflow with front-matter, xref, and :symbol verification
steps).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013iZTT4CmZybHUCsGU38tNn
@github-actions

github-actions Bot commented Jul 2, 2026

Copy link
Copy Markdown

🛰️ Docs preview: https://pr-61.pennington-dev.pages.dev

Rebuilt on every push to this PR; torn down when it closes.

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