wize-dev-kit 0.1.0

package/src/tea-skills/wize-tea-gate/workflow.md

@@ -0,0 +1,51 @@
+---
+code: wize-tea-gate
+name: TEA Gate Decision
+gate: gate
+owner: wize-agent-test-architect   # Hawkeye
+when: story-final
+status: stub
+---
+
+# TEA — Gate Decision
+
+**Goal.** Final per-story gate. PASS / CONCERNS / FAIL / WAIVED with documented rationale.
+
+## Inputs
+- `design.md`, `trace.md`, `review.md` for the story
+- `nfr/{epic}.md` if applicable
+- Story file
+
+## Output
+- `.wize/implementation/tea/{epic}/{story}/gate.md`
+
+## YAML frontmatter (canonical)
+```yaml
+---
+gate: gate
+story_id: …
+status: PASS | CONCERNS | FAIL | WAIVED
+score: 0-100
+policy: advisory | enforcing
+inputs:
+  - design.md: …
+  - trace.md: …
+  - review.md: …
+  - nfr/{epic}.md: …
+findings:
+  - id: G-1
+    severity: low | medium | high
+    summary: …
+    recommendation: …
+waived_by: null | "wizer"
+waived_reason: null | "…"
+created_at: ISO-8601
+---
+```
+
+## Body
+Narrative explanation; structured data is the YAML.
+
+## Policy
+- **advisory** (default): FAIL is a warning. Merge proceeds.
+- **enforcing**: FAIL blocks merge via CI. Configured in `.wize/config/tea.toml`.

package/src/tea-skills/wize-tea-nfr/workflow.md

@@ -0,0 +1,37 @@
+---
+code: wize-tea-nfr
+name: TEA NFR Assessment
+gate: nfr
+owner: wize-agent-test-architect   # Hawkeye
+when: pre-merge-per-epic
+status: stub
+---
+
+# TEA — NFR Assessment
+
+**Goal.** Verify the epic meets Fury's NFR principles: performance, security, reliability, maintainability, accessibility, cost.
+
+## Inputs
+- `.wize/planning/nfr-principles.md`
+- Code from all stories in the epic
+- Telemetry/benchmark output
+
+## Output
+- `.wize/implementation/tea/nfr/{epic}.md`
+
+## YAML frontmatter
+```yaml
+---
+gate: nfr
+epic: …
+status: PASS | CONCERNS | FAIL | WAIVED
+scores:
+  performance: …
+  security: …
+  reliability: …
+  maintainability: …
+  accessibility: …
+  cost: …
+findings: [...]
+---
+```

package/src/tea-skills/wize-tea-review/workflow.md

