AGENTS.md og CLAUDE.md til projektinstruktioner

Hvis du gentager de samme påmindelser til AI-kodeværktøjer, hører de hjemme i repositoryet.

For Codex betyder det typisk AGENTS.md. For Claude Code betyder det typisk CLAUDE.md. Den præcise fil er mindre vigtig end vanen: læg stabile projektregler et sted, hvor værktøjet kan finde dem, hold dem korte, og opdatér dem, når projektet ændrer sig.

Hvad filerne skal gøre

Instruktionsfiler er ikke salgstekst og ikke en komplet manual. De skal hjælpe kodeagenten med at træffe bedre lokale beslutninger.

Nyttige instruktioner omfatter:

• Projektstruktur og grænser mellem moduler
• Package manager og buildkommandoer
• Test, lint, typecheck og deploykommandoer
• Framework-konventioner
• Indholdsregler
• Tilgængelighed og SEO
• Sikkerhedsfølsomme områder
• Hvad der ikke må ændres uden at spørge
• Hvordan validering opsummeres til sidst

For et dansk virksomhedswebsite kan det betyde at bevare /kontakt/-links, holde dansk indhold dansk, undgå ændringer af publicerede slugs og kontrollere booking- eller leadformularer efter ændringer.

Gør instruktionerne operationelle

Dårlig instruktion:

“Skriv ren, skalerbar kode af høj kvalitet.”

Bedre instruktion:

“Brug eksisterende komponenter før nye oprettes. Tilføj ikke dependencies uden godkendelse. Kør pnpm check-types efter TypeScript-ændringer. Bevar offentlige routes, medmindre der tilføjes redirect.”

Den anden version er nyttig, fordi værktøjet kan handle på den, og udvikleren kan verificere den.

Hold fælles regler ét sted

Hvis et projekt bruger både Claude Code og Codex, driver duplikerede instruktioner hurtigt fra hinanden. En praktisk opsætning er at samle fælles regler i én basefil og holde værktøjsspecifik vejledning lille.

Basen kan beskrive projektet, kommandoer, reviewforventninger og forretningskontekst. Værktøjsspecifikke filer kan så kun tilføje det, der er unikt for værktøjet.

Det er især nyttigt i monorepos, flersprogede websites og længerevarende kundeprojekter, hvor de samme regler gælder på tværs af apps eller packages.

Instruktioner erstatter ikke review

Gode instruktioner reducerer gentagen prompting. De garanterer ikke korrekt kode.

Et AI-kodeværktøj kan stadig misforstå forretningslogik, fjerne en edge case, springe validering over eller lave en ændring, der ser plausibel ud, men fejler i produktion. Instruktionsfilen flytter standardadfærden i den rigtige retning; udvikleren ejer stadig resultatet.

Derfor kombinerer jeg instruktionsfiler med workflowet i Codex CLI til repoarbejde i Danmark og Claude Code til eksisterende kodebaser i Danmark.

Ofte stillede spørgsmål

Skal AGENTS.md og CLAUDE.md indeholde det samme?

De kan dele det meste. En praktisk opsætning samler fælles projektregler, kommandoer og forretningskontekst i én basefil, hvorefter hver værktøjsspecifik fil kun tilføjer det, der er unikt for netop det værktøj, så de to filer ikke driver fra hinanden.

Erstatter instruktionsfiler code review?

Nej. De reducerer gentagen prompting og flytter standardadfærden i den rigtige retning, men et AI-kodeværktøj kan stadig misforstå forretningslogik eller springe et valideringstrin over. Udvikleren ejer stadig resultatet.

Hvad gør en instruktion nyttig i stedet for vag?

En nyttig instruktion er operationel: den peger på en konkret kommando, en grænse eller en regel, værktøjet kan handle på, og udvikleren kan verificere — for eksempel “kør pnpm check-types efter TypeScript-ændringer” i stedet for “skriv ren kode.”

Har mindre virksomhedswebsites brug for en instruktionsfil, eller kun store kodebaser?

Ethvert repository, der får gentagne AI-assisterede ændringer, har gavn af det, også et enkelt WordPress-tema, en Laravel-applikation eller et Astro-site. Filen skal bare dække kommandoer, struktur og indholdsregler for netop det projekt.

Hvornår jeg kan hjælpe

Jeg kan hjælpe med praktiske AI-kodeinstruktioner til eksisterende danske virksomhedswebsites, WordPress-temaer, Laravel-applikationer, Astro-sites og API-tunge projekter.

Hvis dit projekt skal i gang med Claude Code, Codex eller begge dele, kan du sende mig repository-konteksten, så kan jeg hjælpe med den første brugbare instruktionsopsætning.