@auraindustry/aurajs 0.1.1 → 0.1.5

package/templates/skills/aurajs/SKILL.md

@@ -1,96 +0,0 @@
-# AuraJS Skill
-
-Use this skill when building or modifying AuraJS games.
-
-## Read First
-- `docs/external/game-dev-api/start-here.md`
-- `docs/external/game-dev-api/creating-a-new-game.md`
-- `docs/external/game-dev-api/working-with-an-aurajs-project.md`
-- `docs/external/game-dev-api/examples-and-first-game-recipes.md`
-- `docs/external/game-dev-api/common-failures-and-fixes.md`
-
-Then choose the smallest exact-reference page that matches the task:
-
-- `docs/reference/runtime-and-2d-exact-reference.md`
-- `docs/reference/lifecycle-window-input-and-2d-camera-exact-reference.md`
-- `docs/reference/draw2d-assets-audio-storage-and-math-exact-reference.md`
-- `docs/reference/gameplay-systems-exact-reference.md`
-- `docs/reference/animation-scenes-state-tilemaps-and-ecs-exact-reference.md`
-- `docs/reference/3d-rendering-and-content-exact-reference.md`
-- `docs/reference/draw3d-camera-lighting-and-postfx-exact-reference.md`
-- `docs/reference/scene3d-mesh-material-gltf-and-avatar-exact-reference.md`
-- `docs/reference/world-simulation-and-multiplayer-exact-reference.md`
-- `docs/reference/physics3d-terrain-navmesh-character3d-and-compute-exact-reference.md`
-- `docs/reference/net-multiplayer-and-runtime-sessions-exact-reference.md`
-- `docs/reference/tooling-web-and-distribution-exact-reference.md`
-- `docs/reference/project-cli-publish-assets-and-web-exact-reference.md`
-
-Only after that should you open:
-
-- `api-contract.md` (canonical core surface)
-- `api-contract-3d.md` (canonical 3D surface)
-
-Do not load these files end-to-end by default.
-Use targeted reads: jump to the exact namespace/method you are touching, then apply that contract strictly.
-
-## Contract Workflow
-1. Identify the APIs your change touches.
-2. Start with the public start/project docs if the task is about scaffolding, layout, workflow, examples, troubleshooting, or publishing.
-3. Search the smallest exact-reference page that matches the subsystem.
-4. Read only the needed sections of the canonical contract and follow signature + validation + error semantics.
-5. If examples or older convenience docs conflict with contract docs, contract docs win.
-
-## Build Loop
-1. Implement the smallest playable mechanic in `src/main.js`.
-2. Run `npm run dev` for fast iteration.
-3. Validate release behavior with `npm run play`.
-4. Publish with `npm run publish` when the package is ready.
-
-## Project Shape
-- `src/main.js`: thin project entry.
-- `src/runtime/project-registry.js`: source of truth for scenes, screens, prefabs, and config/content files.
-- `src/runtime/app-state.js`: shared mutable app/session state.
-- `src/runtime/scene-registry.js`: runtime adapter generated from the project registry.
-- `src/runtime/app.js`: lifecycle owner.
-- `src/runtime/scene-flow.js`, `screen-shell.js`, `project-inspector.js`: shared runtime helpers.
-- `scenes/*.scene.js`: authored scenes.
-- `ui/*.screen.js`: authored HUD, overlay, and modal screens.
-- `prefabs/*.prefab.js`: canonical prefab descriptors.
-- `config/**`: gameplay defaults and tunables.
-- `content/**`: authored game definitions and starter-owned registries.
-- `assets/**`: game assets.
-
-## Template Sources
-- Starters come from `src/cli/templates/create/<template>/` inside the AuraJS CLI package.
-- Shared runtime helpers come from `src/cli/templates/create/shared/src/runtime/`.
-- Shared starter utilities come from `src/cli/templates/create/shared/src/starter-utils/`.
-- Generated files come from `aura make`, which uses the packaged make templates and self-wires `scene`, `ui-screen`, and `prefab` entries into the project registry.
-
-## Make Surface
-- Core make kinds: `scene`, `ui-screen`, `prefab`, `data`, `system`, `component`, `material`, `shader`.
-- Some starters also add extra nouns through starter catalogs. The deckbuilder starter adds `card`, `enemy`, `relic`, and `encounter`.
-- Prefer `auramaxx make list --json` or `npx aura make list --json` inside the current project instead of assuming starter-specific nouns from generic help output.
-
-## Engine Guardrails
-- Put initialization in `aura.setup`.
-- Put frame-step logic in `aura.update(dt)`.
-- Put rendering in `aura.draw`.
-- Keep rendering API calls in draw-only paths.
-- Use `aura.window.getSize()` for runtime layout.
-- Clamp player/world values to avoid drift.
-
-## Vibe Coding Defaults
-- Start with one loop and one strong interaction.
-- Add juice after core feel works: camera, hit feedback, audio, score.
-- Keep systems loosely coupled so AI agents can modify one mechanic at a time.
-
-## Suggested Project Structure
-- `src/main.js`: primary loop and gameplay systems.
-- `src/runtime/`: runtime shell and project manifest files.
-- `scenes/`: scene modules.
-- `ui/`: screen modules.
-- `prefabs/`: prefab descriptors.
-- `config/`: gameplay defaults and tunables.
-- `content/`: authored game definitions and registries.
-- `assets/`: sprites, audio, fonts.
-- `skills/`: agent workflows and contract references.

package/templates/skills/aurajs/api-contract-3d.md

@@ -1,7 +0,0 @@
-# AuraJS API Contract (3D)
-
-Canonical source:
-- `../../docs/api-contract-3d.md`
-
-Published snapshots copy that canonical contract into this file path.
-For agent work, use targeted section reads on the exact APIs you touch.

package/templates/skills/aurajs/api-contract.md

@@ -1,7 +0,0 @@
-# AuraJS API Contract (Core)
-
-Canonical source:
-- `../../docs/api-contract.md`
-
-Published snapshots copy that canonical contract into this file path.
-For agent work, use targeted section reads on the exact APIs you touch.