installatie-onderhoud-graft-rtk-ponytail-lite

Prompt

# Verified Installation and Maintenance — Graft + RTK + Ponytail lite

Je werkt in de huidige repository om deze stack te installeren, bij te werken, te repareren of te verifiëren:

- Graft: codebegrip, lokale grafiek en LSP-verrijking.
- RTK: terminal ruisreductie.
- Ponytail: lite policy, met native integratie wanneer compatibel.

Begin met een alleen-lezen inventarisatie. Stel daarna de ontbrekende vragen hieronder.
Na de antwoorden voer je de geautoriseerde handelingen uit tot de laatste controles.

Start de installatie niet voordat de cliënten en scope zijn bepaald.
Vraag niet opnieuw om een beslissing die al in dit gesprek is gegeven.

## 1. Inventarisatie, daarna keuze gebruiker

### Inventarisatie zonder wijziging

Identificeer:

- OS, architectuur, shell, omgeving: lokale machine, WSL, SSH, container;
- repository root, worktree, Git-status en lopende Git-operaties;
- daadwerkelijke paden, versies en installatiemethode van Git, Node, npm,
  RTK, Graft en beschikbare clients;
- Claude Code, Codex, Kimi, Cursor Agent CLI en Cursor IDE apart;
- Gemini, Copilot CLI of andere clients die al aanwezig zijn als optionele doelen;
- daadwerkelijk gebruikte configuratiemap, omleidingsvariabelen,
  en elke orchestrator zoals AgentsRoom;
- bestaande gebruikers-, project-, plugin- en geërfde hookconfiguraties.

Verifieer de identiteit van `agent` voordat je het als Cursor beschouwt.
Een aanwezige binary bewijst geen authenticatie, hook-functionaliteit of MCP-laden.

Start geen automatische updates, verbindingen of installaties tijdens deze inventarisatie.
Publiceer geen geheime waarden.

Presenteer een korte tabel:
Client | Binary/versie | Effectieve configuratie | Bekende status.

### Vragen om in één keer te stellen

Stel alleen de vragen waarvoor het antwoord ontbreekt:

1. Operatie:
   - Installeer ontbrekende componenten en behoud compatibele versies.
   - Werk de stack bij naar geverifieerde stabiele versies.
   - Repareer de bestaande installatie terwijl de versies behouden blijven.
   - Alleen verifiëren, zonder wijziging.

2. Clients:
   - Alle gedetecteerde clients.
   - Een selectie uit de daadwerkelijk gedetecteerde lijst.
   - Bereid ook configuratie voor enkele afwezige clients voor.

3. Integratiescope:
   - Gedeeld project: draagbare configuraties bedoeld voor de repository.
   - Persoonlijk project: activatie voor deze repository, niet-versiebeheerde lokale bestanden.
   - Globale gebruiker: activatie voor de projecten van deze gebruiker.
   - Gemengd: aparte keuze per client of component.

Als de scope gemengd is, vraag dan alleen de noodzakelijke verduidelijkingen.

Voor een update vraag ook naar eventuele versiebeperkingen als die nog niet bekend zijn.
Anders stel expliciete stabiele versies voor.

Installeer of update de clientapplicaties zelf niet:
de operatie betreft Graft, RTK, Ponytail en hun noodzakelijke afhankelijkheden.
Een verouderde client wordt gerapporteerd met de vereiste versie en resterende actie.

### Maak keuzes concreet

Toon vóór het schrijven het geplande resultaat:

Component/client | Doelversie | Scope | Doelbestanden | Gedeeld effect | Fallback

Leg met name uit:

- Een uitvoerbaar bestand geïnstalleerd op gebruikersniveau kan meerdere repositories bedienen.
- Het bijwerken van dit uitvoerbare bestand beïnvloedt al zijn lokale gebruikers.
- Een plugin kan een globale cache hebben maar activatie per project.
- Een hook per project kan nog steeds een gedeelde status gebruiken.
- De Graft-index blijft specifiek voor de repository/worktree.
- Een globale configuratie geleverd door een orchestrator kan geïsoleerd zijn
  tot een project: verifieer de daadwerkelijke scope, niet alleen de naam.

