ateschh-kit 1.0.0

package/skills/market-research/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: "market-research"
+description: "3-5 competitor analysis with gap identification and positioning"
+used_by: ["market-researcher"]
+---
+
+# Skill: Market Research
+
+## Purpose
+
+Map the competitive landscape and find where the product can win.
+
+## Steps
+
+### 1. Identify Competitors
+
+Find 3–5 players:
+- **Direct**: Same product, same target user
+- **Indirect**: Different product, same problem
+- **Emerging**: New entrants or adjacent tools
+
+### 2. Analyze Each Competitor
+
+For each:
+
+```
+Name: {name}
+URL: {url}
+What it does: {1 sentence}
+Target user: {persona}
+Pricing: {model and tiers}
+Strengths: {what they do well}
+Weaknesses: {user complaints — use App Store / Reddit / G2 / Trustpilot}
+Positioning: {how they describe themselves}
+```
+
+### 3. Gap Analysis
+
+After all competitors:
+- What user segment is underserved?
+- What feature combination doesn't exist?
+- What pricing tier is missing?
+- What is everyone doing that users hate?
+
+## Output Template
+
+```markdown
+## Market Research — {idea name}
+
+### Competitors
+
+#### {Competitor 1}
+- **URL**: {url}
+- **Does**: {one sentence}
+- **Target**: {persona}
+- **Pricing**: {model}
+- **Strong**: {strengths}
+- **Weak**: {weaknesses}
+
+...
+
+### Gap Analysis
+**Underserved user**: {who}
+**Missing feature set**: {what}
+**Pricing opportunity**: {gap}
+
+### Positioning
+**We win because**: {differentiator}
+**Start with**: {niche}
+```

package/skills/publish/SKILL.md

@@ -0,0 +1,80 @@
+---
+name: "publish"
+description: "Deploy the application to production using MCP tools"
+used_by: ["deployer"]
+---
+
+# Skill: Publish
+
+## Deployment Decision Tree
+
+```
+What's the deploy target? (from REQUIREMENTS.md)
+├── Vercel → use Vercel CLI or Vercel MCP
+├── Cloudflare → use Wrangler
+├── Firebase → use Firebase MCP
+├── Supabase → use Supabase MCP (for functions/migrations)
+└── Expo → use EAS CLI
+```
+
+## Commands
+
+### Vercel
+
+```bash
+npx vercel --prod
+```
+
+Post-deploy:
+- Set all env vars in Vercel dashboard
+- Confirm live URL loads
+
+### Cloudflare Workers
+
+```bash
+npx wrangler deploy
+# Set secrets:
+npx wrangler secret put MY_SECRET
+```
+
+### Cloudflare Pages
+
+```bash
+npx wrangler pages deploy ./out --project-name my-app
+```
+
+### Firebase
+
+```bash
+firebase deploy
+# or via Firebase MCP
+```
+
+### Expo Mobile
+
+```bash
+# Production build:
+eas build --platform all --profile production
+
+# OTA update (no store submission):
+eas update --branch production --message "v{version}"
+
+# Submit to stores:
+eas submit --platform ios
+eas submit --platform android
+```
+
+### Supabase DB Migration
+
+```bash
+supabase db push
+# or via Supabase MCP → apply_migration
+```
+
+## Post-Deploy Checklist
+
+- [ ] Live URL is accessible
+- [ ] Core user flow works on production
+- [ ] No 5xx errors in logs
+- [ ] Env vars are set correctly in production
+- [ ] Auth works on production DB