@@ -0,0 +1,35 @@
+---
+code: wize-tea-review
+name: TEA Story Review
+gate: review
+owner: wize-agent-test-architect   # Hawkeye
+when: story-end
+status: stub
+---
+
+# TEA — Story Review
+
+**Goal.** Structured story review (separate from Shuri's `wize-code-review`).
+
+## Inputs
+- Story file (ACs)
+- Test results
+- Trace doc
+
+## Output
+- `.wize/implementation/tea/{epic}/{story}/review.md`
+
+## YAML frontmatter
+```yaml
+---
+gate: review
+story_id: …
+status: PASS | CONCERNS | FAIL
+ac_check:
+  - id: AC-1
+    met: true|partial|false
+    evidence: …
+findings: [...]
+recommendations: [...]
+---
+```

package/src/tea-skills/wize-tea-risk/workflow.md

@@ -0,0 +1,39 @@
+---
+code: wize-tea-risk
+name: TEA Risk Profile
+gate: risk
+owner: wize-agent-test-architect   # Hawkeye
+when: once-after-architecture
+status: stub
+---
+
+# TEA — Risk Profile
+
+**Goal.** Build the probability × impact matrix that prioritizes the rest of TEA's work.
+
+## Inputs
+- `.wize/solutioning/architecture.md`
+- `.wize/solutioning/epics/`
+
+## Output
+- `.wize/implementation/tea/risk-profile.md`
+
+## YAML frontmatter (canonical)
+```yaml
+---
+gate: risk
+status: PASS | CONCERNS | FAIL | WAIVED
+score: 0-100
+created_at: ISO-8601
+findings:
+  - id: R-1
+    area: …
+    probability: low | medium | high
+    impact: low | medium | high
+    rationale: …
+    mitigation: …
+---
+```
+
+## Body
+Narrative summary; the structured data is the YAML.

package/src/tea-skills/wize-tea-trace/workflow.md

@@ -0,0 +1,36 @@
+---
+code: wize-tea-trace
+name: TEA Traceability
+gate: trace
+owner: wize-agent-test-architect   # Hawkeye
+when: during-or-after-implementation
+status: stub
+---
+
+# TEA — Traceability
+
+**Goal.** Map every Acceptance Criterion to one or more concrete tests in the repo.
+
+## Inputs
+- Story file (ACs)
+- Test files produced by Shuri
+
+## Output
+- `.wize/implementation/tea/{epic}/{story}/trace.md`
+
+## YAML frontmatter
+```yaml
+---
+gate: trace
+story_id: …
+status: PASS | CONCERNS | FAIL
+coverage:
+  - ac_id: AC-1
+    tests:
+      - path/to/test.spec.ts::case-name
+    status: covered | partial | missing
+---
+```
+
+## Body
+For any `missing` or `partial`, propose what to write.

package/src/web-overlay/module.yaml

@@ -0,0 +1,41 @@
+code: web-overlay
+name: "Wize Web Dev (overlay)"
+description: "Web-stack extension: scaffolds (Next/Vue/Astro/Laravel/SvelteKit), SEO audit, deploy flows, WCAG playbook for Mantis, Playwright/Vitest playbook for Hawkeye."
+default_selected: false
+required: false
+overlay_of: method
+
+# Stack catalog (referenced by Tony during architecture interview):
+stack_catalog:
+  - Next.js + React + Tailwind
+  - Vue / Nuxt + Tailwind
+  - SvelteKit
+  - Astro
+  - Remix
+  - Laravel + Vue / Inertia
+  - Supabase backends
+  - Drizzle / Prisma ORMs
+
+# Extra artifacts:
+artifacts:
+  - ".wize/planning/web/seo-strategy.md"
+  - ".wize/planning/web/analytics-plan.md"
+  - ".wize/planning/ux/design-tokens.json"
+
+skills:
+  - code: wize-web-scaffold
+    description: "Scaffold a web app skeleton per chosen stack (Next/Vue/etc)."
+  - code: wize-web-seo-audit
+    description: "Audit SEO basics: sitemap, meta tags, structured data, Core Web Vitals."
+  - code: wize-web-deploy
+    description: "Generate deploy playbook (Vercel, Cloudflare, Fly, Coolify, etc)."
+
+# Playbooks added to existing agents:
+agent_playbooks:
+  wize-agent-ux-designer:
+    - "playbooks/wcag-aa.md"
+    - "playbooks/responsive-breakpoints.md"
+    - "playbooks/semantic-html.md"
+  wize-agent-test-architect:
+    - "playbooks/playwright-vitest.md"
+    - "playbooks/web-perf-budgets.md"

package/src/web-overlay/wize-web-deploy/workflow.md

@@ -0,0 +1,26 @@
+---
+code: wize-web-deploy
+name: Web Deploy Playbook
+overlay: web
+owner: wize-agent-architect   # Tony
+status: stub
+---
+
+# Web Deploy Playbook
+
+**Goal.** Document the deploy path: provider, environments, secrets, rollback.
+
+## Inputs
+- `.wize/solutioning/architecture.md`
+- `.wize/planning/nfr-principles.md` (cost, reliability)
+
+## Output
+- `.wize/solutioning/deploy/web-deploy.md`
+
+## Sections
+- Provider (Vercel / Cloudflare / Fly / self-hosted Coolify / etc.)
+- Environments (dev / preview / prod)
+- Secrets management
+- Build/deploy commands
+- Smoke checks
+- Rollback procedure

package/src/web-overlay/wize-web-scaffold/workflow.md

@@ -0,0 +1,32 @@
+---
+code: wize-web-scaffold
+name: Web Scaffold
+overlay: web
+owner: wize-agent-architect   # Tony executes; Fury approves stack family
+status: stub
+---
+
+# Web Scaffold
+
+**Goal.** Scaffold an empty-but-runnable web app per chosen stack.
+
+## Supported stacks (catalog)
+- Next.js + React + Tailwind
+- Vue / Nuxt + Tailwind
+- SvelteKit
+- Astro
+- Remix
+- Laravel + Vue (Inertia)
+- Supabase backends
+- Drizzle / Prisma ORMs
+
+## Steps
+1. Stack interview (Tony asks; Fury approves).
+2. Run `npx create-{stack}` or the equivalent.
+3. Wire up design tokens from `.wize/solutioning/design-system/tokens.json`.
+4. Configure linter, formatter, and test runner.
+5. Generate baseline routes from `.wize/planning/ux/ux-design/`.
+6. Commit "initial scaffold (story E00-S01)".
+
+## Output
+- A bootable app + first commit.

package/src/web-overlay/wize-web-seo-audit/workflow.md

@@ -0,0 +1,22 @@
+---
+code: wize-web-seo-audit
+name: Web SEO Audit
+overlay: web
+owner: wize-agent-pm   # Maria Hill commissions; Mantis + Tony execute
+status: stub
+---
+
+# Web SEO Audit
+
+**Goal.** Audit SEO fundamentals before launch.
+
+## Checks
+- Sitemap + robots.txt
+- Per-page meta (title, description, OG, Twitter card)
+- Structured data (JSON-LD)
+- Core Web Vitals: LCP, INP, CLS
+- Hreflang (if multilingual)
+- 404 / 500 pages
+
+## Output
+- `.wize/planning/web/seo-audit-{YYYY-MM-DD}.md` with findings + actions.

package/tools/installer/detect.js

@@ -0,0 +1,43 @@
+/*
+ * Project detection — distinguishes greenfield from brownfield repos.
+ */
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+const SIGNALS = [
+  { file: 'package.json',  weight: 3, kind: 'js' },
+  { file: 'pubspec.yaml',  weight: 3, kind: 'flutter' },
+  { file: 'Cargo.toml',    weight: 3, kind: 'rust' },
+  { file: 'go.mod',        weight: 3, kind: 'go' },
+  { file: 'composer.json', weight: 3, kind: 'php' },
+  { file: 'pyproject.toml',weight: 3, kind: 'python' },
+  { file: 'Gemfile',       weight: 3, kind: 'ruby' },
+  { file: 'src',           weight: 2, kind: 'src-dir', isDir: true },
+  { file: 'app',           weight: 2, kind: 'app-dir', isDir: true },
+  { file: 'lib',           weight: 2, kind: 'lib-dir', isDir: true },
+  { file: 'README.md',     weight: 1, kind: 'docs' },
+  { file: 'docs',          weight: 1, kind: 'docs-dir', isDir: true }
+];
+
+function detect(rootDir = process.cwd()) {
+  const found = [];
+  let score = 0;
+  for (const s of SIGNALS) {
+    const p = path.join(rootDir, s.file);
+    const exists = fs.existsSync(p);
+    if (!exists) continue;
+    if (s.isDir && !fs.statSync(p).isDirectory()) continue;
+    found.push(s);
+    score += s.weight;
+  }
+  return {
+    brownfield: score >= 3,
+    score,
+    signals: found.map(s => s.file),
+    kinds: [...new Set(found.map(s => s.kind))]
+  };
+}
+
+module.exports = { detect };

package/tools/installer/onboarding.js

@@ -0,0 +1,32 @@
+/*
+ * Onboarding handoff — Wizer-driven triage after install.
+ *
+ * Stub: in v0.1 this just prints the first action Wizer would take.
+ * In a real run this would be a workflow executed by the active IDE adapter.
+ */
+'use strict';
+
+function compose(detection, profiles) {
+  const lines = [
+    '',
+    '╭─ Wizer ─────────────────────────────────────╮',
+    '│ Welcome back. What are we working on?       │',
+    '╰─────────────────────────────────────────────╯'
+  ];
+  if (detection.brownfield) {
+    lines.push('');
+    lines.push('I see this repo already has code. I can ask Pepper and Peggy to baseline it before we plan.');
+    lines.push('  → /wize-document-project');
+  }
+  lines.push('');
+  lines.push('When ready, name the next step:');
+  lines.push('  → /wize-product-brief          (Pepper)');
+  lines.push('  → /wize-create-prd             (Maria Hill, if brief exists)');
+  lines.push('  → /wize-create-architecture    (Tony, if PRD exists)');
+  lines.push('  → /wize-quick-dev              (Shuri, for small fixes)');
+  if (profiles.find(p => p.code === 'web-overlay')) lines.push('  → /wize-web-scaffold           (overlay)');
+  if (profiles.find(p => p.code === 'app-overlay')) lines.push('  → /wize-app-scaffold           (overlay)');
+  return lines.join('\n');
+}
+
+module.exports = { compose };

package/tools/installer/sync.js

@@ -0,0 +1,29 @@
+/*
+ * Adapter sync — regenerates IDE adapter files for each active target.
+ *
+ * Stub: in v0.1 this iterates the adapters/ folder and prints what would
+ * be generated. Actual file emission per IDE is a v0.2+ deliverable.
+ */
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+function syncAll(kitRoot, projectConfig) {
+  const adaptersDir = path.join(kitRoot, 'adapters');
+  if (!fs.existsSync(adaptersDir)) {
+    console.log('(skip) adapters/ not found');
+    return;
+  }
+  const active = projectConfig?.install?.ide_targets || ['claude-code', 'generic'];
+  for (const target of active) {
+    const dir = path.join(adaptersDir, target);
+    if (!fs.existsSync(dir)) {
+      console.log(`(warn) adapter "${target}" not found in adapters/`);
+      continue;
+    }
+    console.log(`→ would sync ${target} adapter (stub)`);
+  }
+}
+
+module.exports = { syncAll };

package/tools/installer/validators/run-all.js

@@ -0,0 +1,82 @@
+/*
+ * Validators — schema + lint + dry-run for kit assets.
+ *
+ * v0.1 scaffold: minimal structural checks. Real schema validation should
+ * use Ajv (json-schema) once a dependency budget is approved.
+ */
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+const { walkAgents, walkWorkflows, walkSkills } = require('./walk.js');
+
+function checkAgent(file) {
+  const content = fs.readFileSync(file, 'utf-8');
+  const errs = [];
+  if (!/^code:\s+wize-/m.test(content)) errs.push('missing or invalid "code:" prefix');
+  if (!/^name:/m.test(content))         errs.push('missing "name:"');
+  if (!/^title:/m.test(content))        errs.push('missing "title:"');
+  if (!/^description:/m.test(content))  errs.push('missing "description:"');
+  return errs;
+}
+
+function checkWorkflow(file) {
+  const content = fs.readFileSync(file, 'utf-8');
+  const errs = [];
+  if (!/^---\s*$/m.test(content))    errs.push('missing YAML frontmatter');
+  if (!/^code:\s+wize-/m.test(content)) errs.push('missing or invalid "code:" prefix');
+  if (!/^name:/m.test(content))      errs.push('missing "name:"');
+  if (!/^owner:/m.test(content) && !/^module:/m.test(content)) errs.push('missing "owner:" or "module:"');
+  return errs;
+}
+
+function runAll(kitRoot) {
+  const KIT = kitRoot || path.resolve(__dirname, '..', '..', '..');
+  let failures = 0, checked = 0;
+
+  console.log('\nValidating agents...');
+  for (const file of walkAgents(KIT)) {
+    checked++;
+    const errs = checkAgent(file);
+    if (errs.length) {
+      failures += errs.length;
+      console.log(`  ✖ ${path.relative(KIT, file)}`);
+      errs.forEach(e => console.log(`     - ${e}`));
+    }
+  }
+
+  console.log('\nValidating workflows...');
+  for (const file of walkWorkflows(KIT)) {
+    checked++;
+    const errs = checkWorkflow(file);
+    if (errs.length) {
+      failures += errs.length;
+      console.log(`  ✖ ${path.relative(KIT, file)}`);
+      errs.forEach(e => console.log(`     - ${e}`));
+    }
+  }
+
+  console.log('\nValidating skills...');
+  for (const file of walkSkills(KIT)) {
+    checked++;
+    const errs = checkWorkflow(file);   // same minimal shape
+    if (errs.length) {
+      failures += errs.length;
+      console.log(`  ✖ ${path.relative(KIT, file)}`);
+      errs.forEach(e => console.log(`     - ${e}`));
+    }
+  }
+
+  console.log(`\nChecked ${checked} files.`);
+  if (failures) {
+    console.log(`✖ ${failures} issue(s) found.`);
+    process.exit(1);
+  }
+  console.log('✓ All structural checks passed.');
+}
+
+if (require.main === module) {
+  runAll();
+}
+
+module.exports = runAll;

package/tools/installer/validators/walk.js

@@ -0,0 +1,40 @@
+/*
+ * Shallow walkers for kit assets — used by validators.
+ */
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+function* walk(rootDir, predicate) {
+  if (!fs.existsSync(rootDir)) return;
+  const stack = [rootDir];
+  while (stack.length) {
+    const dir = stack.pop();
+    let entries;
+    try { entries = fs.readdirSync(dir, { withFileTypes: true }); } catch { continue; }
+    for (const entry of entries) {
+      const full = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        if (entry.name === 'node_modules' || entry.name.startsWith('.')) continue;
+        stack.push(full);
+      } else if (entry.isFile() && predicate(entry.name, full)) {
+        yield full;
+      }
+    }
+  }
+}
+
+function walkAgents(kitRoot) {
+  return walk(path.join(kitRoot, 'src'), name => name === 'agent.yaml');
+}
+
+function walkWorkflows(kitRoot) {
+  return walk(path.join(kitRoot, 'src'), name => name === 'workflow.md');
+}
+
+function walkSkills(kitRoot) {
+  return walk(path.join(kitRoot, 'src'), name => name === 'skill.md');
+}
+
+module.exports = { walk, walkAgents, walkWorkflows, walkSkills };