imprimatur
llms.txt0 starsChanged 4 days agoMITView on GitHub
Imprimatur is a local tool that keeps the work coding agents do in a repo in front of the user (primarily Claude Code; Cursor and Codex too, through MCP). To… These documents are kept by Imprimatur from its database; read them before changing what they describe.
In this repository33 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- adopt-docsSkill
- ask-mattSkill
- codebase-designSkill
- code-reviewSkill
- diagnosing-bugsSkill
- docs-sync-auditSkill
- documentation-writerSkill
- domain-modelingSkill
- exerciseSkill
- grillingSkill
- grill-meSkill
- grill-with-docsSkill
- handoffSkill
- i-have-adhdSkill
- implementSkill
- implement-specSkill
- imprimatur-statsSkill
- improve-codebase-architectureSkill
- issuesSkill
- prototypeSkill
- researchSkill
- social-postSkill
- studySkill
- tddSkill
- to-questionnaireSkill
- to-specSkill
- to-ticketsSkill
- triageSkill
- verification-before-completionSkill
- wayfinderSkill
- writing-clearly-and-conciselySkill
The file
Files
<!-- Generated by Imprimatur from its database; it lists the documents Imprimatur keeps, written again when they change. -->
# imprimatur
> Imprimatur is a local tool that keeps the work coding agents do in a repo in front of the user (primarily Claude Code; Cursor and Codex too, through MCP). To…
These documents are kept by Imprimatur from its database; read them before changing what they describe.
## Project
- [Project](docs/PROJECT.md): Imprimatur is a local tool that keeps the work coding agents do in a repo in front of the user (primarily Claude Code; Cursor and Codex too, through MCP). To…
## Capabilities
- [Capability · agent-setup-audit](docs/capabilities/agent-setup-audit.md): Hooks are registered either in ~/.claude/settings.json (npm run setup) or in the Claude Code plugin's hooks/hooks.json. Both are generated from the same list…
- [Capability · docs-sync](docs/capabilities/docs-sync.md): Every repo can carry four documentation linters: markdownlint-cli2 (structure), cspell (spelling, warnings only), lychee --offline (links between the repo's…
- [Capability · docs](docs/capabilities/docs.md): An ADR, a decision or a current document section tied to files (a record's links.files; a section's contributing records and the repo paths in backticks in i…
- [Capability · exercise-mode](docs/capabilities/exercise-mode.md): Exercises are the user's own data, of no repo or task, in the same device database as everything else (vscode/db.js, schema 9).
- [Capability · mcp-server](docs/capabilities/mcp-server.md): mcp/server.mjs is the only read/write path agents have to tasks and records. Claude Code (user scope or plugin), Cursor (~/.cursor/mcp.json) and Codex (~/.co…
- [Capability · meetings](docs/capabilities/meetings.md): A meeting app writes its notes into Imprimatur, so what was agreed reaches the task it was about.
- [Capability · panel-board](docs/capabilities/panel-board.md): The panel's look comes from three small modules. All are plain CommonJS; they need no build step and do not trip the CSP.
- [Capability · study-mode](docs/capabilities/study-mode.md): - Skill skills/study/SKILL.md: the flow (find the topic, read the material, read the code, write a note, ask one by one, record mastery). The plugin finds sk…
- [Capability · task-tracking](docs/capabilities/task-tracking.md): - Migration 7 (and 8): sectionreads(sectionid PK → docsections, versionid, at). Device-specific. The migration counts every section that exists at that momen…
## Decisions
- [Modül](docs/adr/0001-modul.md): Alternative: tying the color overlay to git's stage/commit state, rejected — the user explicitly wanted agent change tracking independent of git, persisting…
- [`hooks/baseline.mjs`](docs/adr/0002-hooks-baseline-mjs.md): hooks/baseline.mjs — PreToolUse Edit|Write (Claude Code'da MultiEdit yok). Uzantısı listede olan dosyaya (varsayılan md, mdx) dokunulmadan önce: kopya yoksa…
- [`vscode/`](docs/adr/0003-vscode.md): vscode/ — VS Code eklentisi, bağımlılıksız JS. Kopyası olan her dosyayı kopyayla karşılaştırır (ortak baş/son kırpılır, satır LCS; eşleşen silme+ekleme çiftl…
- [Blok blok Accept (0.7.0, #5)](docs/adr/0004-blok-blok-accept-0-7-0-5.md): Blok blok Accept (0.7.0, #5) — editörde CodeLens "✓ Accept" Markdown birimi başına (0.15.0, acceptGroups): blok sınırları VS Code'un markdown-it'inden (önizl…
- [Önizleme işaret şeridi (0.10.0, #5)](docs/adr/0005-onizleme-isaret-seridi-0-10-0-5.md): Önizleme işaret şeridi (0.10.0, #5) — markdown.previewScripts ile önizlemeye preview-markers.js: sağ kenarda, kaydırma çubuğunun üstünde editör overview rule…
- [Nerede gösterilir (0.8.0, #5)](docs/adr/0006-nerede-gosterilir-0-8-0-5.md): Nerede gösterilir (0.8.0, #5) — ayar imprimatur.showIn: preview (varsayılan; Markdown'da işaret yalnız önizlemede, editörde süs ve CodeLens yok) | both | edi…
- [Kendiliğinden yenileme (0.7.2, 0.10.4)](docs/adr/0007-kendiliginden-yenileme-0-7-2-0-10-4.md): Kendiliğinden yenileme (0.7.2, 0.10.4) — hook kopya/tarihçeyi ajanın düzenlemesinden ÖNCE yazar; eklenti .claude/imprimatur/ değişince editörü, CodeLens'i, d…
- [Fark sekmeleri (0.7.3)](docs/adr/0008-fark-sekmeleri-0-7-3.md): Fark sekmeleri (0.7.3) — bir grubun etkin sekmesi TabInputTextDiff ise (Working Tree, git karşılaştırması) o sekmenin iki URI'si "diff'te" sayılır: o belgede…
- [Mermaid farkı (0.11.0; 0.17.0'dan beri varsayılan KAPALI, ayar `imprimatur.mermaidDiff`, #9)](docs/adr/0009-mermaid-farki-0-11-0-0-17-0-dan-beri-varsayilan-kapali-ayar.md): Mermaid farkı (0.11.0; 0.17.0'dan beri varsayılan KAPALI, ayar imprimatur.mermaidDiff, #9) — iki Mermaid önizleme eklentisi (Mermaid Chart + Markdown Mermaid…
- [Liste numaraları (0.17.1)](docs/adr/0010-liste-numaralari-0-17-1.md): Liste numaraları (0.17.1) — satır karşılaştırmasında numaralı liste numarası yok sayılır (listKey: N. → 1.): bir madde silinince alttakilerin yeniden numaral…
- [Kod blokları](docs/adr/0011-kod-bloklari.md): Kod blokları — çitli kod bloklarının ( ya da ~~~, çit satırları dahil; kapanış çiti en az açılış kadar uzun) içindeki değişiklikler işaretlenmez: editör, öni…
- [Editörde eski cümle üstte (0.14.0)](docs/adr/0012-editorde-eski-cumle-ustte-0-14-0.md): Editörde eski cümle üstte (0.14.0) — eklenti API'si editöre gerçek satır ekleyemez (view zone yalnız çekirdekte); cümle düzeyinde değişen satırın eski hâli o…
- [Tek görünüm (0.12.0)](docs/adr/0013-tek-gorunum-0-12-0.md): Tek görünüm (0.12.0) — önceki ve son ajan düzenlemesi aynı görünür (kullanıcı, 2026-10-03): önizleme, editör, sağ kenar çentikleri, CodeLens ve durum çubuğun…
- [Tarihçe düğmesi (0.5.0, #7)](docs/adr/0014-tarihce-dugmesi-0-5-0-7.md): Tarihçe düğmesi (0.5.0, #7) — dosyanın tarihçesi varsa durum çubuğunda hep görünen "$(history) N agent edits" düğmesi (Accept all sonrası da); tıklayınca aja…
- [Agent Change Graph (0.6.0, #8)](docs/adr/0015-agent-change-graph-0-6-0-8.md): Agent Change Graph (0.6.0, #8) — Webview paneli (komut "Imprimatur: Open Agent Change Graph", tarihçe listesinin başından ve durum çubuğundan): repo kökündek…
- [Graph açıklaması (0.19.0, #8)](docs/adr/0016-graph-aciklamasi-0-19-0-8.md): Graph açıklaması (0.19.0, #8) — Açıklama sütunu artık kullanıcının isteği değil (kısa cevaplarda "olur" gibi anlamsızdı; kullanıcı, 2026-10-05): sırayla tari…
- [Görev şeritleri (0.30.0, #39, kullanıcı 2026-10-06: "graphları tasklara göre ayırmak lazım; bir…](docs/adr/0017-gorev-seritleri-0-30-0-39-kullanici-2026-10-06-graphlari-tas.md): Görev şeritleri (0.30.0, #39, kullanıcı 2026-10-06: "graphları tasklara göre ayırmak lazım; bir oturum içinde birden çok farklı şey yapabiliyoruz") — Graph ş…
- [Graph etkileşimi (0.20.0, kullanıcı 2026-10-05)](docs/adr/0018-graph-etkilesimi-0-20-0-kullanici-2026-10-05.md): Graph etkileşimi (0.20.0, kullanıcı 2026-10-05) — Durum sütunu: yeşil ✓ rozet / turuncu nokta, satır üstünde "Accept" düğmesi. Sağ tık VS Code'un kendi menüs…
- [Agent setup (0.27.0, kullanıcı 2026-10-05: "projede ajanı etkileyen her şeyi takip etsin, Cursor…](docs/adr/0019-agent-setup-0-27-0-kullanici-2026-10-05-projede-ajani-etkile.md): Agent setup (0.27.0, kullanıcı 2026-10-05: "projede ajanı etkileyen her şeyi takip etsin, Cursor da olabilir; burada görünüm olsun, graph'a buradan da ulaşıl…
- [Düz adım listesi (0.24.0, kullanıcı 2026-10-05: "hepsi tikli olsa bile kaybolmasın, geçmişi…](docs/adr/0020-duz-adim-listesi-0-24-0-kullanici-2026-10-05-hepsi-tikli-ols.md): Düz adım listesi (0.24.0, kullanıcı 2026-10-05: "hepsi tikli olsa bile kaybolmasın, geçmişi dursun, agent change graph gibi; liste hâlinde, aynıları elemek y…
- [Haiku denetimi (0.24.0, kullanıcı 2026-10-05: "Haiku genel olarak kontrol etsin burayı")](docs/adr/0021-haiku-denetimi-0-24-0-kullanici-2026-10-05-haiku-genel-olara.md): Haiku denetimi (0.24.0, kullanıcı 2026-10-05: "Haiku genel olarak kontrol etsin burayı") — Stop'ta waiting.mjs yalnız soruları kapatan step yazar ve arka pla…
- [Geçmiş taraması (kullanıcı 2026-10-05: "projeye imprimaturu sonradan kurdum, dosyalarda benden…](docs/adr/0022-gecmis-taramasi-kullanici-2026-10-05-projeye-imprimaturu-son.md): Geçmiş taraması (kullanıcı 2026-10-05: "projeye imprimaturu sonradan kurdum, dosyalarda benden beklenen şeyler olabilir") — vscode/history.js scanHistory(roo…
- [Açık adımlar, iş numarası ve TODO.md satırı (0.29.0, #34, kullanıcı 2026-10-05: "descriptionlar…](docs/adr/0023-acik-adimlar-is-numarasi-ve-todo-md-satiri-0-29-0-34-kullani.md): Açık adımlar, iş numarası ve TODO.md satırı (0.29.0, #34, kullanıcı 2026-10-05: "descriptionlar cidden sığ… task numaralarını iliştirelim ve tıklanabilir ols…
- [Chat senkronu (0.23.0, kullanıcı 2026-10-05: "chatte karar veriyorum, oraya senklemen lazım")](docs/adr/0024-chat-senkronu-0-23-0-kullanici-2026-10-05-chatte-karar-veriy.md): Chat senkronu (0.23.0, kullanıcı 2026-10-05: "chatte karar veriyorum, oraya senklemen lazım") — UserPromptSubmit answer satırını yazdıktan sonra waiting.mjs…
- [Görev klasörlerinin yeri (#54, kullanıcı 2026-10-09: "todos -> docs klasörüne taşınacak, README.MD…](docs/adr/0025-gorev-klasorlerinin-yeri-54-kullanici-2026-10-09-todos-docs.md): Görev klasörlerinin yeri (#54, kullanıcı 2026-10-09: "todos -> docs klasörüne taşınacak, README.MD hariç gerekli doküman dosyaları da") — Görev klasörü docs/…
- [Oturumlar arası kapanış (#43, kullanıcı 2026-10-06: başka bir repoda LATD-13977 kapandı ama üç…](docs/adr/0026-oturumlar-arasi-kapanis-43-kullanici-2026-10-06-baska-bir-re.md): Oturumlar arası kapanış (#43, kullanıcı 2026-10-06: başka bir repoda LATD-13977 kapandı ama üç oturuma yayılmış maddeleri açık kaldı) — (1) vscode/todo-done.…
- [Model açıklaması (0.22.0, kullanıcı 2026-10-05: "değişikliği hâlâ anlamıyorum… hook olmalı")](docs/adr/0027-model-aciklamasi-0-22-0-kullanici-2026-10-05-degisikligi-hal.md): Model açıklaması (0.22.0, kullanıcı 2026-10-05: "değişikliği hâlâ anlamıyorum… hook olmalı") — baseline.mjs tarihçeye toolUseId'li satır yazınca hooks/descri…
- [Açık kalan işler (0.21.0, kullanıcı 2026-10-05: "sonraki prompt'ta kayboluyor, hâlâ yapmam gereken…](docs/adr/0028-acik-kalan-isler-0-21-0-kullanici-2026-10-05-sonraki-prompt.md): Açık kalan işler (0.21.0, kullanıcı 2026-10-05: "sonraki prompt'ta kayboluyor, hâlâ yapmam gereken şeyler olabilir") — Tur sonu: satırlardan biri eylem ifade…
- [Waiting on you (0.19.0, #11)](docs/adr/0029-waiting-on-you-0-19-0-11.md): Waiting on you (0.19.0, #11) — Graph panelinde ikinci sekme. İkinci hook hooks/waiting.mjs oturum başına .claude/imprimatur/waiting/<oturum>.jsonl'a satır ek…
- [Kalıcılık](docs/adr/0030-kalicilik.md): Kalıcılık — renkler yalnız Accept (imleçteki değişiklik kopyaya yazılır) ya da Accept all (kopya silinir) ile kalkar; stage, commit, yeniden açma renklere do…
- [Önizlemede anında Accept (0.16.0)](docs/adr/0031-onizlemede-aninda-accept-0-16-0.md): Önizlemede anında Accept (0.16.0) — Accept dosya metnini değiştirmez (yalnız kopyayı), öteki düğmelerin satırları geçerli kalır: önizleme betiği tıklanan blo…
- [Veri denetimi düzeltmeleri (0.30.3, #45; 2026-10-07'de 5 reponun verisi denetlendi)](docs/adr/0032-veri-denetimi-duzeltmeleri-0-30-3-45-2026-10-07-de-5-reponun.md): Veri denetimi düzeltmeleri (0.30.3, #45; 2026-10-07'de 5 reponun verisi denetlendi) — (1) Bash düzenlemesi PostToolUseFailure'da da kaydedilir (hata veren ko…
- [Grafik doğruluğu (0.30.4, #46; grafik denetimi)](docs/adr/0033-grafik-dogrulugu-0-30-4-46-grafik-denetimi.md): Grafik doğruluğu (0.30.4, #46; grafik denetimi) — (1) Bash düzenlemesinin dalı PreToolUse'da da okunur (pending/<id>.json = {files, branch}; eski biçim de ok…
- [Eski veri kendiliğinden düzelir (0.30.5, #47; veri yeniden yazılmaz, onarım betiği yok)](docs/adr/0034-eski-veri-kendiliginden-duzelir-0-30-5-47-veri-yeniden-yazil.md): Eski veri kendiliğinden düzelir (0.30.5, #47; veri yeniden yazılmaz, onarım betiği yok) — (1) vscode/calls.js: grafik bir çağrıyı transcript'ten ilk okuduğun…
- [Eski satırlar çağrılarına bağlanır (0.30.7, #49; interview ve groundwork'ün eski hook'la yazılmış…](docs/adr/0035-eski-satirlar-cagrilarina-baglanir-0-30-7-49-interview-ve-gr.md): Eski satırlar çağrılarına bağlanır (0.30.7, #49; interview ve groundwork'ün eski hook'la yazılmış satırları: toolUseId, transcript, başlık, dal, açıklama yok…
- [Grafik hover'ı review görünümünde (0.31.0, #50; kullanıcı: "md source formatı yerine review…](docs/adr/0036-grafik-hover-i-review-gorunumunde-0-31-0-50-kullanici-md-sou.md): Grafik hover'ı review görünümünde (0.31.0, #50; kullanıcı: "md source formatı yerine review modunda") — Markdown düzenlemesinin hover'ı önce satır diff'ini g…
- [Performans (0.31.1, #51; ölçüm: iki pencerenin extension host'u %120-140 CPU, profilin %63'ü…](docs/adr/0037-performans-0-31-1-51-olcum-iki-pencerenin-extension-host-u-1.md): Performans (0.31.1, #51; ölçüm: iki pencerenin extension host'u %120-140 CPU, profilin %63'ü Imprimatur: diff.js lines, spotsOf, summaryOf) — her tool çağrıs…
- [Arşiv (0.32.0, #52; kullanıcı: sıkıştırılmış arşiv, 7 gün, incelemedeki eski düzenleme de, günde…](docs/adr/0038-arsiv-0-32-0-52-kullanici-sikistirilmis-arsiv-7-gun-inceleme.md): Arşiv (0.32.0, #52; kullanıcı: sıkıştırılmış arşiv, 7 gün, incelemedeki eski düzenleme de, günde bir otomatik) — vscode/archive.js archiveRepo(root, {days}):…
- [Önizleme hatası önizlemeyi boşaltmaz (0.15.2)](docs/adr/0039-onizleme-hatasi-onizlemeyi-bosaltmaz-0-15-2.md): Önizleme hatası önizlemeyi boşaltmaz (0.15.2) — işaretleme (annotate) hata fırlatırsa önizleme işaretsiz çizilir, hata konsola; eski metni biçimlendiren rend…
- [Önizleme (0.4.1, #5, #6)](docs/adr/0040-onizleme-0-4-1-5-6.md): Önizleme (0.4.1, #5, #6) — eklenti VS Code Markdown önizlemesine markdown-it eklentisi verir (markdown.markdownItPlugins, extendMarkdownIt; önizlemede html:…
- [Sınırlar](docs/adr/0041-sinirlar.md): Sınırlar — editörde kelime/cümle düzeyi, önizlemede blok düzeyi; kopya ile şimdiki metin arasındaki her fark renklenir, kullanıcının aynı dosyadaki elle düze…
- [Ad (#10)](docs/adr/0042-ad-10.md): Ad (#10) — modülün ve VS Code eklentisinin adı Imprimatur (Latince "basılsın": onay damgası). Repo [halilural/imprimatur](https://github.com/halilural/imprim…
- [Bu repoya bağlantı yalnız dışarıdan: `.gitignore`'da `.claude/imprimatur/` (tarihçe verisi)](docs/adr/0043-bu-repoya-baglanti-yalniz-disaridan-gitignore-da-claude-impr.md): Bu repoya bağlantı yalnız dışarıdan: .gitignore'da .claude/imprimatur/ (tarihçe verisi). Hook makine genelinde: ~/.claude/settings.json → ~/projects/imprimat…
- [Kayıt veritabanı (hedef hâl, #57)](docs/adr/0044-kayit-veritabani-hedef-hal-57.md): Görevler, sorular, kararlar, notlar, ADR ve PDR'lerin asıl kaynağı Imprimatur'un kendi veritabanı; Markdown'dan üretilen görünüm yok (kullanıcı, 2026-10-09:…
- [Motor](docs/adr/0045-motor.md): Motor — Node'un yerleşik node:sqlite (DatabaseSync): native modül yok, tek evrensel vsix. Eklenti VS Code'un Node'unda (1.141 = Electron 43, Node 24: bayraks…
- [Yer](docs/adr/0046-yer.md): Yer — cihaz başına tek dosya, bütün repolar içinde: Linux/WSL $XDGDATAHOME/imprimatur/imprimatur.db (varsayılan ~/.local/share/…), macOS ~/Library/Applicatio…
- [Eşzamanlılık](docs/adr/0047-eszamanlilik.md): Eşzamanlılık — her bağlantı açılışta journalmode=WAL, synchronous=NORMAL, busytimeout=5000, foreignkeys=ON. Okumalar yazmayı beklemez. Her yazma BEGIN IMMEDI…
- [Şema](docs/adr/0048-sema.md): Şema — zamanlar epoch ms (INTEGER), metinler UTF-8, yapısal ek alanlar JSON metni.
- [Sürüm](docs/adr/0049-surum.md): Sürüm — şema sürümü PRAGMA userversion; db.js'teki MIGRATIONS dizisi sırayla, tek BEGIN IMMEDIATE içinde uygulanır (aynı anda açan iki süreçten biri bekler,…
- [Erişim katmanı `vscode/db.js` (CommonJS; hook'lar `createRequire` ile)](docs/adr/0050-erisim-katmani-vscode-db-js-commonjs-hook-lar-createrequire.md): Erişim katmanı vscode/db.js (CommonJS; hook'lar createRequire ile) — openDb({path}), repoOf, upsertTask, addRecord, updateRecord(id, patch, actor), setPointe…
- [Gecikme](docs/adr/0051-gecikme.md): Gecikme — panel sorguları indeksli ve LIMIT'li, 10k kayıtta < 1 ms; açılış (pragmalar + sürüm kontrolü) < 5 ms; hazır sorgular (prepare) bağlantı başına önbe…
- [MCP sunucusu (#58)](docs/adr/0052-mcp-sunucusu-58.md): Ajanlar kayıtları yalnız Imprimatur MCP sunucusundan okur ve yazar (kullanıcı, 2026-10-09); Claude Code, Cursor, Codex aynı araçları görür.
- [`mcp/server.mjs`](docs/adr/0053-mcp-server-mjs.md): mcp/server.mjs — stdio, bağımlılıksız: satır başına bir JSON-RPC mesajı, stdout'a yalnız MCP, günlük stderr'e; stdin kapanınca çıkar. İki dönem: 2026-07-28 (…
- [Araçlar az ve genel (kullanıcı, 2026-10-09; her tanım ajanın bağlamına girer, #29):…](docs/adr/0054-araclar-az-ve-genel-kullanici-2026-10-09-her-tanim-ajanin-ba.md): Araçlar az ve genel (kullanıcı, 2026-10-09; her tanım ajanın bağlamına girer, #29): whereweleftoff, tasklist, taskget, taskupsert, recordadd (kind ile todo|q…
- [Repo](docs/adr/0055-repo.md): Repo — repo argümanı, yoksa CLAUDEPROJECTDIR, yoksa sunucunun cwd'si; git kökü. MCP roots 2026-07-28'de kullanımdan kalktı, kullanılmaz.
- [Kim](docs/adr/0056-kim.md): Kim — Claude Code MCP sunucusuna oturumu söylemez: hooks/mcp-session.mjs (PreToolUse mcpimprimatur.) updatedInput ile girdiye session ekler (girdinin tamamı…
- [Kurulum](docs/adr/0057-kurulum.md): Kurulum — npm run setup: Claude Code claude mcp add -s user imprimatur (aynı ad varsa önce remove; yol aynıysa dokunmaz), Cursor ~/.cursor/mcp.json mcpServer…
- [Markdown aktarımı (#59)](docs/adr/0058-markdown-aktarimi-59.md): Markdown aktarımı (#59) — vscode/import.js importRepo(db, root)
- [Ajanın her işi: async PostToolUse(*) hook'u her çağrıyı…](docs/adr/0059-ajanin-her-isi-async-posttooluse-hook-u-her-cagriyi.md): Ajanın her işi: async PostToolUse() hook'u her çağrıyı .claude/imprimatur/activity/<oturum>.jsonl'a kısa satır yazar; grafik türe göre süzer, alt ajan çağrıl…
- [Senkron: yerel node:sqlite asıl kaynak kalır; değişiklikler alan alan giden kutusundan Cloudflare…](docs/adr/0060-senkron-yerel-node-sqlite-asil-kaynak-kalir-degisiklikler-al.md): Senkron: yerel node:sqlite asıl kaynak kalır; değişiklikler alan alan giden kutusundan Cloudflare Worker + D1'e itilir, öteki cihazlarınki çekilir; alan bazı…
- [Model çağrıları yalnız gerektiğinde (#62, #63): Haiku, `claude -p`, kural yetiyorsa çağrı yok](docs/adr/0061-model-cagrilari-yalniz-gerektiginde-62-63-haiku-claude-p-kur.md): Ölçüm 2026-10-09: her hook ~65 ms (43 ms Node açılışı), hook'lar paralel; MCP araç tanımları ~1,4k token ve ertelemeli yüklenir; asıl maliyet arka plandaki c…
- [MCP araçları spec 2026-07-28'e ve ajanlara uygun (#64, #72): discover önbelleği, instructions,…](docs/adr/0062-mcp-araclari-spec-2026-07-28-e-ve-ajanlara-uygun-64-72-disco.md): MCP araçları spec 2026-07-28'e ve ajanlara uygun (#64, #72): discover önbelleği, instructions, sınırlı taskget, structuredContent + outputSchema, 10 araç
- [Eklenti güvenliği ve paketleme (#65): extensionKind workspace, Workspace Trust limited, webview…](docs/adr/0063-eklenti-guvenligi-ve-paketleme-65-extensionkind-workspace-wo.md): Eklenti güvenliği ve paketleme (#65): extensionKind workspace, Workspace Trust limited, webview CSP + boş localResourceRoots, esbuild tek dosya
- [Claude Code plugin'i (#67): hooks.json + plugin.json kurulumla aynı listeden üretilir; setup…](docs/adr/0064-claude-code-plugin-i-67-hooks-json-plugin-json-kurulumla-ayn.md): Claude Code plugin'i (#67): hooks.json + plugin.json kurulumla aynı listeden üretilir; setup --plugin geçişi, çift hook yok
- [Canlı güncellemeler (#71): yerel izleyici ilk olay hemen + 50 ms, data_version yedeği 500 ms,…](docs/adr/0065-canli-guncellemeler-71-yerel-izleyici-ilk-olay-hemen-50-ms-d.md): Canlı güncellemeler (#71): yerel izleyici ilk olay hemen + 50 ms, dataversion yedeği 500 ms, Durable Object WebSocket, imzalı GitHub webhook
- [Takip aracı eşitlemesi (#70): epic satırları görevle aynı yazmada kapanır; GitHub (gh) / Jira…](docs/adr/0066-takip-araci-esitlemesi-70-epic-satirlari-gorevle-ayni-yazmad.md): Takip aracı eşitlemesi (#70): epic satırları görevle aynı yazmada kapanır; GitHub (gh) / Jira (REST) ile iki yönlü durum, cihaza özel giden kutusu
- [Imprimatur paneli (#69): tek webview, sekmeler (Ana sayfa, Görevler, Bende bekleyenler, Mimari,…](docs/adr/0067-imprimatur-paneli-69-tek-webview-sekmeler-ana-sayfa-gorevler.md): Imprimatur paneli (#69): tek webview, sekmeler (Ana sayfa, Görevler, Bende bekleyenler, Mimari, Ürün, Ajan değişiklikleri); kenar çubuğu yalnız giriş
- [Tasarım dokümanları (#72): repo başına bir mimari ve bir ürün dokümanı, bölümler + katkı veren…](docs/adr/0068-tasarim-dokumanlari-72-repo-basina-bir-mimari-ve-bir-urun-do.md): Tasarım dokümanları (#72): repo başına bir mimari ve bir ürün dokümanı, bölümler + katkı veren kayıtlar + sürümler; veritabanı asıl kaynak, docs/.md üretilir
- [ADR: «tasarım dokümanları» hedef hâl](docs/adr/0069-adr-tasarim-dokumanlari-hedef-hal.md): ADR: «tasarım dokümanları» hedef hâl — DB ↔ Markdown dosyası iki yönlü docs sync; elle yazılmış dosya sahiplenilir, git rev'den onarım, çakışmada kimse ezilmez
- [ADR: «docUpdate + doküman sağlığı» hedef hâl](docs/adr/0070-adr-docupdate-dokuman-sagligi-hedef-hal.md): ADR: «docUpdate + doküman sağlığı» hedef hâl — bağlı ama kayıttan sonra değişmemiş bölüm de uyarı alır; decision da kapsamda; whereweleftoff boş doküman / ba…
- [Agent setup denetimi agnix'in tam kapsamını alır; bulgular gizlenmez, kaynağa göre gruplanır ve…](docs/adr/0071-agent-setup-denetimi-agnix-in-tam-kapsamini-alir-bulgular-gi.md): Agent setup denetimi agnix'in tam kapsamını alır; bulgular gizlenmez, kaynağa göre gruplanır ve kayıt olarak durumla takip edilir
- [Agent setup denetimi: agnix binary'si npx ile bulunur, bulgular AUDIT kabında fixme kaydı, parmak…](docs/adr/0072-agent-setup-denetimi-agnix-binary-si-npx-ile-bulunur-bulgula.md): Agent setup denetimi: agnix binary'si npx ile bulunur, bulgular AUDIT kabında fixme kaydı, parmak izi satırsız
- [Best practice review: model kaynak haritasını kurar, kod doğrular; başlık başına claude -p,…](docs/adr/0073-best-practice-review-model-kaynak-haritasini-kurar-kod-dogru.md): Best practice review: model kaynak haritasını kurar, kod doğrular; başlık başına claude -p, kaynak+kanıt kapısı; BEST kabında todo, anahtarla eşleşir
- [Tek Recommendations: RECS kabı iki üreticiye; best practice boru hattı (kod toplar, model karar…](docs/adr/0074-tek-recommendations-recs-kabi-iki-ureticiye-best-practice-bo.md): Tek Recommendations: RECS kabı iki üreticiye; best practice boru hattı (kod toplar, model karar verir), ISO 25010 + NIST SSDF
- [Boş tasarım dokümanları ve sözlük, her repo için bir kez arka planda bir ajanla doldurulur](docs/adr/0076-bos-tasarim-dokumanlari-ve-sozluk-her-repo-icin-bir-kez-arka.md): SessionStart'ta (.claude/imprimatur.json olsun olmasın, bilinen her repo için) şu koşullarda bir kez çalışır: repo daha önce hiç backfill edilmemiş, en az 10…
- [Panel görünümü: kendi tasarım katmanımız (tema başına turuncu vurgu) + Lucide ikonları;…](docs/adr/0077-panel-gorunumu-kendi-tasarim-katmanimiz-tema-basina-turuncu.md): Panel görünümü: kendi tasarım katmanımız (tema başına turuncu vurgu) + Lucide ikonları; vscode-elements kullanılmadı
- [Görev analizi dördüncü belge türü: documents.scope = görev anahtarı, eşitleme anahtarı…](docs/adr/0078-gorev-analizi-dorduncu-belge-turu-documents-scope-gorev-anah.md): Görev analizi dördüncü belge türü: documents.scope = görev anahtarı, eşitleme anahtarı "analysis:<key>", Worker değişmez
- [Okuma işareti: section_reads(section_id, version_id, at), cihaza özel; okunmadı = ajan/hook'un son…](docs/adr/0081-okuma-isareti-section-reads-section-id-version-id-at-cihaza.md): Okuma işareti: sectionreads(sectionid, versionid, at), cihaza özel; okunmadı = ajan/hook'un son okunan sürümden sonraki başlık/metin değişikliği
- [/study: skill + salt okur study_material MCP aracı; migration yok](docs/adr/0083-study-skill-salt-okur-study-material-mcp-araci-migration-yok.md): /study: skill + salt okur studymaterial MCP aracı; migration yok — not görev analizinde "study" bölümü, hakimiyet links.study'li not kaydı; kod turu görev an…
- [Device sync leaves the public repo as a private plugin; the public code keeps only a generic…](docs/adr/0085-device-sync-leaves-the-public-repo-as-a-private-plugin-the-p.md): Device sync leaves the public repo as a private plugin; the public code keeps only a generic plugin hook
- [Exercise mode: /exercise turns any topic into 5-9 ticked steps (purpose + done-when each); the…](docs/adr/0086-exercise-mode-exercise-turns-any-topic-into-5-9-ticked-steps.md): Exercise mode: /exercise turns any topic into 5-9 ticked steps (purpose + done-when each); the user's own, of no repo or task; the agent coaches without givi…
- [Social media is a fifth living document (Social), off by default per repo; /social-post reads each…](docs/adr/0087-social-media-is-a-fifth-living-document-social-off-by-defaul.md): Social media is a fifth living document (Social), off by default per repo; /social-post reads each platform's rules at writing time and keeps posts, rules ca…
- [The panel updates by line diff: the host posts changed lines against a versioned copy, the page…](docs/adr/0088-the-panel-updates-by-line-diff-the-host-posts-changed-lines.md): The panel updates by line diff: the host posts changed lines against a versioned copy, the page asks for the whole page when versions do not match
- [The database bounds its WAL to 4 MB and gets a daily upkeep: TRUNCATE checkpoint, PRAGMA optimize,…](docs/adr/0089-the-database-bounds-its-wal-to-4-mb-and-gets-a-daily-upkeep.md): The database bounds its WAL to 4 MB and gets a daily upkeep: TRUNCATE checkpoint, PRAGMA optimize, and a VACUUM in a worker when free pages pass 5%
- [One dispatcher process per hook event (hooks/run.mjs) runs every Imprimatur hook step in-process;…](docs/adr/0090-one-dispatcher-process-per-hook-event-hooks-run-mjs-runs-eve.md): One dispatcher process per hook event (hooks/run.mjs) runs every Imprimatur hook step in-process; activity stays on, written there for the tools it handles a…
- [Keys and tokens move from config.json to secrets.json (0600), denied to Claude Code's file tools;…](docs/adr/0091-keys-and-tokens-move-from-config-json-to-secrets-json-0600-d.md): Keys and tokens move from config.json to secrets.json (0600), denied to Claude Code's file tools; a key moves only when its reader declares it
- [MCP tool profiles: IMPRIMATUR_TOOLS (or mcp.tools in .claude/imprimatur.json / config.json) picks…](docs/adr/0092-mcp-tool-profiles-imprimatur-tools-or-mcp-tools-in-claude-im.md): MCP tool profiles: IMPRIMATURTOOLS (or mcp.tools in .claude/imprimatur.json / config.json) picks core, standard, all or groups; default all; lean profiles le…
- [search answers with an index (no bodies, titles cut to 160, 8 hits, more/hint); task_get gives…](docs/adr/0093-search-answers-with-an-index-no-bodies-titles-cut-to-160-8-h.md): search answers with an index (no bodies, titles cut to 160, 8 hits, more/hint); taskget gives each body's first line and the fields an agent acts on; full:tr…
- [Version tables are compacted losslessly (option A): drop only what another stored value says, fill…](docs/adr/0094-version-tables-are-compacted-losslessly-option-a-drop-only-w.md): Version tables are compacted losslessly (option A): drop only what another stored value says, fill it back when history is read; a full backup before the fir…
- [One Imprimatur version per machine: the status line runs the plugin's copy when the plugin is…](docs/adr/0095-one-imprimatur-version-per-machine-the-status-line-runs-the.md): One Imprimatur version per machine: the status line runs the plugin's copy when the plugin is installed and flags a version that differs from the extension's…
- [Per-repo data lives at <database folder>/repos/<name>-<hash>/, not in the repo; dataPath() maps…](docs/adr/0096-per-repo-data-lives-at-database-folder-repos-name-hash-not-i.md): Per-repo data lives at <database folder>/repos/<name>-<hash>/, not in the repo; dataPath() maps every old .claude/imprimatur path there; the first use moves…
- [Managed documents live only in Imprimatur and open there as read-only Markdown; repos hold no…](docs/adr/0097-managed-documents-live-only-in-imprimatur-and-open-there-as.md): Managed documents live only in Imprimatur and open there as read-only Markdown; repos hold no generated or hand-written design docs
- [Waiting logs are parsed once per file version: an in-process cache keyed by inode, size and mtime…](docs/adr/0098-waiting-logs-are-parsed-once-per-file-version-an-in-process.md): Waiting logs are parsed once per file version: an in-process cache keyed by inode, size and mtime holds each log's items and step rows; callers get shallow c…
- [Imprimatur carries the adopted skills itself and installs them automatically; what it cannot…](docs/adr/0099-imprimatur-carries-the-adopted-skills-itself-and-installs-th.md): Imprimatur carries the adopted skills itself and installs them automatically; what it cannot carry, it learns from (ideas built into its own features)
- [Architecture and product sections carry a fixed chapter (doc_sections.chapter); files render every…](docs/adr/0101-architecture-and-product-sections-carry-a-fixed-chapter-doc.md): Architecture and product sections carry a fixed chapter (docsections.chapter); files render every chapter as an H2 under <a id="chapter-…">, sections as numb…
- [Agent setup lists installed Claude Code plugins (from ~/.claude/plugins/installed_plugins.json)…](docs/adr/0102-agent-setup-lists-installed-claude-code-plugins-from-claude.md): Agent setup lists installed Claude Code plugins (from ~/.claude/plugins/installedplugins.json) and skills synced from claude.ai (their manifest), each with v…
- [Agent setup shows what the repo's last Claude Code session was given, read from its transcript's…](docs/adr/0104-agent-setup-shows-what-the-repo-s-last-claude-code-session-w.md): Agent setup shows what the repo's last Claude Code session was given, read from its transcript's attachments: loaded instruction files, each hook's runs/time…
- [/imprimatur-stats is a skill whose script prints an ASCII scoreboard (now vs the period before)…](docs/adr/0105-imprimatur-stats-is-a-skill-whose-script-prints-an-ascii-sco.md): /imprimatur-stats is a skill whose script prints an ASCII scoreboard (now vs the period before) from the DB, the review data (archive included) and the last…
- [The board look comes from theme.js: on dark and light themes the panel redefines the --vscode-*…](docs/adr/0107-the-board-look-comes-from-theme-js-on-dark-and-light-themes.md): The board look comes from theme.js: on dark and light themes the panel redefines the --vscode- colours it uses and its own tokens to the board palette, and c…
- [The baseline for every repo: Imprimatur's own skills plus five third-party items the user chose](docs/adr/0108-the-baseline-for-every-repo-imprimatur-s-own-skills-plus-fiv.md): The user chose this baseline on 2026-11-05.
- [Decisions as MADR 4 files: numbered once in the record's links, generated beside the documents,…](docs/adr/0109-decisions-as-madr-4-files-numbered-once-in-the-record-s-link.md): Decisions as MADR 4 files: numbered once in the record's links, generated beside the documents, linked both ways
- [AGENTS.md through the checklist: templates for a repo with none, Fix it for splitting an existing…](docs/adr/0110-agents-md-through-the-checklist-templates-for-a-repo-with-no.md): AGENTS.md through the checklist: templates for a repo with none, Fix it for splitting an existing CLAUDE.md
- [Documentation rules in setup_audit as Imprimatur's own IMP-DOC rules, decision rules reported once…](docs/adr/0111-documentation-rules-in-setup-audit-as-imprimatur-s-own-imp-d.md): Documentation rules in setupaudit as Imprimatur's own IMP-DOC rules, decision rules reported once per rule
- [Fix it on IMP-DOC-001..005 runs Claude with Imprimatur's MCP tools, not as a file diff](docs/adr/0112-fix-it-on-imp-doc-001-005-runs-claude-with-imprimatur-s-mcp.md): Those findings live in the database; docs/.md is generated, so a file diff on it is lost at the next export. Fix it on such a finding (a row, or the bulk but…
- [Doc linting: generated Markdown is tidied where it is made; Agent Setup writes four lint configs…](docs/adr/0113-doc-linting-generated-markdown-is-tidied-where-it-is-made-ag.md): Doc linting: generated Markdown is tidied where it is made; Agent Setup writes four lint configs and npm scripts into a repo, never overwriting
- [Doc skills vetted: documentation-writer, docs-sync-audit and writing-clearly-and-concisely ship in…](docs/adr/0114-doc-skills-vetted-documentation-writer-docs-sync-audit-and-w.md): Doc skills vetted: documentation-writer, docs-sync-audit and writing-clearly-and-concisely ship in skills/ (retargeted); five rejected
- [PDR: «A meeting's note lives where its work is» target state](docs/adr/0115-pdr-a-meeting-s-note-lives-where-its-work-is-target-state.md): PDR: «A meeting's note lives where its work is» target state — meeting record (note body, date, participants) on the task it was about; decisions and to-dos…
- [Sync heals itself: bad rows set aside, a pull-again after upgrades, self-update of the plugin…](docs/adr/0117-sync-heals-itself-bad-rows-set-aside-a-pull-again-after-upgr.md): Sync heals itself: bad rows set aside, a pull-again after upgrades, self-update of the plugin checkout, a stuck warning
- [A task analysis is a five-chapter design doc, written with the analysis skill; file sections land…](docs/adr/0118-a-task-analysis-is-a-five-chapter-design-doc-written-with-th.md): A task analysis is a five-chapter design doc, written with the analysis skill; file sections land in the chapter their heading names
- [The agent's reply language is one per-machine setting, said at every session start; English by…](docs/adr/0119-the-agent-s-reply-language-is-one-per-machine-setting-said-a.md): The agent's reply language is one per-machine setting, said at every session start; English by default
- [Pocock's artifacts live in the existing tables: spec, map and capability as scoped documents;…](docs/adr/0121-pocock-s-artifacts-live-in-the-existing-tables-spec-map-and.md): Pocock's artifacts live in the existing tables: spec, map and capability as scoped documents; project and out-of-scope as repo documents; delta on sections;…
- [GLOSSARY.md at the root in Pocock's format with term anchors for the round trip; ADRs as…](docs/adr/0122-glossary-md-at-the-root-in-pocock-s-format-with-term-anchors.md): GLOSSARY.md at the root in Pocock's format with term anchors for the round trip; ADRs as docs/adr/NNNN-slug.md read back by hash, the record winning a clash…
- [keepGoing is a Stop hook in the Ralph Wiggum way, made epic-aware: the epic of the child changed…](docs/adr/0123-keepgoing-is-a-stop-hook-in-the-ralph-wiggum-way-made-epic-a.md): keepGoing is a Stop hook in the Ralph Wiggum way, made epic-aware: the epic of the child changed last, its next child whose named blockers are done; a 👉 or…
- [.scratch/ is written by scratch-files.js from spec and map documents and their child tasks; edits…](docs/adr/0124-scratch-is-written-by-scratch-files-js-from-spec-and-map-doc.md): .scratch/ is written by scratch-files.js from spec and map documents and their child tasks; edits read back by file hash as with ADRs; out of git through its…
- [pocock-files.js writes .out-of-scope/, docs/PROJECT.md, docs/capabilities/ and docs/agents/ with…](docs/adr/0125-pocock-files-js-writes-out-of-scope-docs-project-md-docs-cap.md): pocock-files.js writes .out-of-scope/, docs/PROJECT.md, docs/capabilities/ and docs/agents/ with the shared writer; a done task's spec deltas merge into capa…
- [Imprimatur carries 19 of Pocock's skills verbatim (MIT, NOTICE per skill, commit 4ae2317ddb22);…](docs/adr/0126-imprimatur-carries-19-of-pocock-s-skills-verbatim-mit-notice.md): Imprimatur carries 19 of Pocock's skills verbatim (MIT, NOTICE per skill, commit 4ae2317ddb22); only the tracker sentence changes to "Imprimatur itself"; to-…
- [The MCP document tools take every scoped kind (spec, map, capability with task = key or name) and…](docs/adr/0127-the-mcp-document-tools-take-every-scoped-kind-spec-map-capab.md): The MCP document tools take every scoped kind (spec, map, capability with task = key or name) and a section's delta; taskupsert takes tickettype and blockedb…
- [Search ranks with BM25 in JavaScript (node:sqlite has no FTS5): an in-memory index per connection,…](docs/adr/0128-search-ranks-with-bm25-in-javascript-node-sqlite-has-no-fts5.md): Search ranks with BM25 in JavaScript (node:sqlite has no FTS5): an in-memory index per connection, rebuilt on change; every word must match, the last as a pr…
- [The wiki is docs/wiki/<module>.md per top-level code folder plus README.md, written by…](docs/adr/0129-the-wiki-is-docs-wiki-lt-module-gt-md-per-top-level-code-fol.md): The wiki is docs/wiki/<module>.md per top-level code folder plus README.md, written by Sonnet (claude -p) from the files' opening comments, the module'…
- [The new panel is vscode/app/: a pure model (model.js), pure HTML (html.js) and a thin webview glue…](docs/adr/0130-the-new-panel-is-vscode-app-a-pure-model-model-js-pure-html.md): The new panel is vscode/app/: a pure model (model.js), pure HTML (html.js) and a thin webview glue (panel.js) re-rendered on every move; VS Code theme variab…
- [A spec's gate counts as approved only when the user created its decision record (first version's…](docs/adr/0131-a-spec-s-gate-counts-as-approved-only-when-the-user-created.md): A spec's gate counts as approved only when the user created its decision record (first version's actorkind = user); an agent's shows as agent-recorded with C…
- [Current File is a native tree view: records whose links name the file (ADRs and decisions first),…](docs/adr/0132-current-file-is-a-native-tree-view-records-whose-links-name.md): Current File is a native tree view: records whose links name the file (ADRs and decisions first), the Agent Change Graph's rows for it, and the document sect…
- [The old panel (graphView.js and the pages' HTML in tasksView, docsView, exerciseView) is deleted;…](docs/adr/0133-the-old-panel-graphview-js-and-the-pages-html-in-tasksview-d.md): The old panel (graphView.js and the pages' HTML in tasksView, docsView, exerciseView) is deleted; the new panel is the only one
- [Key choices](docs/adr/0134-key-choices.md): The few choices the rest of the design follows from. Each is explained in the section named.
- [Social document: a per-repo opt-in document kind (#109)](docs/adr/0135-social-document-a-per-repo-opt-in-document-kind-109.md): A fifth document kind, social ("Social Media"), stored like the design documents (documents, docsections, versions, read marks) and synced with docs/SOCIAL.md.
- [One-time backfill of design documents and glossary](docs/adr/0136-one-time-backfill-of-design-documents-and-glossary.md): A repo's empty design documents and glossary are filled once, in the background, by a read-only claude -p agent run, rather than left empty or backfilled by…
- [/imprimatur-stats: scoreboard skill (#146)](docs/adr/0137-imprimatur-stats-scoreboard-skill-146.md): skills/imprimatur-stats/stats.mjs is a Node ESM script run by the /imprimatur-stats skill: it maps a repo folder to its git root, takes --days N (default 7),…
- [Device sync heals itself (#169)](docs/adr/0138-device-sync-heals-itself-169.md): Device sync lives in the private plugin (imprimatur-private, config.json "plugins"). It keeps itself working with no commands on any machine:
- [Local database and data model](docs/adr/0139-local-database-and-data-model.md): - Node's built-in node:sqlite (DatabaseSync): no native module, one universal .vsix. The extension runs on VS Code's Node (Node 24); hooks and the MCP server…
- [File-based review data](docs/adr/0140-file-based-review-data.md): The review of an agent edit is kept not in the database but as files, one folder per repo: hooks must write very fast before an edit, the data must be split…
- [Project glossary: a third living document (#91)](docs/adr/0141-project-glossary-a-third-living-document-91.md): - 6903: the project glossary became a third living document alongside Architecture and Product (documents.kind = 'glossary'), one section per term, sorted al…
- [Imprimatur's rules live in their own generated file (.claude/rules/imprimatur.md), never in the…](docs/adr/0142-imprimatur-s-rules-live-in-their-own-generated-file-claude-r.md): Imprimatur's rules live in their own generated file (.claude/rules/imprimatur.md), never in the repo's AGENTS.md or rules files
## Terms
- [imprimatur](GLOSSARY.md): The words this project uses, one entry each; the words under Avoid mean the same and are not used.
## Out of scope
- [Out of scope](.out-of-scope/non-goals.md): - A cost dashboard or enterprise FinOps: providers (Claude Code /usage, Cursor, Copilot) and free tools already report cost. Imprimatur shows what eats conte…
## For agents
- [Domain Docs](docs/agents/domain.md): How the engineering skills read this repo's domain documentation.
- [Issue tracker: Imprimatur](docs/agents/issue-tracker.md): Issues and specs for this repo live in Imprimatur's database, written out as Pocock's local Markdown tracker under .scratch/. Read and write them with the Im…
## Wiki
- [imprimatur wiki](docs/wiki/README.md): Generated from the code's own comments, the ADRs and the glossary; written again when those change. Edit the sources, not these pages.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

