{"owner":"pascalorg","repo":"editor","hasSkills":true,"hasMcp":false,"mcpConfig":null,"found":["AGENTS.md"],"skills":{"AGENTS.md":"# Agent Instructions — `pascalorg/editor`\n\nPublic, open-source home of `@pascal-app/{core,viewer,editor,mcp}` and the standalone editor app. Consumed both as npm packages and (in `pascalorg/private-editor`) as a git submodule.\n\n## Repo Shape\n\n| Path | Purpose |\n|---|---|\n| `packages/core` | Scene graph, node schemas, stores, event bus, core systems — pure logic, no Three.js |\n| `packages/viewer` | Standalone 3D canvas: renderers, viewer systems, presentation state |\n| `packages/editor` | Editor UI components reused by the standalone app and embedders |\n| `packages/mcp` | MCP server and scene storage adapters |\n| `apps/editor` | Standalone editor app — composes `viewer` + `editor` + tools |\n\n## Where to look\n\n- **Architecture rules** — `wiki/architecture/` (read on demand; index in `wiki/architecture/README.md`).\n- **Skills (ready workflows)** — `.agents/skills/<name>/SKILL.md`. Same content is reachable as `.claude/skills/`, `.cursor/skills/`, `.codex/skills/` (symlinks to `.agents/skills/`).\n- **Repo orientation for humans** — `README.md`, `SETUP.md`, `CONTRIBUTING.md`.\n\n`CLAUDE.md`, `GEMINI.md`, and `.github/copilot-instructions.md` are symlinks to this file. Codex reads this file directly.\n\n## Layer Boundaries (read once, internalise)\n\n- **`packages/core`** owns domain data and pure logic. It must not import Three.js, `packages/viewer`, `apps/editor`, rendering/UI concepts, tools, modes, phases, or view-specific concepts such as floorplan or paint preview.\n- **`packages/viewer`** owns the standalone 3D canvas, renderers, viewer systems, and genuine presentation state. It must not know about `useEditor`, editor tools, phases, modes, paint mode, floorplan state, or editor-only presentation vocabulary.\n- **`apps/editor`** owns the editing experience: tools, `useEditor`, panels, floorplan helpers, paint mode, keyboard shortcuts, command palette, action menus, cursor badges, and editor-only overlays. Editor features are injected into `<Viewer>` via props and children.\n\nDetails, examples, and rationale live in `wiki/architecture/layers.md`, `wiki/architecture/viewer-isolation.md`, `wiki/architecture/systems.md`, `wiki/architecture/renderers.md`, `wiki/architecture/tools.md`.\n\n## When making architecture-sensitive changes\n\nRead the relevant page in `wiki/architecture/` **before** writing code. The page list lives in `wiki/architecture/README.md`. As a minimum:\n\n- Adding a node type → `node-schemas.md`, `renderers.md`, `systems.md`\n- Adding a tool → `tools.md`, `spatial-queries.md`, `events.md`\n- Adding / changing a placement or move interaction → `tools.md` (\"2D ↔ 3D behavioral parity\": applicable behaviors must exist in both views; port the change to the sibling 2D/3D file in the same PR)\n- Adding a system → `systems.md`, `scene-registry.md`\n- Anything in `packages/viewer` → `viewer-isolation.md`, `layers.md`\n- Anything touching selection → `selection-managers.md`, `scene-registry.md`, `events.md`\n\n## When reviewing a PR\n\nInvoke the `review-architecture` skill (`.agents/skills/review-architecture/SKILL.md`). It loads the required architecture pages, fetches the diff, classifies each new file by layer, and reports findings grouped by severity.\n\n## Operating rules\n\n- Read the full file before editing. Plan all changes, then make one complete edit.\n- When the user corrects you, stop and re-read their message.\n- After two consecutive tool failures, stop and change approach.\n- Don't introduce backwards-compatibility shims, dead code, or speculative abstractions.\n- Don't write new comments unless they explain a non-obvious *why*.\n"},"files":{"AGENTS.md":"# Agent Instructions — `pascalorg/editor`\n\nPublic, open-source home of `@pascal-app/{core,viewer,editor,mcp}` and the standalone editor app. Consumed both as npm packages and (in `pascalorg/private-editor`) as a git submodule.\n\n## Repo Shape\n\n| Path | Purpose |\n|---|---|\n| `packages/core` | Scene graph, node schemas, stores, event bus, core systems — pure logic, no Three.js |\n| `packages/viewer` | Standalone 3D canvas: renderers, viewer systems, presentation state |\n| `packages/editor` | Editor UI components reused by the standalone app and embedders |\n| `packages/mcp` | MCP server and scene storage adapters |\n| `apps/editor` | Standalone editor app — composes `viewer` + `editor` + tools |\n\n## Where to look\n\n- **Architecture rules** — `wiki/architecture/` (read on demand; index in `wiki/architecture/README.md`).\n- **Skills (ready workflows)** — `.agents/skills/<name>/SKILL.md`. Same content is reachable as `.claude/skills/`, `.cursor/skills/`, `.codex/skills/` (symlinks to `.agents/skills/`).\n- **Repo orientation for humans** — `README.md`, `SETUP.md`, `CONTRIBUTING.md`.\n\n`CLAUDE.md`, `GEMINI.md`, and `.github/copilot-instructions.md` are symlinks to this file. Codex reads this file directly.\n\n## Layer Boundaries (read once, internalise)\n\n- **`packages/core`** owns domain data and pure logic. It must not import Three.js, `packages/viewer`, `apps/editor`, rendering/UI concepts, tools, modes, phases, or view-specific concepts such as floorplan or paint preview.\n- **`packages/viewer`** owns the standalone 3D canvas, renderers, viewer systems, and genuine presentation state. It must not know about `useEditor`, editor tools, phases, modes, paint mode, floorplan state, or editor-only presentation vocabulary.\n- **`apps/editor`** owns the editing experience: tools, `useEditor`, panels, floorplan helpers, paint mode, keyboard shortcuts, command palette, action menus, cursor badges, and editor-only overlays. Editor features are injected into `<Viewer>` via props and children.\n\nDetails, examples, and rationale live in `wiki/architecture/layers.md`, `wiki/architecture/viewer-isolation.md`, `wiki/architecture/systems.md`, `wiki/architecture/renderers.md`, `wiki/architecture/tools.md`.\n\n## When making architecture-sensitive changes\n\nRead the relevant page in `wiki/architecture/` **before** writing code. The page list lives in `wiki/architecture/README.md`. As a minimum:\n\n- Adding a node type → `node-schemas.md`, `renderers.md`, `systems.md`\n- Adding a tool → `tools.md`, `spatial-queries.md`, `events.md`\n- Adding / changing a placement or move interaction → `tools.md` (\"2D ↔ 3D behavioral parity\": applicable behaviors must exist in both views; port the change to the sibling 2D/3D file in the same PR)\n- Adding a system → `systems.md`, `scene-registry.md`\n- Anything in `packages/viewer` → `viewer-isolation.md`, `layers.md`\n- Anything touching selection → `selection-managers.md`, `scene-registry.md`, `events.md`\n\n## When reviewing a PR\n\nInvoke the `review-architecture` skill (`.agents/skills/review-architecture/SKILL.md`). It loads the required architecture pages, fetches the diff, classifies each new file by layer, and reports findings grouped by severity.\n\n## Operating rules\n\n- Read the full file before editing. Plan all changes, then make one complete edit.\n- When the user corrects you, stop and re-read their message.\n- After two consecutive tool failures, stop and change approach.\n- Don't introduce backwards-compatibility shims, dead code, or speculative abstractions.\n- Don't write new comments unless they explain a non-obvious *why*.\n"},"items":[{"name":"AGENTS.md","path":"AGENTS.md","title":"AGENTS.md","content":"# Agent Instructions — `pascalorg/editor`\n\nPublic, open-source home of `@pascal-app/{core,viewer,editor,mcp}` and the standalone editor app. Consumed both as npm packages and (in `pascalorg/private-editor`) as a git submodule.\n\n## Repo Shape\n\n| Path | Purpose |\n|---|---|\n| `packages/core` | Scene graph, node schemas, stores, event bus, core systems — pure logic, no Three.js |\n| `packages/viewer` | Standalone 3D canvas: renderers, viewer systems, presentation state |\n| `packages/editor` | Editor UI components reused by the standalone app and embedders |\n| `packages/mcp` | MCP server and scene storage adapters |\n| `apps/editor` | Standalone editor app — composes `viewer` + `editor` + tools |\n\n## Where to look\n\n- **Architecture rules** — `wiki/architecture/` (read on demand; index in `wiki/architecture/README.md`).\n- **Skills (ready workflows)** — `.agents/skills/<name>/SKILL.md`. Same content is reachable as `.claude/skills/`, `.cursor/skills/`, `.codex/skills/` (symlinks to `.agents/skills/`).\n- **Repo orientation for humans** — `README.md`, `SETUP.md`, `CONTRIBUTING.md`.\n\n`CLAUDE.md`, `GEMINI.md`, and `.github/copilot-instructions.md` are symlinks to this file. Codex reads this file directly.\n\n## Layer Boundaries (read once, internalise)\n\n- **`packages/core`** owns domain data and pure logic. It must not import Three.js, `packages/viewer`, `apps/editor`, rendering/UI concepts, tools, modes, phases, or view-specific concepts such as floorplan or paint preview.\n- **`packages/viewer`** owns the standalone 3D canvas, renderers, viewer systems, and genuine presentation state. It must not know about `useEditor`, editor tools, phases, modes, paint mode, floorplan state, or editor-only presentation vocabulary.\n- **`apps/editor`** owns the editing experience: tools, `useEditor`, panels, floorplan helpers, paint mode, keyboard shortcuts, command palette, action menus, cursor badges, and editor-only overlays. Editor features are injected into `<Viewer>` via props and children.\n\nDetails, examples, and rationale live in `wiki/architecture/layers.md`, `wiki/architecture/viewer-isolation.md`, `wiki/architecture/systems.md`, `wiki/architecture/renderers.md`, `wiki/architecture/tools.md`.\n\n## When making architecture-sensitive changes\n\nRead the relevant page in `wiki/architecture/` **before** writing code. The page list lives in `wiki/architecture/README.md`. As a minimum:\n\n- Adding a node type → `node-schemas.md`, `renderers.md`, `systems.md`\n- Adding a tool → `tools.md`, `spatial-queries.md`, `events.md`\n- Adding / changing a placement or move interaction → `tools.md` (\"2D ↔ 3D behavioral parity\": applicable behaviors must exist in both views; port the change to the sibling 2D/3D file in the same PR)\n- Adding a system → `systems.md`, `scene-registry.md`\n- Anything in `packages/viewer` → `viewer-isolation.md`, `layers.md`\n- Anything touching selection → `selection-managers.md`, `scene-registry.md`, `events.md`\n\n## When reviewing a PR\n\nInvoke the `review-architecture` skill (`.agents/skills/review-architecture/SKILL.md`). It loads the required architecture pages, fetches the diff, classifies each new file by layer, and reports findings grouped by severity.\n\n## Operating rules\n\n- Read the full file before editing. Plan all changes, then make one complete edit.\n- When the user corrects you, stop and re-read their message.\n- After two consecutive tool failures, stop and change approach.\n- Don't introduce backwards-compatibility shims, dead code, or speculative abstractions.\n- Don't write new comments unless they explain a non-obvious *why*.\n","category":"root","tokens":897}]}