[onedr0p]

This adds AGENTS.md (the real content) and CLAUDE.md (a one-line @AGENTS.md import, per Claude Code's documented import syntax) with this repo's Go conventions: idiomatic Go 1.26, idempotency, DRY, unit testing, log/slog, caarlos0/env, spf13/pflag where a real CLI surface exists, plus project layout, error handling, mise-based build/lint/test, container build, and security conventions grounded in this repo's actual code, .golangci.yml, .mise/config.toml, and CI.

AI disclosure (per this org's CONTRIBUTING.md AI Usage Policy): the content was drafted by Claude Code from a bullet-point brief, independent research (Go 1.26 release notes, caarlos0/env and spf13/pflag docs), and this repo's own code, CI, and mise config, then directed and reviewed interactively by @onedr0p across multiple rounds, including the AGENTS.md/CLAUDE.md split itself and folding this org's own AI Usage Policy and commit conventions back into the file.

[greptile-apps]

Greptile Summary

Adds repository-wide Go development guidance for coding agents and a Claude Code import file.

• Documents project conventions for configuration, logging, testing, errors, lifecycle management, builds, containers, and security.
• Adds CLAUDE.md as a one-line import of the shared guidance.

Confidence Score: 4/5

The documentation-only PR appears safe to merge, with a non-blocking toolchain-version inconsistency that should be clarified.

The documented build tasks and architectural conventions align with the repository, but the claim that the Go declarations match and should move together conflicts with the current 1.26.4 and 1.26.5 values.

Files Needing Attention: AGENTS.md

Important Files Changed

Filename	Overview
AGENTS.md	Adds comprehensive Go conventions; its toolchain synchronization statement conflicts with the repository's existing patch-version pins.
CLAUDE.md	Adds the intended one-line Claude Code import of AGENTS.md with no identified issue.

_{Reviews (1): Last reviewed commit: "docs: add AGENTS.md with Go conventions" | Re-trigger Greptile}

[greptile-apps]

Go version pins do not match

This guidance says the Go declarations match and must be bumped together, but go.mod declares 1.26.4 while .mise/config.toml pins 1.26.5. Clarify whether exact patch synchronization is required so contributors do not make unnecessary version changes or preserve an unintended mismatch.