AGENTS.md og CLAUDE.md til danske projekter

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.

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 i DKK ekskl. moms.