Source
Where the knowledge came from: file, issue, docs page, human decision, PR, or generated artifact.
durable memory that has to show where it came from
Knowledge Kit turns useful session memory into a durable, provenance-gated knowledge store. It is for the facts, decisions, repo conventions, product boundaries, and lessons an agent should be able to reuse later without pretending chat history is evidence. Flow Agents provides the engine underneath: structured triggers, gates, adapters, sidecars, evidence, and trust records.
$ flow-agents kit activate knowledge
candidate: repo convention
source: AGENTS.md + current diff
subject: public-copy-boundary
✓ provenance present
✓ freshness checked
REVIEW authority required before durable promotion
store: .kontourai/flow-agents/knowledge/
Knowledge record
Where the knowledge came from: file, issue, docs page, human decision, PR, or generated artifact.
Who captured it, when it was observed, what changed, and which evidence backs the statement.
Whether the record is current enough to reuse, stale enough to recheck, or disputed enough to block reuse.
Whether the record is advisory, owner-reviewed, CI-backed, or an accepted exception.
The job
Agents need reusable context. They also need to know when context is stale, private, disputed, source-less, or too weak to guide the next change. Knowledge Kit makes that boundary explicit.
A useful note can be captured. A promoted record needs provenance. A stale record asks for recheck. A disputed record blocks or escalates instead of silently steering the next session.
PASS source link exists
PASS public-boundary check clean
PASS owner label present
BLOCK promotion: freshness expired
next action: re-read source, then refresh record
result: advisory until refreshed
What keeps memory useful
The agent can reuse prior knowledge only when the record still carries usable source and provenance.
Draft notes do not silently become durable guidance. The kit routes uncertain knowledge through review or recheck.
Flow Agents supplies triggers, gates, adapters, evidence records, and Trust Bundle shape. Knowledge supplies the store workflow.
Knowledge Kit is a Flow Agents kit, not a privileged runtime feature. It steers through declared triggers and gates like every other kit in the catalog.