Skip to content

amanpal3/Dr-SKILLs / .agent/skills/antigravity-agents

antigravity-agents

Flagged

A multi-agent orchestration skill for building, deploying, and coordinating specialized AI agents that work together like an elite squad. Use this skill whenever the user wants to: assign tasks to multiple AI agents, build an agentic pipeline or workflow, create a team of specialized agents (coding, UI/UX, security, database, planning, debugging, etc.), run autonomous multi-step operations, or orchestrate complex projects where different agents handle different roles. Trigger this skill aggressively — if the user mentions "agents", "squad", "team", "pipeline", "orchestrate", "automate workflow", "multi-step task", "assign tasks", or any mention of splitting a big project into specialized roles, this skill MUST be used.

templates/ARCHITECTURE.md

View on GitHub
# ARCHITECTURE.md — [Project Name]

> Maintained by Tony Stark. Updated whenever a major architecture decision is made.

---

## System Overview

[2–3 sentences describing what this system does and its primary purpose]

## Tech Stack

| Layer | Technology | Reason |
|---|---|---|
| Frontend | | |
| Backend | | |
| Database | | |
| Cache | | |
| Auth | | |
| File Storage | | |
| CI/CD | | |
| Hosting | | |

## Directory Structure

```
project-root/
├── src/
│   ├── api/          ← Route handlers (thin — delegate to services)
│   ├── services/     ← Business logic
│   ├── repositories/ ← DB access only
│   ├── middleware/   ← Auth, validation, error handling
│   ├── models/       ← DB schema / ORM models
│   ├── utils/        ← Pure functions, shared helpers
│   ├── config/       ← Environment, constants, feature flags
│   └── types/        ← Shared TypeScript interfaces
├── tests/
│   ├── unit/
│   └── integration/
├── scripts/
├── .env.example
├── docker-compose.yml
└── package.json
```

## Database Schema

```sql
-- [Table 1]
CREATE TABLE [name] (
  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  created_at TIMESTAMPTZ DEFAULT NOW(),
  updated_at TIMESTAMPTZ DEFAULT NOW()
);

-- [Table 2]
```

## API Endpoints

| Method | Endpoint | Auth | Description |
|---|---|---|---|
| GET | /api/v1/health | No | Health check |
| POST | /api/v1/auth/login | No | User login |
| GET | /api/v1/users/me | Yes | Get current user |

## Data Flow Diagrams

### [Feature Name] Flow
```
[Client] → [API Gateway] → [Auth Middleware] → [Route Handler]
       → [Service Layer] → [Repository] → [Database]
       ← [Response] ← [Service] ← [Repository]
```

## Key Architecture Decisions (ADRs)

### ADR-001: [Decision Title]
- **Date**: [Date]
- **Status**: Accepted
- **Context**: [Why a decision was needed]
- **Decision**: [What was decided]
- **Consequences**: [Tradeoffs accepted]

## Environment Variables

```bash
# Required
DATABASE_URL=
JWT_SECRET=
NODE_ENV=

# Optional
REDIS_URL=
SENTRY_DSN=
```

## Performance Targets

| Metric | Target |
|---|---|
| API p95 response time | < 200ms |
| DB query time | < 50ms |
| Page LCP | < 2.5s |
| Uptime | 99.9% |

## Known Technical Debt

| Item | Impact | Priority | Owner |
|---|---|---|---|
| | | | |
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall