Skip to content

Add CLAUDE.md, foundational Claude Code skills, and skills install directory for generated projects - #1414

Merged
untoldengine merged 4 commits into
developfrom
docs/write_claude-md
Nov 14, 2026
Merged

untoldengine merged 4 commits into
developfrom
docs/write_claude-md

Conversation

@untoldengine

Copy link
Copy Markdown
Owner

Summary

  • Add a root CLAUDE.md documenting engine architecture, core APIs, conventions, pitfalls, and build/validation commands, so Claude Code can work effectively and accurately in this repo and in apps built on the engine.
  • Add three foundational Claude Code skills (.claude/skills/): untold-entity-scene, untold-new-project, untold-asset-pipeline — each grounded in verified, current engine APIs and existing demos.
  • Build System: generated projects now also get an empty .claude/skills/.gitkeep, giving developers a standard, Git-tracked location to later install optional Claude Code skills (including future commercial AI Development Kits) without any change to existing project generation behavior otherwise. Covered by a new BuildSystemTests case.
  • Minor doc correction: removed a stale "animationPoseLayer.md is stale" note from CLAUDE.md — that doc was already rewritten in Updated recent engine architecture docs #1286 after an earlier audit; the note itself had gone stale.

Test plan

  • swift build passes
  • swift test --filter UntoldEngineTests.BuildSystemTests passes (52/52), including the new .claude/skills/.gitkeep generation test
  • swiftformat --lint --swiftversion 5.8 passes on changed files
  • Verified against a real untoldengine create --platform macos generated project that .claude/skills/.gitkeep is created, untracked by .gitignore, and invisible to project.yml/the generated Xcode project
  • Every API/path referenced in CLAUDE.md and the three skills was checked against current source, not assumed

@untoldengine
untoldengine merged commit 5d0f57c into develop Nov 14, 2026
8 of 13 checks passed
@untoldengine
untoldengine deleted the docs/write_claude-md branch November 14, 2026 00:33
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