Agent Guidelines

Precedence: Nearest AGENTS.md wins. This is the root file with global defaults.

Quick Navigation

• internal/AGENTS.md - Backend services
• internal/web/AGENTS.md - Frontend & CSS

Global Defaults

Project Overview

Self-service web application with strict accessibility standards.

Setup

Prerequisites: Docker + Docker Compose, Go, Node.js, pnpm

Build & Test Commands

Build everything, frontend assets + binary. Tests: go test -v ./... Formatting: prettier --write . Type checking: TypeScript strict compilation, Go compilation

Code Style

TypeScript: Ultra-strict tsconfig, Prettier formatting, No any types Go: Standard Go formatting, Error wrapping with context General: Composition over inheritance, SOLID, KISS, DRY, YAGNI

Security

No secrets in git, LDAPS required, Rate limiting, Token security, Input validation, No PII logging, Run as non-root

PR/Commit Checklist

Format all, TypeScript strict check, All tests pass, Compilation check, No secrets, Update docs, WCAG compliance

Commit format: Conventional Commits. No Claude attribution in commit messages.