@jhm1909/ag-kit 0.1.0

package/.agent/skills/research-first/SKILL.md

@@ -0,0 +1,118 @@
+---
+name: research-first
+description: Meta-skill that teaches AI to research before coding. Always check latest docs via context7 MCP, verify versions, and validate assumptions before writing code. Use this skill for ANY coding task.
+allowed-tools: Read, Write, Edit, Glob, Grep
+---
+
+# Research-First — Always Verify Before You Code
+
+> **Philosophy**: AI training data goes stale. Libraries update. APIs change.
+> **Always research first, code second.**
+
+---
+
+## The Research-First Protocol
+
+Before writing ANY code that uses a library, framework, or API:
+
+```
+1. IDENTIFY  → What libraries/frameworks am I about to use?
+2. RESEARCH  → Query context7 MCP for latest docs
+3. VERIFY    → Check version compatibility
+4. CODE      → Write code based on verified information
+5. VALIDATE  → Test that it actually works
+```
+
+---
+
+## When to Research (MANDATORY)
+
+| Trigger | Action |
+|---------|--------|
+| Using any npm/pip/cargo package | Query context7 for latest API |
+| Framework-specific patterns (Next.js, React, Vue) | Check current version docs |
+| Deployment configs (Docker, CI/CD) | Verify current best practices |
+| Security implementations (auth, crypto) | Always check latest recommendations |
+| Any error you're unsure about | Search docs before guessing |
+
+## When NOT to Research
+
+| Scenario | Why |
+|----------|-----|
+| Pure logic/algorithms | Math doesn't change |
+| Language fundamentals (JS, Python, Go) | Core syntax is stable |
+| Git operations | Well-established, stable |
+| File I/O, string manipulation | Standard library, stable |
+
+---
+
+## How to Research — Tool Usage
+
+### Primary: context7 MCP (Real-time Docs)
+
+```
+Step 1: Resolve library ID
+→ mcp_context7_resolve-library-id({ libraryName: "next.js", query: "app router setup" })
+
+Step 2: Query specific docs
+→ mcp_context7_query-docs({ libraryId: "/vercel/next.js", query: "server components data fetching" })
+```
+
+### Secondary: Web Search (When context7 lacks coverage)
+
+```
+→ search_web({ query: "React 19 use() hook examples 2026" })
+```
+
+### Tertiary: GitHub (Implementation examples)
+
+```
+→ mcp_github_search_code({ q: "useFormStatus react-dom language:typescript" })
+```
+
+---
+
+## Research Depth by Task Complexity
+
+| Task | Research Depth |
+|------|----------------|
+| **Simple** (add a button, style a div) | None needed |
+| **Medium** (integrate a library, add auth) | 1 context7 query |
+| **Complex** (new architecture, unfamiliar framework) | 2-3 queries + verify |
+| **Critical** (security, payments, data migration) | Full research + cross-reference |
+
+---
+
+## Anti-Patterns
+
+| ❌ Don't | ✅ Do |
+|----------|-------|
+| Assume you know the latest API | Query context7 first |
+| Copy patterns from training data | Verify they're current |
+| Use deprecated methods | Check migration guides |
+| Guess at config options | Read actual docs |
+| Write 500 lines then test | Research → small test → build |
+
+---
+
+## Decision Framework
+
+```
+User asks: "Add Stripe payments to my Next.js app"
+
+❌ BAD: Start coding from memory
+  → Might use old Stripe.js API
+  → Might use deprecated Next.js patterns
+
+✅ GOOD: Research first
+  1. context7: "next.js server actions" → get current patterns
+  2. context7: "stripe" → get latest Stripe.js API
+  3. Verify: Next.js version in package.json
+  4. Code: Using verified, current patterns
+  5. Test: Verify integration works
+```
+
+---
+
+> **Remember**: Your training data is a starting point, not ground truth.
+> When in doubt, **look it up**. The 30 seconds spent researching saves 30 minutes debugging outdated code.

package/.agent/skills-manifest.json

