AskHuman: Instructions file for Codex

AGENTS.md

Before a complex task

Read docs/overview.md first to understand the architecture and project layout. Its “文档边界” section defines what belongs in the main overview versus supplementary overview, spec, and plan documents. When the task is complete, check whether the change made any overview or referenced spec inaccurate and update only the appropriate document; do not edit the main overview when the repository-wide map and invariants are unchanged.

Git worktree / parallel development

If the task needs a new or existing git worktree for parallel feature work on this repo (so install/AskHuman do not share the main daemon or overwrite another agent’s binary), read docs/agent-worktree-setup.md first and follow it—including asking the human via AskHuman whether to attach a channel preset—before coding. After dev enable, run ./scripts/install.sh and verify through the project askhuman-dev MCP’s dev_ask (or node scripts/dev.mjs ask for CLI). Ordinary discussion, approvals and handoff continue through the normal AskHuman connection.

Tracking unfinished work in docs/PROGRESS.md

docs/PROGRESS.md tracks durable unfinished or deferred work and concrete next steps across sessions. Read it before starting work. When a tracked item is completed, delete its section — history stays in git.

Verifying your changes

After making any change to this project's functionality or logic, verify the result by running the install script to compile the new code directly into your environment, then use the newly installed AskHuman for subsequent prompts:

For an enabled Dev Instance, use the explicit verification flow above; ordinary discussion continues through the normal AskHuman connection.

# macOS / Linux
./scripts/install.sh

# Windows
./scripts/install-windows.cmd

Before a long build or test

Before ./scripts/install.sh, cargo test, cargo clippy or xcodebuild, run node scripts/machine-health.mjs. If it exits 2 (the machine is thrashing) the same job takes 10–25 minutes instead of 1–3, so tell the human through AskHuman with its report and ask them to free memory, run the job in the background and poll it in short slices that say what is being waited on, and never wait silently.