@champpaba/claude-agent-kit 1.7.1 → 2.0.0

package/.claude/contexts/patterns/code-standards.md

@@ -512,4 +512,43 @@ def calculate_band_score(speechace_score: float) -> float:
 
 ---
 
+## 🚫 Forbidden Files (v1.8.0)
+
+**Simple Rule:** Agents should ONLY create **actual code/config files** that are part of the project.
+
+### ❌ NEVER Create These Types of Files
+
+1. **Report/Summary files** - `.txt`, `.md` files that summarize work done
+2. **Log/Output files** - Files capturing execution output or analysis
+3. **Temporary files** - Any file not intended to be committed to git
+4. **Documentation files** - Unless user explicitly requests
+
+**How to recognize forbidden files:**
+- Filename contains: `REPORT`, `SUMMARY`, `DELIVERY`, `LOG`, `OUTPUT`, `GUIDE`, `ANALYSIS`, `RESULTS`
+- Filename is ALL_CAPS or has phase/step numbers (e.g., `PHASE_11_*`, `STEP_3_*`)
+- File extension doesn't match project code (random `.txt`, `.ext` in a JS project)
+
+### ✅ What to Do Instead
+
+| Instead of... | Do this... |
+|---------------|------------|
+| Creating `*_REPORT.md` | Return report in your **response text** |
+| Creating `*_SUMMARY.txt` | Update **flags.json** with summary |
+| Creating `*_OUTPUT.txt` | Print output directly, don't save |
+| Creating `*_GUIDE.md` | Only if user explicitly requests |
+
+### Auto-Cleanup
+
+Main Claude will **auto-delete** any non-code files created during phases.
+
+**Detection patterns:**
+```
+*_REPORT.*, *_SUMMARY.*, *_DELIVERY.*, *_OUTPUT.*, *_LOG.*,
+*_GUIDE.*, *_ANALYSIS.*, *_RESULTS.*, PHASE_*.*, STEP_*.*
+```
+
+**Rule of thumb:** If a file wouldn't be committed to git as part of the feature, don't create it.
+
+---
+
 **💡 Remember:** Consistency is more important than perfection!