kontext

📄

Deklaratívne

To, čím sa agenti riadia, je deklarované v repozitári. Jeden Markdown súbor na rozhodnutie hovorí, čo platí, odkedy a pre ktoré cesty; .ai/kontext.toml hovorí, ako sa to podáva. Nič nežije v službe ani v UI.

🔁

Reprodukovateľné

Ten istý commit dá každému kolegovi aj agentovi tie isté tímové znalosti. Lokálny index je odvodený a dá sa zmazať; ďalšie volanie ho zostaví znova. Checkoutni starší commit a agenti uvidia rozhodnutia, ktoré platili v tom commite.

↩️

Posúdené a vratné

Agenti zachytávajú do lokálneho inboxu; znalosťou tímu sa zachytenie stane až cez commit a pull request. Zrušené rozhodnutie nahradí nové, nezmaže sa, a git revert vráti zlú zmenu ako každú inú.

🧭

Jeden brief pre každého agenta

ctx_brief dá Claude Code, Codexu, Cursoru, OpenCode či ľubovoľnému MCP klientovi rozhodnutia pre cesty, ktoré pomenuje, v rámci tokenového rozpočtu (predvolene 1400). Na cesty v submodule či inom worktree odpovedá repozitár, ktorému patria.

Viac repozitárov

⏳

Neaktuálne znalosti vyplávajú

Záznam sa zapíše raz, ale jeho kód sa ďalej mení. Záznam, ktorého cesty od posledného pohľadu naň zasiahlo 20 a viac commitov (nastaviteľné), sa označí v briefe, a kontext drift vypíše, čo vetva nechala za sebou.

Aktuálnosť

🔒

Lokálny, bez služby

Jedna Rust binárka je MCP server, CLI aj git hooky. Žiadny účet ani server; nič neopustí počítač, kým to nenastavíš.

Deklaruj to

.ai/decisions/2026-09-28-prices-are-integer-cents.md.ai/kontext.toml

markdown

---
id: 2026-09-28-prices-are-integer-cents
kind: decision
title: Prices are integer cents
status: accepted
date: 2026-09-28
paths: [src/billing/**]
author: Jane Doe
---
Floats broke VAT rounding on invoices with many lines.
Every amount is stored and computed as an integer number of cents.

toml

# committed, reviewed like code
[brief]
budget_tokens = 1400     # what one brief may cost an agent
max_decisions = 12

[freshness]
threshold_commits = 20   # flag an entry after this many commits on its paths

[hooks]
validate = true          # malformed entries and secrets block the commit
trailers = true          # `Decision: <id>` on the commit that ships a decision

[secrets]
scan = "staged"          # scan every staged file, not only knowledge

Z týchto dvoch súborov kontext odvodí zvyšok:

agent, ktorý zavolá ctx_brief s focus: ["src/billing"], dostane rozhodnutie ako prvé,

kontext why src/billing/round.ts:40 ho ukáže vedľa blame a commitov, ktoré k nemu viedli,

commit, ktorý ho prináša, nesie Decision: 2026-09-28-prices-are-integer-cents,

po 20 commitoch na src/billing/** sa označí na kontrolu,

novšie rozhodnutie, ktoré ho nahradí, zaujme jeho miesto a kontext log --all zachová reťaz.

Prečo nie pamäť Claude Code alebo CLAUDE.md?

	CLAUDE.md, AGENTS.md, `.claude/rules`	Automatická pamäť Claude Code	Služby pamäte	kontext
Píše ju	ľudia, ako prózu	model, sám od seba	model, zo sessions	agenti navrhujú, ľudia schvaľujú
Zdieľaná a posúdená	v pull requestoch	nie: jeden používateľ, jeden stroj	podľa nasadenia, bez review	v pull requeste danej zmeny
K agentovi sa dostane	koreňový súbor každú session; vnorený `CLAUDE.md`, keď agent číta súbory v jeho adresári; súbor `.claude/rules` s `paths:`, keď sa dotkne zodpovedajúcich súborov	prvých 200 riadkov indexu, každú session	podľa podobnosti s dopytom	zoradená pre cesty, ktoré agent pomenuje, v rámci rozpočtu
Záznam nesie	najviac cesty (`.claude/rules`); žiadny stav, dátum ani vlastníka	čas zápisu	podľa úložiska	cesty, stav, dátum, autora, posledné overenie
Keď zastará	zostane, kým si to niekto nevšimne	model ho môže prepísať	model ho môže prepísať	označí sa po N commitoch na jeho cestách
Funguje s	Claude Code číta `AGENTS.md` natívne, rovnako Codex, Cursor a OpenCode; `.claude/rules` len Claude Code	Claude Code	ich pluginom, SDK alebo MCP serverom	každým MCP klientom a CLI

CLAUDE.md, AGENTS.md, .claude/rules

Automatická pamäť Claude Code

Služby pamäte

kontext

Píše ju

ľudia, ako prózu

model, sám od seba

model, zo sessions

agenti navrhujú, ľudia schvaľujú

Zdieľaná a posúdená

v pull requestoch

nie: jeden používateľ, jeden stroj

podľa nasadenia, bez review

v pull requeste danej zmeny

K agentovi sa dostane

koreňový súbor každú session; vnorený CLAUDE.md, keď agent číta súbory v jeho adresári; súbor .claude/rules s paths:, keď sa dotkne zodpovedajúcich súborov

prvých 200 riadkov indexu, každú session

podľa podobnosti s dopytom

zoradená pre cesty, ktoré agent pomenuje, v rámci rozpočtu

Záznam nesie

najviac cesty (.claude/rules); žiadny stav, dátum ani vlastníka

čas zápisu

podľa úložiska

cesty, stav, dátum, autora, posledné overenie

Keď zastará

zostane, kým si to niekto nevšimne

model ho môže prepísať

označí sa po N commitoch na jeho cestách

Funguje s

Claude Code číta AGENTS.md natívne, rovnako Codex, Cursor a OpenCode; .claude/rules len Claude Code

Claude Code

ich pluginom, SDK alebo MCP serverom

každým MCP klientom a CLI

kontext nenahrádza CLAUDE.md ani AGENTS.md: nechaj tam pár pokynov, ktoré potrebuje každá session. Rozhodnutí je priveľa na to, aby sa načítavali celé, a sú pridôležité na to, aby zostali neposúdené. Viac o alternatívach

Pod tvojou kontrolou

Schvaľovanie. Znalosti sa menia len cez commity. S /.ai/ @acme/architects v CODEOWNERS a povinným review od vlastníkov kódu žiadny agent nezmení to, čím sa riadia všetci agenti, bez súhlasu tohto tímu.

Auditná stopa. git log -- .ai a kontext log --all ukážu, kto čo rozhodol, kedy a čo to nahradilo. S nainštalovanými hookmi kontextu git log --grep "Decision: <id>" nájde commit, ktorý rozhodnutie priniesol.

Pravidlá v CI. kontext check zastaví pull request s chybným záznamom, duplicitným id alebo tajným údajom s vysokou istotou.

Bez uzamknutia. Úložisko je obyčajný Markdown v tvojom repozitári a dá sa čítať aj bez kontextu.

kontextDeklaratívne tímové znalosti pre coding agentov