|
| 1 | +# AI Context & Instructions for SwitchCraft |
| 2 | + |
| 3 | +## 🧬 Project DNA |
| 4 | +**Repository:** `SwitchCraft` |
| 5 | +**Type:** General Software Project |
| 6 | +**Description:** **SwitchCraft is your comprehensive packaging assistant for IT Professionals. It goes beyond simple switch identification to streamline your entire application packaging workflow.** |
| 7 | + |
| 8 | +## 🛠 Tech Stack & Standards |
| 9 | +- **Core Languages/Frameworks:** Node.js, Python, Docker |
| 10 | +- **Toolchain:** Ruff/Flake8 (Linting) |
| 11 | + |
| 12 | +## 📐 Coding Guidelines |
| 13 | +- **Modularity:** Keep functions small, testable, and focused. |
| 14 | +- **Quality Assurance:** Write clean, readable code following standard conventions for the respective language. |
| 15 | +- **State Management:** Avoid global state. Use dependency injection where possible. |
| 16 | +- **Error Handling:** Use granular try-catch/except blocks. Log contexts cleanly without exposing secrets. |
| 17 | + |
| 18 | +## 🤖 Tool-Specific Optimization |
| 19 | + |
| 20 | +### 🐙 GitHub Copilot |
| 21 | +- **Inline Generation:** Align closely with the formatting of adjacent code blocks. Provide meaningful docstrings or JSDoc comments. |
| 22 | + |
| 23 | +### 🧠 Claude Code |
| 24 | +- **Architectural Changes:** Propose an execution plan first. Parse the repository structure to identify shared utilities before re-implementing logic. |
| 25 | + |
| 26 | +### 🚀 Google Antigravity |
| 27 | +- **Autonomous Operations:** Focus on zero-regression edits. Before creating new files, analyze the directory tree to determine if the logic belongs in an existing helper module. |
| 28 | + |
| 29 | +## 🧪 Test Procedures |
| 30 | +- **Running Tests:** Check for standard test runners or scripts. |
| 31 | +- **Strategy:** Isolate unit tests from integration tests. Use appropriate mock objects. |
| 32 | + |
| 33 | +## 🚫 Exclusion Rules |
| 34 | +- **DO NOT TOUCH:** |
| 35 | + - Build artifacts, `dist/`, or `build/` directories. |
| 36 | + - Package lock files (`package-lock.json`, `poetry.lock`) unless specifically upgrading a dependency. |
0 commit comments