Skip to content

agentteamland/software-project-team

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

29 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ—οΈ Software Project Team

A team of 13 specialized AI agents for building production-grade software projects. Built on Vertical Slice Architecture + Clean Architecture + Mediator pattern with .NET, PostgreSQL, RabbitMQ, Redis, Elasticsearch, and more.

Installation

/team install https://github.com/agentteamland/software-project-team.git

Requires Agent Team Manager to be installed first. Dependency: Core (auto-installed via team.json).

Agents (13)

🧠 API Agent (api-agent) β€” 18 children

The brain of every project. All business logic lives in Domain + Application layers. Other services are bridges.

Topics: Architecture layers, audit trail, caching (pipeline behavior + Redis), concurrency (optimistic locking), dynamic settings (DB + Redis), error handling, file storage (MinIO/S3), idempotency, logging (virtual debug), multi-tenancy (User + Profile + Tenant), naming conventions, notification (HTTP + RMQ), pagination (cursor-based), RMQ topology, seed data, soft delete, user-facing strings (API↔UI i18n contract), workflows.


⚑ Socket Agent (socket-agent) β€” 17 children

SignalR WebSocket bridge. Real-time communication between clients and API. No business logic.

Topics: Hub design, auth (JWT query string), internal endpoints, API client pattern, group management, connection tracking, reconnection handling, CORS, rate limiting, event conventions, data boundary, multi-device, presence/typing, heartbeat, error handling, event versioning, hub method blueprint.


⏰ Worker Agent (worker-agent) β€” 6 children

Scheduled background jobs with Cronos. Calls API via HTTP. No business logic.

Topics: Job blueprint, cron scheduling, API client pattern, distributed locking, graceful shutdown, health monitoring.


πŸ“± Flutter Agent (flutter-agent) β€” 22 children

Mobile/tablet specialist. iOS + Android from a single Dart codebase. UI bridge β€” no business logic.

Topics: Screen blueprint, state management (Riverpod), routing (go_router), API integration (Dio), responsive design, i18n, theme system, component design, form handling, offline-first, push notifications, auth flow, image handling, list patterns, navigation patterns, testing, deep linking, permissions, app lifecycle, error/loading states, WebView, Claude Design handoff (React→Flutter translation rules).


🌐 React Agent (react-agent) β€” 24 children

Web UI specialist. TypeScript + Vite (or Next.js for SSR). Admin panels, dashboards, web apps. No business logic.

Topics: Component blueprint, component design, state management (React Query + Zustand), routing (React Router), API integration (Axios), form handling (React Hook Form + Zod), styling (Tailwind CSS), auth flow, table patterns (TanStack Table), list patterns, modal/dialog, error/loading states, layout patterns, i18n, file upload, testing (Vitest + RTL + MSW), WebSocket (SignalR), permission guard, chart/dashboard, keyboard shortcuts, print/export, SEO/meta, white-label, Claude Design handoff (bundle adaptation rules).


🐳 Infra Agent (infra-agent) β€” 16 children

Docker, Compose, CI/CD, environment management. Everything runs in containers.

Topics: Compose blueprint, compose architecture, Dockerfile patterns, volume strategy, env management, health checks, port management, hot reload, logging infra, MinIO setup, CI/CD (GitHub Actions), production Dockerfile, backup/restore, multi-project coexistence, resource limits, SSL/TLS local.


πŸ—„οΈ Database Agent (database-agent) β€” 9 children

PostgreSQL + EF Core specialist. Schema design, migrations, indexing, query optimization.

Topics: Schema design blueprint, migration management, index strategy, query optimization, naming conventions, relationships, data types, constraint patterns, monitoring.


πŸ”΄ Redis Agent (redis-agent) β€” 8 children

Cache, session, distributed lock, rate limiting specialist. Ephemeral data only.

Topics: Cache blueprint, key naming, data structures, TTL strategy, pub/sub, memory management, connection management, distributed patterns.


πŸ‡ RMQ Agent (rmq-agent) β€” 8 children

RabbitMQ messaging specialist. Exchange/queue topology, producer/consumer patterns, reliability.

Topics: Consumer blueprint, topology design, exchange patterns, retry/DLX, idempotency, message serialization, connection management, monitoring.


πŸ” Code Reviewer (code-reviewer) β€” 8 children

Reviews code changes for quality, security, performance, and convention compliance.

Topics: Review blueprint, SOLID check, naming review, security scan, performance check, error handling review, logging review, API review.


πŸ“‹ Project Reviewer (project-reviewer) β€” 7 children

Reviews overall project health, architecture, dependencies, and technical debt.

Topics: Review blueprint, architecture review, dependency audit, tech debt, documentation check, configuration review, scalability assessment.

🎨 Design System Agent (design-system-agent) β€” 11 children

Visual foundation of every project. Colors, typography, spacing, icons, component tokens, accessibility. One design system, all platforms.

Topics: Design blueprint, color system, typography, spacing system, icon strategy, elevation/shadow, component tokens, accessibility (WCAG 2.1 AA), dark mode, animation/motion, tokens for Claude Design (codebase-readable token authoring).


