x-code-cli: Instructions file for Codex

AGENTS.md

This is the repository instruction entrypoint. X-Code loads the applicable AGENTS.md chain into project context; other agent hosts must use a verified discovery path or open this file explicitly. Keep it concise because it is prompt context.

Rules

• Use visualizations when they help explain complex concepts.
• Keep responses concise and direct, and clearly distinguish facts from assumptions.
• Base research on reliable sources.
• Stay aligned with the user's goals and constraints.
• Avoid unnecessary questions; ask only when a key decision requires confirmation.
• Use sub-agents judiciously and avoid unnecessary parallelism.
• Keep code changes minimal and avoid unrelated refactoring.
• Verify actual results through testing; do not assume something is complete just because it looks complete.
• Keep all features and tests compatible with Windows, macOS, and Linux. Do not assume POSIX paths, shells, signals, terminal glyphs, process behavior, or file-lock semantics. Platform-conditional tests are allowed only when the underlying capability cannot be tested equivalently, and the reason must be explicit.
• Protect existing code and data.
• Report key results without unnecessary progress updates.

Commands

pnpm workspace; Node >= 22.

pnpm build              # tsc -b (core) then esbuild (cli → dist/cli.js)
pnpm dev                # build core, then run CLI from source via tsx (no watch)
pnpm typecheck          # tsc -b — strict, run before any PR
pnpm lint               # eslint --fix; ignores **/tests/** and *.js
pnpm test               # build + Unit/Fault/Package/PTY tests
pnpm test <pattern>     # single file: pnpm test packages/core/tests/agent-loop.test.ts
pnpm run ci             # typecheck + lint/format checks + pnpm test

After editing core sources you must pnpm build (or tsc -b --watch in packages/core). The CLI imports packages/core/dist/, not the TS source.

Delivery workflow

Follow docs/development/agent-workflow.md for work definition, Human Plan Review, verification evidence, Human Local Acceptance, Draft/Ready PR handling, and continuous knowledge capture. Use .github/pull_request_template.md for the durable PR handoff. Capability status in that guide describes what can run; every task must report its own check outcomes separately.