ghidra-cli/AGENTS.md

AGENTS.md

Read first

• Read PRD.md, CONTEXT.md, and applicable ADRs before changing behavior.
• Keep the Rust harness synchronous and the Ghidra worker capability-sandboxed.
• Treat JSON schemas, error codes, ordering, and exit statuses as public API.

Change rules

• Add a regression test for every bug fix.
• Never change golden files or schemas implicitly.
• Keep the Rust operation registry, Java dispatch, schemas, and goldens in exact parity.
• Preserve strict stdout/stderr framing.
• Preserve the worker's no-network and no-default-data-egress boundary.
• Do not add unsafe, an async runtime, database, daemon, or dependency without an accepted design change.
• Do not weaken bounds, validation, sandboxing, or atomic store behavior.

Required checks

• cargo fmt --check
• cargo clippy --all-targets --all-features -- -D warnings
• cargo test --all-targets
• cargo deny check
• nix flake check

Source control

• Use Jujutsu for normal local change management.
• Use jj status, jj diff, jj log, jj describe, and jj new.
• Push Forgejo bookmarks through jj git push.
• Keep changes focused and preserve unrelated user work.
• Use direct Git commands only for interop or recovery that Jujutsu cannot perform.
• Never run git clean -xdf; it can delete colocated .jj/ metadata.