Skip to main content
AI/MLjmagly

aiwg-orchestrate

Route structured artifact work to AIWG workflows via MCP with zero parent context cost

Stars
141
Source
jmagly/aiwg
Updated
2026-05-31
Slug
jmagly--aiwg--aiwg-orchestrate
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/jmagly/aiwg/HEAD/agentic/code/frameworks/sdlc-complete/templates/hermes/skills/aiwg-orchestrate/SKILL.md -o .claude/skills/aiwg-orchestrate.md

Drops the SKILL.md into .claude/skills/aiwg-orchestrate.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

When to Use

Use when the user asks for:

  • A requirements document, architecture decision record, test plan, or risk register
  • A multi-step workflow with persistent output in .aiwg/
  • Template-driven structured documents
  • Recovery-oriented staged execution with checkpoints

Do NOT use for one-off questions, short tasks, or conversational replies.

Procedure

  1. Confirm the task needs a persistent AIWG artifact
  2. Identify the workflow: workflow-run with the appropriate workflow name
  3. Use delegate_task to isolate the AIWG interaction:
delegate_task(
    goal="Run AIWG workflow: [workflow-name] for [description]. Save artifact to .aiwg/[category]/[filename].md",
    context="Project: [project name]. Key constraint: [if any]."
)

Note: Child agents automatically exclude context files (AGENTS.md, SOUL.md) and memory (MEMORY.md, USER.md) — this is hardcoded behavior, not configurable per-call. The delegation model is set globally in ~/.hermes/config.yaml under delegation.model.

  1. When the child returns, extract: artifact path + one-sentence summary
  2. Store in MEMORY.md: [date] Created [type] at [path]: [summary]
  3. Report the result to the user with the artifact path

Context Cost

Approach Parent context cost
Direct MCP calls 3,000-8,000 tokens per workflow
This skill (delegate_task) ~150-250 tokens per workflow

Over a session with 5 workflows: 1,250 tokens vs. 40,000 tokens.

Memory Rule

Store in MEMORY.md:

[YYYY-MM-DD] Created [artifact-type] at [path]: [one-sentence summary]

Never store artifact body content in memory. The artifact lives in .aiwg/ — use artifact-read to access it.

Pitfalls

  • Do NOT load artifact content into parent context after delegation — defeats the purpose
  • Do NOT skip delegation for "quick" AIWG calls — even small tool results accumulate
  • Context isolation is automatic in delegate_task — child agents never see AGENTS.md or memory files

Verification

After delegation returns:

  1. Confirm the artifact path exists under .aiwg/
  2. Confirm the summary accurately describes the artifact
  3. If the user asks to see the artifact, use artifact-read (not memory recall)

References

  • @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/README.md — SDLC framework context and workflow catalog
  • @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/context-bloat.md — Minimizing context cost via delegation
  • @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/subagent-scoping.md — Focused subagent delegation patterns
  • @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/implicit-dependencies.md — Passing required context to delegated agents
  • @$AIWG_ROOT/docs/cli-reference.md — CLI reference for AIWG workflow commands