VidyFoo/antigravity-skill-engine / .agent/skills/1-dev/architecting
architecting
VerifiedArchitects new features through the full lifecycle. Use when designing, planning, implementing, or extending features. Triggers on 'new feature', 'design', 'plan', 'implement', 'architect', 'prd', 'spec'.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.7 KB |
| resources/anti-patterns.md | markdown | 1.3 KB |
| resources/architecture-patterns.md | markdown | 2.1 KB |
| resources/kiss-checklist.md | markdown | 1.1 KB |
| resources/spec-template.md | markdown | 1.5 KB |
| resources/tech-stack-integration.md | markdown | 1.5 KB |
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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 321k | Updated | Claude CodeCodex | Verified | Install |
| 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: 197k | Updated | Claude CodeCodex | Verified | Install |
| 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: 197k | Updated | Claude CodeCodex | Verified | Install |
| 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: 197k | Updated | Claude CodeCodex | Verified | Install |