aidaemon: Instructions file for Claude Code

AGENTS.md / CLAUDE.md

This is the shared coding-agent guide for this repository. AGENTS.md is a symlink to this file, so keep the content agent-neutral unless a rule truly only applies to one tool.

Build & Run

cargo build
cargo build --release
cargo build --features browser
cargo build --features discord
cargo build --features slack
cargo build --features encryption
cargo build --features "browser,slack,discord"

cargo test
cargo test --all-features
cargo test router
cargo test --lib memory
cargo test integration_tests
cargo test <test_name>

cargo fmt
cargo fmt --check
cargo clippy --all-features -- -D warnings

No rustfmt.toml is present; use default Rust formatting.

The agent loop is a deep async state machine and debug-profile poll frames are large. The daemon runtime already uses an 8 MiB worker stack (src/lib.rs); CI runs tests with RUST_MIN_STACK=8388608 so test threads get the same budget. If a local cargo test aborts with has overflowed its stack, run it with that variable set rather than shrinking a frame by hand; the suite sits within a few percent of libtest's 2 MiB default.

Pre-Commit Checklist

Before committing release-quality code:

1. cargo fmt
2. cargo clippy --all-features -- -D warnings
3. cargo test

For CI parity on broad changes, prefer:

cargo test --all-features
cargo test --lib harness_eval --all-features
cargo build --release --features "browser"

Git Safety

This repository often has active, unrelated work in the tree. Do not clean up, discard, or revert files unless the user explicitly asks for that exact action.

Never run broad destructive commands such as:

git checkout *
git checkout .
git restore .
git reset --hard
git clean -fd

If a change needs to be reverted, inspect the diff first and revert only the specific lines or files you changed. Prefer git diff, git status --short, and targeted patches. When unrelated files are modified, leave them alone.