// afspraak
copilot-instructions.md
Hoe Copilot zich op deze repo moet gedragen.
Voor gebruikers van GitHub Copilot CLI
Copilot begint elke sessie blind.
Aangepaste instructies vertellen Copilot hoe het zich moet gedragen. Ze vertellen niet wat er in je repo staat. Maguyva indexeert de codebase en levert die terug via MCP, zodat GitHub Copilot CLI bewerkt alsof het de code al heeft gelezen.
Free-abonnement: 3 repositories, Tot 50K geïndexeerde repo-regels, geen creditcard nodig.
Gebruik instructies voor gedrag. Gebruik Maguyva voor actuele codebase-feiten.De gelaagde stack
Vier ideeën. Elk met precies één taak.
// transport
MCP
Hoe Copilot externe tools en context benadert.
// codebase
Maguyva
De MCP-server die gefundeerde repofeiten teruggeeft.
// wie betaalt
Per workspace, niet per gebruiker
Voor agents betaal je geen gebruikerslicenties. Bekijk de prijzen
Aangepaste instructies zijn een werkafspraak. Gebruik ze.
# .github/copilot-instructions.md
- Geef de voorkeur aan de bestaande modulegrenzen.
- Voer het testcommando van de repo uit voordat je een merge voorstelt.
- Verzin geen bestandspaden. Vraag het voordat je een nieuw package maakt.Blijvende instructies horen thuis in .github/copilot-instructions.md. Dat is de juiste plek voor:
- Build-, test- en lintcommando's die Copilot moet uitvoeren.
- “Doe altijd X / doe nooit Y”-regels specifiek voor deze repo.
- Naamgevingsconventies en reviewvoorkeuren.
- Verwijzingen naar het beslissingslogboek — geen dump van elk symbool.
Dat bestand was nooit een doorzoekbare index van de repo. Het vertelt Copilot hoe het moet werken. Het vertelt niet wat er is.
Waar aangepaste instructies op schaal statisch worden
Vier faalmodi die Copilot niet kan oplossen vanuit een markdown-bestand.
// instructies zijn geen index
Telling Copilot how to behave does not tell it which class owns parseConfig, or which package actually implements the public API. De eerste bewerking op een onbekende boom is een gok naar de bestandsstructuur.
// docs verouderen, code niet
Een instructieblok dat de auth-flow van vorig kwartaal beschrijft, is overduidelijk fout op de dag dat iemand de session store opsplitst. Copilot will prefer the file you committed over the code that shipped.
// afhankelijkheden staan niet in markdown
“Wat importeert dit?” is a graph question. Instructies kunnen niet elke aanroeper opsommen, en dat zou je ook niet willen.
// contextvensters hebben een budget
Meer van de repo in instructies proppen ruilt redeneertokens in voor een verouderde momentopname. Na een paar KB betaal je voor een slechtere kaart.
Maguyva als de toegevoegde laag
Copilot denkt al in instructies en tools.
copilot-instructions.md
afspraak
hoe Copilot zich gedraagt
MCP
het kanaal
hoe het bereikt
Maguyva
codebase-feiten
wat het ziet
- Een doorzoekbare kaart van de repo geleverd via MCP als externe streamable-HTTP-server.
- 11 klantgerichte tools voor semantisch, structureel (AST-), graaf- en tekstzoeken, plus symbolen, afhankelijken en bestandsophaal.
- Gerangschikte resultaten met bestandspaden en regelnummers over meer dan 284 talen en tekstgebaseerde technologieën.
- Eén configuratie Dezelfde workspace geeft antwoord in Copilot, Claude Code, Cursor, Codex en elke andere MCP-compatibele client.
Aangepaste instructies vertellen Copilot hoe het zich moet gedragen.
Maguyva geeft Copilot een doorzoekbare kaart van de code.
Drie workflows
Vraag het de kaart voordat je de diff accepteert.
// workflow 01
Vind de echte implementatie, niet de teststub
copilot> hoe verwerkt normalizePhoneNumber E.164? semantic::query("normalize phone E.164") src/util/phone.ts:88 normalizePhoneNumber() ← echte impl. test/util/phone.spec.ts:14 jest.mock(...) ← stub → Copilot opent de implementatie, niet de mock. [exit 0]
Namen liegen. Mocks verhullen echte code. Maguyva rangschikt de echte implementatie boven de test-mock.
// workflow 02
Controleer de impactradius voordat je refactort
copilot> wat roept QueueDispatcher.publish aan? graph::callers(QueueDispatcher.publish) 3 in src/billing/* 1 in src/audit/* 1 in src/notifications/* → De diff is onderbouwd met echte importers. [exit 0]
Aanroeppunten tussen packages verschijnen inline. De diff is onderbouwd met echte importers, niet met Copilots grep.
// workflow 03
Hernoem een gedeelde klasse, vind eerst elke afhankelijkheid
copilot> rename PaymentClient → BillingClient graph::callers(PaymentClient) 12 verwijzingen in 7 packages graph::importers(src/payments/client.ts) 9 importers graph::extends(PaymentClient) 2 subklassen (RetryClient, MockClient) → Copilot stelt een migratie voor met de bestandslijst inline. [exit 0]
Copilot vraagt Maguyva naar afhankelijkheden voordat het begint te bewerken. De migratielijst komt terug op basis van de echte graaf, niet Copilots herinnering.
Installatie in GitHub Copilot CLI
Drie stappen. Free-abonnement: 3 repositories, Tot 50K geïndexeerde repo-regels, geen creditcard nodig.
// step 01
Indexeer een repo op maguyva.ai
Kies er een die je al kent, zodat je de antwoorden kunt beoordelen. Meld je gratis aan, verbind GitHub, wacht op de index.
// step 02
Voeg Maguyva toe als externe MCP-server in Copilot
copilot mcp add --transport http --header "Authorization: Bearer mgv_xxxx" maguyva https://maguyva.tools/mcp~/.copilot/mcp-config.json{ "mcpServers": { "maguyva": { "type": "http", "url": "https://maguyva.tools/mcp", "headers": { "Authorization": "Bearer mgv_xxxx" } } } }// step 03
Stel een vraag waarvan je het antwoord al kent
Begin niet met het hele bedrijf. Stel een vraag waarvan je het antwoord al kent, open dan het geciteerde bestand.