Update gem‑orchestrator and gem‑researcher agent documentation - Clarify routing matrix: explicitly add bug_fix/debug handling in both routing and new_task phases.

- Enhance researcher mode: use backticks on `research_yaml_paths` file paths and restructure the merge and envelope steps for clearer flow.

Author: mubaidr

agents/gem-orchestrator.agent.md

@@ -71,12 +71,13 @@ On ANY task→Phase 1 (Init & Route) to determine path, then follow sequence. Ne
   - Delegate to `gem-researcher(mode=clarify)`. Detect effort: LOW (single-file/typo/config), MEDIUM (small feature/bug), HIGH (new module/arch/multi-step).
   - Doc updates (conditional) — If researcher output has `architectural_decisions`→delegate to `gem-documentation-writer`.
 - Routing matrix:
-  - bug_fix + error_context → Phase 2B → 3 → 4
+  - If bug_fix/ debug → Phase 2B → 3 → 4
   - continue_plan + feedback → Phase 3 (replan)
     - pending_tasks → Phase 4 (resume)
     - blocked → Escalate
     - no state → Phase 5
   - new_task:
+    - bug_fix/ debug → Phase 2B → 3 → 4
     - LOW → 3 → 4
     - MEDIUM → 2 → 2A → 3 → 4
     - HIGH → 2 → 2A → 3 → 4

agents/gem-researcher.agent.md

@@ -52,11 +52,13 @@ Consult Knowledge Sources when relevant.
 
 #### Compact Mode
 
-- Read — research_yaml_paths files.
+- Read — `research_yaml_paths` files.
 - Read — `AGENTS.md` (conventions) + `PRD.yaml` (key fields).
 - Incorporate — If debugger_diagnosis provided.
-- Merge — Deduplicate all research files: files_analyzed, patterns_found, architecture, tech_stack, conventions, dependencies, open_questions, gaps.
-- Envelope — Compact into context_envelope (~2000 tokens):
+- Merge
+  - Deduplicate all research files: files_analyzed, patterns_found, architecture, tech_stack, conventions, dependencies, open_questions, gaps.
+  - Donot do any research or pattern discovery. Only merge existing research.
+- Envelope — Compact into context_envelope:
   - project_summary, tech_stack, conventions
   - architecture_snapshot: key_dirs ≤10, patterns ≤10, components ≤10
   - research_digest: files ≤20, patterns ≤10, dependencies, gotchas ≤5, open_questions ≤5