Imported from GiantCroissant-Lunar/fantasim-app-godot (
AGENTS.md). Install upstream withnpx skills add GiantCroissant-Lunar/fantasim-app-godot. Copyright stays with the author.
AGENTS.md — fantasim-app-godot agent rules
Entry point for agent rules in this project. CLAUDE.md is a thin @AGENTS.md pointer;
other CLI agents read AGENTS.md directly. This file is hand-maintained — the source of
truth — and points to the rules and skills under .agent/ instead of restating them.
Docs — vault/
Project documentation lives under vault/ — see vault/README.md for the
taxonomy: architecture/ (evergreen design) · specs/ (dated concept-lock) · plans/
(implementation) · handover/ (session records). Write new specs/plans/handovers there;
superpowers writing-plans / spec output should target vault/plans and vault/specs
(not docs/superpowers/).
Look / presentation work: vault/reference/README.md is the
binding registry of user-given visual references (deposited pixels + verbal specs). Read
it BEFORE any look proposal or look gate; entries bind even when a file is MISSING, and every
look render is judged against them by the user's eye — never claim no reference exists, and
deposit any new user-given reference artifact there in the same session it is given.
Rules — .agent/rules/
- bundle-hot-reload-verify — 4-tier, bundle-oriented:
first bind verification to the intended worktree, commit, absolute executable, and PID; then
hot-reload a changed collectible plugin and require both lifecycle logs (
old ALC collected) and a fresh stable-scene screenshot plus representative interaction from that same PID. Duplicate exports are a stop-and-ask condition, never a display-name guess. Full build + exact-path relaunch is required for changes outside a collectible ALC. - no-smoke-or-fake-production-code — keep smoke checks, fake/demo assets, and verification-only harnesses out of production runtime composition; use tests/tools/harnesses for proofs, and keep app startup/config tied to real product concepts.
Skills — .agent/skills/
Deployed into .claude/skills/ and .agents/skills/ by the sync (task agent:sync:repo -- yokan-projects/fantasim-app-godot from the workspace root). Use the one matching your task.
- verify-windowed — the full hot-reload verification loop, exact worktree/executable/PID identity gate, reload-vs-relaunch decision table, and conjunctive lifecycle plus screenshot/interaction evidence.