Replace opaque built-in review behavior with explicit parallel review lenses for correctness, concurrency, security, architecture, coding style, and regression coverage, plus bounded domain-specific reviewers and independent validation. Prefetch pull request discussion in the setup job while letting the read-only review job fetch and inspect the full commit history without per-commit worktrees. Keep GitHub writes isolated to the setup and posting jobs, pin the Claude models and CLI, and bound execution below the AWS credential lifetime. Materialize review instructions from the trusted base revision and scope agent writes to the structured result directory so untrusted pull request content cannot widen the review authority. Treat the posting job as the authoritative trust boundary: validate all model-selected commits, paths, lines, and thread IDs, normalize degenerate line ranges, bound sanitized output, and surface GitHub API failures in the tracking comment before performing writes. Retain daandemeyer/systemd in the repository allowlist so the workflow can be exercised end to end on the personal fork. Manual runs against fork PR #15 covered OIDC authentication, sandboxing, result artifact handoff, tracking-comment updates, and validation of posted output. Signed-off-by: Daan De Meyer <daan@amutable.com>
1.7 KiB
1.7 KiB
AGENTS.md
This file provides guidance to AI coding agents when working with code in this repository. Only add instructions to this file if you've seen an AI agent mess up that particular bit of logic in practice.
Legal
- Only human beings can ever be credited within commit messages. This means no Co-Developed-By or Co-Authored-By or anything similar that lists an AI model instead of a human being.
Key Documentation
Always consult these files as needed:
docs/ARCHITECTURE.md— code organization and component relationshipsdocs/HACKING.md— development workflow with mkosidocs/CODING_STYLE.md— full style guide (must-read before writing code)docs/CONTRIBUTING.md— contribution guidelines and PR workflow
Running arbitrary commands
- Never use
mkosi boxto wrap commands. You are either already running inside an mkosi box environment or running outside of it — use the tools available in your current environment directly.
Build and Test Commands
- Never compile individual files. Always run
meson compile -C build <target>to build the target you're working on. Meson handles incremental compilation automatically. - Never run
meson compilefollowed bymeson testas separate steps. Always runmeson test -C build -v <TEST-NAME>directly. Meson will automatically rebuild any required targets before running tests. - Never invent your own build commands or try to optimize the build process.
- Never use
head,tail, or pipe (|) the output of build or test commands. Always let the full output display. This is critical for diagnosing build and test failures.
Integration Tests
- Never use
grep -qin pipelines; usegrep >/dev/nullinstead (avoidsSIGPIPE)