add-endpoint-go

Imported from hynix666/ULTRA-TEMPLATE (.claude/skills/add-endpoint-go/SKILL.md). Install upstream with npx skills add hynix666/ULTRA-TEMPLATE --skill add-endpoint-go. Copyright stays with the author.

Add an endpoint to api-go

Work from the inside out, one layer at a time, and run go test ./... in services/api-go after each step.

1. Entity (internal/entity) — add the rule, and a sentinel error if the operation can fail on domain grounds. No I/O and no clock: time and ids arrive as arguments. Add table-test cases to task_test.go, including the refused ones.
2. Use case (internal/usecase) — add a method on Tasks. If it needs storage the TaskRepository port does not offer, extend the port and implement it in internal/repo/memory, with a test there: the memory repository defines the behaviour every store must match.
3. Transport (internal/controller/httpapi) — add the method to the consumer-side TaskService interface and register the route in NewRouter with a method pattern ("PATCH /api/tasks/{id}"). Decode bodies with decode, which caps them at 1 MiB and rejects unknown fields, and map any new domain error in fail. Add cases to router_test.go for success and every refusal.
4. Wiring — only internal/app chooses implementations. Change it only when a new port needs one.
5. Check — gofmt -l ., go vet ./..., go test -race ./... and golangci-lint run. If internal/architecture_test.go fails, a layer imported something it must not: move the code, do not widen the rule.
6. Keep the contract in step — update the API table in services/api-go/README.md. Every task service in this repository must answer every route with the same status codes, so make the same change in each of the others, table included; each module keeps its own copy so it stays readable when the others are not selected. If the endpoint changes who depends on whom, update architecture/model/system.c4 when it exists.