agent-box AGENTS.md

• use nix develop --command to run the commands in the flake's devshell
• use conventionalcommits.org pattern when writing commit messages

pre commit

• format code with cargo fmt
• check code with cargo check
• check clippy with cargo clippy
• always keep the docs and README files in sync with the code changes (root and crate-level READMEs)
• keep the table of contents in the root README.md up to date whenever a change is made

image

The image flake uses a custom docker.nix from the nix input (github:0xferrous/nix/extra-args).

To get the nix store path of the nix flake input:

nix eval --raw --impure --expr '(builtins.getFlake (toString ./image)).inputs.nix'
# Returns: /nix/store/<hash>-source

To read the docker.nix file from that input:

cat $(nix eval --raw --impure --expr '(builtins.getFlake (toString ./image)).inputs.nix')/docker.nix

This is referenced in image/flake.nix as:

pkgs.callPackage "${nix}/docker.nix" { ... }

wrappers

• implement wrapper binaries in Rust (keep wrapper runtime language consistent across wrappers/)

portal ADR

• Portal architecture decisions are tracked in adr/.
• Current accepted ADRs:
  • adr/0001-agent-portal.md
  • adr/0002-transparent-portal-wrappers.md
• For portal work, keep implementation and configuration aligned with these ADRs.