Zodra keuzes zijn verkregen, ga door zonder herhaalde bevestigingen.
Vraag alleen een nieuwe beslissing als een beperking een uitbreiding van scope of een materiële oplossing vereist.

## 2. Uitvoeringsregels

Volgorde:
inventarisatie → keuze → back-ups → RTK → Graft/LSP → Ponytail →
instructies → verificaties → rapport.

Respecteer repository-instructies en beheerde beleidsregels.
Als een bestand wordt beheerd door AgentsRoom of een andere orchestrator,
gebruik dan het officiële mechanisme; wijzig de gegenereerde bestanden niet direct.

Voor elke wijziging:

- valideer het formaat EN de structuur van JSON/JSONC/TOML-configuraties;
- maak een back-up van de getroffen bestanden buiten de repository, met beperkte toegang;
- registreer versies en elementen die nodig zijn voor rollback;
- bekijk de dry-run van de installer als die bestaat.

Een ongeldig bestand mag nooit worden vervangen door een lege configuratie.

Merge configuraties waarbij andere MCP's, hooks, permissies,
instructies, opmerkingen indien mogelijk en statusregels behouden blijven.
Wijzig geen goedkeuringsregels of vertrouwens-fingerprints.

Behoud vooraf bestaande Git-wijzigingen. Geen commit, push, reset,
clean, stash of wijzigingen in applicatiecode.
Bij een onopgelost conflict of lopende Git-operatie, schort
schrijfacties in de repository op; ga door met onafhankelijke diagnostiek.

Installeer Graphify, CodeGraph, Caveman of Headroom niet.
Een oude conflicterende integratie wordt alleen verwijderd na precieze identificatie,
back-up en binnen de geautoriseerde scope.
Verwijder een tool die elders wordt gebruikt niet globaal.

Een fout blokkeert de afhankelijke stappen, niet andere onafhankelijke clients.
Verklaar een stap niet succesvol om een beperking te omzeilen.

## 3. Mogelijkheden en scope: verifieer vóór configuratie

Raadpleeg de help van geïnstalleerde versies en de documenten die horen bij
de gepubliceerde versies die je gaat gebruiken:

- https://github.com/rtk-ai/rtk
- https://github.com/trailhq/Graft
- https://github.com/DietrichGebert/ponytail
- officiële documentatie van elke geselecteerde client.

De main/develop branch kan functies beschrijven die afwezig zijn in een release.
Bij twijfel over een optie, controleer de release, de help of de geleverde code.

Stel voor elke integratie vast:

Client | Beschikbare projecthooks | Compatibele installer |
Activatiescope | Statusscope | Bewijs

Verwar niet:
"de client accepteert projecthooks"
en "de installer van deze tool weet hoe ze op projectniveau te installeren."

Controlepunten om opnieuw te verifiëren in de huidige versies:

- Claude: gebruikersinstellingen, gedeeld project en lokaal project.
- Cursor: gebruikers- en projecthooks; test IDE en CLI apart.
- Codex: gebruikers-/projectconfiguraties en pluginactivatie;
  verifieer de daadwerkelijk beschikbare hook-mechanismen.
- Kimi: ga niet uit van een per-project hookconfiguratie;
  onderscheid gebruikersconfiguratie, projectinstructies en lanceeropties.
- Gemini/Copilot: verifieer hun eigen mechanismen indien geselecteerd.

Als de installer de gevraagde scope niet respecteert:

1. Zoek naar een geschikte officiële optie.
2. Gebruik anders een gedocumenteerde handmatige configuratie van dezelfde adapter,
   alleen als het protocol en de paden compatibel blijven.
3. Gebruik anders fallback via expliciete instructies/prefix.
4. Schakel nooit stilzwijgend over naar globaal.

Inspecteer geërfde globale hooks voordat je hun lokale equivalenten toevoegt:
ze kunnen zich opstapelen in plaats van elkaar te vervangen.
Behoud beveiligingshooks. Rapporteer globale effecten die actief blijven.

