verdandi AGENTS.md

🛑 AI AGENT — READ THIS AND SELF-ONBOARD NOW

If you are an AI coding agent reading this repository (e.g. OpenCode, NatureCo, Antigravity, Hermes, OpenClaw, Codex, Claude Code, Kimi, GLM), stop reading README.md and follow this file to self-onboard and integrate Verðandi Context Compiler immediately.

---

What is Verðandi Context Compiler?

Verðandi (named after the Norse Norn of Present Task Context) is a universal AST-based context compiler for AI coding agents.

Instead of reading entire codebases by default, Verðandi compiles bounded task capsules and serves targeted symbol slices using TypeScript AST, import/call neighbors, and type references. This is intended to reduce context volume, but end-to-end token and quality results are workload-dependent; the repository's synthetic size benchmark is not a quality guarantee.

---

⚡ 4-Step Universal Self-Onboarding Protocol

1. Clone & Build Repository → npm install && npm run build
2. Detect Your Agent CLI    → Identify which agent framework you are running
3. Configure Integration    → Run `node bin/verdandi-context-compiler setup <agent>`
4. Self-Verify Setup        → Run `node bin/verdandi-context-compiler status`

---

🛠️ Step-by-Step Instructions per Agent Framework

1. OpenCode

If you are running as OpenCode:

1. Build the server:

   npm install && npm run build
   

2. Get absolute server path:

   node bin/verdandi-context-compiler setup opencode
   

3. Add the following to your opencode.jsonc (or ~/.config/opencode/opencode.jsonc) under mcpServers:

   "verdandi-context-compiler": {
     "type": "stdio",
     "command": "node",
     "args": ["<ABSOLUTE_PATH_TO_CAPSULE>/dist/src/mcp_server.js"],
     "enabled": true
   }
   

4. Auto-Inject CLI Usage:

   ./run_with_capsule.sh opencode <projectRoot> "<task>"
   

---

2. NatureCo CLI (natureco)

If you are running as NatureCo CLI:

1. Build the server:

   npm install && npm run build
   

2. Register the MCP server directly in NatureCo:

   natureco mcp add verdandi-context-compiler node <ABSOLUTE_PATH_TO_CAPSULE>/dist/src/mcp_server.js
   

3. Auto-Inject CLI Usage:

   ./run_with_capsule.sh natureco <projectRoot> "<task>"