chore: add discussion/build toggle mode to agent workflow

AGENTS.md

@@ -1,6 +1,6 @@
 # Service Factory — ERPNext Custom App Project
 
-> **Current Version: V0.1.0001** — Each completed prompt/step increments the patch number by 1 (V0.1.0000 → V0.1.0001 → V0.1.0002…). The agent automatically commits and pushes after every step.
+> **Current Version: V0.1.0002** — Each completed prompt/step increments the patch number by 1 (V0.1.0000 → V0.1.0001 → V0.1.0002…). The agent automatically commits and pushes after every step.
 
 ## Project Overview
 
@@ -185,9 +185,20 @@ This ensures every interaction is checkpointed and version-tracked.
 | Python | ≥3.14 |
 | Runtime | Node.js/Bun, `@opencode-ai/plugin` |
 
+### Agent Modes (Toggle)
+
+OpenAgent operates in two explicit modes during conversation:
+
+| Mode | Trigger | Behaviour |
+|------|---------|-----------|
+| 🗣️ **Discuss** | **Default** — every interaction starts here | Ideas, trade-offs, architecture sketches (text-only), questions, exploration. **Not a single file is touched, no bash executed.** |
+| 🔧 **Build** | Only when you say `"build it"` or equivalent | Execute the agreed plan — write files, edit code, run benchmarks, deploy, commit & push. All standard approval gates still apply. |
+
+The toggle is conversational: I stay in 🗣️ Discuss until you explicitly switch to 🔧 Build. This ensures we align on direction before any work begins.
+
 ### Agent Rules
 
-- **OpenAgent** — General purpose, workflow orchestration
+- **OpenAgent** — General purpose, workflow orchestration (toggle mode: discuss / build)
 - **OpenCoder** — Production development
 - Load context via ContextScout before any code/doc/test work
 - Approval gates required before file writes and bash execution