Project Brain Codex

Synthesize the project's architecture, constraints, and workflows into a single instruction set.

Workflow

1. Ingest Sources

Read key documentation files: - AGENTS.md (Primary rules). - package.json (Dependencies). - .github/copilot-instructions.md (Coding style).

1. Synthesize Constraints

Extract non-negotiables: - Stack: React 19.2.8, Vite 8.2.2, Tailwind 4.3.3. - State: Immutable, Reducer-driven. - Style: Brutalist, CSS Variables.

1. Map Architecture

Describe the folder structure and domain ownership. - src/scenes/ -> Game Loops. - src/data/ -> Static Content. - src/utils/ -> Logic Engines.

1. Format Output

Create a Markdown document with clear sections: - Project Overview - Tech Stack - Core Rules - Architecture Map

Example

Input: "Create a summary for a new developer."

Output:

# NEUROTOXIC Project Codex

## Project Overview

Neurotoxic is a brutalist rhythm game...

## Tech Stack

- React 19.2.8 + Vite 8.2.2
- Tailwind 4 (Brutalist Design)
- Pixi.js 8 + Tone.js 15

## Core Rules

1. **State**: Never mutate `gameState` directly. Use reducers.
2. **Audio**: Init AudioContext only after user gesture.
3. **Assets**: Use `import.meta.glob` for dynamic assets.

## Architecture Map

- `src/scenes/`: Main game states (Overworld, Gig).
- `src/utils/audio/audioEngine.ts`: Central audio controller.

Skill sync: compatible with React 19.2.8 / Vite 8.2.2 / Tailwind 4.3.3 baseline as of 2026-05-20.