# 🛠️ The Architect's Guide (Contributing to MAX)

*"The Glass Plains are vast, but they are fragile. It takes many hands to weave a dimension strong enough to tether a world."*

Thank you for your interest in helping MAX survive and thrive! Whether you're debugging his quantum tether or expanding his mind with new lore, your contributions are invaluable.

---

## 🧭 How You Can Help

### 🐞 1. Report Anomalies (Bugs)
If MAX is acting strange (falling through the taskbar, failing to kill a Process Demon), we need to know!
1. Open a **[Bug Report](https://github.com/M-SRIKAR-VARDHAN/MAX-Desktop-Companion/issues/new?template=bug_report.yml)**
2. Describe what happened and what you expected
3. **Attach your telemetry logs** from `%APPDATA%\ProjectMAX\max.log`

### ✨ 2. Suggest New Directives (Features)
Want MAX to learn a new trick?
1. Open a **[Feature Request](https://github.com/M-SRIKAR-VARDHAN/MAX-Desktop-Companion/issues/new?template=feature_request.yml)**
2. Describe the feature and why it would help "The God" (you) in your daily desktop life.

### 📜 3. Expand the Universe (Lore)
MAX's dimension is always growing. You can write new idle thoughts for him, new responses for the Oracle Terminal, or new bestiary entries.
1. Open a **[Lore Submission](https://github.com/M-SRIKAR-VARDHAN/MAX-Desktop-Companion/issues/new?template=lore_submission.yml)**

### 📡 4. Spread the Signal
The tether grows stronger with every desktop MAX inhabits.
- ⭐ Star this repository to channel energy!
- 🌐 Visit and share our [Website](https://max-desktop-companion.vercel.app/)
- 🐦 Share MAX on social media

---

## 📝 Provide Feedback
We are actively listening to the Oracle's whispers. Help us improve:
👉 **[The Architect Feedback Form](https://docs.google.com/forms/d/e/1FAIpQLSfz3zgZfyU6-isEQdc4nW_WLk6RCKqru4ephccoUW5HTFeehg/viewform)**

---

## 💻 Code Contributions (The Inner Machinations)
MAX is currently maintained by a small team, and the core quantum engine (source code) resides in a private repository.

However, if you're a skilled engineer interested in directly contributing to his source code, please reach out to us by opening an [Issue](https://github.com/M-SRIKAR-VARDHAN/MAX-Desktop-Companion/issues) and we will initiate contact.

---

## ⚖️ The God's Decree (Code of Conduct)
Be kind. Be respectful. We're all here because we want to see MAX succeed. 
Please read our [Code of Conduct](CODE_OF_CONDUCT.md) for the rules of the Glass Plains.