Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
30 changes: 13 additions & 17 deletions plugins/agent-stack/skills/agent-orchestrator/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,8 @@ name: agent-orchestrator
description: >-
Use when building an agent system — an orchestrator, an LLM-powered tool, a chatbot with tool
use, an AI pipeline — or metering and billing the LLM access it burns. Covers tool-calling
loops, pipelines with human checkpoints, provider routing with fallback/retry, four-layer
memory with confidence decay, context budgets, sub-agent coordination, error hierarchies; the
loops, pipelines with human checkpoints, provider routing with fallback/retry, memory
architecture, retrieval and decay, context budgets, sub-agent coordination, error hierarchies; the
work as a graph — parallel layers, fake edges, a checker before convergence; for resale:
tiered wallets, one markup boundary, two-phase commit across database and provider API,
spend-delta polling, budget and loop guards, per-tenant keys. Triggers - "agent",
Expand Down Expand Up @@ -232,23 +232,19 @@ Four layers, each with a different lifetime and a different reason to exist:
| 3 Long-term learnings | per resource | months | what worked, with a confidence score |
| 4 Insights | per project | permanent | conclusions that outlived their resource |

Read `references/patterns.md` for the data models, **Confidence Management**
(how a learning decays and when it is retired), **Learning Extraction
Heuristics**, **Fuzzy Deduplication** and **Conflict Resolution** — the four
mechanisms that decide what actually enters layers 3 and 4.
What enters layers 3 and 4 is decided by `references/patterns.md` — **Confidence
Management**, **Learning Extraction Heuristics**, **Fuzzy Deduplication**, **Conflict
Resolution**.

**The trap is the budget, not the storage.** Every layer competes for the same
context window, so allocation has to be decided per call rather than per layer:
a session that trims chat history to fit a large set of learnings has quietly
chosen old generalities over what the user said sixty seconds ago. Give layer 1
a floor.
**These four are lifetimes, and lifetime is not the taxonomy.** Layers 3 and 4 are
*experiential*; **nothing here is a factual store**, and a stale fact about the USER makes
the agent rude while one about the ENVIRONMENT makes it wrong. Retrieval is absent here and
is four decisions, the first of which — whether to retrieve at all — fails as a confident
answer built from nothing, in no error log.

**Layer 0 — carryover state.** Goal, artifacts, verified work and restrictive
mode cross a compaction boundary as copied typed blocks, not prose (§12).

**Workspace scale.** Managing persistent workspaces rather than sessions shifts
the scopes — run, workspace, global, doctrine — and adds the journal-spine
rules: `references/patterns.md` → **Workspace-scale memory**.
**Design a memory layer from
[`references/memory-architecture.md`](references/memory-architecture.md)**, not from this
table. It also carries the context-budget trap, layer 0 carryover and workspace scale.
## 8. Self-Learning Feedback Loops

Three cycles feed the memory layers, and they differ by what supplies the signal: a failed
Expand Down
Loading
Loading