Markdown Converter
Agent skill for markdown-converter
This document describes how AI agents should interact with and develop on the Idle Bricks 3D codebase.
Sign in to like and favorite skills
This document describes how AI agents should interact with and develop on the Idle Bricks 3D codebase.
Also see copilot instructions in
.github/copilot-instructions.md.
Idle Bricks 3D is a 3D idle breakout game. Agents working on this project should understand:
├── src/ │ ├── components/ # React and R3F components │ │ ├── Arena.tsx # 3D boundaries │ │ ├── Ball.tsx # Ball physics and rendering │ │ ├── Brick.tsx # Brick rendering │ │ ├── GameScene.tsx # Main 3D scene │ │ └── UI.tsx # HUD and upgrade panel │ ├── store/ │ │ └── gameStore.ts # Zustand game state │ ├── test/ # Test files │ ├── App.tsx # Root component │ └── main.tsx # Entry point ├── .github/ │ ├── agents/ # Agent configuration files │ └── instructions/ # Development instructions ├── memory/ # Memory bank for context persistence └── public/ # Static assets
npm run lint to check current lint statusnpm run typecheck to verify typesnpm run test:run to ensure tests passnpm run format to ensure consistent formattingnpm run lint:fix to auto-fix lint issuesnpm run typecheck to verify type safetynpm run lint to check for issuesnpm run test:run to verify tests passnpm run build to ensure production build worksAll changes must pass:
npm run typecheck - TypeScript compilationnpm run lint - ESLint rulesnpm run test:run - All testsnpm run build - Production buildCode must be formatted with Prettier:
npm run format # Auto-format all files
Configuration is in
.prettierrc:
Orchestrates planning, implementation, and review cycles. For this project:
When researching context:
gameStore.ts for state structureBall.tsxWhen implementing changes:
When reviewing changes:
| Technology | Version | Purpose |
|---|---|---|
| React | 19.x | UI framework |
| TypeScript | 5.9.x | Type safety |
| React Three Fiber | 9.x | React renderer for WebGL |
| Three.js | 0.181.x | 3D graphics |
| Zustand | 5.x | State management |
| Vite | 7.x | Build tool |
| Vitest | 4.x | Testing |
| ESLint | 9.x | Code linting |
| Prettier | 3.x | Code formatting |
src/test/npm run test:runsrc/components/gameStore.tsThe
/memory directory stores persistent context:
designs/ - Design documentstasks/ - Task trackingAgents should consult these for project context between sessions.
Important Details for the memory bank and spec driven workflows are in
.github/instructions/memory-bank.instructions.md and .github/instructions/spec-driven-workflow-v1.instructions.md.