Make a compatible change
Choose the owning package and prove the changed contract
- Start from the user path and compatibility contract.
- Keep Cobra command files focused on wiring, flags, validation, and output.
- Put reusable behavior in the owning
internal/*capability package. - Preserve inspectable, versioned durable formats.
- Keep expstore authoritative and hosted analytics downstream.
- Test behavior at the layer that owns it.
Run focused package tests while iterating. Before TauGrid-internal closeout:
cd cli
go test ./...
Manifest, runtime, telemetry, or Kubernetes lifecycle changes also require the smallest safe end-to-end path that proves the external contract. Use the Kind smoke test when the changed contract belongs to the portable Kubernetes path.