| name | inject |
| description | Load relevant .agents context. |
| practices | ["wiki-knowledge-surface","pragmatic-programmer"] |
| hexagonal_role | driving-adapter |
| consumes | [] |
| produces | [] |
| context_rel | [] |
| skill_api_version | 1 |
| user-invocable | false |
| context | {"window":"fork","intent":{"mode":"none"},"sections":{"exclude":["TASK"]},"intel_scope":"full"} |
| metadata | {"tier":"background","dependencies":[],"internal":true} |
| output_contract | stdout: injected knowledge summary |
DEPRECATED (removal target: v3.0.0) — Use ao lookup --query "topic" for on-demand learnings retrieval and ao context assemble for phase-scoped context packets. This skill and the ao inject CLI command still work as compatibility adapters, but they are not the canonical context path and are not called from default hooks or other skills.
Inject Skill
On-demand knowledge retrieval. Not run automatically at startup (since ag-8km).
It is read-only: it only reads knowledge for injection and never writes to .agents/.
Load relevant prior knowledge into the current session as a legacy adapter.
Lease
| Field | Value |
|---|
| Lease | retire-candidate |
| Replacement port | retrieve_context / assemble_context |
| Replacement adapters | ao lookup, ao context assemble, knowledge brief artifacts |
| Current allowed use | manual compatibility lookup only |
| Not allowed | default startup injection, hidden hook delivery, task planning |
How It Works
In the default manual startup mode, MEMORY.md is auto-loaded by Claude Code and no startup injection occurs. Prefer ao lookup for on-demand retrieval and ao context assemble when a phase needs a bounded packet. Use /inject or ao inject only for legacy compatibility.
In lean or legacy startup modes (set via AGENTOPS_STARTUP_CONTEXT_MODE), the SessionStart hook runs:
ao inject --apply-decay --format markdown --max-tokens 400 \
[--bead <bead-id>] [--predecessor <handoff-path>]
ao inject --apply-decay --format markdown --max-tokens 800 \
[--bead <bead-id>] [--predecessor <handoff-path>]
This legacy path searches for relevant knowledge and prints a bounded summary.
Work-Scoped Injection
When --bead is provided (via HOOK_BEAD env var from Gas Town):