6996e12ff0
- Introduced new documentation for Agent Skills, detailing best practices, code patterns, common pitfalls, and quick references across various categories such as Architecture, Data Access, Security, Error Handling, Testing, Infrastructure, Communication, and Documentation. - The documentation is structured to facilitate easy navigation and understanding, supporting developers in implementing consistent patterns on the GoodGo Platform. - Both English and Vietnamese versions are provided to ensure accessibility for a wider audience.
5.2 KiB
Agent Skills Documentation
Welcome to the GoodGo Platform Agent Skills documentation. These skills are specialized guides that help you implement consistent, production-ready patterns across the platform.
What Are Agent Skills?
Agent Skills are structured knowledge modules that provide:
- Best practices for specific technical domains
- Code patterns with real examples from the platform
- Common pitfalls to avoid
- Quick references for rapid development
Each skill is designed to be actionable and immediately applicable to your work.
Skills by Category
🏗️ Architecture & Design
Master the architectural patterns that power GoodGo's microservices.
- RESTful API Design - Standards for consistent, maintainable APIs with MediatR integration
- CQRS & MediatR - Separate read/write operations with pipeline behaviors
- Domain-Driven Design - Rich domain models, aggregates, and domain events
💾 Data Access
Efficient and scalable data access patterns.
- Repository Pattern - Entity Framework Core repositories and Unit of Work
- Redis Caching - Distributed caching strategies with invalidation patterns
🔐 Security & Authentication
Protect your services and users.
- Security Patterns - Authentication, authorization, and data protection with Duende IdentityServer
⚡ Error Handling & Resilience
Build robust, fault-tolerant services.
- Error Handling Patterns - Global exception handling, Result pattern, and Polly resilience
🧪 Testing
Ensure quality through comprehensive testing.
- Testing Patterns - Unit, integration, and functional tests with xUnit and Testcontainers
🚀 Infrastructure & Deployment
Deploy and monitor production services.
- Docker & Traefik - Containerization and reverse proxy configuration
- Kubernetes Deployment - Pods, Services, Ingress, and Helm Charts
- Observability - Monitoring with Prometheus, Grafana, and distributed tracing
🔄 Communication
Enable seamless inter-service communication.
- Inter-Service Communication - Event Bus (RabbitMQ), HTTP clients with Polly, and gRPC
📝 Documentation & Development
Maintain quality documentation and code standards.
- Documentation Guidelines - Bilingual documentation standards (EN/VI)
- Code Commenting - Bilingual code comments and XML documentation
- Skill Authoring - How to create and maintain Agent Skills
- Project Rules - Platform-wide coding standards and architecture
How to Use Skills
1. Find the Right Skill
Browse by category above or search for specific patterns you need to implement.
2. Understand the Context
Each skill starts with a "When to Use" section that helps you determine if it's applicable to your current task.
3. Learn the Patterns
Study the code examples and diagrams. All examples are based on real production code from the GoodGo platform.
4. Avoid Common Mistakes
Review the "Common Mistakes" section to save time and avoid known pitfalls.
5. Reference Quickly
Use the "Quick Reference" section for rapid lookups during development.
Skill Development
Skills are living documents that evolve with the platform. If you discover better patterns or want to contribute:
- Review the Skill Authoring guide
- Follow the established structure and bilingual format
- Include real examples from the codebase
- Submit for review
Quick Links
By Technology Stack
- .NET / C#: API Design, CQRS, Repository, Testing
- Infrastructure: Docker, Kubernetes, Observability
- Security: Security Patterns, Error Handling
- Documentation: Docs Guidelines, Code Comments
By Use Case
- Starting a new service: Project Rules → API Design → CQRS → Repository
- Adding authentication: Security Patterns
- Improving performance: Redis Caching
- Deploying to production: Docker → Kubernetes → Observability
- Writing tests: Testing Patterns
Additional Resources
- Architecture Documentation - Overall system design
- Development Guides - Getting started with local development
- API Specifications - OpenAPI documentation
Note: All skills follow bilingual documentation standards (English/Vietnamese). Vietnamese versions are available in docs/vi/skills/.