Protocol Contracts & Schemas
agentic-go implements a frozen protocol surface consisting of 14 MCP tools, 7 resources, 1 resource template, 6 prompts, and three durable JSON schemas.
Core JSON Schemas
1. Context Pack Schema (agentic.context/v1)
Emitted by go_workspace_brief and go_symbol_context. Provides compact, source-grounded summaries of packages, definitions, implementations, and call relationships.
2. Change Contract Schema (agentic.change/v1)
Emitted by go_begin_change and go_checkpoint_change. Keeps agents aligned with initial user intent and detects structural drift.
3. Verification Report Schema (agentic.verify/v1)
Emitted by go_verify_change and the CLI. Assembles package test results, coverage delta, race reports, and calibrated analyzer findings into one deterministic structure.
Frozen MCP Tools Inventory (14 Tools)
| Tool Name | Read Only | Destructive | Purpose |
|---|---|---|---|
go_workspace_brief |
true | false | High-level workspace package map, module roots, and entry points. |
go_search |
true | false | Bounded symbol, type, and identifier search across workspace packages. |
go_symbol_context |
true | false | Definitions, references, implementations, and callers for a symbol. |
go_begin_change |
false | false | Initializes a Change Contract with goal, scope, and snapshot hash. |
go_checkpoint_change |
false | false | Validates progress against contract; catches API drift and scope leaks. |
go_refactor |
false | true | Preview and apply deterministic rename, format, and import edits. |
go_verify_change |
false | true | Executes full impacted verification suite and compiles JSON report. |
go_test_structured |
false | true | Executes package tests and returns structured failure diagnostics. |
go_race_report |
false | true | Runs tests under Go race detector and parses data race traces. |
go_coverage_gaps |
false | true | Identifies uncovered statement blocks in modified functions. |
go_benchmark_diff |
false | true | Compares execution performance against baseline commits. |
go_flake_finder |
false | true | Repeats test execution with randomization to uncover flaky tests. |
go_audit_concurrency |
true | false | Audits goroutines, channels, and sync primitives (0% false positives). |
go_audit_errors |
true | false | Audits error wrapping, sentinel checking, and return conventions. |