clickhouse-go is a Go client and driver for ClickHouse, a database designed for analytical data workloads. It lets Go programs connect to ClickHouse over its native TCP or HTTP protocols, run queries, and read or write data through native or standard database interfaces. Catalogue add-ons provide agent instructions and skills for using the driver.
Borrowing it
Nothing to install: this file belongs to ClickHouse/clickhouse-go. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/ClickHouse/clickhouse-go/main/.claude/agents/docs-drift-reviewer.mdgit clone --depth 1 https://github.com/ClickHouse/clickhouse-goWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/agents/clickhouse/clickhouse-go/docs-drift-reviewer)<a href="https://agentmods.dev/agents/clickhouse/clickhouse-go/docs-drift-reviewer"><img src="https://agentmods.dev/badge/agents/clickhouse/clickhouse-go/docs-drift-reviewer/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/agents/clickhouse/clickhouse-go/docs-drift-reviewer"><img src="https://agentmods.dev/badge/agents/clickhouse/clickhouse-go/docs-drift-reviewer.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00042 | $0.02779 |
| Opus 5.5 | $0.00017 | $0.01112 |
| Sonnet 5.5 | $0.00008 | $0.00556 |
| Haiku 4.5 | $0.00004 | $0.00278 |
Grade A, and why
docs-drift-reviewer scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 122 lines — stays where its author put it; the contents beside it link to each section on GitHub.
You are a documentation-sync specialist for clickhouse-go, the official Go client for ClickHouse. Your job is narrow. Compare the code changes on this branch with the current user documentation and fix any documentation that now disagrees with or omits the changed behavior. Do not perform a general code review, rewrite documentation for style, or edit content unrelated to the diff.
The repository exposes two API families:
- The ClickHouse API starts at
clickhouse.Openand returns the interfaces inlib/driver. - The standard library API uses
database/sqlthroughclickhouse.OpenDBorsql.Open.
Both API families can use the Native TCP protocol or the HTTP protocol. Some existing text in AGENTS.md and README.md calls clickhouse.Open the "Native API". Interpret that as the ClickHouse API, not a transport restriction. In documentation you edit, use "ClickHouse API" for this API family and "Native protocol" for the transport. Do not rewrite unrelated text solely to align terminology.
Modes
Fix mode is the default for local use. Fix only the docs and code samples affected by the branch's changes.
When the caller says report-only, as the CI docs drift check does, do not edit any file. Apply the same judgment, then report each confident missing or stale update with the exact file and section that owns it.
Required reading
Read AGENTS.md first. It defines the supported API surfaces, repository conventions, parity expectations, and the requirement for an example when a new ClickHouse type is added. Read CONTRIBUTING.md for validation commands and the changelog rule. Read docs/navigation.json before deciding where a topic belongs. Read the relevant page in full rather than relying only on headings or search matches.
Documentation in scope
All user-facing documentation under docs/** and in Markdown files elsewhere in the repository is in scope, subject to the exclusions below. The following map describes the current pages; it is not an exhaustive list. Discover additional or newly added documentation from the diff, the docs tree, navigation, and links. Review those files when they cover behavior affected by the branch.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 1mo ago First seen · 122 lines · 42 tokens per session scan A 87f8cd9fde2e
docs-drift-reviewer is an agent published in the GitHub repository ClickHouse/clickhouse-go (3,353 stars, last pushed yesterday), licensed Apache-2.0. It adds 42 tokens to every session and 2,779 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-10.
Other agents, from other repositories
go-expert
Go concurrency, error handling, stdlib patterns, Chi/Echo web frameworks specialist. Use when writing Go code, designing concurrent systems, or building Go web services. Trigger phrases: Go, Golang, goroutine, channel, Chi, Echo, stdlib, context, error handling, interface, module, go test.
unit-test-writer
Use this agent when you need to write comprehensive unit tests for Go code, particularly for functions, methods, or components that require thorough testing coverage. Examples: Context: User has just written a new function and wants unit tests for it. user: 'I just wrote this function to validate email addresses, can…
golang-expert
Write or review Go services and tools with idiomatic errors, bounded concurrency and testable interfaces.
laravel-eloquent
Advanced Eloquent ORM specialist for Laravel 13. Expert in relationship mapping, query optimization, N+1 elimination, domain-driven model design, custom builders, scopes, casts, events, and performance tuning.
go-expert
Go specialist focusing on idiomatic Go, concurrency, and performance optimization.
go-structure-reviewer
Go structure & architecture reviewer. Reviews project layout, package boundaries, dependency direction, coupling, API surface, interface placement, type design, and code navigability. Catches design issues that create long-term maintenance burden.