@@ -0,0 +1,264 @@
+{
+  "version": "3.0.0",
+  "generated_at": "2026-03-27",
+  "description": "Skills manifest for antigravity-kit — skill metadata, triggers, profiles, and workflow integration",
+  "core": ["project-manager", "business-analysis", "qa-tester"],
+  "skills": {
+    "project-manager": {
+      "name": "Project Manager",
+      "description": "Project Planning, Roadmapping, Requirements, Skill Creation",
+      "size": "96K",
+      "dependencies": [],
+      "triggers": ["roadmap", "PRD", "requirements", "user story", "prioritization", "RICE", "Kano", "sprint", "backlog"],
+      "used_by_workflows": ["brainstorm", "guide", "absorb", "break-tasks", "custom-behavior"],
+      "router": "./skills/project-manager/router.json"
+    },
+    "business-analysis": {
+      "name": "Business Analysis",
+      "description": "Requirements analysis, specs, agile documentation",
+      "size": "80K",
+      "dependencies": [],
+      "triggers": ["domain", "compliance", "persona", "user research", "acceptance criteria", "stakeholder", "use case"],
+      "used_by_workflows": ["documentation", "absorb", "break-tasks"]
+    },
+    "marketer": {
+      "name": "Marketer",
+      "description": "Marketing, SEO, social media, content strategy, video production",
+      "size": "80K",
+      "dependencies": [],
+      "triggers": ["marketing", "SEO", "social media", "content strategy", "campaign", "branding"],
+      "sub_skills": ["remotion-best-practices"],
+      "used_by_workflows": []
+    },
+    "qa-tester": {
+      "name": "QA Tester",
+      "description": "Test planning, test cases, bug reporting, automation",
+      "size": "72K",
+      "dependencies": [],
+      "triggers": ["testing", "test case", "QA", "bug", "E2E", "unit test", "playwright", "coverage"],
+      "used_by_workflows": ["gen-tests", "qa", "documentation", "implement-feature"]
+    },
+    "frontend-developer": {
+      "name": "Frontend Developer",
+      "description": "Frontend architecture, React, optimization, accessibility",
+      "size": "292K",
+      "dependencies": [],
+      "triggers": ["react", "vue", "angular", "css", "tailwind", "frontend", "component", "performance", "nextjs"],
+      "sub_skills": ["react-nextjs", "threejs"],
+      "used_by_workflows": ["implement-feature", "ui-ux-design"]
+    },
+    "backend-developer": {
+      "name": "Backend Developer",
+      "description": "API design, Architecture, Security, Node/Python/Go/Java",
+      "size": "36K",
+      "dependencies": [],
+      "triggers": ["API", "database", "auth", "security", "microservice", "backend", "node", "python", "go", "REST", "GraphQL"],
+      "used_by_workflows": ["implement-feature", "documentation"]
+    },
+    "mobile-developer": {
+      "name": "Mobile Developer",
+      "description": "React Native, Expo, native features, mobile deployment",
+      "size": "236K",
+      "dependencies": [],
+      "triggers": ["expo", "react-native", "ios", "android", "mobile", "app store", "play store", "native module"],
+      "sub_skills": ["api-routes", "building-ui", "data-fetching", "deployment", "dev-client", "tailwind-setup", "upgrading-expo", "use-dom", "cicd-workflows"],
+      "used_by_workflows": ["implement-feature"]
+    },
+    "designer": {
+      "name": "Designer",
+      "description": "UI/UX design intelligence with searchable BM25 database. 50+ styles, 161 colors, 57 fonts, 161 products, 99 UX rules. Data-driven design decisions.",
+      "size": "640K",
+      "dependencies": [],
+      "triggers": ["design", "UI", "UX", "design system", "accessibility", "branding", "color palette", "font pairing", "style", "glassmorphism", "dark mode", "landing page"],
+      "used_by_workflows": ["ui-ux-design", "implement-feature"]
+    },
+    "devops-engineer": {
+      "name": "DevOps Engineer",
+      "description": "CI/CD, multi-cloud infrastructure, observability, SRE",
+      "size": "40K",
+      "dependencies": [],
+      "triggers": ["docker", "kubernetes", "CI/CD", "deployment", "monitoring", "observability", "terraform", "AWS", "GCP"],
+      "used_by_workflows": ["documentation"]
+    },
+    "lead-architect": {
+      "name": "Lead Architect",
+      "description": "System design, high-stakes decisions, scalability, ADRs",
+      "size": "48K",
+      "dependencies": [],
+      "triggers": ["architecture", "system design", "scalability", "ADR", "RFC", "tech spec", "microservices", "monolith"],
+      "used_by_workflows": ["documentation", "absorb", "break-tasks", "implement-feature", "bootstrap"]
+    },
+    "ai-engineer": {
+      "name": "AI Engineer",
+      "description": "GenAI, Agentic Systems, RAG, Evaluation pipelines",
+      "size": "24K",
+      "dependencies": [],
+      "triggers": ["AI", "LLM", "RAG", "prompt", "embedding", "fine-tune", "openai", "anthropic", "agentic"],
+      "used_by_workflows": ["implement-feature"]
+    },
+    "blockchain-engineer": {
+      "name": "Blockchain Engineer",
+      "description": "Smart contracts, protocol architecture, security auditing",
+      "size": "20K",
+      "dependencies": [],
+      "triggers": ["blockchain", "smart contract", "web3", "ethereum", "solidity", "defi", "tokenomics"],
+      "used_by_workflows": ["implement-feature"]
+    },
+    "prompt-engineer": {
+      "name": "Prompt Engineer",
+      "description": "Prompt engineering, system prompts, few-shot, chain-of-thought",
+      "size": "12K",
+      "parent": "ai-engineer",
+      "dependencies": ["ai-engineer"],
+      "triggers": ["prompt engineering", "system prompt", "few-shot", "chain-of-thought", "prompt template"],
+      "used_by_workflows": []
+    },
+    "mcp-builder": {
+      "name": "MCP Builder",
+      "description": "Production-grade MCP server development (TypeScript/Python). Architecture, tool design, security, evaluation.",
+      "size": "92K",
+      "dependencies": [],
+      "triggers": ["MCP", "model context protocol", "MCP server", "FastMCP", "tool server", "MCP SDK"],
+      "used_by_workflows": ["implement-feature"],
+      "source": "anthropics/skills (Apache 2.0)"
+    },
+    "remotion-best-practices": {
+      "name": "Remotion Best Practices",
+      "description": "Video creation with Remotion framework",
+      "size": "132K",
+      "parent": "marketer",
+      "dependencies": ["frontend-developer"],
+      "triggers": ["remotion", "video", "composition", "animation", "render"]
+    },
+    "react-nextjs": {
+      "name": "React & Next.js",
+      "description": "Next.js best practices, Server Components, App Router",
+      "size": "180K",
+      "parent": "frontend-developer",
+      "dependencies": ["frontend-developer"],
+      "triggers": ["nextjs", "next.js", "server component", "RSC", "app router", "Next.js 16"],
+      "router": "./skills/frontend-developer/react-nextjs/router.json"
+    },
+    "threejs": {
+      "name": "Three.js",
+      "description": "3D graphics, WebGL, interactive 3D scenes",
+      "size": "520K",
+      "parent": "frontend-developer",
+      "dependencies": ["frontend-developer"],
+      "triggers": ["threejs", "three.js", "3D", "webgl", "scene", "camera", "renderer"],
+      "router": "./skills/frontend-developer/threejs/router.json"
+    },
+    "research-first": {
+      "name": "Research-First",
+      "description": "Meta-skill: teaches AI to research via context7 MCP before coding. Verify versions, check latest docs.",
+      "size": "4K",
+      "dependencies": [],
+      "triggers": ["research", "docs", "latest", "version", "context7", "verify", "check docs"],
+      "used_by_workflows": ["development", "implement-feature"]
+    },
+    "app-builder": {
+      "name": "App Builder",
+      "description": "Application scaffolding orchestrator. 13 project templates, tech stack selection.",
+      "size": "80K",
+      "dependencies": [],
+      "triggers": ["new app", "scaffold", "full-stack", "starter", "template", "SaaS", "monorepo"],
+      "used_by_workflows": ["bootstrap"]
+    },
+    "game-development": {
+      "name": "Game Development",
+      "description": "Game dev orchestrator with 10 sub-skills. Core principles + platform routing.",
+      "size": "48K",
+      "dependencies": [],
+      "triggers": ["game", "game dev", "game loop", "sprites", "physics", "Unity", "Godot", "platformer"],
+      "sub_skills": ["2d-games", "3d-games", "web-games", "mobile-games", "pc-games", "vr-ar", "game-design", "multiplayer", "game-art", "game-audio"],
+      "used_by_workflows": ["implement-feature"]
+    },
+    "context-engineering": {
+      "name": "Context Engineering",
+      "description": "Context engineering for AI agents. Token optimization, progressive disclosure, memory systems, multi-agent coordination.",
+      "size": "36K",
+      "dependencies": [],
+      "triggers": ["context", "token", "context window", "progressive disclosure", "memory", "multi-agent", "compaction"],
+      "used_by_workflows": []
+    },
+    "debugging": {
+      "name": "Debugging",
+      "description": "Systematic debugging: root cause analysis, defense-in-depth, verification gates. 4 sub-methodologies.",
+      "size": "28K",
+      "dependencies": [],
+      "triggers": ["debug", "bug", "root cause", "stack trace", "fix", "regression", "test failure"],
+      "used_by_workflows": ["implement-feature", "development"]
+    },
+    "code-review": {
+      "name": "Code Review",
+      "description": "Code review: verification gates, security-focused differential review, spec compliance. Trail of Bits methodology.",
+      "size": "32K",
+      "dependencies": [],
+      "triggers": ["review", "PR", "pull request", "feedback", "verification", "completion", "done", "security review", "blast radius"],
+      "used_by_workflows": ["implement-feature", "commit"]
+    },
+    "modern-python": {
+      "name": "Modern Python",
+      "description": "Modern Python tooling: uv, ruff, ty, pytest. Project setup, migration, PEP 723 scripts. Trail of Bits methodology.",
+      "size": "16K",
+      "dependencies": [],
+      "triggers": ["python", "uv", "ruff", "ty", "pyproject.toml", "pip", "poetry", "mypy"],
+      "used_by_workflows": ["bootstrap", "development"]
+    }
+  },
+  "workflows": {
+    "guide":             { "skills": ["project-manager", "lead-architect"],     "chains_to": ["brainstorm", "break-tasks", "development", "absorb"] },
+    "brainstorm":        { "skills": ["project-manager"],                       "chains_to": ["documentation"] },
+    "documentation":     { "skills": ["lead-architect", "business-analysis", "backend-developer", "devops-engineer", "qa-tester", "project-manager"], "chains_to": ["break-tasks"] },
+    "break-tasks":       { "skills": ["business-analysis", "lead-architect"],   "chains_to": ["implement-feature"] },
+    "implement-feature": { "skills": ["lead-architect", "backend-developer", "frontend-developer", "designer", "qa-tester", "project-manager"], "chains_to": ["gen-tests", "commit"] },
+    "development":       { "skills": [],                                        "chains_to": ["commit"] },
+    "debug":             { "skills": ["debugging"],                             "chains_to": ["commit"] },
+    "ui-ux-design":      { "skills": ["designer", "frontend-developer"],        "chains_to": ["break-tasks"] },
+    "qa":                { "skills": ["qa-tester"],                             "chains_to": ["gen-tests"] },
+    "gen-tests":         { "skills": ["qa-tester"],                             "chains_to": ["commit"] },
+    "absorb":            { "skills": ["project-manager", "lead-architect", "business-analysis"], "chains_to": ["break-tasks"] },
+    "commit":            { "skills": [],                                        "chains_to": [] },
+    "bootstrap":         { "skills": ["lead-architect"],                        "chains_to": ["brainstorm"] },
+    "custom-behavior":   { "skills": ["project-manager"],                       "chains_to": [] },
+    "install-skill":     { "skills": [],                                        "chains_to": ["commit"] }
+  },
+  "profiles": {
+    "web-frontend": {
+      "name": "Web Frontend",
+      "description": "React/Vue/Angular web applications",
+      "skills": ["frontend-developer", "designer"],
+      "optional": ["react-nextjs", "threejs"]
+    },
+    "fullstack-saas": {
+      "name": "Fullstack SaaS",
+      "description": "Complete SaaS with frontend, backend, and infrastructure",
+      "skills": ["frontend-developer", "backend-developer", "devops-engineer", "project-manager", "qa-tester"],
+      "optional": ["react-nextjs", "ai-engineer", "lead-architect"]
+    },
+    "mobile-app": {
+      "name": "Mobile App",
+      "description": "React Native / Expo mobile application",
+      "skills": ["mobile-developer", "designer", "qa-tester"],
+      "optional": ["backend-developer", "devops-engineer"]
+    },
+    "video-content": {
+      "name": "Video Content Tool",
+      "description": "Video creation and editing with Remotion",
+      "skills": ["marketer", "frontend-developer", "remotion-best-practices"],
+      "optional": ["threejs", "designer"]
+    },
+    "ai-powered-app": {
+      "name": "AI-Powered Application",
+      "description": "Applications with LLM integration and AI features",
+      "skills": ["ai-engineer", "frontend-developer", "backend-developer"],
+      "optional": ["lead-architect", "prompt-engineer"]
+    },
+    "blockchain-dapp": {
+      "name": "Blockchain dApp",
+      "description": "Decentralized application with smart contracts",
+      "skills": ["blockchain-engineer", "frontend-developer", "backend-developer"],
+      "optional": ["devops-engineer", "lead-architect"]
+    }
+  }
+}

