IRMA voor ontwikkelaars: agents

Deze pagina is voor wie een AI-agent met IRMA laat werken: een coding agent zoals Claude Code, een eigen agent, of een assistent die deze documentatie leest.

De skill voor Claude Code

De skill vertelt Claude Code wanneer en hoe hij de irma-CLI gebruikt, en welke regels gelden. Installeren:

mkdir -p ~/.claude/skills/irma
curl -fsSL https://docs.prudai.com/skills/irma/SKILL.md -o ~/.claude/skills/irma/SKILL.md

Voor één project zet je hem in .claude/skills/irma/ van dat project. Werk je met een andere agent, dan kun je de inhoud overnemen in je AGENTS.md of systeeminstructie: het is gewone Markdown.

`irma guide`

De CLI heeft zijn eigen gids voor agents: irma guide. Daarin staan de twee ingangen en hun sleutels, de envelop, de droogloop bij schrijven, de exitcodes en wat een agent niet mag. De gids hoort altijd bij de geïnstalleerde versie; laat een agent hem aan het begin van een sessie lezen. De volledige tekst staat ook in de CLI-referentie.

Deze documentatie voor agents

Wat	Waar
Inhoudsopgave voor taalmodellen	`/llms.txt`
De volledige tekst van alle openbare pagina’s in één bestand (NL en EN)	`/llms-full.txt`
Elke pagina als Markdown	voeg `.md` toe aan de slug, bijvoorbeeld `/irma-developers-quickstart.md`
Dezelfde pagina als Markdown via content negotiation	`curl -H 'Accept: text/markdown' https://docs.prudai.com/irma-developers-quickstart/`

Pagina’s achter inloggen staan bewust niet in llms.txt en llms-full.txt, en een Markdown-versie van zo’n pagina krijg je alleen na inloggen.

Regels voor een agent

Begin bij de juiste ingang. Voor incidenten: irma whoami. Voor /v1: irma context --json, en lees de leesscope. Bij beperkt of geen zegt een lege lijst niet dat er niets is.
Lees de hele envelop. Pagineer tot nextOffset leeg is, gebruik notIncluded en next, en noem bij elk getal de herkomst. Verzin geen percentielen of bedragen.
Schrijven is een droogloop tot --no-dry-run --yes. Lees het plan, bevestig daarna.
Concepten, geen directe wijzigingen, behalve bij het aanleveren van incidenten. Zie Begrippen.
Een 403 is het ontwerp. Zoek er geen weg omheen en vraag geen bredere sleutel.
Geef geen sleutel als optie mee op de opdrachtregel. Gebruik een omgevingsvariabele of irma auth set --stdin.
Neem geen inhoud uit IRMA over in tickets, commits of chats buiten IRMA. Rapporteer op metaniveau: aantallen, status, id’s.

MCP-server

Later. Na de API en de CLI komt er een MCP-server, zodat AI-clients die MCP spreken IRMA direct als tools kunnen gebruiken. Die gebruikt dezelfde taaklogica als de API: dezelfde envelop, dezelfde rechten, dezelfde droogloop en goedkeuring. Tot die tijd geeft de CLI met de skill een agent dezelfde mogelijkheden.