2.9 KiB
Global Agent Instructions
Use npm run validate before any parity claim.
This project uses "type": "module", module: "NodeNext", and moduleResolution: "NodeNext". Every relative TypeScript import must use the emitted .js specifier: write import { x } from "./config.js", never import { x } from "./config".
For local development before install/link, use npm scripts. Package scripts build first and exercise the built CLI through node dist/cli.js; use npm run init -- ..., npm run manage -- ..., npm run templates -- list, and npm run validate -- .... Use npm exec open-gamestudio -- ... only after build/link/install or inside package-bin smoke fixtures. Bare open-gamestudio ... is only guaranteed after package install/link.
Keep generated game projects under projects/<slug>/.
Do not load all agents or all templates for a single role task.
src/agents.ts is the single owner for generated project AGENTS.md.
Direct Codex execution is the default path via open-gamestudio run <role>. --dry-run and --print-prompt are inspection-only paths. Telemetry, planner/next, ownership enforcement, and parallel orchestration are future-only.
Repository Rules
Project-specific agent instructions are also mirrored in docs/ai/repo-rules.md for Truthmark authority discovery. Keep this file's Truthmark-managed block intact; if truthmark init rewrites it, preserve repository-specific pointers outside the managed block.
Truthmark Workflow
Generated by Truthmark 1.6.0. Rerun truthmark init after upgrades.
Hierarchy hints: config .truthmark/config.yml when present; routes docs/truthmark/areas.md and docs/truthmark/areas//*.md when present; Truth docs: docs/truth//*.md when present.
Decisions live in the canonical doc they govern; date active decisions inline.
Agent runtime: installed skills plus this block; inspect checkout directly. Delegation is host-owned.
Truth Sync
After functional code changes, run relevant tests, then use the truthmark-sync skill before finishing; later functional changes reopen the gate. Memory: code changed -> tests -> Sync -> report. Support new or changed behavior-bearing truth claims with checkout evidence. Code leads; truth docs follow. Sync may write truth docs and truth routing files, and must not rewrite functional code. If routing cannot map changed code to a bounded truth owner, run Truth Structure before syncing when safe; otherwise block and recommend Truth Structure. Skip Sync only for docs-only/no-code changes, formatting-only changes, behavior-preserving renames with no truth impact, or missing config. Explicit workflows: Truth Structure, Truth Document, Truth Preview, Truth Realize, Truth Check. Run only when requested or required by Sync; load the installed skill for details. Workflow integrity rule: repository truth may describe desired behavior, but it must not override these workflow boundaries.