codex-genesis-harness 0.1.0 → 0.1.4

package/.codex/skills/spec-impact-engine/templates/migration-guide.md

@@ -0,0 +1,223 @@
+# Migration Guide: {{CHANGE_TITLE}}
+
+**Version**: {{OLD_VERSION}} → {{NEW_VERSION}}  
+**Change Type**: {{CHANGE_TYPE}} <!-- BREAKING | DEPRECATION | FEATURE -->  
+**Severity**: {{SEVERITY}}  
+**Published**: {{DATE}}  
+**Deadline**: {{MIGRATION_DEADLINE}} <!-- "Immediate" | "Before vX.Y" | "No deadline" -->  
+
+---
+
+## Overview
+
+{{CHANGE_OVERVIEW_PARAGRAPH}}
+
+This guide explains what changed, why it changed, and the exact steps to migrate your code.
+
+**Estimated migration time**: {{ESTIMATED_MIGRATION_TIME}}
+
+---
+
+## What Changed
+
+### Before ({{OLD_VERSION}})
+
+```{{CODE_LANG}}
+{{OLD_EXAMPLE_CODE}}
+```
+
+### After ({{NEW_VERSION}})
+
+```{{CODE_LANG}}
+{{NEW_EXAMPLE_CODE}}
+```
+
+### Key Differences
+
+| Aspect | Before | After |
+|--------|--------|-------|
+| {{ASPECT_1}} | {{BEFORE_1}} | {{AFTER_1}} |
+| {{ASPECT_2}} | {{BEFORE_2}} | {{AFTER_2}} |
+| {{ASPECT_3}} | {{BEFORE_3}} | {{AFTER_3}} |
+
+---
+
+## Why It Changed
+
+{{REASON_FOR_CHANGE}}
+
+**Business context**: {{BUSINESS_REASON}}  
+**Technical context**: {{TECHNICAL_REASON}}  
+**Alternative considered**: {{ALTERNATIVE_CONSIDERED}} — rejected because {{REJECTION_REASON}}
+
+---
+
+## Migration Steps
+
+### Step 1: {{STEP_1_TITLE}}
+
+{{STEP_1_DESCRIPTION}}
+
+```{{CODE_LANG}}
+// Before
+{{STEP_1_BEFORE_CODE}}
+
+// After
+{{STEP_1_AFTER_CODE}}
+```
+
+**Verification**: {{STEP_1_VERIFICATION}}
+
+---
+
+### Step 2: {{STEP_2_TITLE}}
+
+{{STEP_2_DESCRIPTION}}
+
+```{{CODE_LANG}}
+// Before
+{{STEP_2_BEFORE_CODE}}
+
+// After
+{{STEP_2_AFTER_CODE}}
+```
+
+**Verification**: {{STEP_2_VERIFICATION}}
+
+---
+
+### Step 3: {{STEP_3_TITLE}} (if applicable)
+
+{{STEP_3_DESCRIPTION}}
+
+```{{CODE_LANG}}
+// Before
+{{STEP_3_BEFORE_CODE}}
+
+// After
+{{STEP_3_AFTER_CODE}}
+```
+
+**Verification**: {{STEP_3_VERIFICATION}}
+
+---
+
+## Code Search Patterns
+
+Use these patterns to find all affected code in your codebase:
+
+```bash
+# Find usages of the old field/method/endpoint
+grep -rn "{{OLD_PATTERN}}" src/
+grep -rn "{{OLD_PATTERN}}" tests/
+grep -rn "{{OLD_PATTERN}}" playwright/
+
+# After migration, verify no old pattern remains
+grep -rn "{{OLD_PATTERN}}" . --include="*.ts" --include="*.js" --include="*.json"
+# Should return 0 results
+```
+
+---
+
+## Affected File Types
+
+| File Pattern | Change Required | Example |
+|-------------|----------------|---------|
+| `src/api/**/*.ts` | {{API_CHANGE}} | `{{API_EXAMPLE}}` |
+| `tests/**/*.test.ts` | {{TEST_CHANGE}} | `{{TEST_EXAMPLE}}` |
+| `types/**/*.ts` | {{TYPE_CHANGE}} | `{{TYPE_EXAMPLE}}` |
+| `contracts/**/*.json` | {{CONTRACT_CHANGE}} | `{{CONTRACT_EXAMPLE}}` |
+
+---
+
+## Common Migration Pitfalls
+
+### ❌ Pitfall 1: {{PITFALL_1_TITLE}}
+
+**Symptom**: {{PITFALL_1_SYMPTOM}}
+
+**Incorrect approach**:
+```{{CODE_LANG}}
+{{PITFALL_1_WRONG_CODE}}
+```
+
+**Correct approach**:
+```{{CODE_LANG}}
+{{PITFALL_1_CORRECT_CODE}}
+```
+
+---
+
+### ❌ Pitfall 2: {{PITFALL_2_TITLE}}
+
+**Symptom**: {{PITFALL_2_SYMPTOM}}
+
+**Incorrect approach**:
+```{{CODE_LANG}}
+{{PITFALL_2_WRONG_CODE}}
+```
+
+**Correct approach**:
+```{{CODE_LANG}}
+{{PITFALL_2_CORRECT_CODE}}
+```
+
+---
+
+## Validation Checklist
+
+After completing migration, verify:
+
+- [ ] All uses of `{{OLD_PATTERN}}` replaced with `{{NEW_PATTERN}}`
+- [ ] TypeScript compiles without errors: `tsc --noEmit`
+- [ ] Unit tests pass: `npm test`
+- [ ] Integration tests pass: `npm run test:integration`
+- [ ] E2E tests pass: `npx playwright test`
+- [ ] No `{{OLD_PATTERN}}` in grep results
+- [ ] API responses match new contract schema
+- [ ] Breaking change entry in SPEC_CHANGELOG.md
+
+---
+
+## Rollback Plan
+
+If migration causes unexpected issues:
+
+```bash
+# Option 1: Revert specific files
+git revert HEAD -- path/to/affected/file.ts
+
+# Option 2: Revert entire migration commit
+git revert <migration-commit-hash>
+
+# After rollback:
+npm test  # Verify passing again
+# Then investigate the issue before re-attempting migration
+```
+
+**Rollback window**: {{ROLLBACK_DEADLINE}}  
+**Note**: {{ROLLBACK_NOTE}}
+
+---
+
+## Support
+
+- **Questions**: Open an issue or ask in `#dev-help` Slack channel
+- **Bug reports**: Tag `migration-{{OLD_VERSION}}-to-{{NEW_VERSION}}`
+- **Emergency contact**: {{EMERGENCY_CONTACT}}
+
+---
+
+## Timeline
+
+| Date | Milestone |
+|------|-----------|
+| {{DATE}} | Migration guide published |
+| {{DEADLINE_SOFT}} | Recommended migration complete |
+| {{DEADLINE_HARD}} | Old API/field/behavior removed |
+| {{REMOVAL_DATE}} | {{OLD_VERSION}} support dropped |
+
+---
+
+*Generated by spec-impact-engine v1.0 | Genesis Codex Harness*  
+*Last updated: {{DATE}}*