## 4. RTK

Controleer de oorsprong `rtk-ai/rtk`, de versie, de help, de configuratie
en `rtk gain`. Een `gain`-fout kan komen door de basis of permissies:
dit is geen voldoende bewijs van een slecht pakket.

Installeer of update met de reeds gebruikte manager, indien passend.
Controleer de oorsprong van de formule of het pakket en de verkregen versie.
Vermijd gelijktijdige installaties en onnodige PATH-wijzigingen.
Voer niet blindelings `cargo install rtk` uit.

Raadpleeg `rtk init --help` voor de gekozen versie.
Selecteer opties per client en scope; kopieer niet systematisch
`-g` uit een documentatievoorbeeld.

Ga er niet van uit dat de Codex-integratie altijd een eenvoudige instructie is,
noch dat deze altijd een hook heeft: dit hangt af van de RTK-versie.
Controleer ook incompatibiliteiten tussen initialisatieopties.

Voeg in de daadwerkelijk gelezen configuratie uitsluitingen samen:

    [hooks]
    exclude_commands = ["graft", "curl", "playwright"]

Behoud bestaande uitsluitingen en verifieer hun inachtneming.
Als deze instelling globaal is, geef dit effect aan voordat je deze wijzigt.
Schakel optionele telemetrie uit via de gedocumenteerde methode,
binnen de toegestane scope.

RTK is het enige onderdeel dat shell-commando's mag herschrijven.
Beveiligings-, audit- en goedkeuringshooks blijven van toepassing.

Kopieer een Claude-hook niet naar een andere client zonder gedocumenteerde compatibiliteit.
Zonder effectieve herschrijving, configureer de expliciete prefix `rtk`.
Vermijd dubbele hooks en dubbele prefixes.

## 5. Graft met LSP

### Installatie en privacy

Verifieer de identiteit van het pakket `@nanonets/graft`, de gepubliceerde versie
en de Node-vereisten.

Installeer buiten applicatie-afhankelijkheden, op een geschikte locatie.
Wijzig package.json of het projectlockbestand niet om Graft te installeren.

Pas `DO_NOT_TRACK=1` toe vanaf de eerste lancering en in de MCP.
Gebruik de officiële telemetrie-uitzetopdracht indien beschikbaar.

Activeer geen Brain, account, LLM-verrijking of `--deep`.
Beloof geen nul netwerk zonder dit te verifiëren.

Voer `graft init` niet automatisch uit.
Geef de voorkeur aan expliciete koppeling; de installer kan buiten de repository schrijven.

### Echt operationele LSP

Respecteer vóór het verkennen van applicatiecode de Graft-regels van de repository.
Identificeer vervolgens nuttige talen en raadpleeg de LSP-integraties
van de gekozen Graft-versie.

Herbruik compatibele servers die al aanwezig zijn.
Installeer alleen noodzakelijke servers, met geregistreerde versies,
bij voorkeur buiten applicatie-afhankelijkheden.

Controleer:

- de uitvoerbare file en de versie;
- de beschikbaarheid in de PATH van het Graft/MCP-proces;
- taal- en werkruimtevereisten;
- de ondersteuning door deze Graft-versie.

Gebruik na het lezen van de help met name, indien beschikbaar, deze opties:

    graft build --lsp --no-ignore --no-gitignore
    graft check
    graft ask "Where are the main entry points and API routes, if any?" --source

Pas DO_NOT_TRACK toe op deze commando's met de huidige shell-syntaxis.

Controleer de betekenis van de opties: in sommige versies
voorkomen `--no-ignore` en `--no-gitignore` het schrijven van uitsluitingsbestanden;
ze betekenen niet "indexeer genegeerde bestanden."

Beheer expliciet Git-uitsluiting van `/graft/` volgens de gekozen scope.
Verifieer dit met Git. Verwijder geen reeds getrackte bestanden automatisch.
Behoud annotaties en menselijke inhoud.

Een build met `--lsp` en exitcode 0 bewijst niet dat LSP wordt gebruikt.
Zoek naar gericht bewijs: server daadwerkelijk gestart, resolutieresultaat,
verrijkte edges of gedocumenteerde diagnostiek.

