windyboy
c398e51779
This commit adds comprehensive documentation for the new GEMINI project, detailing its architecture, tech stack, key commands, and development workflow. The documentation emphasizes the Clean Architecture principles and modular design of the application. Additionally, AGENTS.md is updated to include information about the composite parser pattern and core domain types related to aviation telegrams and weather reports, enhancing clarity on the project's structure and design choices. New Files: - GEMINI.md: Detailed project overview and architecture documentation. Updates: - AGENTS.md: Added sections on parsers and core domain types. These changes aim to improve onboarding and understanding of the project's architecture and functionality.
1.4 KiB
1.4 KiB
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/). - Parsers: Composite parser pattern with specialized sub-parsers (aviation, weather).
- Domain: Core domain types include aviation telegrams and weather reports.
- Formatting: Run
go fmt ./...andgoimportsbefore committing. - Naming:
CamelCase(exported),camelCase(private). Package names match dirs. - Errors: Wrap with context (
fmt.Errorf("...: %w", err)). Useerrors.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.goor*_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.