From 0111d689648a9389c145963cb9e8ddc9deb59280 Mon Sep 17 00:00:00 2001
From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Date: Sat, 16 May 2026 06:06:10 +0000
Subject: [PATCH] docs: add AGENTS.md with core commands

Co-Authored-By: Sachin Iyer <siyer@detail.dev>
---
 AGENTS.md | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 AGENTS.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..1aeaf2c
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,37 @@
+# Agent Guidance
+
+## Core Commands
+
+```bash
+# Build
+cargo build
+
+# Format check
+cargo fmt --check
+
+# Lint
+cargo clippy -- -D warnings
+
+# Type check
+cargo check
+
+# Run tests
+cargo test
+
+# Check vendored artifacts (openapi.json + docs/HELP.md) are up to date
+cargo xtask check
+
+# Regenerate docs/HELP.md from current CLI definitions
+cargo xtask generate-help > docs/HELP.md
+
+# Regenerate openapi.json from upstream API
+cargo xtask generate-openapi
+```
+
+## CI
+
+CI runs formatting, clippy, check, tests, vendored artifact checks, and a security audit. All must pass before merge.
+
+## Lint Policy
+
+Clippy is configured with strict `pedantic`, `nursery`, and many restriction lints denied. See `[lints.clippy]` in `Cargo.toml` for the full list. Notable: `unwrap_used`, `expect_used`, `panic`, and `unsafe_code` are all denied outside of tests.