AGENTS.md

1# Kubernetes
2 
3## Communication Preferences
4 
5- Dry, concise, low-key humor. No flattery, no forced memes. Skip preambles and postambles.
6- Comments explain "why", not "what".
7- Error messages: actionable and specific. No vague "something went wrong" output.
8 
9## Constraints
10 
11- **Generated files are read-only.** Never hand-edit `zz_generated.*` or `generated.pb.go`. Run `make update`.
12- **go.mod/go.work are generated.** Use `hack/pin-dependency.sh` + `hack/update-vendor.sh`. Never `go mod tidy`.
13- **Staging is source of truth** for `k8s.io/*` (`staging/src/k8s.io/`). Never import `k8s.io/kubernetes` from staging.
14- **Boilerplate required.** Every `.go` file needs the license header from `hack/boilerplate/boilerplate.go.txt`.
15 
16## Contributor Guidelines
17 
18- Keep changes focused and reviewable
19- Add or update relevant tests
20- Do not put `@mentions` or `fixes #...` keywords in commit messages
21- Do not add `Co-authored-by:`  in commit messages
22 
23## Commands
24 
25Run `make help` for all available targets. Common workflows:
26 
27```
28make test WHAT=./pkg/kubelet GOFLAGS=-v     # Unit tests (one package)
29make test-integration WHAT=./test/integration/scheduler
30make verify                                 # All verification checks
31make update                                 # ALL generators and formatters
32```
33 
34## Style
35 
36- Packages: lowercase, single word, match directory.
37