agestra 4.14.0 → 4.14.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +1 -1
- package/.claude-plugin/plugin.json +1 -1
- package/AGENTS.md +42 -42
- package/README.ja.md +0 -2
- package/README.ko.md +0 -2
- package/README.md +0 -2
- package/README.zh.md +0 -2
- package/dist/bundle.js +408 -408
- package/package.json +1 -1
- package/skills/build-fix.md +76 -76
- package/skills/cancel.md +58 -58
- package/skills/trace.md +62 -62
- package/skills/worker-manage.md +67 -67
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
"name": "agestra",
|
|
13
13
|
"source": "./",
|
|
14
14
|
"description": "Multi-host MCP orchestration across Claude, Ollama, Gemini, and Codex for review, QA, and cross-validation",
|
|
15
|
-
"version": "4.14.
|
|
15
|
+
"version": "4.14.2",
|
|
16
16
|
"author": {
|
|
17
17
|
"name": "mua-vtuber"
|
|
18
18
|
},
|
package/AGENTS.md
CHANGED
|
@@ -1,51 +1,51 @@
|
|
|
1
|
-
# Agestra for Codex
|
|
2
|
-
|
|
3
|
-
This repository includes a Codex-friendly host wrapper for Agestra.
|
|
4
|
-
|
|
5
|
-
## First Run
|
|
6
|
-
|
|
1
|
+
# Agestra for Codex
|
|
2
|
+
|
|
3
|
+
This repository includes a Codex-friendly host wrapper for Agestra.
|
|
4
|
+
|
|
5
|
+
## First Run
|
|
6
|
+
|
|
7
7
|
1. Build the bundled MCP server if needed: `npm run bundle`
|
|
8
8
|
2. Register this checkout with Codex and install user-scope generated custom agents/skills: `npm run install:codex`
|
|
9
9
|
3. For a real npm-global install from this checkout instead, run `npm run bundle`, `npm install -g .`, then `npm run install:codex:global`
|
|
10
10
|
4. Open the target repository in Codex. Its `AGENTS.md` file is loaded automatically when the project is trusted.
|
|
11
11
|
|
|
12
12
|
Use `npm run install:codex:mcp` only when you intentionally want MCP registration without generated Codex agents/skills. Use `npm run install:codex:assets` only when you intentionally want project-local `.codex/agents` and `.codex/skills` assets in the current checkout.
|
|
13
|
-
Low-level MCP calls do not silently write setup. High-level Agestra workflows must call `setup_status` first; if it reports `Setup required: yes`, run the interactive setup questions immediately, call `setup_apply` after the user chooses providers/locale, then resume the original workflow.
|
|
14
|
-
Use `host_assets_status` to inspect generated Codex host assets, and only call `host_assets_install` after the user agrees to install or refresh Codex custom agents. The `host_assets_*` MCP tools currently manage Codex assets only.
|
|
15
|
-
|
|
16
|
-
## How to Work Here
|
|
17
|
-
|
|
18
|
-
- Default to direct Codex work using the workspace `AGENTS.md` contract, oh-my-codex workflows, and Superpowers-style skills when they apply.
|
|
19
|
-
- Use Agestra primarily for explicit multi-AI or provider orchestration requests, such as when the user names Agestra, Codex/Gemini/Ollama providers, "multi-AI", "multiple AI", "provider", `agent_debate_*`, `cli_worker_*`, or asks to gather/compare several AI opinions.
|
|
20
|
-
- 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.
|
|
21
|
-
- 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.
|
|
22
|
-
- Native helper agents are created by the active host layer. In Codex, use the generated custom agents installed from these assets; external MCP/CLI/chat providers participate through Agestra tools and never create or manage Codex native agents.
|
|
23
|
-
- Keep Agestra setup/status/provider checks as installation and health checks, not as workflow-routing triggers.
|
|
24
|
-
- Run `setup_status`, `environment_check`, and `provider_list` when the task concerns Agestra installation, MCP registration, host assets, provider availability, or before entering an Agestra workflow. If `setup_status` reports `Setup required: yes`, complete interactive setup first and then resume the original task.
|
|
25
|
-
- Do not treat ordinary review, QA, security, design, idea, implementation, cleanup, build-fix, or planning requests as Agestra workflows just because setup/status/provider checks exist.
|
|
26
|
-
- When an Agestra workflow is active, treat `commands/*.md` as the source of truth for that workflow.
|
|
27
|
-
- Prefer Agestra MCP tools over ad-hoc multi-provider prompting only when the task is actually in Agestra/multi-provider mode.
|
|
28
|
-
- If any legacy workflow text mentions old single-host Agestra execution, treat it as obsolete. Direct current-host work should happen outside Agestra workflows.
|
|
29
|
-
|
|
30
|
-
## Workflow Mapping
|
|
31
|
-
|
|
32
|
-
- When Agestra is active, review requests follow `commands/review.md`
|
|
33
|
-
- When Agestra is active, QA / verification requests follow `commands/qa.md`
|
|
34
|
-
- When Agestra is active, security audit requests follow `commands/security.md`
|
|
35
|
-
- 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.
|
|
36
|
-
- 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`.
|
|
37
|
-
- When Agestra is active, design and architecture requests follow `commands/design.md`
|
|
38
|
-
- When Agestra is active, idea discovery requests follow `commands/idea.md`
|
|
39
|
-
- When Agestra is active, implementation requests follow `commands/implement.md`
|
|
40
|
-
|
|
41
|
-
## Core MCP Tools
|
|
42
|
-
|
|
43
|
-
- `setup_status`, `environment_check`, and `provider_list`: inspect installation, host, and provider state for Agestra health checks and active Agestra workflows
|
|
44
|
-
- `agent_consensus_start` (with `agent_debate_approve`/`_continue`/`_reject`) and `agent_debate_review`: run approval-gated consensus flows from prepared `initial_aggregation`
|
|
45
|
-
- `cli_worker_spawn`, `agent_changes_review`, `agent_changes_accept`, `agent_changes_reject`: use for explicit autonomous Codex/Gemini worker tasks
|
|
46
|
-
- `host_assets_status`, `host_assets_install`, `host_assets_uninstall`: inspect and explicitly manage generated Codex host-native assets such as custom agents and skills
|
|
47
|
-
- `qa_run`: run workspace build/test verification before reporting implementation completion
|
|
48
|
-
|
|
13
|
+
Low-level MCP calls do not silently write setup. High-level Agestra workflows must call `setup_status` first; if it reports `Setup required: yes`, run the interactive setup questions immediately, call `setup_apply` after the user chooses providers/locale, then resume the original workflow.
|
|
14
|
+
Use `host_assets_status` to inspect generated Codex host assets, and only call `host_assets_install` after the user agrees to install or refresh Codex custom agents. The `host_assets_*` MCP tools currently manage Codex assets only.
|
|
15
|
+
|
|
16
|
+
## How to Work Here
|
|
17
|
+
|
|
18
|
+
- Default to direct Codex work using the workspace `AGENTS.md` contract, oh-my-codex workflows, and Superpowers-style skills when they apply.
|
|
19
|
+
- Use Agestra primarily for explicit multi-AI or provider orchestration requests, such as when the user names Agestra, Codex/Gemini/Ollama providers, "multi-AI", "multiple AI", "provider", `agent_debate_*`, `cli_worker_*`, or asks to gather/compare several AI opinions.
|
|
20
|
+
- 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.
|
|
21
|
+
- 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.
|
|
22
|
+
- Native helper agents are created by the active host layer. In Codex, use the generated custom agents installed from these assets; external MCP/CLI/chat providers participate through Agestra tools and never create or manage Codex native agents.
|
|
23
|
+
- Keep Agestra setup/status/provider checks as installation and health checks, not as workflow-routing triggers.
|
|
24
|
+
- Run `setup_status`, `environment_check`, and `provider_list` when the task concerns Agestra installation, MCP registration, host assets, provider availability, or before entering an Agestra workflow. If `setup_status` reports `Setup required: yes`, complete interactive setup first and then resume the original task.
|
|
25
|
+
- Do not treat ordinary review, QA, security, design, idea, implementation, cleanup, build-fix, or planning requests as Agestra workflows just because setup/status/provider checks exist.
|
|
26
|
+
- When an Agestra workflow is active, treat `commands/*.md` as the source of truth for that workflow.
|
|
27
|
+
- Prefer Agestra MCP tools over ad-hoc multi-provider prompting only when the task is actually in Agestra/multi-provider mode.
|
|
28
|
+
- If any legacy workflow text mentions old single-host Agestra execution, treat it as obsolete. Direct current-host work should happen outside Agestra workflows.
|
|
29
|
+
|
|
30
|
+
## Workflow Mapping
|
|
31
|
+
|
|
32
|
+
- When Agestra is active, review requests follow `commands/review.md`
|
|
33
|
+
- When Agestra is active, QA / verification requests follow `commands/qa.md`
|
|
34
|
+
- When Agestra is active, security audit requests follow `commands/security.md`
|
|
35
|
+
- 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.
|
|
36
|
+
- 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`.
|
|
37
|
+
- When Agestra is active, design and architecture requests follow `commands/design.md`
|
|
38
|
+
- When Agestra is active, idea discovery requests follow `commands/idea.md`
|
|
39
|
+
- When Agestra is active, implementation requests follow `commands/implement.md`
|
|
40
|
+
|
|
41
|
+
## Core MCP Tools
|
|
42
|
+
|
|
43
|
+
- `setup_status`, `environment_check`, and `provider_list`: inspect installation, host, and provider state for Agestra health checks and active Agestra workflows
|
|
44
|
+
- `agent_consensus_start` (with `agent_debate_approve`/`_continue`/`_reject`) and `agent_debate_review`: run approval-gated consensus flows from prepared `initial_aggregation`
|
|
45
|
+
- `cli_worker_spawn`, `agent_changes_review`, `agent_changes_accept`, `agent_changes_reject`: use for explicit autonomous Codex/Gemini worker tasks
|
|
46
|
+
- `host_assets_status`, `host_assets_install`, `host_assets_uninstall`: inspect and explicitly manage generated Codex host-native assets such as custom agents and skills
|
|
47
|
+
- `qa_run`: run workspace build/test verification before reporting implementation completion
|
|
48
|
+
|
|
49
49
|
## Project Assets
|
|
50
50
|
|
|
51
51
|
- `agents/`: canonical role prompts (`agestra-team-lead`, `agestra-research`, `agestra-debate`, `agestra-implementer`)
|
package/README.ja.md
CHANGED
package/README.ko.md
CHANGED
package/README.md
CHANGED
|
@@ -79,9 +79,7 @@ Use `npm run install:gemini:global` for Gemini.
|
|
|
79
79
|
|
|
80
80
|
## More Docs
|
|
81
81
|
|
|
82
|
-
- [docs/tool-inventory.md](docs/tool-inventory.md): MCP tool reference
|
|
83
82
|
- [commands/](commands): workflow source of truth
|
|
84
|
-
- [docs/plans/](docs/plans): design and implementation notes
|
|
85
83
|
|
|
86
84
|
## Development
|
|
87
85
|
|