Rapporteer per taal:
LSP geverifieerd / beschikbaar zonder waargenomen verrijking / niet beschikbaar / niet ondersteund.

Laad nooit de volledige grafiek of wiring.json in de context.
Controleer ook of LSP-verrijking blijft na een automatische verversing;
indien niet gegarandeerd, documenteer de expliciete reconstructie die nodig is.

### MCP en versheid

Configureer één effectieve Graft-entry per client.
Ontdek het bestand, schema en de daadwerkelijk ondersteunde scope.

Verifieer voor elke server:
geïnstalleerd commando, MCP-argumenten, DO_NOT_TRACK, PATH en werkmap.

Ga er niet van uit dat een `.kimi-code/mcp.json`, `.mcp.json` of ander bestand automatisch wordt geladen: bevestig het clientmechanisme of de noodzakelijke lanceeroptie.

Een globale MCP-configuratie is acceptabel alleen als het doelproces elke repository correct adresseert. Anders houd MCP op projectniveau.

Gebruik niet `npx -y ...@latest` bij elke opstart.
Versiebeheer geen absolute persoonlijke paden of geheimen.
Bedenk geen universele variabele `${workspaceFolder}`.

Voeg in dit profiel geen Graft-hooks toe.
Geen smart-grep, grep-redirect of Graft shell-interceptie.

Controleer de verversing en het ontbreken van onbedoelde uitschakeling.
Een mislukte verversing verbiedt het presenteren van de grafiek als vers.

Inspecteer oude integraties en auto-wiring metadata vóór migratie.
Verwijder alleen geïdentificeerde en geback-upte elementen.
Verifieer dat ze niet terugkeren na MCP-opstart en query.

### Graft Statistieken

Scheiding van operatie, waargenomen gebruik en statistiekverzameling.

Afhankelijk van de versie is `graft stats` afhankelijk van sessiehooks.
Zonder deze hooks kan "nog geen sessie geregistreerd" worden verwacht ondanks succesvolle Graft-verzoeken.

Maak geen statistieken aan of voer `graft init` niet uit om dit bericht te laten verdwijnen.

Als de gebruiker native statistieken nodig heeft, toon dan de compatibiliteit van beschikbare meethooks en vraag expliciet om profielontwikkeling zonder hooks vóór enige activatie.

## 6. Ponytail lite

Geef de voorkeur aan een officiële integratie die compatibel is met de client en scope.
Controleer het manifest, de events en afhankelijkheden.

Maak onderscheid tussen:
installatie van de plugin, activatie, standaardmodus en huidige modusstatus.

Inspecteer de daadwerkelijk gelezen bronnen:
configuratie, `PONYTAIL_DEFAULT_MODE`, persistente status en plugindata.
`defaultMode: lite` bewijst niet dat een oude volledige status is vervangen.

Als de modus gedeeld wordt tussen gesprekken, geef dit dan aan.
In projectscope, verander niet stilzwijgend de globale standaard.
Gebruik een gedocumenteerd lokaal mechanisme of het lite-beleid via instructies.

Per client:

- Claude/Codex: officiële installatie en activatie binnen beschikbare scope.
  Controleer subcommando's voordat je ze gebruikt.
  Hook-goedkeuringen blijven bij de gebruiker.
- Cursor: officiële adapter, of instructieregel; vermijd hun accumulatie.
  Als `scripts/cursor-hooks.js install --project` bestaat, voer het script uit
  vanuit de root van de doelrepository met het officiële checkoutpad.
  Zonder `--project`, controleer de gebruikersbestemming.
  Inspecteer gegenereerde paden: een projecthook met een absoluut pad
  naar een persoonlijke checkout is niet draagbaar en mag niet worden gecommit.
- Kimi: zoek naar een compatibele officiële adapter. Anders lite-beleid
  in AGENTS.md; voeg alleen een minimale lokale skill toe als nuttig
  en als het formaat en laden bevestigd zijn.
  Identificeer het als een aanpassing, zonder native commando's of stats te beloven.
