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/spec-template.md

View on GitHub
# Feature Specification Template

> Copy this structure to `src/features/{name}/docs/spec.md`.

# {Feature Name} Specification

**Status**: 🚧 Drafting | ✅ Approved | 🔨 Implementing | 🚀 Released
**Owner**: {AI Persona / User}
**Last Updated**: {Date}

---

## 1. Context & Goals

### 1.1 Problem Statement
{Why are we building this? What user pain point does it solve?}

### 1.2 User Stories
- As a **{role}**, I want to **{action}**, so that **{benefit}**.

### 1.3 Success Metrics
- [ ] Metric 1 (e.g., Latency < 100ms)
- [ ] Metric 2 (e.g., Zero Type Errors)

---

## 2. Experience Contract

### 2.1 Information Architecture
- **Entry Point**: {Where does the user allow access?}
- **Route**: `/{route-path}`

### 2.2 UI States
| State | Behavior / Visual |
|-------|-------------------|
| **Loading** | {Skeleton / Spinner} |
| **Empty** | {Illustration + CTA} |
| **Error** | {Retry Button + Toast} |

---

## 3. Technical Architecture

### 3.1 Data Model (Zod)
```typescript
const XxxSchema = z.object({
  id: z.string().uuid(),
  // ...
});
```

### 3.2 State Management
- **Server State**: React Query Key `['xxx', 'list']`
- **Client State**: Zustand (if global) or Context (if scoped)

### 3.3 Dependencies
- **New Deps**: {List or None}
- **Reuse**: {Existing components}

---

## 4. Implementation Plan

- [ ] **Phase 1: Core** (Schema, Service, Types)
- [ ] **Phase 2: UI Components** (Presentational)
- [ ] **Phase 3: Integration** (Page, Routing)
- [ ] **Phase 4: Optimization** (Memo, Lazy)
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: 322kUpdated 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: 198kUpdated 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: 198kUpdated 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: 198kUpdated Claude CodeCodexVerifiedInstall