package/skills/requirements-lock/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: "requirements-lock"
+description: "Writes and locks the REQUIREMENTS.md file after tech stack is approved"
+used_by: ["requirements-expert"]
+---
+
+# Skill: Requirements Lock
+
+## Purpose
+
+Formally lock the tech stack into REQUIREMENTS.md so it cannot change during development.
+
+## When to Use
+
+After the requirements-expert proposes a stack and the user approves it.
+
+## Steps
+
+### 1. Write REQUIREMENTS.md
+
+Use this template exactly:
+
+```markdown
+# Requirements — {Project Name}
+
+**Status**: LOCKED ✅
+**Locked on**: {YYYY-MM-DD}
+
+## Platform
+{Web App / Mobile iOS+Android / Desktop / etc.}
+
+## Stack
+
+| Category | Technology | Version | Purpose |
+|----------|-----------|---------|---------|
+| Framework | {name} | {version} | {1 sentence} |
+| Database | {name} | {version} | {1 sentence} |
+| Auth | {name} | {version} | {1 sentence} |
+| UI Components | {name} | {version} | {1 sentence} |
+| Styling | {name} | {version} | {1 sentence} |
+| State | {name} | {version} | {1 sentence} |
+| Deploy | {name} | {version} | {1 sentence} |
+
+## All Libraries
+
+| Library | Version | Purpose |
+|---------|---------|---------|
+| {library} | {version} | {purpose} |
+
+## Out of Scope (v1)
+
+- {feature or technology not included}
+- {reason}
+
+## Change Policy
+
+To change this document: run `/requirements` and get explicit approval.
+Any library not listed here must be approved before use.
+```
+
+### 2. Verify File is Complete
+
+Before saving:
+- [ ] All categories filled (no "TBD")
+- [ ] All versions specified (no "latest" — use real semver)
+- [ ] Out of scope section filled
+- [ ] File status says LOCKED ✅
+
+### 3. Log in DECISIONS.md
+
+```markdown
+## {date} — Tech Stack Locked
+- Locked: {framework + DB + deploy}
+- Reasoning: {brief why}
+```

package/skills/run-tests/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: "run-tests"
+description: "Runs L1-L4 verification across the full application"
+used_by: ["tester"]
+---
+
+# Skill: Run Tests
+
+## The Four Levels
+
+### L1 — Syntax (Static)
+
+```bash
+npm run build      # or: expo build / go build / etc.
+npm run typecheck  # tsc --noEmit
+npm run lint       # eslint check
+```
+
+Pass = exit code 0 on all three.
+
+### L2 — Functionality (Per Feature)
+
+For each feature in STRUCTURE.md:
+
+```
+Feature: {name}
+Happy path: {steps} → Expected: {result}
+Error path: {bad input} → Expected: {error state shown}
+Empty state: {no data} → Expected: {empty state shown}
+```
+
+### L3 — Integration (System)
+
+Standard flow:
+1. New user: register → verify → first action → result
+2. Auth gates: access protected page without auth → redirect to login
+3. CRUD: create → appears in list → update → delete → gone
+4. Errors: network timeout, server error → user sees friendly message
+
+### L4 — Quality (Pre-Deploy)
+
+```
+Web:
+- [ ] 375px (mobile) layout OK
+- [ ] 768px (tablet) layout OK
+- [ ] 1280px (desktop) layout OK
+
+All:
+- [ ] No console.log in production files
+- [ ] Loading states visible during async ops
+- [ ] Error messages are user-friendly
+- [ ] No credentials in code
+- [ ] .env.example present
+```
+
+## Defect Format
+
+```
+[L{N}] {Description}
+File: {path}:{line}
+Reproduce: {steps}
+Expected: {result}
+Actual: {result}
+Severity: Critical / High / Medium / Low
+```
+
+## Pass Criteria
+
+All L1 + L2 + L3 = no Critical or High severity issues remaining.
+L4 = no Critical issues remaining.

package/skills/write-code/SKILL.md

@@ -0,0 +1,92 @@
+---
+name: "write-code"
+description: "Implements a single PLAN.md task following locked requirements and design system"
+used_by: ["coder"]
+---
+
+# Skill: Write Code
+
+## Purpose
+
+Implement exactly one task from PLAN.md — completely and correctly.
+
+## Pre-Coding Checklist
+
+Before writing a single line:
+- [ ] REQUIREMENTS.md read — know allowed libraries
+- [ ] DESIGN.md read — know design tokens to use
+- [ ] Task description clear — know exact scope
+- [ ] Library API verified — use Context7 MCP if uncertain
+
+## Implementation Rules
+
+| Rule | Detail |
+|------|--------|
+| Scope | Exactly the task. Nothing more. |
+| Dependencies | Only from REQUIREMENTS.md |
+| Types | TypeScript strict mode. No `any`. |
+| Error handling | All async operations must handle failure |
+| Design | Use exact values from DESIGN.md |
+| Env vars | Never hardcode. Use process.env. |
+
+## Code Patterns
+
+### React/Next.js Component
+
+```typescript
+// Named export, functional, typed props
+export function ComponentName({ prop }: { prop: string }) {
+  return (
+    <div className="...">
+      {prop}
+    </div>
+  )
+}
+```
+
+### Supabase Query
+
+```typescript
+const { data, error } = await supabase
+  .from('table')
+  .select('*')
+  .eq('user_id', userId)
+
+if (error) {
+  console.error('Failed to fetch:', error.message)
+  throw new Error(error.message)
+}
+```
+
+### API Route (Next.js)
+
+```typescript
+export async function GET(request: Request) {
+  try {
+    // ... logic
+    return Response.json({ data })
+  } catch (error) {
+    return Response.json({ error: 'Internal error' }, { status: 500 })
+  }
+}
+```
+
+## After Coding
+
+Run L1 verification:
+```bash
+npm run build && npm run typecheck && npm run lint
+```
+
+If any fail → fix before reporting done.
+
+## Completion Report
+
+```
+✅ {task name} implemented
+
+Files:
+- {file}: {change description}
+
+L1: ✅ Build • TypeScript • Lint all clean
+```

