ager-init-graph

name	ager-init-graph
description	Scaffold an OKF Agent Graph (AGER) bundle with orchestrator/workers/judge layout, LoopPolicy, ScratchPad, FailurePolicy, and sample Tool. Use when starting multi-agent graphs, AGER configs, or loop-engineering scaffolds. Requires okf-plugin (okf-graph-eng).

AGER Init Graph

Scaffold a multi-agent loop engineering OKF bundle (AGER v0.3).

Prerequisite

okf-graph-eng must be installed (SpillwaveSolutions/okf-plugin). Use it for final validate / impact.

When to use

• New multi-agent system design in OKF
• User asks for orchestrator/workers, judges, loop budgets, tool policies
• Converting a project to AGER layout

Steps

1. Confirm target directory (default .okf/ or agent-graph/ at repo root).
2. Run the deterministic generator from the plugin root:

python3 <plugin-root>/scripts/ager-init.py <bundle> --title "<graph title>"

The command refuses an existing destination, renders into a temporary directory, runs strict AGER validation, and installs the bundle atomically. 3. The generated structure is:

<bundle>/
├── index.md
├── log.md
├── agents/
├── runtime/          # LoopPolicy, ScratchPad, Checkpoint, edges
├── ops/              # Failure, Retry, Run, Trigger, limits
├── evaluation/       # Rubrics
├── memory/           # KnowledgeBind, Retrieval
├── tools/
├── models/
├── patterns/
└── schemas/

4. Customize the illustrative research graph without deleting required contracts.
5. Root index.md keeps okf_version: "0.2" and ager_version: "0.3.0".
6. Absolute links only: [Lead](/agents/lead-researcher.md).
7. Validate:
   • AGER structural checks (required fields per type)
   • okf validate / okf-graph.py validate from okf-plugin
8. Report paths + any errors.

Rules

• Do not invent domain content beyond one illustrative research/example graph.
• Every file: YAML frontmatter with type, title, description, timestamp (and ager_version on AGER types).
• Prefer record_output_to: { key, mode: append } on workers/judges.
• Link FailurePolicy via on_failure / failure_policy field.

Canonical scaffold

The complete source tree lives at <plugin-root>/scaffold/. Do not recreate a second template tree under this skill; tests keep the generated scaffold valid.

Done when

• Bundle exists with agents + runtime + ops
• LoopPolicy includes goal + deadline + price + max_turns + no_progress
• okf validate (if available) reports no broken links