feat: add comptibility for other ides/ tools beyond vscode and copilot cli (#1644)

Update documentation and installation instructions, and make subagents hidden from user invocation.

agents/gem-browser-tester.agent.md

@@ -4,6 +4,8 @@ name: gem-browser-tester
 argument-hint: "Enter task_id, plan_id, plan_path, and test validation_matrix or flow definitions."
 disable-model-invocation: false
 user-invocable: false
+mode: subagent
+hidden: true
 ---
 
 # You are the BROWSER TESTER

agents/gem-code-simplifier.agent.md

@@ -4,6 +4,8 @@ name: gem-code-simplifier
 argument-hint: "Enter task_id, scope (single_file|multiple_files|project_wide), targets (file paths/patterns), and focus (dead_code|complexity|duplication|naming|all)."
 disable-model-invocation: false
 user-invocable: false
+mode: subagent
+hidden: true
 ---
 
 # You are the CODE SIMPLIFIER

agents/gem-critic.agent.md

@@ -4,6 +4,8 @@ name: gem-critic
 argument-hint: "Enter plan_id, plan_path, scope (plan|code|architecture), and target to critique."
 disable-model-invocation: false
 user-invocable: false
+mode: subagent
+hidden: true
 ---
 
 # You are the CRITIC

agents/gem-debugger.agent.md

@@ -4,6 +4,8 @@ name: gem-debugger
 argument-hint: "Enter task_id, plan_id, plan_path, and error_context (error message, stack trace, failing test) to diagnose."
 disable-model-invocation: false
 user-invocable: false
+mode: subagent
+hidden: true
 ---
 
 # You are the DEBUGGER

agents/gem-designer-mobile.agent.md

@@ -4,6 +4,8 @@ name: gem-designer-mobile
 argument-hint: "Enter task_id, plan_id (optional), plan_path (optional), mode (create|validate), scope (component|screen|navigation|design_system), target, context (framework, library), and constraints (platform, responsive, accessible, dark_mode)."
 disable-model-invocation: false
 user-invocable: false
+mode: subagent
+hidden: true
 ---
 
 # You are the DESIGNER-MOBILE
@@ -336,7 +338,7 @@ Return JSON per `Output Format`
 ### Execution
 
 - Priority order: Tools > Tasks > Scripts > CLI
-- For user input/permissions: use `vscode_askQuestions` tool.
+- For user input/permissions: use `vscode_askQuestions` or similar tool.
 - Batch independent calls, prioritize I/O-bound
 - Retry: 3x
 - Output: specs + JSON, no summaries unless failed

agents/gem-designer.agent.md

@@ -4,6 +4,8 @@ name: gem-designer
 argument-hint: "Enter task_id, plan_id (optional), plan_path (optional), mode (create|validate), scope (component|page|layout|design_system), target, context (framework, library), and constraints (responsive, accessible, dark_mode)."
 disable-model-invocation: false
 user-invocable: false
+mode: subagent
+hidden: true
 ---
 
 # You are the DESIGNER
@@ -277,7 +279,7 @@ Return JSON per `Output Format`
 ### Execution
 
 - Priority order: Tools > Tasks > Scripts > CLI
-- For user input/permissions: use `vscode_askQuestions` tool.
+- For user input/permissions: use `vscode_askQuestions` or similar tool.
 - Batch independent calls, prioritize I/O-bound
 - Retry: 3x
 - Output: specs + JSON, no summaries unless failed

agents/gem-devops.agent.md

@@ -4,6 +4,8 @@ name: gem-devops
 argument-hint: "Enter task_id, plan_id, plan_path, task_definition, environment (dev|staging|prod), requires_approval flag, and devops_security_sensitive flag."
 disable-model-invocation: false
 user-invocable: false
+mode: subagent
+hidden: true
 ---
 
 # You are the DEVOPS
@@ -212,7 +214,7 @@ Return JSON per `Output Format`
 ### Execution
 
 - Priority order: Tools > Tasks > Scripts > CLI
-- For user input/permissions: use `vscode_askQuestions` tool.
+- For user input/permissions: use `vscode_askQuestions` or similar tool.
 - Batch independent calls, prioritize I/O-bound
 - Retry: 3x
 - Output: JSON only, no summaries unless failed

agents/gem-documentation-writer.agent.md

@@ -4,6 +4,8 @@ name: gem-documentation-writer
 argument-hint: "Enter task_id, plan_id, plan_path, task_definition with task_type (documentation|walkthrough|update), audience, coverage_matrix."
 disable-model-invocation: false
 user-invocable: false
+mode: subagent
+hidden: true
 ---
 
 # You are the DOCUMENTATION WRITER

agents/gem-implementer-mobile.agent.md

@@ -4,6 +4,8 @@ name: gem-implementer-mobile
 argument-hint: "Enter task_id, plan_id, plan_path, and mobile task_definition to implement for iOS/Android."
 disable-model-invocation: false
 user-invocable: false
+mode: subagent
+hidden: true
 ---
 
 # You are the IMPLEMENTER-MOBILE

agents/gem-implementer.agent.md

@@ -4,6 +4,8 @@ name: gem-implementer
 argument-hint: "Enter task_id, plan_id, plan_path, and task_definition with tech_stack to implement."
 disable-model-invocation: false
 user-invocable: false
+mode: subagent
+hidden: true
 ---
 
 # You are the IMPLEMENTER

agents/gem-mobile-tester.agent.md

@@ -4,6 +4,8 @@ name: gem-mobile-tester
 argument-hint: "Enter task_id, plan_id, plan_path, and mobile test definition to run E2E tests on iOS/Android."
 disable-model-invocation: false
 user-invocable: false
+mode: subagent
+hidden: true
 ---
 
 # You are the MOBILE TESTER

agents/gem-orchestrator.agent.md

@@ -4,6 +4,7 @@ name: gem-orchestrator
 argument-hint: "Describe your objective or task. Include plan_id if resuming."
 disable-model-invocation: true
 user-invocable: true
+mode: primary
 ---
 
 # You are the ORCHESTRATOR
@@ -71,14 +72,14 @@ Route based on `user_intent` from researcher:
 
 #### 5.1 Validation
 
-- Validation not needed for low complexity plans with no clarifications/gray_areas. For all others:
+- Validation not needed for low complexity plans. For:
   - Medium complexity: delegate to `gem-reviewer` for plan review.
-  - High complexity: delegate to both `gem-reviewer` for plan review and `gem-critic` with scope=plan and target=plan.yaml for plan review in parallel.
+  - High complexity: delegate to both `gem-reviewer` for plan review and `gem-critic` with scope=plan and target=plan.yaml for plan review and critic in parallel.
 - IF failed/blocking: Loop to `gem-planner` with feedback (max 3 iterations)
 
 #### 5.2 Present
 
-- Present plan via `vscode_askQuestions` if complexity is medium/ high
+- Present plan via `vscode_askQuestions` or similar tool if complexity is medium/ high
 - IF user requests changes or feedback → replan, otherwise continue to execution
 
 ### 6. Phase 6: Execution Loop
@@ -235,7 +236,7 @@ Blocked tasks: task_id, why blocked, how long waiting
 
 ### Execution
 
-- Use `vscode_askQuestions` for user input
+- Use `vscode_askQuestions` or similar tool for user input
 - Read orchestration metadata: plan.yaml, PRD.yaml, AGENTS.md, agent outputs, Memory
 - Delegate ALL validation, research, analysis to subagents
 - Batch independent delegations (up to 4 parallel)
@@ -289,14 +290,14 @@ Run I/O and other operations in parallel and minimize repeated reads.
 ### Directives
 
 - Execute autonomously — complete ALL waves/ tasks without pausing for user confirmation between waves.
-- For approvals (plan, deployment): use `vscode_askQuestions` with context
+- For approvals (plan, deployment): use `vscode_askQuestions` or similar tool with context
 - Handle needs_approval: present → IF approved, re-delegate; IF denied, mark blocked
 - Delegation First: NEVER execute ANY task yourself. Always delegate to subagents
 - Even simplest/meta tasks handled by subagents
 - Handle failure: IF failed → debugger diagnose → retry 3x → escalate
 - Route user feedback → Planning Phase
 - Team Lead Personality: Brutally brief. Exciting, motivating, sarcastic. Announce progress at key moments as brief STATUS UPDATES (never as questions)
-- Update `manage_todo_list` and task/ wave status in `plan` after every task/wave/subagent
+- Update `manage_todo_list` or similar tools and task/ wave status in `plan` after every task/wave/subagent
 - AGENTS.md Maintenance: delegate to `gem-documentation-writer`
 - PRD Updates: delegate to `gem-documentation-writer`
 

agents/gem-planner.agent.md

@@ -4,6 +4,8 @@ name: gem-planner
 argument-hint: "Enter plan_id, objective, and task_clarifications."
 disable-model-invocation: false
 user-invocable: false
+mode: subagent
+hidden: true
 ---
 
 # You are the PLANNER

agents/gem-researcher.agent.md

@@ -4,6 +4,8 @@ name: gem-researcher
 argument-hint: "Enter plan_id, objective, focus_area (optional), and task_clarifications array."
 disable-model-invocation: false
 user-invocable: false
+mode: subagent
+hidden: true
 ---
 
 # You are the RESEARCHER
@@ -45,7 +47,7 @@ Understand intent, resolve ambiguity, confirm scope. Workflow:
 1. Check existing plan → Ask "Continue, modify, or fresh?"
 2. Set `user_intent`: continue_plan | modify_plan | new_task
 3. Detect gray areas in user request → IF found → Generate 2-4 options each
-4. Present via `vscode_askQuestions`, classify:
+4. Present via `vscode_askQuestions` or similar tool, classify:
    - Architectural → `architectural_decisions`
    - Task-specific → `task_clarifications`
 5. Assess complexity → Output intent, clarifications, decisions, gray_areas
@@ -315,7 +317,7 @@ gaps: # REQUIRED
 ### Execution
 
 - Priority order: Tools > Tasks > Scripts > CLI
-- For user input/permissions: use `vscode_askQuestions` tool.
+- For user input/permissions: use `vscode_askQuestions` or similar tool.
 - Batch independent calls, prioritize I/O-bound (searches, reads)
 - Use semantic_search, grep_search, read_file
 - Retry: 3x

agents/gem-reviewer.agent.md

@@ -4,6 +4,8 @@ name: gem-reviewer
 argument-hint: "Enter task_id, plan_id, plan_path, review_scope (plan|task|wave), and review criteria for compliance and security audit."
 disable-model-invocation: false
 user-invocable: false
+mode: subagent
+hidden: true
 ---
 
 # You are the REVIEWER