package/templates/project/DECISIONS.md

@@ -0,0 +1,24 @@
+# Decision Log — {Project Name}
+
+A running log of all significant technical and product decisions made during this project.
+This prevents re-debating settled questions and documents the reasoning for future reference.
+
+---
+
+## How to Use
+
+Add an entry whenever you:
+- Choose one technology over another
+- Change direction on a feature
+- Fix a non-obvious bug
+- Make a UX trade-off
+
+**Format**: `## {date} — {short title}`
+
+---
+
+## {date} — Project Started
+
+- **Decision**: Started project "{name}"
+- **Context**: {one sentence on the idea}
+- **Stack**: {one-line summary of chosen tech}

package/templates/project/DESIGN.md

@@ -0,0 +1,141 @@
+# Design System — {Project Name}
+
+**Status**: DRAFT 📝
+**Locked on**: (not yet locked)
+
+---
+
+## Brand Direction
+
+{1-2 sentences describing the visual mood and what the design communicates}
+
+---
+
+## Colors
+
+### Primary
+| Token | Hex | Use |
+|-------|-----|-----|
+| primary-50 | #{hex} | Light background tints |
+| primary-500 | #{hex} | Main brand color |
+| primary-700 | #{hex} | Hover states |
+| primary-900 | #{hex} | Text on light backgrounds |
+
+### Secondary
+| Token | Hex | Use |
+|-------|-----|-----|
+| secondary-500 | #{hex} | Supporting color |
+
+### Accent
+| Token | Hex | Use |
+|-------|-----|-----|
+| accent-500 | #{hex} | CTAs and highlights |
+
+### Neutrals
+| Token | Hex | Use |
+|-------|-----|-----|
+| neutral-50 | #{hex} | Page background |
+| neutral-100 | #{hex} | Card background |
+| neutral-300 | #{hex} | Dividers, borders |
+| neutral-600 | #{hex} | Secondary text |
+| neutral-900 | #{hex} | Primary text |
+
+### Semantic
+| Token | Hex | Use |
+|-------|-----|-----|
+| success | #{hex} | Success states |
+| error | #{hex} | Error states |
+| warning | #{hex} | Warning states |
+| info | #{hex} | Info states |
+
+### Dark Mode
+| Token | Hex | Use |
+|-------|-----|-----|
+| dark-bg | #{hex} | Page background |
+| dark-surface | #{hex} | Card background |
+| dark-text | #{hex} | Primary text |
+
+---
+
+## Typography
+
+**Font Family**: {font name}
+**Google Fonts URL**: {url}
+
+| Scale | Size | Weight | Line Height | Use |
+|-------|------|--------|-------------|-----|
+| xs | 12px | 400 | 1.4 | Captions |
+| sm | 14px | 400 | 1.5 | Labels |
+| base | 16px | 400 | 1.6 | Body text |
+| lg | 18px | 500 | 1.5 | Emphasized body |
+| xl | 20px | 600 | 1.4 | Section headings |
+| 2xl | 24px | 700 | 1.3 | Page headings |
+| 3xl | 30px | 700 | 1.2 | Hero headings |
+| 4xl | 36px | 800 | 1.1 | Display |
+
+---
+
+## Spacing
+
+Base unit: 4px
+
+| Token | Value | Use |
+|-------|-------|-----|
+| xs | 4px | Tight gaps |
+| sm | 8px | Small gaps |
+| md | 16px | Default padding |
+| lg | 24px | Section gaps |
+| xl | 32px | Large sections |
+| 2xl | 48px | Page sections |
+| 3xl | 64px | Hero padding |
+
+---
+
+## Component Styles
+
+**Border Radius**: {value}px
+**Shadow**: {description (e.g., "0 1px 3px rgba(0,0,0,0.1)")}
+**Button style**: {filled / outlined / ghost}
+
+---
+
+## CSS Variables
+
+```css
+:root {
+  /* Colors */
+  --color-primary: #{hex};
+  --color-secondary: #{hex};
+  --color-accent: #{hex};
+  --bg-page: #{hex};
+  --bg-surface: #{hex};
+  --text-primary: #{hex};
+  --text-secondary: #{hex};
+  --color-success: #{hex};
+  --color-error: #{hex};
+  
+  /* Typography */
+  --font-sans: '{font}', sans-serif;
+  --text-base: 16px;
+  
+  /* Spacing */
+  --space-md: 16px;
+  --space-lg: 24px;
+  
+  /* Shapes */
+  --radius: {value}px;
+  --radius-lg: {value*2}px;
+  --radius-full: 9999px;
+  
+  /* Shadows */
+  --shadow-sm: 0 1px 3px rgba(0,0,0,0.1);
+  --shadow-md: 0 4px 16px rgba(0,0,0,0.12);
+}
+```
+
+---
+
+## Change Policy
+
+This document is locked after `/design` approval.
+To change the design system: run `/design` and get explicit approval.

