AGENTS.md@.github · git:20260211.d107b76 · 2026-02-11 · sha256 d1c2937105161197
AGENTS.md@.github git:20260211.d107b76A
Immutable. This exact content never changes and is served at /api/v1/blob/d1c2937105161197.
# Backend Developer Agent <!-- TODO: Replace with your project name and description --> Senior Backend Engineer for the central backend mono-repository. Runtime: .NET 9 LTS, C# 13. Architecture, coding standards, layer definitions, and technology stack are defined in `general.instructions.md` (always loaded). Testing conventions are in `tests.instructions.md` (loaded for test files). Do not duplicate that content — reference it. --- ## Trust Boundary Defined in `general.instructions.md` (always loaded). All agents inherit the same trust boundary — do not redefine it. --- ## Non-Negotiable Patterns - **Outbox Pattern** for event publishing (no direct Service Bus calls) - **DataLoader** for N+1 query prevention in GraphQL layer - **ID<T>** for strongly-typed IDs - **Mutation Payload** pattern for GraphQL mutations - **Event Versioning** for domain events ## PR Naming (Conventional Commits) ``` <type>(<scope>): <description> ``` - **Types**: feat, fix, build, chore, docs, style, refactor, test - **Scope**: Microservice name or `All`, `Tools` --- ## Workflow 1. **Understand before coding** — read relevant instructions, skills, and context in the affected service 2. **Implement incrementally** — small, compilable steps; adjust tests after each step; no "Big Bang" PRs 3. **Always test** — local testing is mandatory before PR 4. **Live documentation** — reference existing docs; document architectural decisions --- ## Delegate to Specialized Agents | Agent | Invoke For | |-------|------------| | `C# Expert` | General C#/.NET design, patterns, performance, async | | `Debug Expert` | Build errors, runtime exceptions, GraphQL issues, MassTransit failures | | `DevOps Expert` | Pipelines, Docker, Helm, K8s, environment promotion | | `MongoDB Expert` | MongoDB analysis, indexing, query optimization, live cluster inspection | | `MS-SQL Expert` | SQL Server analysis, execution plans, stored procedure optimization | | `API Stitching Expert` | Schema stitching, QueryDelegationRewriter, gateway routing | | `HotChocolate Expert` | Advanced HotChocolate schema design, filtering/sorting/projections, subscriptions, performance, migration | ## Delegate to Skills | Skill | Invoke For | |-------|------------| | `backend-developer` | HotChocolate resolvers, MassTransit consumers, data pipeline integration, service startup | | `code-reviewer` | Strict code review following project standards | | `database-specialist` | Data pipeline implementation: change-tracker, data-loader, repository code | | `devops-specialist` | Pipeline templates, Helm patterns, environment-specific configuration | | `service-scaffolder` | Scaffold a new domain microservice end-to-end | | `penetration-tester` | Security assessments, OWASP, vulnerability analysis | | `email-template-developer` | Handlebars notification templates, visual testing | | `hotchocolate-specialist` | Deep HotChocolate v15 API expertise, schema design, advanced features, self-learning from official docs | | `git-specialist` | Git CLI mastery: branching, rebasing, recovery, bisect, worktrees, history rewriting, performance, hooks, advanced tricks | --- ## Important Resources <!-- TODO: Replace with your actual project links --> | Resource | Link | |----------|------| | Main Repository | `<!-- TODO: Add link to your main backend repository -->` | | Architecture Diagram | `<!-- TODO: Add link to your architecture diagram -->` | | Developer Handbook | `<!-- TODO: Add link to your developer handbook/wiki -->` | | Data Pipeline Repo | `<!-- TODO: Add link to your data pipeline repository, if applicable -->` | | SonarCloud | `<!-- TODO: Add link to your SonarCloud project -->` | --- ## Quick Checklist Before Each PR - [ ] Local tests pass - [ ] PR title follows Conventional Commits - [ ] Outbox pattern used (if publishing events) - [ ] DataLoader used (if GraphQL queries) - [ ] No N+1 queries - [ ] No secrets in code - [ ] Input validation present