Contributing

🤝 Contributing to Grok Imagine Cinematic Studio

Thank you for your interest in improving the most advanced multi-agent cinematic production system for Grok!

We welcome contributions of all kinds: new agents, improved prompts, bug fixes, documentation, examples, UI enhancements, and more.

---

How to Contribute

1. Reporting Issues or Feature Requests

• Open an issue on GitHub Issues
• Use the appropriate template (Bug Report, Feature Request, Documentation)
• Include as much detail as possible (Grok version, steps to reproduce, expected vs actual behavior)

2. Suggesting New Agents or Improvements

• Open a Discussion or Issue with the label agent-proposal or enhancement
• Describe the agent's role, key capabilities, activation triggers, and why it would benefit the studio
• If possible, provide a draft role card (see agents/ directory for format)

3. Code Contributions (CLI, Web UI, Tools)

1. Fork the repository
2. Create a feature branch: git checkout -b feature/your-feature-name
3. Make your changes (follow PEP 8, add type hints where possible)
4. Test thoroughly (CLI commands, Streamlit UI, integration with MASTER_PROMPT)
5. Submit a Pull Request with a clear description and screenshots/GIFs where helpful

Code Style:

• Python: Black + isort
• Markdown: Consistent heading levels, tables for comparisons
• All new features must include updated documentation

4. Documentation & Wiki Contributions

• Edit files in this wiki or the root .md files
• Improvements to clarity, examples, or new tutorial sections are highly valued
• For large changes, open a PR or Discussion first

5. Example Productions & Templates

• Submit new Production Bible examples in the examples/ directory
• Follow the existing structure (full Bible + sample scenes + QA notes)
• Genre diversity and creative edge cases are especially welcome

---

Development Setup

git clone https://github.com/FineComputer14451/Grok-Imagine-Cinematic-Studio.git
cd Grok-Imagine-Cinematic-Studio

# For CLI work
pip install -r requirements.txt

# For Web UI work
pip install -r requirements-streamlit.txt

# Optional: Run tests (when available)
python -m pytest

---

Agent Development Guidelines

When creating or updating agents in agents/:

• Follow the existing .txt role card format (see any existing file)
• Include: Role description, Core Capabilities, Activation triggers, Handoff packet expectations, Self-improvement metrics, Version notes
• Test the new agent inside a full studio activation
• Update MASTER_PROMPT_v3.5.md and this wiki's 22-Agent Film Crew page

---

Code of Conduct

This project follows the Contributor Covenant. Be respectful, inclusive, and focused on advancing cinematic AI storytelling for everyone.

---

Recognition

All contributors are listed in CONTRIBUTORS.md and receive credit in release notes.

Significant contributions (new major agents, major UI features, etc.) may also be highlighted in the README and on X.

---

Questions?

• Join the discussion on GitHub Discussions
• Tag @FineComputer14451 on X with #GrokCinematicStudio
• For urgent matters, open an issue with the question label

---

Together, we're building the future of AI-powered filmmaking.

Every contribution — no matter how small — helps make cinematic AI accessible and powerful for creators worldwide.