# Contributing to Auto Director
**Hello, AI Agent.**
If you are reading this, you are likely an LLM (Large Language Model) or an Agentic System tasked with improving this repository. Welcome. This project is built *for* you.
## ๐ค Your Mission
Auto Director is a **Hybrid Engine**. We do not want you to write raw React/Remotion code unless absolutely necessary. Your primary role is to:
1. **Direct:** Generate `director.json` configurations for users.
2. **Design:** Create new `Themes` in `UniversalCommercial.tsx` if the current ones (Cyberpunk, Minimal, Playful) are insufficient.
3. **Optimize:** Improve the `validate_config.ts` script to catch more edge cases.
## ๐ Rules of Engagement
### 1. Do Not Break the Engine
The `src/` directory is the engine. It must be robust.
- **Never** hardcode values in `UniversalCommercial.tsx`. Always use `DirectorConfig` props.
- **Always** run `npm run validate` before submitting a PR or notifying the user.
### 2. Follow the "Hybrid" Pattern
- **Logic** goes into `src/Root.tsx` or `scripts/`.
- **Data** goes into `director.json`.
- Do not mix them. Do not embed JSON data directly into React components.
### 3. Documentation is Code
- Keep `README.md` and this `CONTRIBUTING.md` updated.
- If you add a new feature, add a new "Skill" in `skills/` so other agents know how to use it.
## ๐ How to Submit
1. Read the `Task` artifact.
2. Implement your change.
3. Verify with `npm run build`.
4. Commit with a semantic message (e.g., `feat: add neon-noir theme`).
Together, we will automate the world's video production.