Skip to content

agent-context.md

Latest commit

 

History

History
66 lines (49 loc) · 2.96 KB

agent-context.md

File metadata and controls

66 lines (49 loc) · 2.96 KB
Raw
title Agent Context
description Reference for AI coding assistants to understand the structure, context, and conventions of the drover-code repository.
product drover-code
audience agent
doc_type reference
surface repo-docs

Agent Context for Drover Code

Welcome, AI Agent. This file is intended to help AI coding assistants understand the structure, context, and conventions of the drover-code repository.

Ecosystem Role

Part of the Drover Ecosystem: drover-code serves as the Core Agent Engine. It is the fast, static Go binary that actually runs the agentic loop, calls the Anthropic API (via drover-gateway), and executes tools. It is orchestrated by drover and runs headlessly inside drover-cloud unikernels.

What this repo is

Layout

Path Role
cmd/drover-code CLI entry: TUI, headless, webhook, flags
cmd/ukc-agent HTTP agent for Unikraft Cloud instances (workspace sync & exec)
internal/agent Agent loop, events
internal/api HTTP client, SSE stream
internal/bridge IDE bridge (JSON-RPC framing over stdio)
internal/config Settings merge, CLAUDE.md / markdown injection
internal/integrations/sqlforge Detect sqlforge.yml; inject SQLForge CLI guidance
internal/convo Conversation state, compaction heuristics
internal/coordinator Multi-worker coordinator mode
internal/github Webhook server, parser, runner
internal/tools Tool registry and implementations
internal/tui Bubble Tea model and views
internal/dream Session memory (JSON / SQLite)
design/ Design specs and roadmap (numbered 01-…, test plan 13, UX 14)
docs/ User-facing docs (Tutorials, How-Tos, Reference, Explanation)

Build and test

CGO_ENABLED=0 go build -o drover-code ./cmd/drover-code
CGO_ENABLED=0 go build -o ukc-agent ./cmd/ukc-agent
CGO_ENABLED=0 go test ./...

CI uses Go 1.22 with CGO_ENABLED=0. Local go.mod may list a newer go directive; keep changes compatible with CI unless you bump the workflow.

Fuzz targets are listed in .github/workflows/ci.yml (fuzz job).

Conventions

  • Prefer focused changes: match existing style, imports, and error wrapping in touched packages.
  • Property / fuzz tests: see design/12-property-fuzz-testing.md and doc 13-test-coverage-plan.md.
  • Do not assume Node: this is Go-only for the main binary.

Product behavior pointers

  • End-user overview, env vars, and modes: README.md.
  • internal/config walks upward from workDir and merges CLAUDE.md files into the system prompt. If this repository is the working directory, this CLAUDE.md is included like any other project instructions file.
  • When sqlforge.yml is found at a project root, SQLForge CLI guidance is appended automatically. How-to: docs/how-to/sqlforge-from-drover-code.md.

Optional evals

Live Anthropic eval tests are opt-in (RUN_AGENT_EVALS=1 and API key); see evals/ and README.md.