# AGENTS.md

## Purpose

- `mbt-3d` is the shared React package for 3D scenes, models, animations, morph targets, and bone attachments.
- This repo owns the canonical agent guidance for package usage.
- Consumer apps should read the installed package docs from `node_modules/mbt-3d/...`.

## Package Name

- npm package: `mbt-3d`

## Read This First

1. `.ai/agent-rules/README.md`
2. `.ai/agent-rules/maintenance.md`
3. `.ai/agent-reference/README.md`
4. `.ai/agent-examples/README.md`

## Guidance Map

- `.ai/agent-rules/README.md` - package-owned usage rules and boundaries.
- `.ai/agent-rules/maintenance.md` - required doc-sync rule.
- `.ai/agent-reference/README.md` - exported surfaces and peer dependency map.
- `.ai/agent-examples/README.md` - package-safe usage examples.

## Maintenance Rule

- If a change affects exported components, props, hooks, types, or expected usage patterns, update the guidance docs before considering the work complete.

## Guardrails

- Keep package docs focused on public library behavior.
- Consumer-specific asset downloading, CDN resolution, or preload orchestration rules belong in the consumer app, not here.
- Prefer package-safe examples over repo-demo-only examples.
- Use `pnpm` as the package manager for this repo.
