Skip to content

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

architecting

Unverified

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'.

Architect Feature

Role: Oversee the entire lifecycle of a Feature—from 0 to 1 to N—ensuring architectural consistency and UX integrity.

When to use this skill

  • Creating a new feature from scratch
  • Extending an existing feature with new capabilities
  • Implementing code based on a finalized design spec

How to use it

Choose a mode based on your intent:

ModeTrigger keywordsScenario
DESIGNnew feature, 设计Create a brand-new feature directory from scratch
EXTEND扩展, add capabilityAdd sub-capabilities to an existing feature
BUILDimplement, 实现Code an already-designed spec

DESIGN Mode (从 0 到 1)

  1. Context Check: Read src/features/ to avoid reinventing the wheel.
  2. KISS Check: Really need a new directory? If < 3 files, consider shared.
  3. Generate Spec: Use resources/spec-template.md.
  4. Tech Decisions: Define dependencies and Schema.

Output: src/features/{name}/docs/spec.md


EXTEND Mode (从 1 到 N)

  1. Locate Host: Identify the target Feature.
  2. Architecture Conformance: Read the host's spec.md, follow its design philosophy.
  3. Incremental Design: Append an "Extension Section" instead of creating new docs.

Output: Updated src/features/{name}/docs/spec.md or core code.


BUILD Mode (编码实现)

  1. Read Contract: Always read spec.md first for scope.
  2. Quality Gate: Establish "Type-First" (Zod Schema -> TypeScript Type).
  3. Layered Implementation:
    • L1 Core: Schema & Service (no UI, pure logic)
    • L2 UI: Components (no business logic)
    • L3 Integration: Pages & Routing
  4. Self-Verify: npm run type-check and npm run lint must pass.

Resources

ResourcePurpose
spec-template.mdStandardized design doc template
kiss-checklist.mdAnti-over-engineering checklist
anti-patterns.mdArchitecture anti-pattern warnings

Quality Baseline

As an architect, you MUST reject:

  • ❌ Circular Dependencies: Features importing each other.
  • ❌ Global State Abuse: Local state pushed to global store.
  • ❌ Any Type: Even one any is a disgrace.
  • ❌ Implicit Logic: Critical logic without comments or docs.
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: 318kUpdated Claude CodeCodexUnverifiedInstall
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: 196kUpdated 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: 196kUpdated 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: 196kUpdated Claude CodeCodexVerifiedInstall