Kanon

Geladen instructiebestanden vastleggen ​

Kanon is een Claude Code-plugin op basis van hooks. De plugin registreert elk geladen instructiebestand, inclusief bestandspad, volgorde en de door Claude Code opgegeven reden.

Een CLAUDE.md kan uit het huidige project komen, uit ~/.claude, uit een bovenliggende map, uit een submap die tijdens de sessie wordt geopend, uit een keten van @path-imports of uit een dependency. Claude Code laadt deze bestanden zonder een overzicht van de herkomst te geven.

FOREIGN markeert een extern instructiebestand, bijvoorbeeld uit een dependency. missing markeert een bestand dat bij de sessiestart verwacht werd maar niet is geladen. quiet markeert een beschikbare regel waarvan de laadvoorwaarde tijdens de sessie niet is geactiveerd.

Vergelijken met eerdere sessies ​

Kanon bewaart voor de repository een overzicht van eerder geladen instructiebestanden, met een sha256 per bestand. appeared betekent dat een bestand voor het eerst is geregistreerd, changed dat de bytes zijn veranderd en vanished dat het bestand van schijf is verwijderd. Een verdwenen bestand wordt één keer gemeld.

Zo kan een dependency-update worden gesignaleerd die een CLAUDE.md wijzigt terwijl de bestandslijst gelijk blijft. De digest toont dát de inhoud is veranderd, zonder de betekenis te analyseren of een inhoudelijke diff te tonen. Die diff kun je apart bekijken.

Context bij de sessiestart ​

Instructiebestanden worden samengevoegd in de modelcontext zonder bronvermelding. Kanon voegt aan het begin van elke sessie een overzicht van de herkomst toe.

Het overzicht vermeldt elk bestand en de herkomst, citeert de eerste richtlijn uit elk extern bestand, rapporteert wijzigingen sinds de vorige sessie en bevat de opdracht om opvallende punten ter beoordeling aan je voor te leggen. Dezelfde tekst gaat via beide SessionStart-kanalen: additionalContext voor het model en systemMessage voor je transcript.

Laadt een extern instructiebestand later, dan meldt Kanon dat bij de volgende prompt. Claude Code verwijdert de uitvoer van InstructionsLoaded, waardoor die hook een laadmoment wel kan vastleggen maar geen waarschuwing kan tonen. Bij een gewone beurt gebruikt de vervolgcontrole één wc -l. Als het sessielog niet is gegroeid, start Bun niet.

Snel starten ​

Vereist Bun 1.1 of nieuwer. Kanon doet geen netwerkverzoeken, heeft geen API-key nodig en blokkeert geen sessies.

claude plugin marketplace add https://github.com/AraneaDev/aranea-marketplace
claude plugin install kanon@aranea

Hooks worden bij de sessiestart geregistreerd. Start na installatie een nieuwe sessie om het vastleggen te beginnen. Eerdere laadmomenten zijn niet te reconstrueren.

Rapporten, herkomst zoeken en audits ​

/kanon toont een sessierapport. Zonder argumenten wordt de laatst vastgelegde sessie voor de huidige repository geselecteerd. Sessies uit andere mappen worden niet gebruikt, omdat dat niet-gerelateerde laadmomenten en verwachtingen zou vergelijken.

/kanon:whose <zinsnede> doorzoekt instructiebestanden op de bron van een regel. Daarmee kun je de herkomst opzoeken van tekst die zonder bronvermelding in de gecombineerde context staat.

WHOSE  "geen em dashes"                                   observed
  user       ~/.claude/rules/schrijfstijl.md         line 24
             "- **Geen em dashes (—).** Gebruik een komma of twee korte zinnen."

Zoeken is hoofdletterongevoelig. Witruimte wordt samengevouwen, zodat een zinsnede ook gevonden wordt als die in het instructiebestand over meerdere regels is verdeeld.

Als geen bestand de zinsnede bevat, vermeldt het resultaat dat en het aantal doorzochte bestanden. De richtlijn kan uit een skill, MCP-server of hook van een andere plugin komen, of nooit in een instructiebestand hebben gestaan. Die andere bronnen vallen buiten deze zoekfunctie.

/kanon:audit toont instructiebestanden die in deze checkout in een sessie zouden kunnen laden. Een eerdere sessie is niet nodig. Je kunt de audit dus direct na het klonen van een repository of het installeren van dependencies uitvoeren.

De tweede kolom beschrijft hoe een bestand zou laden, niet of dat daadwerkelijk is gebeurd. Een on-demand-bestand in een dependency laadt wanneer Claude Code een bestand in die map leest. De audit neemt dependency- en puntmappen mee. Andere Kanon-scans slaan die over wanneer laadmomenten via sessie-events zijn vast te leggen. .git wordt altijd overgeslagen.

Vastgelegde events en voorspelde laadmomenten ​

De plugin verwerkt vastgelegde events en voorspellingen in afzonderlijke lagen.

Een hook voegt ruwe events toe aan ~/.kanon/sessions/<id>.jsonl, met minimale verwerking. Het overzicht van geladen bestanden is daardoor niet afhankelijk van een model van de bestandsresolutie van Claude Code.

De voorspellingslaag modelleert die resolutie om te bepalen welke bestanden hadden moeten laden. Als een geladen bestand niet was voorspeld, meldt Kanon het verschil en krijgt NOT LOADED voor die sessie het label onbetrouwbaar. De vastgelegde laadmomenten blijven los daarvan beschikbaar.

Elk rapport bevat een ruleset-stempel dat het gebruikte model identificeert. Anthropic kan het laadgedrag van Claude Code wijzigen. Het stempel helpt rapporten op basis van een verouderd model te herkennen.

Bereik en beperkingen ​

Kanon rapporteert geladen bestanden en de herkomst. De plugin analyseert de betekenis van instructies niet, geeft geen scores, rangschikt geen instructies en scant niet op prompt injection. Je beslist zelf of instructies uit een dependency bij je sessie horen.

Het sessieoverzicht citeert de eerste inhoudelijke richtlijn uit elk extern bestand, zodat de tekst terug te vinden is in de gecombineerde context. /kanon:whose leest ook bestandsinhoud om letterlijke tekst te zoeken en citeert de gevonden regels. Geen van beide functies beoordeelt de kwaliteit van instructies. Zoekresultaten staan op volgorde van herkomst, zonder scores of rangorde.

Skills, MCP-servers, output styles en hooks van andere plugins kunnen ook instructies toevoegen. Kanon modelleert die bronnen niet: Claude Code geeft een hook-event voor instructiebestanden, maar geen vergelijkbaar event voor skilltekst of serverinstructies. Resultaten voor instructiebestanden zijn vastgelegde events of gelabelde voorspellingen. /kanon:whose vermeldt de grenzen van die dekking als geen bestand overeenkomt.

Kanon blokkeert geen configuratiewijzigingen, ook niet via ConfigChange.

Kanon slaat gegevens uitsluitend onder ~/.kanon/ op en schrijft nergens anders. Kanon leest ~/.claude/ zonder daar te schrijven. Data ouder dan 90 dagen wordt bij de volgende run verwijderd.