AGENTS.md (1423B)
1 # hyf - code directives 2 3 - this repo defines `hyf`, the contextual intelligence layer for Radroots networks; the primary daemon is `hyfd` 4 - treat this repo root as the source of truth for source, runtime behavior, repo-local release-candidate validation, and documentation 5 - official Radroots signed artifact provisioning, builder selection, target matrices, publication, promotion, and deploy transport are not defined by this repo 6 - keep docs and manifests honest about current implementation status and documented command surfaces 7 - prefer the smallest coherent change that fully addresses the request; do not mix unrelated cleanup, speculative refactors, or roadmap work into the same change 8 - read `README.md`, `pixi.toml`, and `flake.nix` before broad edits, and inspect the current implementation before changing behavior 9 - validate from this repo root with documented commands first; the current bootstrap smoke check is `pixi run run` 10 - keep the service boundary as stdio rpc; `hyfd` is the canonical local process interface 11 - keep the service core in mojo; use the checked-in repo tooling surface for development, validation, and launch workflows 12 - if validation cannot run, report the blocker clearly instead of guessing past it 13 - toolchain: Mojo via the locally installed Modular toolchain 14 - prefer explicit typed models, deterministic behavior, and direct service boundaries over stringly or implicit behavior