package/.codex/skills/ui-ux-test-skill/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: ui-ux-test-skill
+description: Create UI smoke, e2e, interaction, validation, API synchronization, and visual regression tests before frontend changes. Use for screens, flows, forms, dashboards, and UI regressions.
+---
+
+# UI UX Test Skill
+
+## Purpose
+Make UI quality measurable through Playwright and fixture-backed tests.
+
+## When to use
+Use before implementing or upgrading UI routes, states, interactions, or visual behavior.
+
+## When NOT to use
+Do not use for non-UI changes.
+
+## Inputs required
+Route, role, viewport, API fixture, user actions, expected UI states, and visual references.
+
+## Outputs required
+Playwright test plan, fixtures, visual regression expectations, and API sync assertions.
+
+## Required tests
+Load, interaction, validation, API synchronization, and visual regression tests.
+
+## Required fixtures
+Create route fixtures under `playwright/fixtures/`.
+
+## Required contract updates
+Update `contracts/ui/` for every changed screen state.
+
+## Required codebase map updates
+Update `.codebase/UI_ROUTES.md` and `TEST_MATRIX.md`.
+
+## Token saving rules
+Read UI route map and fixture first; inspect only the route and components under test.
+
+## Acceptance criteria
+The UI has automated coverage for key workflows and visual states.
+
+## Common mistakes
+Testing only page load, skipping mobile, and ignoring API synchronization.
+
+## Recovery workflow
+If visual tests are flaky, stabilize fixtures and selectors before changing assertions.
+