πŸ§‘β€πŸŽ¨ UX Agent (ux-agent) β€” 11 children

User experience specialist. Screen flows, navigation patterns, form design, data presentation, feedback systems.

Topics: Screen flow blueprint, navigation UX, form UX, data presentation, feedback patterns, onboarding UX, mobile vs tablet vs web, notification UX, error UX, accessibility UX, Claude Design prompts (high-yield prompt authoring).

Skills (3)

/create-new-project [Name]

5-phase scaffolder for a complete production-ready project from scratch. Asks key questions (project name, SaaS, modules, port offset, Claude Design opt-in), then creates the full stack: .NET API + Docker Compose + Postgres + RabbitMQ + Redis + Elasticsearch + logging pipeline + email pipeline + auth + optional Flutter/React apps. Includes /verify-system invocation as a mandatory final step.

/verify-system

4-level end-to-end health check for this team's stack: containers running, ports accessible, applications healthy, pipelines working (logging / email / auth / socket / worker / redis / storage / audit). Returns a boxed pass/fail report.

/design-screen start "<description>" | done <handoff-url>

Orchestrates the Claude Design loop. start derives a slug, gathers requirements via AskUserQuestion, builds a token-aware prompt, writes intent.md (status: pending-design), hands the prompt to the user. done finds the matching pending design (asks if multiple), fetches the bundle, briefs flutter-agent or react-agent for integration. State persists in .claude/design/{slug}/intent.md across sessions (brainstorm pattern). Requires Claude Pro/Max/Team/Enterprise; opt-in during project scaffolding.

Settled Architectural Patterns

These are systemic capabilities the team enforces across all generated code. Each is documented in detail by the relevant agent's children files.

UI-only i18n (1.0.3+)

Backend (API / Socket / Worker / LogIngest) is English-only. UI apps (Flutter, React admin, React public) localize via a messageKey + placeholders + fallback envelope inside ProblemDetails.extensions (errors), notification payloads (socket events), and EmailJob / PushNotificationJob (with locale field). MailSender + push dispatcher hold per-locale templates and render server-side. Enum values render via {entity}_{field}_{value} convention. Canonical reference: api-agent/children/user-facing-strings.md.

Claude Design integration (1.1.0+)

Optional visual-prototype phase between text-only flow specs (ux-agent) and code (flutter-agent / react-agent). The /design-screen skill orchestrates the round-trip; flutter-agent + react-agent gain handoff playbooks (flutter / react) for the React+HTML bundle; design-system-agent gains token-authoring guidance for codebase readability; ux-agent gains prompt-authoring guidance. Pilot evidence (walkingforme login, 2026-04-19): 1 iteration, 4/5 fidelity, 28 min total, 0 hex literals in resulting Dart.

Architecture Overview

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                  API                     β”‚  ← Brain (all logic)
β”‚  Domain β†’ Application β†’ Infrastructure  β”‚
β”‚  Minimal API Endpoints (bridges)        β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
           β”‚          β”‚
    β”Œβ”€β”€β”€β”€β”€β”€β”΄β”€β”€β”  β”Œβ”€β”€β”€β”€β”΄β”€β”€β”€β”€β”
    β”‚ Socket  β”‚  β”‚ Worker  β”‚  ← Bridges (HTTP to API)
    β”‚ SignalR β”‚  β”‚  Cronos β”‚
    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
           β”‚
    β”Œβ”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
    β”‚      RabbitMQ           β”‚  ← Async messaging
    β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
    β”‚LogIngestβ”‚  MailSender   β”‚  ← Consumers
    β”‚β†’Elastic β”‚  β†’SMTP        β”‚
    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Tech Stack

Layer Technology
API .NET 9, Minimal API, Mediator (source gen)
Database PostgreSQL 17, EF Core 9
Messaging RabbitMQ 3 (fanout exchanges)
Cache Redis 7
Logging Serilog β†’ RMQ β†’ Elasticsearch 8 + Kibana
Email MailSender consumer β†’ Mailpit (dev)
Auth JWT HS256, BCrypt, X-Internal-Token
Storage MinIO (dev) / S3 (prod)
Mobile Flutter (Riverpod, go_router)
Web UI React + TypeScript + Vite (or Next.js)
Infrastructure Docker Compose, dotnet watch

Recommended Companion Skills

  • Brainstorm Skill β€” structured brainstorming with persistent state
  • Rule Skill β€” coding rule management with guided wizard
  • Core β€” memory system, journal, save-learnings (auto-installed as dependency)

Key Rules

  • Everything runs in Docker β€” no local SDK installations (except Flutter)
  • Minimal API only β€” no Controllers
  • martinothamar/Mediator β€” source generator, not MediatR
  • LogIngest logs to console only β€” prevents infinite RMQ loop
  • X-Internal-Token for system-to-system auth
  • API is the brain β€” all logic lives there, everything else is a bridge

License

MIT

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors