--- trigger: always_on --- # Technology & Architecture — this project **Type**: greenfield | **Domain**: generic | **Profile**: standard ## Stack - (no manifest — generic enterprise defaults apply) ## Architecture (hexagonal + DDD) - `domain/` — pure business logic, no framework dependencies - `application/` — use cases and orchestration - `infrastructure/` — adapters for DB, messaging, external services - `web/` — HTTP layer, DTOs ## Repository intelligence This repository uses **EEIK**. Regenerate this file with `eeik generate-adapters --apply` after a manifest change. ## Capability packs (engineering intelligence available) | Pack | Focus | |---|---| | `agent-harness` | Generic, enterprise-grade agent runtime conformance | | `ai-engineering` | Agentic AI engineering — agent design, LangGraph, RAG, prompt engineering, evaluation | | `angular` | Angular engineering capability pack — Angular 17+ standalone components, Signals API, OnPu… | | `architecture` | Enterprise architecture capability pack providing solution design, ADR authoring, NFR anal… | | `aws` | AWS cloud engineering capability pack — CDK, security, tagging, cost, deployment | | `banking` | Banking domain — payments, risk, and PSD2 / Basel III / PCI-DSS compliance | | `belgium-insurance` | Belgium insurance domain capability pack — Branch 21/23/26 product rules, FSMA/NBB regulat… | | `chaos-engineering` | Chaos & resilience engineering — hypothesis-driven fault-injection experiments, blast-radi… | | `containers` | Containerisation — Dockerfiles, ECS Fargate, and container runtime standards | | `core` | Foundational capability pack — cross-cutting agents, standards, and workflows for all proj… | | `data-engineering` | Data pipeline engineering capability pack | | `delivery` | Delivery — sprint planning, release management, and branching / CI-CD standards | | `finops` | Cloud FinOps — cost visibility, allocation/tagging, rightsizing, commitment discounts (RI/… | | `go` | Go engineering — cloud-native services, standard-library HTTP, table-driven tests, and idi… | | `governance` | Enterprise governance — architecture reviews, security reviews, PRR, AI governance, compli… | | `healthcare` | Healthcare domain — FHIR / HL7, HIPAA / GDPR health-data compliance, clinical data | | `insurance` | Insurance domain — claims, underwriting, and Solvency II / GDPR compliance | | `java` | Enterprise Java engineering capability pack for Spring Boot 3.x / Java 21 | | `modernization` | Legacy modernization — COBOL / RPG / IBM i analysis and strangler-fig migration | | `node` | Node.js / TypeScript backend — NestJS & Fastify services, strict TypeScript, Zod validatio… | | `openshift` | Red Hat OpenShift and Kubernetes engineering capability pack | | `platform-engineering` | Platform engineering — internal developer platforms (IDP), golden paths / paved roads, sel… | | `python` | Python engineering — FastAPI, Pydantic, pytest, and type-annotated services | | `react` | React engineering capability pack — Next.js 14 App Router, Server Components, TanStack Que… | | `retail` | Retail & e-commerce domain — catalog, cart/checkout, order management, inventory, pricing/… | Activate the packs your `project-manifest.yaml` selects with `eeik activate --apply`; each materialises its agents and standards into `.claude/`. ## Standards enforced `ai-governance`, `angular`, `api-standard`, `architecture-principles`, `aws`, `branching-standard`, `cicd`, `containers`, `data-engineering`, `estimation-standard`, `event-driven`, `fastapi`, `golden-rules`, `graphql`, `integration-standard`, `java`, `java-standard`, `mainframe`, `modernization-patterns`, `nfr-standard`, `observability-baseline`, `python`, `react-standard`, `security-baseline`, `spring-standard`, `sql`, `testing` Standards live in `.claude/standards/` (and `capability-packs//standards/`). They define the CORRECT/WRONG patterns the golden rules summarise. ## Approved patterns - `agentic-supervisor-pattern` - `java-outbox-pattern` See `knowledge/patterns/` for the full write-ups and `knowledge/anti-patterns/` for what to avoid. ## Specialist agents | Agent | Use for | |---|---| | `a2a-engineer` | Use for designing and implementing Agent-to-Agent (A2A) communication protocols, multi-agent orchestration sys… | | `ai-engineer` | Use for designing and implementing generative AI applications: RAG pipelines, LLM integrations, Bedrock agents… | | `ai-governance-officer` | Use for AI governance reviews, model risk assessments, ethical AI audits, and producing model cards, AI risk r… | | `angular-coverage-checker` | Use for analysing Angular Istanbul/Karma coverage reports, identifying uncovered branches in components and se… | | `angular-developer` | Use for ticket-scoped Angular feature delivery: standalone components, services, reactive forms, lazy routes, … | | `angular-tester` | Use for generating Jasmine/TestBed spec files for Angular standalone components and services | | `arb-reviewer` | Use for Architecture Review Board (ARB) gate reviews: validating designs against enterprise standards, assessi… | | `architect` | Use for system design, architectural pattern validation, ADR authoring, bounded context reviews, API contract … | | `autogen-engineer` | Use for designing and implementing multi-agent systems with Microsoft AutoGen: conversation patterns, GroupCha… | | `aws-architect` | Use for AWS cloud architecture design, Well-Architected reviews, CDK stack skeletons, cost estimates, and scal… | | `aws-deploy-helper` | Use for AWS deployment tasks: ECS Fargate service deployments, Lambda updates, CDK deploy commands, deployment… | | `business-analyst` | Use for translating requirements into OpenAPI contracts, Gherkin acceptance criteria, data models, and event s… | | `cdk-terraform-helper` | Use for producing AWS CDK TypeScript constructs and Terraform HCL modules | | `ci-engineer` | Use for CI/CD pipeline design, GitHub Actions workflow authoring, build optimisation, test parallelisation, an… | | `code-reviewer` | Use for structured pull request reviews with severity labels [BLOCKER]/[MAJOR]/ [MINOR]/[NIT] | | `containerisation-helper` | Use for Docker and container-related tasks: writing Dockerfiles, docker-compose files, multi-stage builds, con… | | `coverage-enforcer` | Use for multi-stack coverage gap analysis (Java + Angular) and generating targeted tests to close gaps | | `crewai-engineer` | Use for designing and implementing multi-agent systems with CrewAI: crew composition, agent role definition, t… | | `data-engineer` | Use for data pipeline implementation: Kafka producer/consumer setup, Apache Spark jobs, dbt model authoring, A… | | `data-scientist` | Use for data science tasks: exploratory data analysis, feature engineering, model training and evaluation, sta… | | `dba-advisor` | Use for database design and operational guidance: Flyway/Liquibase migration authoring, query plan analysis, i… | | `devsecops-engineer` | Use for DevSecOps pipeline integration: SAST/DAST tooling, secrets scanning, container vulnerability scanning,… | | `enterprise-architect` | Use for TOGAF-aligned enterprise architecture artifacts: capability maps, value streams, technology lifecycle … | | `estimator` | Use for bottom-up effort estimation: producing P50/P80/P90 estimates for features, epics, and technical tasks | | `ibmi-modernization-expert` | Use for IBM i (AS/400) modernisation tasks: analysing RPG IV / RPGLE / CL programs, mapping IBM i business log… | | `incident-handler` | Use for incident management: declaring incidents, coordinating response, producing live status updates, and dr… | | `jacoco-coverage-tester` | Use for JaCoCo XML/HTML report analysis, identifying uncovered lines and branches in business logic, and gener… | | `java-developer` | Use for ticket-scoped Java Spring Boot implementation work: services, controllers, repositories, DTOs, and Map… | | `java-tech-lead` | Use for Java PR gating, standards enforcement, tech debt classification, and framework-level decisions on Spri… | | `java-tester` | Use for generating complete Java test suites: JUnit 5 unit tests, Spring Boot slice tests (@WebMvcTest, @DataJ… | | `kubernetes-engineer` | Use for Kubernetes and Helm workloads: Helm chart authoring, RBAC configuration, NetworkPolicy design, Horizon… | | `langraph-engineer` | Use for designing and implementing stateful multi-agent workflows with LangGraph: graph-based agent orchestrat… | | `local-deploy-helper` | Use for local development environment setup and troubleshooting: starting services with docker-compose, config… | | `mcp-engineer` | Use for designing and implementing Model Context Protocol (MCP) servers and clients: tool definitions, resourc… | | `ml-engineer` | Use for ML engineering tasks: building and optimising ML training pipelines, feature stores, model serving inf… | | `mlops-engineer` | Use for MLOps platform design and implementation: model registry management, drift monitoring, automated retra… | | `modernization-expert` | Use for mainframe and legacy application modernisation: COBOL-to-Java migration strategy, legacy Spring 4/5 to… | | `ops-engineer` | Use for operational tasks: CloudWatch dashboard design, runbook authoring, alert configuration, capacity plann… | | `performance-engineer` | Use for detecting N+1 queries, unbounded result sets, resource leaks, Angular rendering bottlenecks, and scala… | | `project-tracker` | Use for project status tracking, sprint planning support, dependency mapping, and delivery health reporting | | `python-developer` | Use for ticket-scoped Python implementation work: FastAPI services, Django applications, data scripts, CLI too… | | `rca-agent` | Use for post-incident Root Cause Analysis: conducting 5-Whys analysis, producing RCA reports, identifying syst… | | `react-developer` | Activate for React tasks: functional components, hooks, React Query, Zustand/Redux Toolkit state, Next.js App … | | `security-auditor` | Use for OWASP Top 10 security reviews, vulnerability analysis, and producing severity-rated findings with reme… | | `senior-developer` | Use for full-stack Java and Angular implementation spanning both backend and frontend layers | | `spring-security-engineer` | Activate for Spring Security tasks: OAuth2/OIDC configuration, JWT validation, method security (@PreAuthorize)… | | `sre-engineer` | Use for SRE practice implementation: SLI/SLO definition, error budget management, toil identification, reliabi… | | `technical-writer` | Use for technical documentation tasks: API documentation, architecture guides, onboarding docs, runbooks, ADRs… | | `test-quality-enforcer` | Use for auditing test suites for anti-patterns (empty assertions, mocking SUT, Thread.sleep, flaky patterns) a… | | `tester` | Use for comprehensive test strategy and generating full test pyramid coverage for any stack |