Skip to content

[codex] clarify registered agent dispatch #504

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
chaochaoweb3 wants to merge 1 commit into
base: main
Choose a base branch
from
+6 −6
Draft

[codex] clarify registered agent dispatch #504

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions understand-anything-plugin/skills/understand/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -218,7 +218,7 @@ Set up and verify the `.understandignore` file before scanning.

Report to the user: `[Phase 1/7] Scanning project files...`

Dispatch a subagent using the `project-scanner` agent definition (at `agents/project-scanner.md`). Append the following additional context:
Dispatch a subagent with `subagent_type: understand-anything:project-scanner`. If the host cannot dispatch registered plugin agents by type, load the fallback prompt from `$PLUGIN_ROOT/agents/project-scanner.md`. Append the following additional context:

> **Additional context from main session:**
>
Expand Down Expand Up @@ -284,7 +284,7 @@ Load `.understand-anything/intermediate/batches.json` (produced by Phase 1.5). I

Report: `[Phase 2/7] Analyzing files — <totalFiles> files in <totalBatches> batches (up to 5 concurrent)...`

For each batch, dispatch a subagent using the `file-analyzer` agent definition (at `agents/file-analyzer.md`). Run up to **5 subagents concurrently**. Append the following additional context:
For each batch, dispatch a subagent with `subagent_type: understand-anything:file-analyzer`. If the host cannot dispatch registered plugin agents by type, load the fallback prompt from `$PLUGIN_ROOT/agents/file-analyzer.md`. Run up to **5 subagents concurrently**. Append the following additional context:

> **Additional context from main session:**
>
Expand Down Expand Up @@ -374,7 +374,7 @@ After batches complete:

Report to the user: `[Phase 3/7] Reviewing assembled graph...`

Dispatch a subagent using the `assemble-reviewer` agent definition (at `agents/assemble-reviewer.md`).
Dispatch a subagent with `subagent_type: understand-anything:assemble-reviewer`. If the host cannot dispatch registered plugin agents by type, load the fallback prompt from `$PLUGIN_ROOT/agents/assemble-reviewer.md`.

Pass these parameters in the dispatch prompt:

Expand Down Expand Up @@ -402,7 +402,7 @@ After the subagent completes, read `$PROJECT_ROOT/.understand-anything/intermedi
Report to the user: `[Phase 4/7] Identifying architectural layers...`

**Build the combined prompt template:**
1. Use the `architecture-analyzer` agent definition (at `agents/architecture-analyzer.md`).
1. Use `subagent_type: understand-anything:architecture-analyzer`. If the host cannot dispatch registered plugin agents by type, load the fallback prompt from `$PLUGIN_ROOT/agents/architecture-analyzer.md`.
2. **Language context injection:** For each language detected in Phase 1 (e.g., `python`, `markdown`, `dockerfile`, `yaml`, `sql`, `terraform`, `graphql`, `protobuf`, `shell`, `html`, `css`), read the file at `./languages/<language-id>.md` (e.g., `./languages/python.md`, `./languages/dockerfile.md`) and append its content after the base template under a `## Language Context` header. If the file does not exist for a detected language, skip it silently and continue. These files are in the `languages/` subdirectory next to this SKILL.md file. **Include non-code language snippets** — they provide edge patterns and summary styles for non-code files.
3. **Framework addendum injection:** For each framework detected in Phase 1 (e.g., `Django`), read the file at `./frameworks/<framework-id-lowercase>.md` (e.g., `./frameworks/django.md`) and append its full content after the language context. If the file does not exist for a detected framework, skip it silently and continue. These files are in the `frameworks/` subdirectory next to this SKILL.md file.
4. **Output locale injection:** If `$OUTPUT_LANGUAGE` is NOT `en` (English), read the locale guidance file at `./locales/<language-code>.md` (e.g., `./locales/zh.md`, `./locales/ja.md`, `./locales/ko.md`) and append its content after the framework addendums under a `## Output Language Guidelines` header. This provides language-specific guidance for tag naming conventions, summary style, and layer name translations. If the locale file does not exist for the specified language, skip silently — the `$LANGUAGE_DIRECTIVE` still applies. These files are in the `locales/` subdirectory next to this SKILL.md file.
Expand Down Expand Up @@ -484,7 +484,7 @@ All four fields (`id`, `name`, `description`, `nodeIds`) are required.

Report to the user: `[Phase 5/7] Building guided tour...`

Dispatch a subagent using the `tour-builder` agent definition (at `agents/tour-builder.md`). Append the following additional context:
Dispatch a subagent with `subagent_type: understand-anything:tour-builder`. If the host cannot dispatch registered plugin agents by type, load the fallback prompt from `$PLUGIN_ROOT/agents/tour-builder.md`. Append the following additional context:

> **Additional context from main session:**
>
Expand Down Expand Up @@ -677,7 +677,7 @@ If the script exits non-zero, read stderr, fix the script, and retry once.

If `--review` IS in `$ARGUMENTS`, dispatch the LLM graph-reviewer subagent as follows:

Dispatch a subagent using the `graph-reviewer` agent definition (at `agents/graph-reviewer.md`). Append the following additional context:
Dispatch a subagent with `subagent_type: understand-anything:graph-reviewer`. If the host cannot dispatch registered plugin agents by type, load the fallback prompt from `$PLUGIN_ROOT/agents/graph-reviewer.md`. Append the following additional context:

> **Additional context from main session:**
>
Expand Down