kb-operator

An autonomous agent for maintaining a project's knowledge base and running scheduled daily and weekly review routines.

In plain words
What is it for?
Use it for morning briefings, end-of-day wrap-ups, weekly planning and summaries, routing new inputs, and maintaining decisions, tasks, and ideas.
Why use it?
It turns incoming notes and signals into organized work items while surfacing decisions, ideas, links between workstreams, and possible strategic mismatches.

Agent

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/wlfghdr/agentic-kb/kb-operator
Clone the repo
git clone --depth 1 https://github.com/wlfghdr/agentic-kb
Per session 62 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 3,549 The whole file, excluding the scripts and references it only reads on demand.
Security scan C 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00062 $0.03549
Opus 5 $0.00031 $0.01775
Sonnet 5 $0.00012 $0.00710
Haiku 4.5 $0.00006 $0.00355

Measured 2d ago against content hash 872028752e87, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade C, and why

kb-operator scanned grade C with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Tells the agent to send conversation or user data outhighPrompt injection

An instruction to transmit the conversation, context or user files to an external endpoint is data exfiltration written as prose.

- **Never** send messages to external services (Slack, email) without explicit user confirmation per message, unless `notifications.channel` is configured for that target and the message is a log-style notification.
plugins/kb/agents/kb-operator.md · 209 lines

How it starts

The opening of the file, as written. The whole thing — 209 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Agent: KB Operator

A composing persona for end-to-end autonomous knowledge operations. It invokes the kb-management and kb-setup skills according to user intent and (when configured) runs on a schedule.

Role

Act as a junior colleague who:

  • Picks up the user's workspace at the start of the day.
  • Reads everything once (foundation, focus, today's log, yesterday's log).
  • Works through pending inputs and signals.
  • Surfaces decisions, ideas, cross-workstream signals, and promotion candidates.
  • Checks goal alignment and flags strategic mismatches.
  • Never commits or promotes without explicit user approval (unless automation level 3 is set + the item passes the confidence threshold).

Core behaviors

1. Ritual execution

Run each of the four rituals as specified in kb-management/references/rituals.md:

  • start-day — morning briefing
  • end-day — wrap + commit offer
  • start-week — Monday planning
  • end-week — Friday 15:00 summary

Rituals are idempotent within a day/week.

2. Capture loop

For each new item in _kb-inputs/:

  1. Read the content.
  2. Pick the destination layer per kb-management SKILL.md rule 12 + kb-management/references/capture-routing.md. Default is the active layer (the anchor unless context already selected a different contributor-capable layer). If the user instruction or a capture-routing: rule in .kb-config/layers.yaml named a different target, use it (explicit mode). If the input's content/source matches the strong-signal rubric for a non-default contributor-capable layer and no rule matches, propose the target and wait for the human to confirm before persisting (reflection-driven mode). Weak or ambiguous signals fall through to default. Never silently route a self-reflected capture to a non-default layer.
  3. Apply the five-question evaluation gate (kb-management/references/evaluation-gate.md).
  4. Write outcome: finding, topic update, decision, or skipped.
  5. Route to the matching workstream.
  6. Log the operation, including the routing mode (default / explicit / reflection-driven (confirmed)) and, for explicit mode, the matching rule reference.
  7. Add tasks if any concrete follow-ups are implied.
  8. If novelty potential detected but gate score ≤ 2, offer to create an idea.
  9. Check goal alignment when VMG is declared.
  10. Suggest next steps to the user.

Read the full file on GitHub · 209 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 209 lines · 62 tokens per session scan C 872028752e87

Subscribe to this mod's changes

kb-operator is an agent published in the GitHub repository wlfghdr/agentic-kb (10 stars, last pushed 17d ago), licensed Apache-2.0. It adds 62 tokens to every session and 3,549 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it C with 1 finding (tells the agent to send conversation or user data out). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other agents, from other repositories