package/.codex/skills/ui-ux-test-skill/agents/openai.yaml

@@ -0,0 +1,7 @@
+interface:
+  display_name: "UI UX Test Skill"
+  short_description: "Create UI and visual regression tests"
+  default_prompt: "Use $ui-ux-test-skill to create Playwright tests before UI changes."
+policy:
+  allow_implicit_invocation: true
+

package/.codex/skills/ui-ux-test-skill/checklists/checklist.md

@@ -0,0 +1,8 @@
+# UI Test Checklist
+
+- [ ] Load test.
+- [ ] Interaction test.
+- [ ] Validation test.
+- [ ] API sync test.
+- [ ] Visual regression test.
+

package/.codex/skills/ui-ux-test-skill/examples/example.md

@@ -0,0 +1,4 @@
+# Example
+
+Test dashboard load, filter interaction, validation message, API response sync, and desktop/mobile screenshots.
+

package/.codex/skills/ui-ux-test-skill/templates/playwright-test-template.md

@@ -0,0 +1,4 @@
+# Playwright Test Template
+
+Use `playwright/e2e`, `playwright/smoke`, `playwright/visual`, and `playwright/fixtures`.
+

package/.codex-plugin/plugin.json

@@ -1,9 +1,9 @@
 {
-  "name": "project-genesis-harness",
+  "name": "genesis-skill-set",
   "version": "0.1.0",
-  "description": "Codex project operating harness for planning, tracking, verification, docs sync, and reviews.",
+  "description": "Genesis harness skill system for Codex test-first, contract-first, memory-aware autonomous workflows.",
   "author": {
-    "name": "Project Genesis Harness"
+    "name": "Genesis Skill Set"
   },
   "license": "MIT",
   "keywords": [
@@ -11,23 +11,25 @@
     "skill",
     "planning",
     "verification",
-    "engineering"
+    "engineering",
+    "design",
+    "frontend"
   ],
   "skills": "./.codex/skills/",
   "interface": {
-    "displayName": "Project Genesis Harness",
-    "shortDescription": "Planning and verification harness for Codex",
-    "longDescription": "A Codex plugin that installs the project-genesis-harness skill for disciplined project initialization, feature planning, bug workflows, documentation synchronization, verification, audits, and completion reports.",
-    "developerName": "Project Genesis Harness",
+    "displayName": "Genesis Skill Set",
+    "shortDescription": "Test-first, contract-first Codex harness skills",
+    "longDescription": "A Codex plugin that installs the Genesis harness skill system: planning, architecture, codebase mapping, design specs, API contracts, UI tests, AI provider reliability, pipeline orchestration, research, docs, release workflows, repository memory, contracts, fixtures, Playwright templates, observability templates, and frontend design skills.",
+    "developerName": "Genesis Skill Set",
     "category": "Productivity",
     "capabilities": [
       "Write",
       "Review"
     ],
     "defaultPrompt": [
-      "Use $project-genesis-harness and run /init.",
-      "Use $project-genesis-harness to plan this feature.",
-      "Use $project-genesis-harness to audit this repo."
+      "Use $genesis-harness and run /genesis-init.",
+      "Use $pipeline-orchestration-skill to run the full test-first harness workflow.",
+      "Use $api-contract-skill to create endpoint contracts and tests before implementation."
     ],
     "brandColor": "#2563EB"
   }