[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

The PR adds repository-specific Go contribution guidance and exposes it to Claude Code through a file import.

• Documents coding, testing, configuration, error-handling, build, container, and security conventions.
• Replaces inaccurate concrete task and Dockerfile references with instructions to inspect repository configuration.
• Restores the nonempty guidance imported by CLAUDE.md.

Confidence Score: 5/5

The PR appears safe to merge.

No blocking failure remains; the previously reported guidance and import issues are fixed or invalid against the current repository state.

Important Files Changed

Filename	Overview
AGENTS.md	Adds comprehensive Go conventions; the previously reported API, mise-task, and Dockerfile-reference issues are no longer present at current HEAD.
CLAUDE.md	Imports the now-populated AGENTS.md using Claude Code’s file-import syntax.

_{Reviews (3): Last reviewed commit: "fix: restore AGENTS.md content lost to a..." | Re-trigger Greptile}

[greptile-apps]

Nonexistent Go error API

The guide recommends errors.AsType[T](err), but that function is unavailable in the pinned Go toolchain, so code written according to this convention will not compile.

Suggested change

	When a newer construct is genuinely more idiomatic, use it: Go 1.26 added
	`errors.AsType[T](err)`, a generic type-safe replacement for the
	`var t *T; errors.As(err, &t)` two-step; prefer it in new code. `go fix`
	(rebuilt in 1.26 as a modernizer runner on `go vet`'s analysis) surfaces
	these mechanical migrations; run it after a toolchain bump.
	Use `errors.As` when callers need to inspect an error's concrete type while
	preserving wrapped-error behavior. `go fix` surfaces supported mechanical
	migrations; run it after a toolchain bump.

[greptile-apps]

Dockerfile reference is nonlocal

The container section directs contributors to ocharted/Dockerfile, which is not present in this repository, while the root Dockerfile already demonstrates the described build and runtime configuration.

Suggested change

	and run `FROM gcr.io/distroless/static:nonroot` (see `ocharted/Dockerfile`
	for a reference implementation). Only drop `CGO_ENABLED=0` if a dependency
	and run `FROM gcr.io/distroless/static:nonroot` (see the root `Dockerfile`
	for the current implementation). Only drop `CGO_ENABLED=0` if a dependency