package/templates/project/PLAN.md

@@ -0,0 +1,63 @@
+# Build Plan — {Project Name}
+
+**Status**: DRAFT 📝
+**Approved on**: (not yet approved)
+
+---
+
+## How to Use
+
+- Run `/build` for each unchecked task in order
+- Check the box when a task completes L1+L2 verification
+- Do not skip tasks — each builds on the previous
+
+**Task sizes**: S = ~15 min | M = ~30 min | L = ~1 hour
+
+---
+
+## Phase 4 Tasks
+
+### 🛠 Setup
+- [ ] Initialize project with {framework} — S
+- [ ] Install all dependencies from REQUIREMENTS.md — S
+- [ ] Configure environment variables (.env) — S
+- [ ] Set up database schema — M
+- [ ] Configure auth provider — M
+
+---
+
+### 📄 {Page/Feature Name} — {S/M/L}
+
+- [ ] {Specific implementation task}
+- [ ] {Specific implementation task}
+- [ ] {Specific implementation task}
+
+---
+
+### 📄 {Page/Feature Name} — {S/M/L}
+
+- [ ] {Specific implementation task}
+- [ ] {Specific implementation task}
+
+---
+
+### 🔗 Integration
+
+- [ ] Auth flow end-to-end (sign up → login → protected route) — M
+- [ ] API connections tested — S
+- [ ] Error states implemented — S
+- [ ] Loading states implemented — S
+
+---
+
+### ✨ Polish
+
+- [ ] Responsive layout verified — S
+- [ ] Empty states implemented — S
+- [ ] Final UI consistency pass — M
+
+---
+
+## Completed Tasks Archive
+
+<!-- Move completed tasks here as they are done -->

package/templates/project/REQUIREMENTS.md

@@ -0,0 +1,46 @@
+# Requirements — {Project Name}
+
+**Status**: DRAFT 📝
+**Locked on**: (not yet locked)
+
+---
+
+## Platform
+
+{Web App / Mobile iOS+Android / Desktop / Backend API / Other}
+
+---
+
+## Stack
+
+| Category | Technology | Version | Purpose |
+|----------|-----------|---------|---------|
+| Framework | {name} | {x.x} | {one sentence} |
+| Database | {name} | {x.x} | {one sentence} |
+| Auth | {name} | {x.x} | {one sentence} |
+| UI Components | {name} | {x.x} | {one sentence} |
+| Styling | {name} | {x.x} | {one sentence} |
+| State | {name} | {x.x} | {one sentence} |
+| Deploy | {name} | {x.x} | {one sentence} |
+
+---
+
+## All Libraries
+
+| Library | Version | Purpose |
+|---------|---------|---------|
+| {library} | {version} | {purpose} |
+
+---
+
+## Out of Scope (v1)
+
+- {feature or technology not included — and why}
+
+---
+
+## Change Policy
+
+This document is locked after `/requirements` approval.
+To change anything here: run `/requirements` and get explicit approval.
+Any library NOT listed here must be approved before use.