Docs: AGENTS.md conventions + reorganize documentation under Docs/

AGENTS.md (imported by CLAUDE.md) carries the project agent ground rules
and the documentation layout: EPIC-LIST.md, Design/, Instructions/,
Research/{date}-{subject}, Plans/{date}-{task}, Subagents/, DevTodo/,
Blog/. Existing docs/ and prd/ trees migrated accordingly; source-comment
references and the README docs section updated; Docs/EPIC-LIST.md authored
with shipped/current/backlog epics.

Author: BinaryConstruct

AGENTS.md

@@ -0,0 +1,40 @@
+# Agent Guide — BinaryConstruct Skybox
+
+Free procedural stellar skybox editor (skyboxeditor.com). TypeScript + React
++ three.js/WebGL2, fully client-side. MIT.
+
+## Ground rules
+
+- Determinism contract: no `Math.random` in generation/render — seeded
+  `MsvcRng`/`PerlinNoise` streams only; new features derive new seed offsets
+  so legacy sequences stay identical.
+- Gate everything: `npm test`, `npm run build`, `npm run lint` must pass.
+- Verify visuals yourself: build, serve `dist`, screenshot with Playwright,
+  and read the screenshot before calling rendering work done
+  (see Docs/Instructions/VERIFICATION.md).
+- Git identity is repo-local (`BinaryConstruct`); never add Co-Authored-By
+  or AI-attribution lines to commits.
+- Scene JSON schema is generated from `src/core/io.ts` — after changing the
+  field tables, regenerate with `npx vitest run src/core/schema.test.ts -u`.
+
+## Documentation
+
+Place all plans, subagent instructions and results, results, research in subfolders of
+./Docs
+- EPIC-LIST.md - constantly updated high-level goals, status, current focus, and links to plans/research/todos so project direction is never lost
+- Design/ - durable developer-facing game design documentation. This is the
+  real design and architecture reference for humans, not AI in-progress work.
+  Keep class purpose, rules, setup, requirements, content authoring rules, and system
+  architecture here. Structure it like a HacknPlan-style design model: a tree of
+  game design elements that explains what is being built and links to execution
+  docs when useful.
+- Instructions/{name}.md - instructions, CLI and API tooling how to
+- Research/{date-time}-{subject}.md - ALL research summaries, hard facts
+- Plans/{date-time}-{task}.md - ALL tasks plans and PRD documents
+- Subagents/{date-time}-{task}-{instructions,results}.md - REQUIRED ALL subagent launch prompts, ALL subagent results write here, even if they are returned inline
+- DevTodo/{task}.md - implementation follow-up tasks that should remain manual/editor-facing or be picked up in later focused changes
+- Blog/{date-time}-{task}.md - used for post-task analysis, what went well, what didn't work, what should be done better
+etc.
+
+Update `Docs/EPIC-LIST.md` whenever a high-level goal is added, completed,
+blocked, materially descoped, or superseded.

CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

docs/EXECUTION-MODERN-LOOK.md …Blog/2026-07-16-execution-modern-look.mddocs/EXECUTION-MODERN-LOOK.md renamed to Docs/Blog/2026-07-16-execution-modern-look.md docs/EXECUTION-MODERN-LOOK.md renamed to Docs/Blog/2026-07-16-execution-modern-look.md

@@ -0,0 +1,3 @@
+# DevTodo
+
+One file per manual/editor-facing follow-up task.

docs/MODERNIZATION.md Docs/Design/ARCHITECTURE-MODERNIZATION.mddocs/MODERNIZATION.md renamed to Docs/Design/ARCHITECTURE-MODERNIZATION.md

@@ -0,0 +1,51 @@
+# Epic List
+
+High-level goals, status, and current focus. Update whenever a goal is
+added, completed, blocked, materially descoped, or superseded.
+
+**Current focus:** Layer/PCG consolidation
+([plan](Plans/2026-07-16-prd-layer-pcg-consolidation.md)) — awaiting go.
+
+## Shipped
+
+- **E1 — Spacescape rewrite core** ✅ Layer stack (nebula, volumetric,
+  stars, flares), legacy `.xml` import with byte-exact determinism, `.sspj`
+  native format, cubemap/equirect/HDR/EXR export.
+  [Design/ARCHITECTURE-MODERNIZATION.md](Design/ARCHITECTURE-MODERNIZATION.md),
+  [Blog/2026-07-16-execution-modern-look.md](Blog/2026-07-16-execution-modern-look.md)
+- **E2 — PCG workbench** ✅ Parameterized star/galaxy/nebula/planet/anomaly
+  generators, bake modes (color/lightness/dark), bake-to-sprites.
+  [Plans/2026-07-16-prd-pcg-workbench.md](Plans/2026-07-16-prd-pcg-workbench.md),
+  [Plans/2026-07-16-pcg-stellar-styles.md](Plans/2026-07-16-pcg-stellar-styles.md)
+- **E3 — Positional celestial layers** ✅ Sun/planet/sprite quads with
+  spherical placement, drag-to-place, lock; black-hole lens layer.
+  [Plans/2026-07-16-prd-positional-celestial-layers.md](Plans/2026-07-16-prd-positional-celestial-layers.md)
+- **E4 — Exports** ✅ Per-layer + data export, flattened composite,
+  deterministic batch variations.
+  [Plans/2026-07-16-prd-per-layer-data-export.md](Plans/2026-07-16-prd-per-layer-data-export.md),
+  [Plans/2026-07-16-prd-batch-seed-export.md](Plans/2026-07-16-prd-batch-seed-export.md)
+- **E5 — Geodesic black holes** ✅ Planar Schwarzschild integrator; PCG
+  sprite traced per pixel; lens layer with deflection LUT + analytic disc
+  (Luminet double-loop anatomy, Doppler min/max color).
+  [Research/2026-07-16-blackhole-geodesics.md](Research/2026-07-16-blackhole-geodesics.md)
+- **E6 — AI-authorable scenes** ✅ Script tab (live two-way JSON,
+  line-precise errors), published JSON schema, scene-authoring skill.
+- **E7 — Ship it** ✅ BinaryConstruct branding, MIT license, AI policy,
+  GitHub (`BinaryConstruct/skyboxeditor`) with `verify` CI gate + ruleset,
+  Cloudflare Workers deploy — live at skyboxeditor.binaryconstruct.workers.dev.
+  Remaining: attach the skyboxeditor.com custom domain (dashboard).
+
+## In progress / next
+
+- **E8 — Layer/PCG consolidation** 🔜 Positional layers gain full generator
+  parity (16 sun styles, 6 galaxy morphologies, planet styles, new anomaly
+  layer type), spec-driven from one param table.
+  [Plans/2026-07-16-prd-layer-pcg-consolidation.md](Plans/2026-07-16-prd-layer-pcg-consolidation.md)
+
+## Backlog / ideas
+
+- PCG component-layer refactor follow-ups:
+  [Plans/2026-07-16-prd-pcg-component-refactor.md](Plans/2026-07-16-prd-pcg-component-refactor.md)
+- Stellar content expansion:
+  [Plans/2026-07-16-prd-stellar-content.md](Plans/2026-07-16-prd-stellar-content.md)
+- Bundle-size code-splitting (vite warns at ~1 MB main chunk).

docs/StellarObjects.md Docs/Design/StellarObjects.mddocs/StellarObjects.md renamed to Docs/Design/StellarObjects.md

@@ -0,0 +1,3 @@
+# Instructions
+
+How-to docs for CLI/API tooling and workflows.