package/.agent/workflows/absorb.md

@@ -0,0 +1,176 @@
+---
+description: Analyze a reference project/kit, compare with ours, and generate an action plan for what to copy, adapt, or skip
+---
+
+# Absorb — Study & Adapt Reference Kit
+
+> [!IMPORTANT]
+> Philosophy: **Study → Compare → Copy Best → Upgrade → Ship**
+> Reads a reference project, produces a structured action plan.
+
+---
+
+## Step 0: Identify Source
+
+**Invoke `[project-manager]` skill** to clarify scope.
+
+Ask user:
+
+```
+📂 Which reference project/kit to analyze?
+1. A local directory (paste path)
+2. A GitHub repo (paste URL)
+3. An npm package (paste package name)
+```
+
+If **GitHub URL** → clone to `.agent/tmp/<repo-name>/`
+If **npm package** → `npm pack <name> && tar -xf *.tgz -C .agent/tmp/`
+If **local path** → use directly
+
+---
+
+## Step 1: Deep Scan
+
+// turbo
+
+**Invoke `[lead-architect]` skill** to analyze the reference project structure.
+
+```bash
+find <source-path> -type f -not -path '*node_modules*' -not -path '*.git/*' | head -200
+```
+
+Build an **inventory table**:
+
+| Category | Count | Examples |
+|----------|------:|---------|
+| Agents | ? | orchestrator.md, debugger.md... |
+| Skills | ? | react-patterns/, api-design/... |
+| Workflows | ? | deploy.md, test.md... |
+| Rules | ? | GEMINI.md, eslint-config... |
+| Scripts | ? | verify_all.py, checklist.py... |
+| Config | ? | mcp_config.json, .editorconfig... |
+| Docs | ? | ARCHITECTURE.md, AGENT_FLOW.md... |
+
+---
+
+## Step 2: Compare With Our Kit
+
+// turbo
+
+**Invoke `[business-analysis]` skill** to create a comparison matrix.
+
+For each item, classify action:
+
+| Action | Meaning | When to Use |
+|--------|---------|-------------|
+| `COPY` | Take as-is | Doesn't exist in our kit |
+| `ADAPT` | Copy + modify for our conventions | Different format |
+| `UPGRADE` | Merge best parts into existing | Both have it, theirs is better |
+| `SKIP` | Don't take | We have equal/better |
+| `INSPIRE` | Study idea, write our own | Good idea, bad implementation |
+
+---
+
+## Step 3: Read Key Files
+
+**Invoke `[lead-architect]` skill** to evaluate quality and compatibility.
+
+For each `COPY` or `ADAPT` item:
+
+1. Read first 50-80 lines to understand structure
+2. Note format differences vs our conventions:
+   - Frontmatter format (our agentskills.io spec vs theirs)
+   - Skill invocation pattern (`Invoke [skill]`)
+   - Knowledge graph integration needed?
+3. Assess quality: keep, improve, or rewrite?
+
+---
+
+## Step 4: Generate Action Plan
+
+**Invoke `[project-manager]` skill** to structure the plan.
+
+Create `docs/050-Research/Absorb-<source-name>.md`:
+
+```markdown
+# Absorb Plan: <Source Name>
+
+## Summary
+| Action | Count |
+|--------|------:|
+| COPY | X |
+| ADAPT | X |
+| UPGRADE | X |
+| SKIP | X |
+| INSPIRE | X |
+
+## COPY Items
+### <filename>
+- **Source**: <path> → **Target**: <our-path>
+- **Changes needed**: None
+
+## ADAPT Items
+### <filename>
+- **Source**: <path> → **Target**: <our-path>
+- **Changes**:
+  - [ ] Update frontmatter to agentskills.io format
+  - [ ] Add skill invocations
+  - [ ] Integrate with knowledge graph
+
+## UPGRADE Items
+### <filename>
+- **Take from theirs**: Section X (better)
+- **Keep ours**: Section A (our format)
+
+## SKIP / INSPIRE Items
+(table format)
+```
+
+---
+
+## Step 5: User Review
+
+Present the action plan:
+
+```
+📋 Absorb Plan ready!
+COPY: X | ADAPT: X | UPGRADE: X | SKIP: X | INSPIRE: X
+
+1. Execute all (recommended)
+2. Let me pick specific items
+3. Skip for now
+```
+
+---
+
+## Step 6: Execute Plan
+
+**Invoke `[lead-architect]` skill** for structural changes.
+**Invoke relevant domain skill** for content adaptation.
+
+Process in order:
+1. **COPY items** → direct file copies
+2. **ADAPT items** → copy + apply our conventions
+3. **UPGRADE items** → careful merge
+
+For each:
+```
+✅ [1/12] COPIED: agents/orchestrator.md
+✅ [2/12] ADAPTED: mcp_config.json (updated for our format)
+✅ [3/12] UPGRADED: frontend skill (merged 5 new sections)
+```
+
+After all items:
+- **Invoke `[project-manager]` skill** to update `skills-manifest.json`
+- Update `skills-manifest.json` if new entries needed
+- Suggest `/commit`
+
+---
+
+## Error Handling
+
+| Issue | Recovery |
+|-------|----------|
+| Source not found | Ask user to verify path |
+| Format incompatible | Flag as INSPIRE instead |
+| Conflict with existing | Show diff, ask user |

