ager-author

name	ager-author
description	Author or update AGER concepts — OrchestratorAgent, WorkerAgent, JudgeAgent, LoopPolicy/LoopControl, Tool+ToolRule, ScratchPad, Run/Trigger, FailurePolicy, KnowledgeBind. Use when editing multi-agent graphs, budgets, tool rules, or ops policies. Requires okf-plugin for link validation.

AGER Author

Create/update AGER v0.3 OKF concepts with correct fields, typed edges, and provenance.

Prerequisite

Use okf-author patterns from okf-graph-eng for general OKF rules; this skill adds AGER-specific fields.

Concept quick rules

Agents

• Always set input_schema + output_schema (path or inline)
• Workers: record_output_to: { key: worker_outputs, mode: append }
• Judges: rubrics + record_output_to: { key: judgments, mode: append }
• Optional: timeout_ms, failure_policy, retry_policy, retrievals

LoopPolicy

• Include controls covering: goal, deadline, price_budget, max_turns, no_progress as appropriate
• Set on_exhaust and on_goal
• Link graph with rel: controlled_by

Tool

• side_effects, schemas, rules[] with when + action
• Hardening: idempotency, secrets (SecretRef only), rate_limit, compensation, dual_control

ScratchPad

• Document conventional keys; lineage: full for production
• Never store SecretRef material in plaintext

Run / Trigger

• Trigger kinds: manual | webhook | cron | ticket_event | okf_change | ci
• Run status machine: queued → running → paused_human → terminal

Steps

1. Identify concept type and target path under the bundle.
2. Copy the nearest concept from the canonical ../../scaffold/ tree or sample-ager/.
3. Fill required fields; add typed links.
4. Update parent catalog index.md.
5. Append log.md entry.
6. Run ager-validate / okf validate.

References

• references/typed-edges.md
• references/loop-controls.md
• ../../scaffold/