- Andere geselecteerde clients: pas dezelfde verificatie toe, zonder automatisch
  Claude/Codex-events te transponeren.

Houd de adaptercheckout op een geïdentificeerde versie of commit.
Voer geen git pull uit op een gewijzigde checkout.
Voeg geen statuslijn of visuele indicator toe.

Test de effectieve modus in een nieuwe sessie.

## 7. Compacte algemene instructies

Voeg een blok samen dat wordt afgebakend door:

    <!-- agent-stack:start -->
    ...
    <!-- agent-stack:end -->

in AGENTS.md. Behoud alle externe inhoud en menselijke toevoegingen.
Kopieer deze installatieprompt niet in agentinstructies.

Het blok moet uitdrukken:

### Graft

Om de code te begrijpen of te wijzigen, eerst applicatieverkenning:
`graft ask "<precies vraag>" --source`, of daadwerkelijk blootgestelde MCP Graft-tool.

Instructies, skills, Git, configuraties en MCP-ontdekking kunnen voorafgaan.
Na oriëntatie, lees direct de nuttige delen.
Voor aanroepers, gebruik beschikbare trace-commando's/-tools.

Bij een verouderde grafiek: controleer, aangepaste reconstructie met LSP, dan nieuwe query.
Na een mislukte zoekopdracht: gerichte graft grep, dan directe lezing
of begrensde rg met uitleg van de limiet.

Een geleverd bestand, een stacktrace, een configuratie of een niet-geïndexeerde taal
maakt directe gerichte lezing mogelijk.
Afwezigheid in de grafiek bewijst niet de afwezigheid van code of aanroepers.

Na wijzigingen: graft blast, geverifieerde Git-basis en relevante tests.
Geen --name, geen volledige grafiekladen.
Rapporteer het werkelijke aantal aanroepen en eventuele fouten.

### RTK

Gecontroleerde hook: laat herschrijven toe zonder dubbele prefix.
Anders: prefix expliciet compatibele commando's.
Geef Graft nooit door via RTK.

Voor volledige output: roep --full opnieuw op indien beschikbaar, of proxy.
Voer een commando met bijwerkingen niet automatisch opnieuw uit.
Behoud pipelines en omleidingen.

Voor validatie: echte ongecomprimeerde diffs, diff --cached,
diff --check en aparte inspectie van nieuwe bestanden.
Geen automatische staging.

### Ponytail lite

Implementeer het verzoek correct en hergebruik bestaand.
Rapporteer kort een aanzienlijk eenvoudigere oplossing.
Behoud validatie, beveiliging, permissies, toegankelijkheid, transacties
en noodzakelijke tests. Verifieer gebruik vóór verwijdering of inline plaatsen.

Volledig alleen op expliciet verzoek, nooit ultra standaard.
Een audit triggert geen herontwerp.
Correctie heeft prioriteit voor beveiliging, parsers, gelijktijdigheid en migraties.

Claim niet dat een gedeelde modus lokaal is voor een gesprek.
Na een geautoriseerde volledige, verifieer terugkeer naar lite.
Uit staat verwijdert geen reeds geïnjecteerde instructies.

### Laden

Bevestig hoe elke client deze instructies daadwerkelijk laadt.
Gebruik gedocumenteerde minimale imports/adapters.
Vermijd duplicaties en circulaire imports.

RTK blijft de enige shell-herschrijver.
Geen Graft-hook in dit profiel.

## 8. Bijwerken en Repareren

Dezelfde prompt moet zonder duplicaten opnieuw kunnen worden uitgevoerd.

In update-modus:

1. Lees de scopekeuzes en de eerder geverifieerde status opnieuw.
2. Vergelijk geïnstalleerde versies, doelversies en incompatibele wijzigingen.
3. Maak een back-up vóór elke migratie.
4. Werk alleen de geselecteerde componenten bij.
5. Vernieuw plugins/adapters met hun officiële mechanisme.
6. Herwaardeer mogelijkheden: een oude fallback kan nu vervangen worden
   door een native integratie binnen dezelfde scope.
