agestra 4.13.5 → 4.14.1

package/.claude-plugin/marketplace.json

@@ -12,7 +12,7 @@
       "name": "agestra",
       "source": "./",
       "description": "Multi-host MCP orchestration across Claude, Ollama, Gemini, and Codex for review, QA, and cross-validation",
-      "version": "4.13.5",
+      "version": "4.14.1",
       "author": {
         "name": "mua-vtuber"
       },

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agestra",
-  "version": "4.13.5",
+  "version": "4.14.1",
   "description": "Claude Code plugin — multi-host MCP orchestration across Claude, Ollama, Gemini, and Codex for review, QA, and cross-validation",
   "mcpServers": {
     "agestra": {

package/.gemini/commands/agestra/design.toml

@@ -1,16 +1,16 @@
-description = "Run the Agestra design workflow for an architecture or implementation topic."
+# Generated by Agestra. Managed file.
+description = "Explore architecture and design trade-offs before implementation"
 prompt = """
-You are executing the Agestra design workflow inside Gemini CLI.
+You are executing the `/agestra design` Gemini command.
 
-User topic:
-{{args}}
+- Start with `setup_status`, then `environment_check` and `provider_list`.
+- For investigation-including workflows, route through `agent_research_consensus_start`.
+- Host research consensus contract:
+  호스트가 조사한다.
+  호스트가 정리한다.
+  시스템이 토론한다.
+  호스트가 문서화한다.
+- External AI research and debate run in separate fresh sessions, even when the same provider participates in both phases.
 
-Use the shared workflow spec below as the source of truth and adapt it to the current Gemini host session:
 @{commands/design.md}
-
-Gemini-specific rules:
-- Start with `setup_status`, then `environment_check` and `provider_list`.
-- Prefer Agestra MCP tools, workspace documents, and debate flows over free-form brainstorming.
-- Translate Claude-specific wording into leader-host wording when Gemini is the active host.
-- Keep the final answer in the user's language.
 """

package/.gemini/commands/agestra/idea.toml

@@ -1,16 +1,16 @@
-description = "Run the Agestra idea workflow to discover improvements or compare options."
+# Generated by Agestra. Managed file.
+description = "Discover and refine ideas with Agestra"
 prompt = """
-You are executing the Agestra idea workflow inside Gemini CLI.
+You are executing the `/agestra idea` Gemini command.
 
-User topic:
-{{args}}
+- Start with `setup_status`, then `environment_check` and `provider_list`.
+- For investigation-including workflows, route through `agent_research_consensus_start`.
+- Host research consensus contract:
+  호스트가 조사한다.
+  호스트가 정리한다.
+  시스템이 토론한다.
+  호스트가 문서화한다.
+- External AI research and debate run in separate fresh sessions, even when the same provider participates in both phases.
 
-Use the shared workflow spec below as the source of truth and adapt it to the current Gemini host session:
 @{commands/idea.md}
-
-Gemini-specific rules:
-- Start with `setup_status`, then `environment_check` and `provider_list`.
-- Prefer Agestra MCP tools, workspace documents, and provider comparisons over one-shot brainstorming.
-- Translate Claude-specific wording into leader-host wording when Gemini is the active host.
-- Keep the final answer in the user's language.
 """

package/.gemini/commands/agestra/implement.toml

@@ -1,17 +1,16 @@
-description = "Run the Agestra implementation workflow with leader-only or multi-provider execution."
+# Generated by Agestra. Managed file.
+description = "Coordinate implementation through Agestra"
 prompt = """
-You are executing the Agestra implementation workflow inside Gemini CLI.
+You are executing the `/agestra implement` Gemini command.
 
-User task:
-{{args}}
+- Start with `setup_status`, then `environment_check` and `provider_list`.
+- For investigation-including workflows, route through `agent_research_consensus_start`.
+- Host research consensus contract:
+  호스트가 조사한다.
+  호스트가 정리한다.
+  시스템이 토론한다.
+  호스트가 문서화한다.
+- External AI research and debate run in separate fresh sessions, even when the same provider participates in both phases.
 
-Use the shared workflow spec below as the source of truth and adapt it to the current Gemini host session:
 @{commands/implement.md}
-
-Gemini-specific rules:
-- Start with `setup_status`, then `environment_check` and `provider_list`.
-- Prefer Agestra MCP tools and worker orchestration over ad-hoc shell-heavy implementation plans.
-- Treat "Leader-host only" as the Gemini-led local path when Gemini is the active host.
-- Use the shared `agestra-implementer` role semantics for host-local code edits.
-- Keep the final answer in the user's language.
 """

package/.gemini/commands/agestra/qa.toml

@@ -1,16 +1,16 @@
-description = "Run the Agestra QA workflow for document-based verification and optional E2E."
+# Generated by Agestra. Managed file.
+description = "Run document-first QA with Agestra"
 prompt = """
-You are executing the Agestra QA workflow inside Gemini CLI.
+You are executing the `/agestra qa` Gemini command.
 
-User target:
-{{args}}
+- Start with `setup_status`, then `environment_check` and `provider_list`.
+- For investigation-including workflows, route through `agent_research_consensus_start`.
+- Host research consensus contract:
+  호스트가 조사한다.
+  호스트가 정리한다.
+  시스템이 토론한다.
+  호스트가 문서화한다.
+- External AI research and debate run in separate fresh sessions, even when the same provider participates in both phases.
 
-Use the shared workflow spec below as the source of truth and adapt it to the current Gemini host session:
 @{commands/qa.md}
-
-Gemini-specific rules:
-- Start with `setup_status`, then `environment_check` and `provider_list`.
-- Prefer Agestra MCP tools and prompt assets over ad-hoc QA prompting.
-- If the workflow refers to Claude-specific wording, translate it to the current leader-host path rather than asking the user to switch hosts.
-- Keep the final answer in the user's language.
 """

package/.gemini/commands/agestra/research.toml

@@ -0,0 +1,16 @@
+# Generated by Agestra. Managed file.
+description = "Run research using a selected investigation topology"
+prompt = """
+You are executing the `/agestra research` Gemini command.
+
+- Start with `setup_status`, then `environment_check` and `provider_list`.
+- For investigation-including workflows that continue into domain consensus, route through `agent_research_consensus_start`.
+- Host research consensus contract:
+  호스트가 조사한다.
+  호스트가 정리한다.
+  시스템이 토론한다.
+  호스트가 문서화한다.
+- External AI research and debate run in separate fresh sessions, even when the same provider participates in both phases.
+
+@{commands/research.md}
+"""

package/.gemini/commands/agestra/review.toml

@@ -1,16 +1,16 @@
-description = "Run the Agestra review workflow for a target, diff, or feature."
+# Generated by Agestra. Managed file.
+description = "Run a code or document review with Agestra"
 prompt = """
-You are executing the Agestra review workflow inside Gemini CLI.
+You are executing the `/agestra review` Gemini command.
 
-User target:
-{{args}}
+- Start with `setup_status`, then `environment_check` and `provider_list`.
+- For investigation-including workflows, route through `agent_research_consensus_start`.
+- Host research consensus contract:
+  호스트가 조사한다.
+  호스트가 정리한다.
+  시스템이 토론한다.
+  호스트가 문서화한다.
+- External AI research and debate run in separate fresh sessions, even when the same provider participates in both phases.
 
-Use the shared workflow spec below as the source of truth and adapt it to the current Gemini host session:
 @{commands/review.md}
-
-Gemini-specific rules:
-- Start with `setup_status`, then `environment_check` and `provider_list`.
-- Prefer Agestra MCP tools and prompt assets over ad-hoc review prompting.
-- If the workflow refers to Claude-specific wording, translate it to the current leader-host path rather than asking the user to switch hosts.
-- Keep the final answer in the user's language.
 """

package/.gemini/commands/agestra/security.toml

@@ -1,17 +1,16 @@
-description = "Run the Agestra dedicated security audit workflow."
+# Generated by Agestra. Managed file.
+description = "Run a security review with Agestra"
 prompt = """
-You are executing the Agestra security workflow inside Gemini CLI.
+You are executing the `/agestra security` Gemini command.
 
-User target:
-{{args}}
+- Start with `setup_status`, then `environment_check` and `provider_list`.
+- For investigation-including workflows, route through `agent_research_consensus_start`.
+- Host research consensus contract:
+  호스트가 조사한다.
+  호스트가 정리한다.
+  시스템이 토론한다.
+  호스트가 문서화한다.
+- External AI research and debate run in separate fresh sessions, even when the same provider participates in both phases.
 
-Use the shared workflow spec below as the source of truth and adapt it to the current Gemini host session:
 @{commands/security.md}
-
-Gemini-specific rules:
-- Start with `setup_status`, then `environment_check` and `provider_list`.
-- Prefer Agestra MCP tools and prompt assets over ad-hoc security prompting.
-- If the workflow refers to Claude-specific wording, translate it to the current leader-host path rather than asking the user to switch hosts.
-- Do not run destructive exploit tests or ask the user to paste real secrets.
-- Keep the final answer in the user's language.
 """

package/.gemini/commands/agestra/setup.toml

@@ -1,12 +1,7 @@
-description = "Run the Agestra setup workflow for provider selection and UI language."
+# Generated by Agestra. Managed file.
+description = "Select AI providers and UI language for Agestra workflows"
 prompt = """
-You are executing the Agestra setup workflow inside Gemini CLI.
+You are executing the `/agestra setup` Gemini command.
 
-Use the shared workflow spec below as the source of truth and adapt it to the current Gemini host session:
 @{commands/setup.md}
-
-Gemini-specific rules:
-- Start with `environment_check`, `provider_list`, and `setup_status`.
-- Prefer Agestra MCP tools over ad-hoc shell edits.
-- Keep all user-facing questions and the final answer in the user's language.
 """

package/GEMINI.md

@@ -2,11 +2,14 @@
 
 This repository includes Gemini-native wrapper assets for Agestra.
 
+Runtime contract: native helper agents are a capability of the active host layer. External MCP/CLI/chat providers participate in Agestra workflows, but they do not create or manage Gemini native agents. These generated Gemini assets are host-neutral workflow assets; verify real Gemini native-agent team behavior before claiming parity with Claude nested teams or Codex custom-agent behavior.
+
 ## First Run
 
 1. Build the bundled MCP server if needed: `npm run bundle`
-2. Register Agestra with Gemini in this project: `npm run install:gemini`
-3. Open the repository in Gemini CLI. `GEMINI.md` and `.gemini/commands/` are loaded automatically.
+2. Register this checkout with Gemini and install the user-scope `agestra` extension: `npm run install:gemini`
+3. For a real npm-global install from this checkout instead, run `npm run bundle`, `npm install -g .`, then `npm run install:gemini:global`
+4. Open the target repository in Gemini CLI. `GEMINI.md` and `.gemini/commands/` are loaded automatically when present.
 
 ## Project Commands
 
@@ -23,17 +26,28 @@ Each command delegates to the shared workflow specs in `commands/*.md`.
 
 ## Usage Rules
 
+- Plain review/QA/check requests without `/agestra` or explicit multi-AI/provider wording stay with the current host; they are not Agestra natural-language auto-triggers.
+- Agestra natural-language routing requires explicit multi-AI/provider wording such as "multiple AIs", "all AIs", "other AI", "multi-AI", "Codex and Gemini", "provider comparison", or "프로바이더 비교". Explicit `/agestra ...` commands remain supported.
 - Start orchestration requests with `setup_status`, then `environment_check` and `provider_list`.
 - Prefer Agestra MCP tools instead of rebuilding workflows in free-form prompts.
 - Treat `commands/*.md` and `agents/*.md` as the canonical workflow and role assets.
-- If any legacy shared workflow text mentions "Claude only", translate that to the current leader-host-only path when Gemini is the active host.
+- Keep native agent creation host-owned. Providers reached through MCP, CLI workers, or chat are participants only.
+- For investigation-including workflows, route through `agent_research_consensus_start`.
+- Use this host research consensus contract verbatim:
+  호스트가 조사한다.
+  호스트가 정리한다.
+  시스템이 토론한다.
+  호스트가 문서화한다.
+- External AI research and debate run in separate fresh sessions, even when the same provider participates in both phases.
+- If any legacy shared workflow text mentions old single-host Agestra execution, treat it as obsolete. Direct current-host work should happen outside Agestra workflows.
 
 ## Core MCP Tools
 
-- `agent_debate_structured`, `agent_debate_approve`/`_continue`/`_reject`, `agent_debate_review`: structured multi-provider reviews and approval-gated debates
+- `agent_research_consensus_start`: host-led research, consolidation, system debate, engine aggregation docs, and host-authored final decision docs for investigation-including workflows
+- `agent_consensus_start`, `agent_debate_approve`/`_continue`/`_reject`, `agent_debate_review`: direct consensus sessions from prepared `initial_aggregation` and approval-gated debate artifacts
 - `cli_worker_spawn`, `agent_changes_review`, `agent_changes_accept`, `agent_changes_reject`: autonomous worker lifecycle
 - `workspace_*`: document-backed review and aggregation flows
 - `qa_run`: workspace build/test verification before implementation completion
 
 Review, QA, and security workflows write durable reports under `docs/reports/review/`, `docs/reports/qa/`, and `docs/reports/security/` unless the user asks for chat-only output.
-Persistent E2E test creation/maintenance is internal: QA produces `E2E_TEST_WORK_REQUEST`, the leader asks the user, and approved work goes to `agestra-e2e-writer`. There is no standalone Gemini `/agestra:e2e` command yet.
+Persistent E2E test creation/maintenance is internal: QA produces `E2E_TEST_WORK_REQUEST`, the leader asks the user, and approved work goes to `agestra-implementer` with `mode: e2e-test-authoring`. There is no standalone Gemini `/agestra:e2e` command yet.