AGENTS.md@src/frontendA

AGENTS.md@src/frontend from greptimeteam/greptimedb is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add greptimeteam/greptimedb/src/frontend/AGENTS.md@git:20261104.fd74b92

Pins git:20261104.fd74b92 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
greptimeteam/greptimedb
Path
src/frontend/AGENTS.md
Versions recorded
13
Latest version
git:20261104.fd74b92, committed Nov 4, 2026
First version recorded
Jun 24, 2026
Size
7,656 bytes
Repository stars
6,792
License
Apache-2.0

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# frontend — Agent & Contributor Guide

Navigation aid for `src/frontend`. Keep it short and point to code. Paths are
relative to the repo root.

Repo-wide rules that apply here: [`.agents/architecture-invariants.md`](../../.agents/architecture-invariants.md).

## What this crate does

Frontend is the request entry point and orchestration layer. It accepts
multi-protocol requests (gRPC, HTTP, MySQL, PostgreSQL, InfluxDB, OTLP, Jaeger,
Prometheus, OpenTSDB), checks permissions, parses/plans SQL, and dispatches:
reads go to the query engine (`query` crate), writes go to the inserter/deleter
(`operator` crate).

Boundary with `servers`: the `servers` crate implements the wire protocols and
network I/O; `frontend` provides the business logic by implementing handler
traits (`SqlQueryHandler`, `GrpcQueryHandler`, `InfluxdbLineProtocolHandler`,
...). In standalone mode the `standalone` crate bridges the frontend to an
embedded datanode `RegionServer`; in distributed mode the frontend talks to
remote datanodes via `operator`/`client`.

## Module map

| Module | Path | Purpose |
| --- | --- | --- |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add greptimeteam/greptimedb/src/frontend/AGENTS.md@sha256:8a3f16a3aa18e639

The line at the top of this page pins the label git:20261104.fd74b92, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_3a2i4ufegdohmmv3.svg)](https://markdownregistry.com/a/art_3a2i4ufegdohmmv3)

6 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 13 versions of this file, between Jun 24, 2026 and Nov 4, 2026, about one every 11 days.

versioncommittedcommitsizeaudit
git:20261104.fd74b92 latest2026-11-04 fd74b92 7,656 BA view · diff
git:20261022.2eff52c2026-10-22 2eff52c 7,204 BA view · diff
git:20261013.863eebd2026-10-13 863eebd 7,062 BA view · diff
git:20261010.a907cbf2026-10-10 a907cbf 6,855 BA view · diff
git:20261008.c82da832026-10-08 c82da83 5,989 BA view · diff
git:20261008.48a2ca62026-10-08 48a2ca6 5,738 BA view · diff
git:20260929.5ccfcd42026-09-29 5ccfcd4 5,594 BA view · diff
git:20260922.723da692026-09-22 723da69 5,359 BA view · diff
git:20260921.66d38e82026-09-21 66d38e8 5,031 BA view · diff
git:20260917.be15c882026-09-17 be15c88 4,461 BA view · diff
git:20260810.d4af6502026-08-10 d4af650 4,043 BA view · diff
git:20260810.5d4699d2026-08-10 5d4699d 4,081 BA view · diff
git:20260624.3b8f55e2026-06-24 3b8f55e 4,296 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (7656 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

greptimeteam/greptimedb · 6,792 stars · license Apache-2.0 · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_3a2i4ufegdohmmv3
GET https://markdownregistry.com/api/v1/resolve?ref=greptimeteam/greptimedb/src/frontend/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/8a3f16a3aa18e639fa11d1f8ad9c69d39d4c3e6d0d5986c3cadbf797f212a027

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from greptimeteam/greptimedb

greptimedb-development-docker-image SKILL.md skill
greptimeteam/greptimedb · .agents/skills/greptimedb-development-docker-image/SKILL.md · Builds a development-only GreptimeDB Docker image from a local debug binary for local-cluster testing, and optionally…
git:20260714.073ae1b · audit B · 6,792 stars
greptimedb-fuzz-ci-failure-investigation SKILL.md skill
greptimeteam/greptimedb · .agents/skills/greptimedb-fuzz-ci-failure-investigation/SKILL.md · Investigate a failed GreptimeDB fuzz CI target link by downloading GitHub Actions job logs plus fuzz artifacts such as…
git:20260803.a6107fb · audit A · 6,792 stars
greptimedb-release-note SKILL.md skill
greptimeteam/greptimedb · .agents/skills/greptimedb-release-note/SKILL.md · Generate a GreptimeDB release changelog (minor, patch, or alpha/beta/rc pre-release) with git cliff (correct range…
git:20261016.a0188c8 · audit A · 6,792 stars
greptimedb-release SKILL.md skill
greptimeteam/greptimedb · .agents/skills/greptimedb-release/SKILL.md · Runbook for publishing a new GreptimeDB version (tag + GitHub release + docs release-note PR) on the upstream…
git:20260619.b365e0d · audit A · 6,792 stars
AGENTS.md AGENTS.md file
greptimeteam/greptimedb · AGENTS.md
git:20260928.43eaea7 · audit A · 6,792 stars
CLAUDE.md CLAUDE.md file
greptimeteam/greptimedb · CLAUDE.md
git:20260626.de873a9 · audit B · 6,792 stars
AGENTS.md@src/common/meta AGENTS.md file
greptimeteam/greptimedb · src/common/meta/AGENTS.md
git:20261015.cbfbad4 · audit A · 6,792 stars
AGENTS.md@src/flow AGENTS.md file
greptimeteam/greptimedb · src/flow/AGENTS.md
git:20260921.66d38e8 · audit A · 6,792 stars
AGENTS.md@src/meta-srv AGENTS.md file
greptimeteam/greptimedb · src/meta-srv/AGENTS.md
git:20261105.4a85e6f · audit A · 6,792 stars
AGENTS.md@src/metric-engine AGENTS.md file
greptimeteam/greptimedb · src/metric-engine/AGENTS.md
git:20261021.f866ef2 · audit A · 6,792 stars
AGENTS.md@src/mito2 AGENTS.md file
greptimeteam/greptimedb · src/mito2/AGENTS.md
git:20261106.a0d7981 · audit A · 6,792 stars
AGENTS.md@src/operator AGENTS.md file
greptimeteam/greptimedb · src/operator/AGENTS.md
git:20261030.f2d7465 · audit A · 6,792 stars

Every file in greptimeteam/greptimedb

Other files named AGENTS.md@src/frontend

AGENTS.md@src/frontend AGENTS.md file
shy2593666979/agentchat · src/frontend/AGENTS.md
git:20261016.a1ec016 · audit A · 929 stars

Browse by kind, by grade A, or by owner.