Úvod

kontext sú deklaratívne tímové znalosti pre coding agentov. Rozhodnutia, konvencie a úskalia, ktorými sa tvoji agenti riadia, sú súbory v repozitári, schválené v pull requestoch ako kód. kontext ich dáva každému agentovi a prepája ich s commitmi, ktorých sa týkajú.

Je to jedna Rust binárka, ktorá je zároveň tromi vecami:

• MCP server (kontext mcp), ktorý môžu volať Claude Code, Codex, Cursor, OpenCode a každý ďalší MCP klient,
• CLI pre ľudí (kontext brief, kontext why, kontext log, …),
• sada git hookov, ktoré znalosti validujú, prepájajú s commitmi a udržiavajú aktuálny vyhľadávací index.

Problém

Coding agenti si dnes vedú vlastnú pamäť a žiadna z nich nie je stavaná pre tím:

• Automatickú pamäť Claude Code píše model sám od seba a ukladá ju pre každého používateľa zvlášť do ~/.claude/projects/<project>/memory/. Prvých 200 riadkov jej indexu sa načíta do každej session. Agenti kolegov ju nikdy neuvidia a nikto ju neschvaľuje.
• CLAUDE.md a AGENTS.md sú zdieľané, ale každý je próza, ktorá sa celá načíta do každej session. Pravidlo nemá vlastníka, dátum ani stav a zastarané tam zostane, kým si to niekto nevšimne.
• Služby pamäte ako mem0, claude-mem či Zep nechajú model vyťažiť zo sessions fakty a vybavujú ich podľa podobnosti. Zlý záver uložený raz sa vybavuje všetkým a nikto ho neodsúhlasil.

Ani jedna nevie odpovedať na to, na čo sa pýta tech lead alebo audítor: ktorými rozhodnutiami sa naši agenti riadia v kóde fakturácie, kto ich prijal a kedy?

Deklaratívne, reprodukovateľné, posúdené

kontext narába so znalosťami tímu tak, ako Nix so systémom: želaný zdieľaný stav je deklarovaný v súboroch a jeho vyhľadávacie indexy sa z nich odvodia.

---
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.

# .ai/kontext.toml: committed, reviewed like code
[brief]
budget_tokens = 1400     # what one brief may cost an agent

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

[hooks]
trailers = true          # `Decision: <id>` on the commit that ships a decision

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

• Deklaratívne. Súbor rozhodnutia hovorí, čo platí, odkedy a pre ktoré cesty. .ai/kontext.toml hovorí, ako sa znalosti podávajú a stráži. Oboje je v commite; 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. To, čo kontext drží v .git/kontext/ (vyhľadávací index, cache), je odvodené: zmaž to a ďalšie volanie to zostaví s rovnakým výsledkom. Checkoutni starší commit a agenti uvidia rozhodnutia, ktoré platili v tom commite.
• Posúdené a vratné. Agenti zachytávajú do lokálneho inboxu. Zachytenie sa stane znalosťou tímu, až keď sa povýši do commitu a zlúči cez pull request, takže ľudia, ktorí posudzujú kód, posúdia aj to, čím sa budú agenti riadiť. Rozhodnutie sa ruší novším, ktoré ho nahradí, kontext log --all zachová reťaz a git revert vráti zlú zmenu.

Brief ukazuje aj tvoje poznámky z inboxu a, ak ich nastavíš, sekcie adaptérov. Tie sú lokálne; tímovú časť určuje commit.

Prečo nie niečo iné?

	CLAUDE.md, AGENTS.md	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	celý súbor, každú session	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	žiadny stav, dátum ani vlastníka	čas zápisu	podľa úložiska	cesty, stav, dátum, autora
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 (predvolene 20)
Funguje s	Claude Code; ostatní čítajú AGENTS.md	Claude Code	ich pluginom, SDK alebo MCP serverom	každým MCP klientom a CLI

• Pravidlá s cestami. .claude/rules/ v Claude Code vie obmedziť pravidlo na cesty. Pravidlo však stále nemá stav, vlastníka ani históriu a ostatní agenti ho nečítajú.
• Priečinok s ADR. Nechaj ho. kontext číta existujúce ADR tam, kde sú, a dáva ich agentom podľa ciest: pozri Zavedenie do existujúceho repozitára.
• Wiki. Žije mimo repozitára, takže sa neposudzuje s kódom, ktorý opisuje, a agent nevie, ktorá stránka ešte platí.

kontext CLAUDE.md nenahrádza. Nechaj v ňom 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é; kontext connect claude-hooks dá brief na začiatok každej session Claude Code.

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: pozri Validácia znalostí v CI.
• Dáta zostávajú lokálne. Žiadny účet ani server. Nič neopustí počítač, kým to nenastavíš, a adaptéry deklarované v repozitári sa spustia až po kontext trust: pozri Bezpečnosť a súkromie.
• Bez uzamknutia. Úložisko je obyčajný Markdown a dá sa čítať aj bez kontextu. Keď kontext odstrániš, súbory zostanú.

Ako vyzerá deň s kontextom

1. Agent začne úlohu a zavolá ctx_brief s cestami, na ktoré siahne. Dostane rozhodnutia a úskalia, ktoré pre ne platia.
2. Počas práce volá ctx_search, ctx_read a ctx_why namiesto toho, aby históriu objavoval znova.
3. Keď sa ustáli niečo trvalé (rozhodnutie, konvencia, úskalie), zavolá ctx_capture.
4. Pred commitom zavolá ctx_prepare_commit, ktorý povýši relevantných kandidátov do zmeny. Hook ich zvaliduje, preskenuje na tajné údaje a doplní trailery Decision: <id>.
5. Pull request nesie kód aj znalosti spolu. Po merge dostanú agenti všetkých kolegov nové rozhodnutie v najbližšom briefe.

Princípy

• Git + Markdown je zdieľaná pravda. Indexy, cache a snapshoty sú odvodené. Počas čakajúcej práce ponechajte inbox/históriu, čakajúce doručenia adaptérom a potvrdenia operácií; držia lokálny workflow a identitu opakovania.
• Agenti nikdy sami nemenia zdieľanú pravdu. Zachytenie skončí v lokálnom inboxe. Znalosťou tímu sa stane, až keď ho povýšiš do commitu. Vtedy sa objaví v diffe a posudzuje sa spolu s kódom, ktorý vysvetľuje.
• Stručné je lepšie než úplné. Každá odpoveď pre agenta má tokenový rozpočet. Detaily sú dostupné na požiadanie cez úrovne (L0 jeden riadok, L1 prehľad, L2 celé).
• Hooky nikdy nečakajú na sieť. Commity zostávajú okamžité.
• Všetko ostatné je voliteľné. Archívy sessions, grafy kódu a sémantickú pamäť možno pripojiť ako adaptéry, každý pár riadkov konfigurácie. kontext funguje aj bez nich.

Kam ďalej

• Nainštaluj kontext
• Rýchly štart: zavedenie do repozitára za päť minút
• Architektúra: ako do seba časti zapadajú