AGENTS.md

# Agent Guidelines for CAATSM

## Commands
- **Build**: `make build` (bin/receiver)
- **Run**: `make run-dev` (dev mode), `make run-prod` (prod mode)
- **Lint**: `make lint` (golangci-lint)
- **Test**: `make test` (Unit/Ginkgo), `make test-int` (Integration/Docker)
- **Single Test**: `ginkgo -r -v --focus "Test Description" ./path/to/package`
- **Coverage**: `make coverage` (>80% target)

## Code Style & Architecture
- **Structure**: Clean Architecture (`cmd/`, `internal/{domain,app,adapter,infra}`, `pkg/`).
- **Formatting**: Run `go fmt ./...` and `goimports` before committing.
- **Naming**: `CamelCase` (exported), `camelCase` (private). Package names match dirs.
- **Errors**: Wrap with context (`fmt.Errorf("...: %w", err)`). Use `errors.Is`.
- **Types**: Interface-driven development. Avoid `any`.
- **Testing**: Ginkgo BDD style (`Describe`, `It`). Table-driven. Mock interfaces.
- **Observability**: Propagate `context.Context`. Use OpenTelemetry (traces/metrics).
- **Generated**: NEVER edit `wire_gen.go` or `*_gen.go`.

## Cursor Rules (.cursor/rules/do.mdc)
- **Expertise**: Go, Microservices, Clean Arch, TDD.
- **Security**: Input validation, secure defaults, retries/backoff.
- **Perf**: Benchmarks, minimize allocations.
✨ Update agent guidelines and improve documentation structure. Refactor `AGENTS.md` to streamline commands and code style guidelines, enhancing clarity and usability. Update `README.md` with refined NATS consumer configuration details and observability metrics. Modify `.gitignore` to exclude dynamically generated Prometheus target files. Enhance configuration files for development and production environments, ensuring consistency and clarity in settings. 2025-11-19 13:07:09 +08:00			`# Agent Guidelines for CAATSM`
✨ Add repository guidelines and enhance documentation for project structure, build commands, coding standards, and testing practices. Introduce `AGENTS.md` for contributor guidance, update `README.md` to reference new guidelines, and improve configuration documentation for NATS modes. Update Makefile and Taskfile with clearer run commands and requirements for development and production modes. Add production deployment guide and improve logging configuration for better observability. 2025-11-17 16:25:23 +08:00
✨ Update agent guidelines and improve documentation structure. Refactor `AGENTS.md` to streamline commands and code style guidelines, enhancing clarity and usability. Update `README.md` with refined NATS consumer configuration details and observability metrics. Modify `.gitignore` to exclude dynamically generated Prometheus target files. Enhance configuration files for development and production environments, ensuring consistency and clarity in settings. 2025-11-19 13:07:09 +08:00			`## Commands`
			- Build: `make build` (bin/receiver)
			- Run: `make run-dev` (dev mode), `make run-prod` (prod mode)
			- Lint: `make lint` (golangci-lint)
			- Test: `make test` (Unit/Ginkgo), `make test-int` (Integration/Docker)
			- Single Test: `ginkgo -r -v --focus "Test Description" ./path/to/package`
			- Coverage: `make coverage` (>80% target)
✨ Add repository guidelines and enhance documentation for project structure, build commands, coding standards, and testing practices. Introduce `AGENTS.md` for contributor guidance, update `README.md` to reference new guidelines, and improve configuration documentation for NATS modes. Update Makefile and Taskfile with clearer run commands and requirements for development and production modes. Add production deployment guide and improve logging configuration for better observability. 2025-11-17 16:25:23 +08:00
✨ Update agent guidelines and improve documentation structure. Refactor `AGENTS.md` to streamline commands and code style guidelines, enhancing clarity and usability. Update `README.md` with refined NATS consumer configuration details and observability metrics. Modify `.gitignore` to exclude dynamically generated Prometheus target files. Enhance configuration files for development and production environments, ensuring consistency and clarity in settings. 2025-11-19 13:07:09 +08:00			`## Code Style & Architecture`
			- Structure: Clean Architecture (`cmd/`, `internal/{domain,app,adapter,infra}`, `pkg/`).
			- Formatting: Run `go fmt ./...` and `goimports` before committing.
			- Naming: `CamelCase` (exported), `camelCase` (private). Package names match dirs.
			- Errors: Wrap with context (`fmt.Errorf("...: %w", err)`). Use `errors.Is`.
			- Types: Interface-driven development. Avoid `any`.
			- Testing: Ginkgo BDD style (`Describe`, `It`). Table-driven. Mock interfaces.
			- Observability: Propagate `context.Context`. Use OpenTelemetry (traces/metrics).
			- Generated: NEVER edit `wire_gen.go` or `*_gen.go`.
✨ Enhance observability and error handling in NATS integration. Introduce comprehensive OpenTelemetry support with environment-based sampling and semantic attributes for tracing and metrics. Implement an advisory dead-letter queue (DLQ) handler for managing message delivery failures. Update NATS consumer to utilize structured logging and improve error handling strategies. Refactor configuration files for OpenTelemetry collector in both development and production environments, ensuring robust telemetry integration. Enhance documentation to reflect new features and best practices for observability. 2025-11-18 11:47:35 +08:00
			`## Cursor Rules (.cursor/rules/do.mdc)`
✨ Update agent guidelines and improve documentation structure. Refactor `AGENTS.md` to streamline commands and code style guidelines, enhancing clarity and usability. Update `README.md` with refined NATS consumer configuration details and observability metrics. Modify `.gitignore` to exclude dynamically generated Prometheus target files. Enhance configuration files for development and production environments, ensuring consistency and clarity in settings. 2025-11-19 13:07:09 +08:00			`- Expertise: Go, Microservices, Clean Arch, TDD.`
			`- Security: Input validation, secure defaults, retries/backoff.`
			`- Perf: Benchmarks, minimize allocations.`