For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /nl/docs/desktop/agents.md (or send Accept: text/markdown).
Bouwen met een codeeragent
Geef taken aan een coding-agent: de bestanden die hij leest, de meegeleverde skills en de review die jou in controle houdt.
Walkthrough voor beginners
Vereisten: lees de twee beginnersgidsen hieronder en voltooi de lokale Desktop-setup. Een coding-agent is een AI-tool — Cursor, Claude Code, Devin of een vergelijkbare assistent — die je project leest, bestanden bewerkt en commando's uitvoert. Alles op deze pagina geldt voor welke je ook gebruikt.
Snelle begrippen: een prompt is de instructietekst die u in de agent plakt. Een diff is de lijst met bestandswijzigingen die hij voorstelt. De root van de repository is de bovenste map met package.json — de agent moet daar altijd beginnen.
1. Open .agents/skills/ in de repository-root en kopieer de skill die het dichtst bij je taak ligt — add-a-desktop-capability is een goede eerste poging.
2. Plak hem in je agent en beschrijf je wijziging, voeg dan één regel toe: Lees llms.txt, dan AGENTS.md, dan .ai/PROJECT_CONTEXT.md voordat je code aanraakt.
3. Laat de agent de bestanden opsommen die hij gaat wijzigen en de controles die hij gaat uitvoeren voordat hij bewerkt. Bekijk de diff wanneer hij klaar is — u keurt echte wijzigingen aan uw product goed.
4. Publiceren, het uitgeven van installers en betaalde provider-aanroepen maken nooit deel uit van een taakprompt. Houd ze als aparte stappen die je expliciet goedkeurt.
De bestanden die uw agent leest
De repository levert een kleine stapel bestanden die voor agenten zijn geschreven, niet alleen voor mensen. U plakt deze context nooit met de hand — wijs de agent naar llms.txt en hij leest de rest zelf.
De leesvolgorde doet ertoe: llms.txt is de kaart, AGENTS.md bepaalt de grenzen en .ai/PROJECT_CONTEXT.md draagt mee wat eerdere sessies hebben geleerd. Een agent die de grenzen overslaat, produceert code die u niet kunt shippen.
| Bestand | Wat het de agent oplevert |
|---|---|
| `llms.txt` | De toegangskaart van de repository, gegenereerd om alleen te tonen wat deze checkout daadwerkelijk meelevert |
| `AGENTS.md` | De niet-onderhandelbare grenzen: alleen lokaal werk totdat je meer goedkeurt, de shell forkt nooit product-UI |
| `.ai/PROJECT_CONTEXT.md` | Geheugen tussen sessies — wat er onlangs is veranderd en waarom; lezen vóór codewijzigingen |
| `.ai/`-mirrordocs | Een bijpassende `.ai/<path>.md`-notitie naast belangrijke bestanden, met beslissingen en open punten per bestand |
| `.agents/skills/` | Taak-runbooks geschreven voor agents — de vijf hieronder genoemde Desktop-skills |
| `docs/agent-security.md` | De acceptatiechecklist — authenticatie, workspace- en rechtencontroles, geredsigeerde logs |
| `docs/desktop-updates.md` | Het runbook voor het update-kanaal — ondertekeningssleutels, endpoints en release-kanalen |
| `.env.example` | De volledige omgevingsinventaris — de agent verzint nooit een variabelenaam die niet in dit bestand staat |
De meegeleverde skills
Elk bestand onder .agents/skills/ is een compleet brief: plak het of laat de agent het lezen, en de regels van de kit reizen mee — product-UI blijft in de webapp, alleen OS-gedrag gaat in Rust.
De plakbare prompts/-bibliotheek wordt alleen in de Web-repository meegeleverd; deze checkout draagt in plaats daarvan skills. Gebruik voor een onbewaakte setup de kant-en-klare prompt in de agent-setup-gids.
add-a-desktop-capability— venster-, tray-, sneltoets-, update- of buildwijzigingenadding-a-dependency— een npm-afhankelijkheid veilig toevoegen, upgraden of verplaatsenreviewing-a-pr— een diff beoordelen op correctheid, workspace-isolatie en geheimenupgrading-from-upstream— een nieuwere kit-release in je shell halenverify-changes— de juiste controles kiezen en uitvoeren voor overdracht
Hoe de agent tussen sessies onthoudt
Agents hebben geen geheugen tussen sessies — de .ai/-map is het geheugen. .ai/PROJECT_CONTEXT.md legt vast wat er recent is veranderd en waarom. Daarnaast legt een spiegeldocument zoals .ai/apps/desktop/src-tauri/src/lib.md de beslissingen achter apps/desktop/src-tauri/src/lib.rs uit die de code alleen niet toont.
Het contract is eenvoudig: lees de mirror van een bestand voordat u het bewerkt en werk de mirror bij wanneer de wijziging landt. Open Threads-vermeldingen houden onafgemaakt werk vast, zodat de volgende sessie verdergaat in plaats van opnieuw te beginnen. Een verouderde mirror is erger dan geen — controleer bij het beoordelen van de diff van de agent of de mirrors van gewijzigde bestanden zijn meeveranderd.
Beoordeel het werk van de agent eerlijk
Een afgeronde taak is bewijs, geen samenvatting. Voordat u het werk van de agent houdt, controleert u het zoals docs/agent-security.md een deployment controleert:
Als er iets mis is, stuur de diff dan terug — de agent repareert zijn eigen werk het snelst wanneer u de falende controle benoemt. Voor alles wat hij nooit alleen had mogen proberen, zegt u dat eenmalig expliciet; die grens geldt voor de rest van de sessie.
- Hij heeft de controles uitgevoerd die hij beweert — cargo test, cargo check of de release-preflight — vraag om het commando en zijn uitvoer, geen conclusie.
- Geheimen bleven alleen op de server — geen ondertekeningssleutel of certificaat werd in een rapport of commit geprint, en de shell draagt nog steeds geen provider-credentials.
- Productgedrag bleef in de webapp — de diff voegt geen parallelle UI-, auth- of chatlogica in Rust toe.
- De
.ai/-mirror van elk gewijzigd bestand is met de code meeveranderd. - Publiceren, het uitgeven van installers en betaalde provider-aanroepen bleven aparte stappen die je hebt goedgekeurd — de agent heeft nooit zelf gemerged, gepusht of uitgegeven.
- Als een stap twee keer faalde, stopte hij en rapporteerde het falende commando in plaats van eromheen te improviseren.
Wil je verdergaan met de configuratie? Lees Desktop-releaseaccounts aanmaken.