formanator: Instructions file for Codex

AGENTS.md

Repository overview

• formanator is a Rust CLI for working with Forma claims, with optional MCP server support.
• src/main.rs is the binary entry point and dispatches subcommands.
• src/cli.rs defines the Clap CLI surface.
• src/commands/ contains one handler per subcommand.
• src/lib.rs exposes shared modules such as Forma API access, claim handling, config, prompts, LLM integration, and MCP support.
• The default feature set includes mcp; the crate targets Rust edition 2024 and has an MSRV of Rust 1.94.

Working in this repository

• Keep changes small and focused on the requested task.
• Follow existing Rust patterns and keep command wiring in src/cli.rs, src/main.rs, and src/commands/.
• Update README.md when user-facing behavior or developer workflow changes.
• Avoid changing dependencies or feature flags unless the task requires it.

Build, test, and validation

Use the same checks that GitHub Actions uses:

1. Run pre-commit for formatting, linting, and repository hygiene:

   pre-commit run --all-files
   

   This covers the configured hook set, including cargo fmt --all, cargo check --locked --workspace --all-features --all-targets, cargo clippy --locked --workspace --all-features --all-targets -- -D warnings, codespell, and standard file checks.

2. Run the test command used by the build workflow:

   cargo test --locked --all-features
   

3. Run the release build used by the build workflow:

   cargo build --release --locked
   

GitHub Actions alignment

• .github/workflows/pre-commit.yml runs the pre-commit checks on pushes and pull requests.
• .github/workflows/build_and_release.yml runs cargo test --locked --all-features --target=<target> and cargo build --release --locked --target=<target> across Linux, macOS, and Windows targets on every push.
• Tags matching v* additionally trigger GitHub release creation and Cargo publishing steps.