Skip to content

VidyFoo/antigravity-skill-engine / .agent/skills/1-dev/architecting

architecting

Verified

Architects new features through the full lifecycle. Use when designing, planning, implementing, or extending features. Triggers on 'new feature', 'design', 'plan', 'implement', 'architect', 'prd', 'spec'.

resources/tech-stack-integration.md

View on GitHub
# Tech Stack Integration Strategy

How to glue `frontend-dev-guidelines` and `backend-dev-guidelines` together for maximum efficiency.

## 1. Type Sharing (The "Secret Weapon")

regardless of architecture (Indie vs Enterprise), sharing types prevents execution errors.

### Strategy
1. **Backend as Source of Truth**: Define Zod schemas in the Backend.
2. **Export for Frontend**:
   - **Monorepo**: Frontend imports `type { User }` and `UserSchema` directly from `@workspace/backend`.
   - **Polyrepo**: Backend publishes a plain `@my-org/types` npm package (versions synchronized).

## 2. Data Fetching & State

### Frontend (TanStack Query)
- **Query Keys**: Must mirror the Backend API URL structure. 
  - URL: `/api/v1/users/123` -> Key: `['users', '123']`
- **Error Handling**: Middleware in `useQuery` configuration should globally handle the standardized error responses defined in `BaseController`.

### Backend (Response Format)
- Must adhere strictly to the `BaseController` format so the Frontend `SuspenseLoader` and Error Boundaries work predictably.
```json
{
  "success": true,
  "data": { ... },
  "message": "Optional toast message"
}
```

## 3. Deployment Pipelines

### Indie Mode
- **Git Push -> Deploy All**.
- Zero downtime not guaranteed but acceptable.
- Database migrations run *before* app startup commands.

### Enterprise Mode
- **Blue/Green Deployment**.
- Database migrations must be **non-breaking** (expand and contract pattern).
- Frontend assets deployed to CDN *before* Backend API switch.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 321kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 197kUpdated Claude CodeCodexVerifiedInstall