package/.agent/workflows/bootstrap.md

@@ -0,0 +1,91 @@
+---
+description: Sets up project structure, installs dependencies, and configures environment based on architectural specs.
+---
+
+# Bootstrap Workflow
+
+## MCP Usage Guidelines
+
+| MCP Tool                          | When to Use                        |
+| :-------------------------------- | :--------------------------------- |
+| `mcp_context7_resolve-library-id` | Find correct package names         |
+| `mcp_context7_query-docs`         | Research installation/config steps |
+
+---
+
+## Step 1: Framework Initialization & Structure
+
+// turbo
+
+1. **Invoke `[lead-architect]` skill** to:
+   - Define the project root structure (Monorepo vs Polyrepo)
+   - Initialize the base project (e.g., `git init`, `npx create-next-app`)
+   - Create the directory skeleton based on SDD
+2. **WAIT** for initialization
+
+---
+
+## Step 2: Maintenance & Quality Engineering Tools
+
+// turbo
+
+> 💡 **Role**: DevOps Engineer ensures the "Development Experience" (DX) is solid.
+
+1. **Invoke `[devops-engineer]` skill** to install & configure:
+   - **Quality Tools**: ESLint, Prettier, TypeScript config
+   - **Git Hooks**: Husky, Lint-staged, Commitlint
+   - **CI/CD**: Github Actions (basic build/test)
+2. Verify: Run `npm run lint` and ensure hooks fire on commit.
+
+---
+
+## Step 3: Frontend Setup
+
+// turbo
+
+> 💡 **Role**: Frontend Developer manages the UI/Client side.
+
+1. **Invoke `[frontend-developer]` skill** to:
+   - **UI Ecosystem**: Install TailwindCSS, Radix/Shadcn, Framer Motion
+   - **State Manager**: Zustand/Jotai/Redux
+   - **Structure**: Setup `src/components`, `src/hooks`, `src/pages` (or `app`)
+   - **Assets**: Configure font loaders, image optimization
+2. **WAIT** for installation
+
+---
+
+## Step 4: Backend Setup
+
+// turbo
+
+> 💡 **Role**: Backend Developer manages the Data/Server side.
+
+1. **Invoke `[backend-developer]` skill** to:
+   - **Database**: Setup Prisma/Drizzle/Supabase client
+   - **API**: Configure API routes/Server Actions
+   - **Validation**: Install Zod/Valibot
+   - **Environment**: Create `.env.example` and validate `.env` keys
+2. **WAIT** for installation
+
+---
+
+## Step 5: Final Validation
+
+// turbo
+
+1. **Invoke `[devops-engineer]` skill** to:
+   - Run full build `npm run build`
+   - Test Type-checking `tsc --noEmit`
+2. **Invoke `[product-manager]`** to update Roadmap status to "In Progress"
+
+---
+
+## Quick Reference
+
+| Step | Skill              | Action                      |
+| :--- | :----------------- | :-------------------------- |
+| 1    | lead-architect     | Init Framework & Structure  |
+| 2    | devops-engineer    | Husky, Linter, CI/CD        |
+| 3    | frontend-developer | Tailwind, Components, State |
+| 4    | backend-developer  | DB, API, Env                |
+| 5    | devops-engineer    | Final Build Check           |