7. Migreer alleen sleutels en blokken die bij deze stack horen.
8. Bouw de grafiek indien nodig opnieuw en controleer de LSP opnieuw.
9. Herstart noodzakelijke MCP/clientprocessen:
   een bestaand proces kan nog de oude versie draaien.
10. Speel controles en tests van gewijzigde integraties opnieuw af.

Installeer een component niet onnodig opnieuw als deze al compliant is.
Start geen algemene update van de pakketten van de machine.

In reparatiemodus, behoud versies behalve bij aangetoonde incompatibiliteit
en expliciete updatebeslissing.

Bereid een gerichte rollback voor: vorige versies, back-ups,
en exacte commando's. Herstel niet blindelings een heel bestand
als er andere wijzigingen zijn sinds de back-up.

Een tweede uitvoering zonder gevraagde wijzigingen mag geen
hook, MCP-server of dubbele instructiesectie creëren.

## 9. Controles en Bewijzen

Test afzonderlijk:

- RTK uitvoerbaar en expliciete compressie;
- automatische hook-triggering, uitzonderingen en ruwe doorvoer;
- Graft: actualiteit, resultaat dat overeenkomt met de repository, en LSP-verrijking;
- MCP: functionele server EN daadwerkelijke loading in elke client;
- Ponytail: activatie en effectieve modus;
- afwezigheid van duplicaten en opnieuw verschenen zelfbedrading;
- definitieve geldigheid van configuraties en effectieve scope.

Een aanwezig bestand is geen bewijs van loading.
Een externe MCP-probe is geen bewijs van loading in de client.
Een expliciete RTK-prefix is geen bewijs van automatische hook.

Voor elke beschikbare en geauthenticeerde client, open een nieuwe sessie
in de repository, met de gebruikelijke beschermingen, en geef dit neutrale ticket:

"Zonder de code te wijzigen, lokaliseer de hoofdingangspunten.
Als er een API is, geef aan waar de routes zijn gemonteerd en traceer
een pad naar de businesslogica. Noem bestanden en regels."

Voeg geen "use Graft" toe.
Inspecteer zichtbare tool-aanroepen, niet interne redenering.
Houd minimale bewijzen en redacteer gevoelige data.

Als goedkeuring, login of UI-actie ontbreekt:
NIET GETEST / GEBRUIKERSACTIE, nooit succes veronderstellen.

## 10. Oplevering

Binnen de geautoriseerde scope, houd een korte onderhoudsdocumentatie bij:

- keuze van operatie, clients en scope;
- exacte versies, herkomst en verificatiedatum;
- configuratiemechanismen en limieten;
- Graft/LSP reconstructie;
- update-, verificatie- en rollback-procedure.

Voor een gedeelde installatie, gebruik `docs/agent-stack.md`.
Voor een persoonlijke/wereldwijde installatie, houd machine-specifieke informatie
buiten versiebeheer bestanden.
In verificatie-only modus, lever het rapport zonder deze bestanden aan te maken.

Rapporteer doorslaggevende commando's, hun resultaten, gewijzigde bestanden,
back-ups en exacte gebruikersacties.

Inventariseer de definitieve hooks:
client, herkomst, scope, event, matcher, rol en geredigeerd commando.

Sluit af met:

Client/versie | Effectieve scope | Aanwezige configuratie |
MCP geladen | Graft waargenomen bij eerste verkenning |
LSP | RTK | Ponytail | Overgebleven bewijs/actie

Gebruik expliciete statussen:
GECONFIGUREERD / GELOAD / GEBRUIK WAARGENOMEN / NIET GETEST / GEBLOKKEERD / NIET VAN TOEPASSING.

Classificeer bestanden:
TE COMMITTEN NA REVIEW / TE NEGEREN / MACHINECONFIGURATIE.

Persoonlijke paden, geheimen, caches, grafieken, back-ups en transcripties
mogen niet worden opgenomen in bestanden om te committen.

Toon de definitieve Git-status en door deze interventie geïntroduceerde wijzigingen,
onderscheidend van reeds bestaande wijzigingen. Commit niets.

Tags