codex-genesis-harness 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (231) hide show
  1. package/.codebase/API_CONTRACTS.md +12 -0
  2. package/.codebase/ARCHITECTURE.md +6 -0
  3. package/.codebase/CURRENT_STATE.md +6 -0
  4. package/.codebase/DEPENDENCY_GRAPH.md +14 -0
  5. package/.codebase/DOMAIN_MODELS.md +8 -0
  6. package/.codebase/EVOLUTION_PLAN.md +35 -0
  7. package/.codebase/KNOWN_PROBLEMS.md +6 -0
  8. package/.codebase/MODULE_INDEX.md +13 -0
  9. package/.codebase/PIPELINE_FLOW.md +14 -0
  10. package/.codebase/TEST_MATRIX.md +11 -0
  11. package/.codebase/UI_ROUTES.md +4 -0
  12. package/.codebase/context/backend-summary.md +4 -0
  13. package/.codebase/context/frontend-summary.md +4 -0
  14. package/.codebase/context/pipeline-summary.md +4 -0
  15. package/.codebase/context/providers-summary.md +4 -0
  16. package/.codebase/context/render-summary.md +4 -0
  17. package/.codebase/context/tests-summary.md +4 -0
  18. package/.codex/skills/ai-provider-skill/SKILL.md +46 -0
  19. package/.codex/skills/ai-provider-skill/agents/openai.yaml +7 -0
  20. package/.codex/skills/ai-provider-skill/checklists/checklist.md +9 -0
  21. package/.codex/skills/ai-provider-skill/examples/example.md +4 -0
  22. package/.codex/skills/ai-provider-skill/templates/provider-contract-template.md +9 -0
  23. package/.codex/skills/api-contract-skill/SKILL.md +46 -0
  24. package/.codex/skills/api-contract-skill/agents/openai.yaml +7 -0
  25. package/.codex/skills/api-contract-skill/checklists/checklist.md +8 -0
  26. package/.codex/skills/api-contract-skill/examples/example.md +4 -0
  27. package/.codex/skills/api-contract-skill/templates/api-contract-template.md +4 -0
  28. package/.codex/skills/architecture-skill/SKILL.md +46 -0
  29. package/.codex/skills/architecture-skill/agents/openai.yaml +7 -0
  30. package/.codex/skills/architecture-skill/checklists/checklist.md +8 -0
  31. package/.codex/skills/architecture-skill/examples/example.md +4 -0
  32. package/.codex/skills/architecture-skill/templates/architecture-decision-template.md +14 -0
  33. package/.codex/skills/codebase-map-skill/SKILL.md +46 -0
  34. package/.codex/skills/codebase-map-skill/agents/openai.yaml +7 -0
  35. package/.codex/skills/codebase-map-skill/checklists/checklist.md +7 -0
  36. package/.codex/skills/codebase-map-skill/examples/example.md +4 -0
  37. package/.codex/skills/codebase-map-skill/templates/map-update-template.md +8 -0
  38. package/.codex/skills/design-spec-skill/SKILL.md +46 -0
  39. package/.codex/skills/design-spec-skill/agents/openai.yaml +7 -0
  40. package/.codex/skills/design-spec-skill/checklists/checklist.md +7 -0
  41. package/.codex/skills/design-spec-skill/examples/example.md +4 -0
  42. package/.codex/skills/design-spec-skill/templates/design-spec-template.md +9 -0
  43. package/.codex/skills/docs-skill/SKILL.md +46 -0
  44. package/.codex/skills/docs-skill/agents/openai.yaml +7 -0
  45. package/.codex/skills/docs-skill/checklists/checklist.md +7 -0
  46. package/.codex/skills/docs-skill/examples/example.md +4 -0
  47. package/.codex/skills/docs-skill/templates/docs-update-template.md +8 -0
  48. package/.codex/skills/{project-genesis-harness → genesis-harness}/SKILL.md +43 -4
  49. package/.codex/skills/genesis-harness/agents/openai.yaml +9 -0
  50. package/.codex/skills/genesis-harness/checklists/checklist.md +10 -0
  51. package/.codex/skills/genesis-harness/examples/example.md +4 -0
  52. package/.codex/skills/genesis-harness/templates/harness-workflow-template.md +10 -0
  53. package/.codex/skills/genesis-new-design/SKILL.md +95 -0
  54. package/.codex/skills/genesis-new-design/agents/openai.yaml +4 -0
  55. package/.codex/skills/genesis-new-design/checklists/checklist.md +8 -0
  56. package/.codex/skills/genesis-new-design/examples/example.md +4 -0
  57. package/.codex/skills/genesis-new-design/templates/new-design-template.md +9 -0
  58. package/.codex/skills/genesis-upgrade-design/SKILL.md +97 -0
  59. package/.codex/skills/genesis-upgrade-design/agents/openai.yaml +4 -0
  60. package/.codex/skills/genesis-upgrade-design/checklists/checklist.md +8 -0
  61. package/.codex/skills/genesis-upgrade-design/examples/example.md +4 -0
  62. package/.codex/skills/genesis-upgrade-design/templates/upgrade-design-template.md +9 -0
  63. package/.codex/skills/harness-engineering-skill/SKILL.md +45 -0
  64. package/.codex/skills/harness-engineering-skill/agents/openai.yaml +7 -0
  65. package/.codex/skills/harness-engineering-skill/checklists/checklist.md +8 -0
  66. package/.codex/skills/harness-engineering-skill/examples/example.md +4 -0
  67. package/.codex/skills/harness-engineering-skill/templates/harness-change-template.md +8 -0
  68. package/.codex/skills/pipeline-orchestration-skill/SKILL.md +46 -0
  69. package/.codex/skills/pipeline-orchestration-skill/agents/openai.yaml +7 -0
  70. package/.codex/skills/pipeline-orchestration-skill/checklists/checklist.md +12 -0
  71. package/.codex/skills/pipeline-orchestration-skill/examples/example.md +4 -0
  72. package/.codex/skills/pipeline-orchestration-skill/templates/orchestration-template.md +12 -0
  73. package/.codex/skills/planning-skill/SKILL.md +46 -0
  74. package/.codex/skills/planning-skill/agents/openai.yaml +7 -0
  75. package/.codex/skills/planning-skill/checklists/checklist.md +8 -0
  76. package/.codex/skills/planning-skill/examples/example.md +4 -0
  77. package/.codex/skills/planning-skill/templates/plan-template.md +11 -0
  78. package/.codex/skills/release-skill/SKILL.md +46 -0
  79. package/.codex/skills/release-skill/agents/openai.yaml +7 -0
  80. package/.codex/skills/release-skill/checklists/checklist.md +8 -0
  81. package/.codex/skills/release-skill/examples/example.md +4 -0
  82. package/.codex/skills/release-skill/templates/release-checklist-template.md +9 -0
  83. package/.codex/skills/research-skill/SKILL.md +46 -0
  84. package/.codex/skills/research-skill/agents/openai.yaml +7 -0
  85. package/.codex/skills/research-skill/checklists/checklist.md +7 -0
  86. package/.codex/skills/research-skill/examples/example.md +4 -0
  87. package/.codex/skills/research-skill/templates/research-note-template.md +9 -0
  88. package/.codex/skills/ui-ux-test-skill/SKILL.md +46 -0
  89. package/.codex/skills/ui-ux-test-skill/agents/openai.yaml +7 -0
  90. package/.codex/skills/ui-ux-test-skill/checklists/checklist.md +8 -0
  91. package/.codex/skills/ui-ux-test-skill/examples/example.md +4 -0
  92. package/.codex/skills/ui-ux-test-skill/templates/playwright-test-template.md +4 -0
  93. package/.codex-plugin/plugin.json +13 -11
  94. package/README.md +164 -181
  95. package/bin/genesis-harness.js +124 -79
  96. package/contracts/agents/CharacterBibleAgent/error.json +1 -0
  97. package/contracts/agents/CharacterBibleAgent/example.json +1 -0
  98. package/contracts/agents/CharacterBibleAgent/request.json +1 -0
  99. package/contracts/agents/CharacterBibleAgent/response.json +1 -0
  100. package/contracts/agents/CharacterBibleAgent/schema.json +1 -0
  101. package/contracts/agents/ImageGenerationAgent/error.json +1 -0
  102. package/contracts/agents/ImageGenerationAgent/example.json +1 -0
  103. package/contracts/agents/ImageGenerationAgent/request.json +1 -0
  104. package/contracts/agents/ImageGenerationAgent/response.json +1 -0
  105. package/contracts/agents/ImageGenerationAgent/schema.json +1 -0
  106. package/contracts/agents/PipelineOrchestrator/error.json +1 -0
  107. package/contracts/agents/PipelineOrchestrator/example.json +1 -0
  108. package/contracts/agents/PipelineOrchestrator/request.json +1 -0
  109. package/contracts/agents/PipelineOrchestrator/response.json +1 -0
  110. package/contracts/agents/PipelineOrchestrator/schema.json +1 -0
  111. package/contracts/agents/PromptGenerationAgent/error.json +1 -0
  112. package/contracts/agents/PromptGenerationAgent/example.json +1 -0
  113. package/contracts/agents/PromptGenerationAgent/request.json +1 -0
  114. package/contracts/agents/PromptGenerationAgent/response.json +1 -0
  115. package/contracts/agents/PromptGenerationAgent/schema.json +1 -0
  116. package/contracts/agents/RenderAgent/error.json +1 -0
  117. package/contracts/agents/RenderAgent/example.json +1 -0
  118. package/contracts/agents/RenderAgent/request.json +1 -0
  119. package/contracts/agents/RenderAgent/response.json +1 -0
  120. package/contracts/agents/RenderAgent/schema.json +1 -0
  121. package/contracts/agents/ScenePlanningAgent/error.json +1 -0
  122. package/contracts/agents/ScenePlanningAgent/example.json +1 -0
  123. package/contracts/agents/ScenePlanningAgent/request.json +1 -0
  124. package/contracts/agents/ScenePlanningAgent/response.json +1 -0
  125. package/contracts/agents/ScenePlanningAgent/schema.json +1 -0
  126. package/contracts/agents/ScreenplayAgent/error.json +1 -0
  127. package/contracts/agents/ScreenplayAgent/example.json +1 -0
  128. package/contracts/agents/ScreenplayAgent/request.json +1 -0
  129. package/contracts/agents/ScreenplayAgent/response.json +1 -0
  130. package/contracts/agents/ScreenplayAgent/schema.json +1 -0
  131. package/contracts/agents/StoryAnalysisAgent/error.json +1 -0
  132. package/contracts/agents/StoryAnalysisAgent/example.json +1 -0
  133. package/contracts/agents/StoryAnalysisAgent/request.json +1 -0
  134. package/contracts/agents/StoryAnalysisAgent/response.json +1 -0
  135. package/contracts/agents/StoryAnalysisAgent/schema.json +1 -0
  136. package/contracts/agents/SubtitleGenerationAgent/error.json +1 -0
  137. package/contracts/agents/SubtitleGenerationAgent/example.json +1 -0
  138. package/contracts/agents/SubtitleGenerationAgent/request.json +1 -0
  139. package/contracts/agents/SubtitleGenerationAgent/response.json +1 -0
  140. package/contracts/agents/SubtitleGenerationAgent/schema.json +1 -0
  141. package/contracts/agents/VoiceGenerationAgent/error.json +1 -0
  142. package/contracts/agents/VoiceGenerationAgent/example.json +1 -0
  143. package/contracts/agents/VoiceGenerationAgent/request.json +1 -0
  144. package/contracts/agents/VoiceGenerationAgent/response.json +1 -0
  145. package/contracts/agents/VoiceGenerationAgent/schema.json +1 -0
  146. package/contracts/api/README.md +4 -0
  147. package/contracts/api/endpoint-template/error.json +7 -0
  148. package/contracts/api/endpoint-template/example.json +11 -0
  149. package/contracts/api/endpoint-template/request.json +7 -0
  150. package/contracts/api/endpoint-template/response.json +6 -0
  151. package/contracts/api/endpoint-template/schema.json +9 -0
  152. package/contracts/events/README.md +4 -0
  153. package/contracts/events/event-template/error.json +4 -0
  154. package/contracts/events/event-template/example.json +6 -0
  155. package/contracts/events/event-template/request.json +6 -0
  156. package/contracts/events/event-template/response.json +3 -0
  157. package/contracts/events/event-template/schema.json +8 -0
  158. package/contracts/ui/README.md +4 -0
  159. package/contracts/ui/screen-template/error.json +4 -0
  160. package/contracts/ui/screen-template/example.json +7 -0
  161. package/contracts/ui/screen-template/request.json +4 -0
  162. package/contracts/ui/screen-template/response.json +4 -0
  163. package/contracts/ui/screen-template/schema.json +8 -0
  164. package/fixtures/agents/agent-fixture-template.md +14 -0
  165. package/fixtures/api/api-fixture-template.md +14 -0
  166. package/fixtures/images/image-fixture-template.md +14 -0
  167. package/fixtures/pipeline/pipeline-fixture-template.md +14 -0
  168. package/fixtures/render/render-fixture-template.md +14 -0
  169. package/fixtures/tts/tts-fixture-template.md +14 -0
  170. package/fixtures/videos/video-fixture-template.md +14 -0
  171. package/observability/agent-runs/agent-run-template.md +22 -0
  172. package/observability/decision-logs/decision-log-template.md +18 -0
  173. package/observability/failures/failure-template.md +18 -0
  174. package/package.json +8 -2
  175. package/playwright/e2e/e2e-template.md +4 -0
  176. package/playwright/fixtures/ui-fixture-template.md +4 -0
  177. package/playwright/smoke/smoke-template.md +4 -0
  178. package/playwright/visual/visual-regression-template.md +4 -0
  179. package/scripts/install.sh +64 -39
  180. package/scripts/run-evals.sh +61 -22
  181. package/scripts/uninstall.sh +40 -20
  182. package/scripts/verify.sh +234 -55
  183. package/tests/contracts/contract-template.test.md +10 -0
  184. package/tests/fixtures/fixture-index.md +4 -0
  185. package/tests/integration/integration-template.test.md +4 -0
  186. package/tests/unit/unit-template.test.md +4 -0
  187. package/.codex/skills/project-genesis-harness/agents/openai.yaml +0 -9
  188. /package/.codex/skills/{project-genesis-harness → genesis-harness}/references/planning-schema.md +0 -0
  189. /package/.codex/skills/{project-genesis-harness → genesis-harness}/references/quality-rubric.md +0 -0
  190. /package/.codex/skills/{project-genesis-harness → genesis-harness}/references/research-rubric.md +0 -0
  191. /package/.codex/skills/{project-genesis-harness → genesis-harness}/references/workflows.md +0 -0
  192. /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/agents-template.md +0 -0
  193. /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/api-docs-template.md +0 -0
  194. /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/architecture-template.md +0 -0
  195. /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/audit-template.md +0 -0
  196. /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/bug-template.md +0 -0
  197. /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/check-template.md +0 -0
  198. /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/conventions-template.md +0 -0
  199. /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/decision-template.md +0 -0
  200. /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/design-template.md +0 -0
  201. /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/escalation-template.md +0 -0
  202. /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/feature-template.md +0 -0
  203. /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/integrations-template.md +0 -0
  204. /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/journeys-template.md +0 -0
  205. /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/lessons-learned-template.md +0 -0
  206. /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/observability-template.md +0 -0
  207. /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/phase-template.md +0 -0
  208. /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/pitfalls-template.md +0 -0
  209. /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/planning-tree-template.md +0 -0
  210. /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/project-template.md +0 -0
  211. /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/quality-score-template.md +0 -0
  212. /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/requirements-template.md +0 -0
  213. /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/research-template.md +0 -0
  214. /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/review-template.md +0 -0
  215. /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/spec-changelog-template.md +0 -0
  216. /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/stack-template.md +0 -0
  217. /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/verification-template.md +0 -0
  218. /package/.codex/skills/{project-genesis-harness → genesis-harness}/scripts/check-architecture-boundaries.sh +0 -0
  219. /package/.codex/skills/{project-genesis-harness → genesis-harness}/scripts/check-docs-sync.sh +0 -0
  220. /package/.codex/skills/{project-genesis-harness → genesis-harness}/scripts/check-no-debug-logs.sh +0 -0
  221. /package/.codex/skills/{project-genesis-harness → genesis-harness}/scripts/check-required-planning-files.sh +0 -0
  222. /package/.codex/skills/{project-genesis-harness → genesis-harness}/scripts/check-spec-changelog.sh +0 -0
  223. /package/.codex/skills/{project-genesis-harness → genesis-harness}/scripts/check-task-tracking.sh +0 -0
  224. /package/.codex/skills/{project-genesis-harness → genesis-harness}/scripts/create-adr.sh +0 -0
  225. /package/.codex/skills/{project-genesis-harness → genesis-harness}/scripts/create-bug.sh +0 -0
  226. /package/.codex/skills/{project-genesis-harness → genesis-harness}/scripts/create-feature.sh +0 -0
  227. /package/.codex/skills/{project-genesis-harness → genesis-harness}/scripts/detect-stack.sh +0 -0
  228. /package/.codex/skills/{project-genesis-harness → genesis-harness}/scripts/init-planning.sh +0 -0
  229. /package/.codex/skills/{project-genesis-harness → genesis-harness}/scripts/list-changed-files.sh +0 -0
  230. /package/.codex/skills/{project-genesis-harness → genesis-harness}/scripts/run-verification.sh +0 -0
  231. /package/.codex/skills/{project-genesis-harness → genesis-harness}/scripts/update-state.sh +0 -0
@@ -0,0 +1,7 @@
1
+ # Docs Checklist
2
+
3
+ - [ ] README updated.
4
+ - [ ] AGENTS remains short.
5
+ - [ ] Memory updated.
6
+ - [ ] Verify passed.
7
+
@@ -0,0 +1,4 @@
1
+ # Example
2
+
3
+ After adding a CLI flag, update README usage, AGENTS map, and codebase module index.
4
+
@@ -0,0 +1,8 @@
1
+ # Docs Update Template
2
+
3
+ ## Public Change
4
+ ## Docs Updated
5
+ ## Memory Updated
6
+ ## Verification
7
+ ## Remaining Gaps
8
+
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: project-genesis-harness
2
+ name: genesis-harness
3
3
  description: Initialize and operate a project planning harness for Codex. Use this skill when the user types /init, asks to create a new project, add a feature, fix a bug, plan work, generate tests first, update docs, track phases, review changes, audit a repository, or manage architecture decisions.
4
4
  ---
5
5
 
@@ -7,9 +7,48 @@ description: Initialize and operate a project planning harness for Codex. Use th
7
7
 
8
8
  This skill turns Codex into a project operating harness.
9
9
 
10
- Codex must not behave like a simple code generator. Codex must behave like a disciplined engineering agent that understands the project before coding, confirms missing product intent, researches the repository and best practices, plans before implementation, defines tests or verification first, keeps docs synchronized with code, tracks tasks explicitly, records bug lessons, maintains architecture diagrams, reviews changed files after implementation, removes unnecessary changes, and escalates when human judgment is required.
11
-
12
- ## Core Principle
10
+ Codex must not behave like a simple code generator. Codex must behave like a disciplined engineering agent that understands the project before coding, confirms missing product intent, researches the repository and best practices, plans before implementation, defines tests or verification first, keeps docs synchronized with code, tracks tasks explicitly, records bug lessons, maintains architecture diagrams, reviews changed files after implementation, removes unnecessary changes, and escalates when human judgment is required.
11
+
12
+ ## Purpose
13
+ Operate a repository through test-first, contract-first, memory-aware Codex workflows.
14
+
15
+ ## When to use
16
+ Use for project initialization, planning, feature work, bug fixes, audits, reviews, verification, and repository memory updates.
17
+
18
+ ## When NOT to use
19
+ Do not use for simple read-only answers that do not require repository workflow or durable artifacts.
20
+
21
+ ## Inputs required
22
+ Read `.codebase/CURRENT_STATE.md`, `.codebase/MODULE_INDEX.md`, and `.codebase/TEST_MATRIX.md` when present, then inspect only relevant files.
23
+
24
+ ## Outputs required
25
+ Plan or implementation artifact, tests, fixtures, verification evidence, docs sync, and codebase memory updates.
26
+
27
+ ## Required tests
28
+ Create or update failing tests before implementation.
29
+
30
+ ## Required fixtures
31
+ Create fixtures for expected inputs, outputs, validation notes, and recovery cases.
32
+
33
+ ## Required contract updates
34
+ Update API, agent, event, or UI contracts when public behavior changes.
35
+
36
+ ## Required codebase map updates
37
+ Update `.codebase` memory after meaningful changes.
38
+
39
+ ## Token saving rules
40
+ Read summaries before source files, maps before modules, and avoid loading the entire repository.
41
+
42
+ ## Acceptance criteria
43
+ Work is complete only when tests pass, contracts and docs are current, and verification evidence is reported.
44
+
45
+ ## Common mistakes
46
+ Implementing before tests, skipping fixtures, overloading `AGENTS.md`, and duplicating long context across skills.
47
+
48
+ ## Recovery workflow
49
+ If blocked or interrupted, reread current state, rerun verification, identify the first failing phase, and resume from that point.
50
+
51
+ ## Core Principle
13
52
 
14
53
  Do not code first.
15
54
 
@@ -0,0 +1,9 @@
1
+ interface:
2
+ display_name: "Genesis Harness"
3
+ short_description: "Plan, track, verify, and review projects"
4
+ brand_color: "#2563EB"
5
+ default_prompt: "Use $genesis-harness to initialize planning and operate this repository with test-first workflows."
6
+
7
+ policy:
8
+ allow_implicit_invocation: true
9
+
@@ -0,0 +1,10 @@
1
+ # Genesis Harness Checklist
2
+
3
+ - [ ] Read memory first.
4
+ - [ ] Create failing test.
5
+ - [ ] Create fixture.
6
+ - [ ] Update contract.
7
+ - [ ] Implement minimum change.
8
+ - [ ] Verify.
9
+ - [ ] Update docs and memory.
10
+
@@ -0,0 +1,4 @@
1
+ # Example
2
+
3
+ Use `$genesis-harness` to initialize planning, create a feature folder, define tests first, verify, and update `.codebase`.
4
+
@@ -0,0 +1,10 @@
1
+ # Harness Workflow Template
2
+
3
+ ## Intent
4
+ ## Failing Test
5
+ ## Fixture
6
+ ## Contract
7
+ ## Implementation
8
+ ## Verification
9
+ ## Memory Update
10
+
@@ -0,0 +1,95 @@
1
+ ---
2
+ name: genesis-new-design
3
+ description: Create premium frontend web designs and usable first-screen experiences for new websites, web apps, dashboards, tools, and landing pages. Use when Codex is asked to design or build a new frontend UI, create a fresh page or app experience, choose a visual direction for a new product surface, or turn a product brief into implementation-ready React, Next.js, Tailwind, CSS, or HTML.
4
+ ---
5
+
6
+ # Genesis New Design
7
+
8
+ Use this skill for greenfield frontend web design. Build the actual usable experience first, not a placeholder, explanation page, or generic marketing shell unless the user explicitly asks for one.
9
+
10
+ ## Purpose
11
+ Create new frontend web experiences with testable UI contracts, fixtures, visual states, and verification.
12
+
13
+ ## When to use
14
+ Use when building a new web page, app screen, dashboard, tool, landing page, or frontend flow.
15
+
16
+ ## When NOT to use
17
+ Do not use for redesigning existing UI without first preserving behavior; use `genesis-upgrade-design` instead.
18
+
19
+ ## Inputs required
20
+ Product intent, target users, primary workflow, stack details, route or entry point, state list, and visual constraints.
21
+
22
+ ## Outputs required
23
+ Implemented UI, UI contract, fixtures, responsive states, visual verification, and docs or memory updates.
24
+
25
+ ## Required tests
26
+ Create UI load, interaction, validation, API sync, and visual checks where practical before implementation.
27
+
28
+ ## Required fixtures
29
+ Create UI fixtures for default, loading, empty, error, and success states.
30
+
31
+ ## Required contract updates
32
+ Update `contracts/ui/` and API contracts for changed UI/API behavior.
33
+
34
+ ## Required codebase map updates
35
+ Update `.codebase/UI_ROUTES.md`, frontend summary, and test matrix.
36
+
37
+ ## Token saving rules
38
+ Read UI route maps and summaries first; inspect only relevant components, routes, and styles.
39
+
40
+ ## Acceptance criteria
41
+ The UI renders correctly on desktop/mobile, supports expected states, and passes available checks.
42
+
43
+ ## Common mistakes
44
+ Building a marketing page instead of the requested app, using placeholder content, and skipping error/empty states.
45
+
46
+ ## Recovery workflow
47
+ If visual output fails, capture screenshot evidence, update the fixture or contract, then apply the smallest design correction.
48
+
49
+ ## Workflow
50
+
51
+ 1. Inspect the project stack before choosing patterns:
52
+ - Read package/config files and existing app structure.
53
+ - Use installed UI, icon, styling, animation, and routing libraries. Do not add dependencies unless explicitly requested.
54
+ - Match the framework version and styling system already present.
55
+
56
+ 2. Define the design intent from the request:
57
+ - Identify audience, product category, primary task, density, tone, and constraints.
58
+ - Choose one clear visual direction and commit to it across typography, color, spacing, surfaces, iconography, and motion.
59
+ - For tools, dashboards, and operational apps, prioritize scanning, repeated use, compact controls, and predictable navigation over decorative hero layouts.
60
+
61
+ 3. Build complete UI states:
62
+ - Include default, loading, empty, error, hover, active, focus, disabled, and responsive states when the surface supports them.
63
+ - Use real draft copy and plausible data. Do not use lorem ipsum, "John Doe", "Acme", or vague AI copy.
64
+ - Use icons for common actions and tool controls. Avoid emojis in UI code, text, alt text, and labels.
65
+
66
+ 4. Use visual assets intentionally:
67
+ - Websites and branded/product pages need relevant images, screenshots, generated bitmap assets, or concrete product visuals when appropriate.
68
+ - Do not rely on decorative blobs, generic gradients, or meaningless illustrations.
69
+ - Keep images inspectable and useful for the user, not dark, blurred, or purely atmospheric.
70
+
71
+ 5. Verify the result:
72
+ - Run the project checks that prove the UI compiles.
73
+ - Start the local dev server when needed.
74
+ - Capture screenshots for visual work and inspect desktop/mobile layouts for overlap, clipping, unreadable text, blank canvases, and broken assets.
75
+
76
+ ## Design Rules
77
+
78
+ - Use strong hierarchy: clear title scale, restrained supporting copy, and compact labels inside dense UI.
79
+ - Use responsive structure with stable dimensions for fixed-format controls, grids, boards, counters, and toolbars.
80
+ - Prefer CSS Grid for multi-column layouts; avoid fragile percentage math.
81
+ - Use `min-height: 100dvh` instead of `100vh` for viewport-height sections.
82
+ - Animate only `transform` and `opacity`; avoid scroll listeners for visual effects.
83
+ - Keep cards purposeful. Do not put cards inside cards or turn every page section into a floating card.
84
+ - Avoid one-note palettes and the default purple/blue AI gradient look.
85
+ - Keep border radius moderate unless the existing design system requires otherwise.
86
+ - Ensure text never overlaps adjacent content or escapes buttons, cards, sidebars, tabs, or toolbars.
87
+
88
+ ## Anti-Patterns
89
+
90
+ - Do not create a landing page when the request is for an app, game, dashboard, editor, or tool.
91
+ - Do not explain the product's features in visible UI instead of building the feature.
92
+ - Do not use oversized hero typography inside compact app panels.
93
+ - Do not invent new design systems when the repo already has component conventions.
94
+ - Do not introduce new dependencies, fonts, animation libraries, or icon libraries without checking the repo and getting explicit approval.
95
+ - Do not finish without verification evidence for the code and the rendered layout.
@@ -0,0 +1,4 @@
1
+ interface:
2
+ display_name: "Genesis New Design"
3
+ short_description: "Create premium frontend web designs"
4
+ default_prompt: "Use $genesis-new-design to design and build a premium frontend web experience."
@@ -0,0 +1,8 @@
1
+ # New Design Checklist
2
+
3
+ - [ ] Stack inspected.
4
+ - [ ] UI contract written.
5
+ - [ ] Fixtures created.
6
+ - [ ] Responsive states verified.
7
+ - [ ] Visual check completed.
8
+
@@ -0,0 +1,4 @@
1
+ # Example
2
+
3
+ Use `$genesis-new-design` to build a new dashboard first screen with loading, empty, error, and success states.
4
+
@@ -0,0 +1,9 @@
1
+ # New Design Template
2
+
3
+ ## Product Intent
4
+ ## Primary Workflow
5
+ ## UI States
6
+ ## Contracts
7
+ ## Fixtures
8
+ ## Verification
9
+
@@ -0,0 +1,97 @@
1
+ ---
2
+ name: genesis-upgrade-design
3
+ description: Upgrade existing frontend web UI quality without changing behavior. Use when Codex is asked to redesign, polish, modernize, improve UX, make an app look premium, clean up AI-looking UI, improve responsive layout, audit visual quality, or apply targeted design upgrades to existing React, Next.js, Tailwind, CSS, HTML, dashboard, app, or website code.
4
+ ---
5
+
6
+ # Genesis Upgrade Design
7
+
8
+ Use this skill for existing frontend projects. Improve what is there; do not rewrite the product or change behavior unless the user explicitly asks.
9
+
10
+ ## Purpose
11
+ Upgrade existing frontend web UI quality while preserving behavior, contracts, and accessibility.
12
+
13
+ ## When to use
14
+ Use for visual polish, redesigns, responsive fixes, interaction states, UI audits, and anti-slop cleanup.
15
+
16
+ ## When NOT to use
17
+ Do not use for greenfield UI creation; use `genesis-new-design` instead.
18
+
19
+ ## Inputs required
20
+ Current UI routes, components, styling system, screenshots when available, behavior constraints, and verification commands.
21
+
22
+ ## Outputs required
23
+ Targeted UI improvements, before/after evidence, preserved behavior, updated tests, fixtures, contracts, and memory.
24
+
25
+ ## Required tests
26
+ Create or update regression tests for changed screens, interactions, validation, and visual states before implementation.
27
+
28
+ ## Required fixtures
29
+ Create fixtures for existing and expected UI states.
30
+
31
+ ## Required contract updates
32
+ Update `contracts/ui/` only when the intended UI state contract changes.
33
+
34
+ ## Required codebase map updates
35
+ Update UI routes, frontend summary, and test matrix.
36
+
37
+ ## Token saving rules
38
+ Read summaries and route maps first; inspect only affected UI files and shared styling primitives.
39
+
40
+ ## Acceptance criteria
41
+ Behavior is preserved, UI quality improves, responsive states work, and verification passes.
42
+
43
+ ## Common mistakes
44
+ Rewriting instead of upgrading, changing data flow, and improving only the happy path.
45
+
46
+ ## Recovery workflow
47
+ If behavior changes unintentionally, restore the contract expectation, add a regression test, and narrow the UI diff.
48
+
49
+ ## Workflow
50
+
51
+ 1. Audit before editing:
52
+ - Inspect routes, components, styling system, theme tokens, assets, and package dependencies.
53
+ - Identify the primary user workflows and the UI surfaces that matter most.
54
+ - Capture or run the current UI when feasible so changes can be compared.
55
+
56
+ 2. Preserve behavior:
57
+ - Keep routing, data flow, public APIs, form semantics, state contracts, accessibility semantics, and test expectations intact.
58
+ - Reuse existing components, utilities, variables, icons, and layout primitives.
59
+ - Avoid broad rewrites. Make targeted changes that raise quality with the smallest safe diff.
60
+
61
+ 3. Upgrade visual quality:
62
+ - Improve typography scale, line height, copy rhythm, alignment, and scanability.
63
+ - Normalize spacing, containers, grid tracks, button sizing, toolbar density, and responsive breakpoints.
64
+ - Replace generic AI patterns: centered sameness, card spam, purple/blue glow defaults, placeholder content, weak empty states, and decorative clutter.
65
+ - Add or improve loading, empty, error, hover, active, focus, and disabled states where the existing UI lacks them.
66
+ - Use images or product visuals only when they clarify the product or user task.
67
+
68
+ 4. Harden responsive and interaction details:
69
+ - Check mobile and desktop viewports for overflow, clipping, overlap, unreadable text, and layout jumps.
70
+ - Use stable dimensions for repeated controls and fixed-format UI.
71
+ - Animate only `transform` and `opacity`; avoid effects that trigger layout or continuous repainting.
72
+ - Keep keyboard focus visible and preserve accessible labels.
73
+
74
+ 5. Verify and compare:
75
+ - Run lint/typecheck/tests/build that are available for the project.
76
+ - Start the dev server when visual validation requires it.
77
+ - Capture screenshots after changes and inspect important states and viewports.
78
+ - If reference screenshots or a target design are provided, compare against them before claiming completion.
79
+
80
+ ## Upgrade Heuristics
81
+
82
+ - Operational tools should feel quiet, dense, and work-focused.
83
+ - Marketing and brand pages should make the product, place, offer, or brand obvious in the first viewport.
84
+ - Dashboards should prioritize scanability, tabular alignment, filters, state visibility, and repeated action speed.
85
+ - Forms should use labels above inputs, helper/error text below inputs, visible focus, and inline validation.
86
+ - Navigation should clearly show current location and avoid dead links.
87
+ - Copy should be specific and plain. Avoid "Elevate", "Seamless", "Unleash", "Next-Gen", "Game-changer", "Delve", and "In the world of...".
88
+
89
+ ## Completion Bar
90
+
91
+ Do not call the upgrade complete until:
92
+
93
+ - Existing behavior is preserved.
94
+ - The changed UI renders correctly at desktop and mobile sizes.
95
+ - Core interactions have hover/active/focus states.
96
+ - No text overlap, clipped controls, broken assets, or blank primary surfaces remain.
97
+ - Verification commands have passed, or any skipped checks are reported with the reason.
@@ -0,0 +1,4 @@
1
+ interface:
2
+ display_name: "Genesis Upgrade Design"
3
+ short_description: "Upgrade existing frontend UI quality"
4
+ default_prompt: "Use $genesis-upgrade-design to improve the existing frontend UI without changing behavior."
@@ -0,0 +1,8 @@
1
+ # Upgrade Design Checklist
2
+
3
+ - [ ] Existing behavior documented.
4
+ - [ ] Regression test written.
5
+ - [ ] Targeted UI diff only.
6
+ - [ ] Desktop and mobile checked.
7
+ - [ ] API sync preserved.
8
+
@@ -0,0 +1,4 @@
1
+ # Example
2
+
3
+ Use `$genesis-upgrade-design` to improve an existing dashboard without changing filters, routing, or API calls.
4
+
@@ -0,0 +1,9 @@
1
+ # Upgrade Design Template
2
+
3
+ ## Current UI
4
+ ## Weaknesses
5
+ ## Preserved Behavior
6
+ ## Regression Tests
7
+ ## Targeted Upgrade
8
+ ## Verification
9
+
@@ -0,0 +1,45 @@
1
+ ---
2
+ name: harness-engineering-skill
3
+ description: "Evolve the Codex harness itself: verification loops, repository memory, test-first scaffolds, resumability, observability, and autonomous workflow reliability. Use for changes to this repository's skill system or harness architecture."
4
+ ---
5
+
6
+ # Harness Engineering Skill
7
+
8
+ ## Purpose
9
+ Optimize the harness, not just prompts, so Codex work is testable, resumable, and verifiable.
10
+
11
+ ## When to use
12
+ Use for changes to skills, scripts, contracts, fixtures, memory, observability, and workflow rules.
13
+
14
+ ## When NOT to use
15
+ Do not use for downstream application feature implementation.
16
+
17
+ ## Inputs required
18
+ Current state, module index, test matrix, target workflow, verification gap, and expected artifact.
19
+
20
+ ## Outputs required
21
+ Failing harness test, minimum harness change, updated docs, updated memory, and run log template when relevant.
22
+
23
+ ## Required tests
24
+ Update `scripts/verify.sh` or `scripts/run-evals.sh` before implementation.
25
+
26
+ ## Required fixtures
27
+ Create fixture templates proving the workflow can be repeated.
28
+
29
+ ## Required contract updates
30
+ Update contracts when harness behavior changes public skill or CLI behavior.
31
+
32
+ ## Required codebase map updates
33
+ Update `.codebase` memory after every harness evolution.
34
+
35
+ ## Token saving rules
36
+ Use `.codebase` summaries before opening skills. Avoid duplicating long instructions across skills.
37
+
38
+ ## Acceptance criteria
39
+ The harness change fails first, passes after implementation, and is documented in memory.
40
+
41
+ ## Common mistakes
42
+ Adding prose without validation, duplicating context, and skipping install/package smoke tests.
43
+
44
+ ## Recovery workflow
45
+ If a harness change breaks install or verify, revert to the last passing contract and add a regression test.
@@ -0,0 +1,7 @@
1
+ interface:
2
+ display_name: "Harness Engineering Skill"
3
+ short_description: "Improve Codex harness reliability"
4
+ default_prompt: "Use $harness-engineering-skill to evolve the harness with tests first."
5
+ policy:
6
+ allow_implicit_invocation: true
7
+
@@ -0,0 +1,8 @@
1
+ # Harness Engineering Checklist
2
+
3
+ - [ ] Verify fails first.
4
+ - [ ] Minimum scaffold added.
5
+ - [ ] Verify passes.
6
+ - [ ] Package dry-run passes.
7
+ - [ ] Memory updated.
8
+
@@ -0,0 +1,4 @@
1
+ # Example
2
+
3
+ Add verify assertions for a missing contract directory, watch verify fail, then add the contract scaffold.
4
+
@@ -0,0 +1,8 @@
1
+ # Harness Change Template
2
+
3
+ ## Failing Test
4
+ ## Fixture
5
+ ## Minimum Change
6
+ ## Verification
7
+ ## Memory Update
8
+
@@ -0,0 +1,46 @@
1
+ ---
2
+ name: pipeline-orchestration-skill
3
+ description: Run end-to-end Codex harness orchestration phases from repository analysis through tests, fixtures, implementation, contracts, memory, docs, and change summaries. Use for autonomous multi-phase work.
4
+ ---
5
+
6
+ # Pipeline Orchestration Skill
7
+
8
+ ## Purpose
9
+ Make autonomous work phase-gated, resumable, observable, and impossible to complete without verification.
10
+
11
+ ## When to use
12
+ Use for end-to-end implementation, multi-session work, or pipelines with several dependent agents.
13
+
14
+ ## When NOT to use
15
+ Do not use for small read-only questions.
16
+
17
+ ## Inputs required
18
+ Goal, current state, module index, test matrix, contracts, fixtures, and acceptance criteria.
19
+
20
+ ## Outputs required
21
+ Phase logs, tests, fixtures, implementation, contracts, memory updates, docs updates, and change summary.
22
+
23
+ ## Required tests
24
+ Create failing tests in Phase 1 before implementation.
25
+
26
+ ## Required fixtures
27
+ Create fixtures in Phase 2 before implementation.
28
+
29
+ ## Required contract updates
30
+ Update contracts in Phase 5 and verify implementation matches them.
31
+
32
+ ## Required codebase map updates
33
+ Update `.codebase` in Phase 6.
34
+
35
+ ## Token saving rules
36
+ Never scan the whole repo first. Read memory, map, and test matrix before source.
37
+
38
+ ## Acceptance criteria
39
+ No phase is skipped and the final report includes verification evidence.
40
+
41
+ ## Common mistakes
42
+ Combining phases, implementing before fixtures, and leaving state non-resumable.
43
+
44
+ ## Recovery workflow
45
+ If interrupted, resume from the last completed phase log and rerun verification before continuing.
46
+
@@ -0,0 +1,7 @@
1
+ interface:
2
+ display_name: "Pipeline Orchestration Skill"
3
+ short_description: "Run phase-gated autonomous workflows"
4
+ default_prompt: "Use $pipeline-orchestration-skill to execute the full test-first harness workflow."
5
+ policy:
6
+ allow_implicit_invocation: true
7
+
@@ -0,0 +1,12 @@
1
+ # Pipeline Checklist
2
+
3
+ - [ ] Phase 0 complete.
4
+ - [ ] Phase 1 failing tests observed.
5
+ - [ ] Phase 2 fixtures created.
6
+ - [ ] Phase 3 minimum code only.
7
+ - [ ] Phase 4 tests pass.
8
+ - [ ] Phase 5 contracts updated.
9
+ - [ ] Phase 6 memory updated.
10
+ - [ ] Phase 7 docs updated.
11
+ - [ ] Phase 8 summary written.
12
+
@@ -0,0 +1,4 @@
1
+ # Example
2
+
3
+ Resume a feature by reading phase logs, rerunning tests, and continuing from the first incomplete phase.
4
+
@@ -0,0 +1,12 @@
1
+ # Orchestration Template
2
+
3
+ ## Phase 0 Analyze Repository
4
+ ## Phase 1 Create Failing Tests
5
+ ## Phase 2 Create Fixtures
6
+ ## Phase 3 Implement Minimum Code
7
+ ## Phase 4 Pass Tests
8
+ ## Phase 5 Update Contracts
9
+ ## Phase 6 Update Codebase Memory
10
+ ## Phase 7 Update Docs
11
+ ## Phase 8 Generate Change Summary
12
+
@@ -0,0 +1,46 @@
1
+ ---
2
+ name: planning-skill
3
+ description: Create decision-complete plans for Codex harness work, including tests, fixtures, contracts, memory updates, verification, and recovery. Use for new features, refactors, bug fixes, audits, or multi-phase autonomous work.
4
+ ---
5
+
6
+ # Planning Skill
7
+
8
+ ## Purpose
9
+ Turn intent into a test-first, contract-first, resumable implementation plan.
10
+
11
+ ## When to use
12
+ Use before any non-trivial change, multi-file task, bug fix, refactor, or autonomous workflow.
13
+
14
+ ## When NOT to use
15
+ Do not use for direct answers that require no repository mutation.
16
+
17
+ ## Inputs required
18
+ Read `.codebase/CURRENT_STATE.md`, `.codebase/MODULE_INDEX.md`, `.codebase/TEST_MATRIX.md`, plus relevant contracts.
19
+
20
+ ## Outputs required
21
+ Goal, success criteria, tests, fixtures, contracts, implementation phases, verification, memory updates, and rollback path.
22
+
23
+ ## Required tests
24
+ Define the first failing test and expected failure reason.
25
+
26
+ ## Required fixtures
27
+ List exact fixture files and expected outputs.
28
+
29
+ ## Required contract updates
30
+ Identify contract files that must be created or changed.
31
+
32
+ ## Required codebase map updates
33
+ List `.codebase` files to update after implementation.
34
+
35
+ ## Token saving rules
36
+ Plan from memory summaries first; inspect only files needed to remove uncertainty.
37
+
38
+ ## Acceptance criteria
39
+ An implementer can execute without making design decisions.
40
+
41
+ ## Common mistakes
42
+ Planning implementation before tests, omitting fixtures, and leaving verification vague.
43
+
44
+ ## Recovery workflow
45
+ If a plan becomes invalid, update the failing test and fixture first, then revise phases.
46
+
@@ -0,0 +1,7 @@
1
+ interface:
2
+ display_name: "Planning Skill"
3
+ short_description: "Create test-first harness plans"
4
+ default_prompt: "Use $planning-skill to create a decision-complete test-first plan."
5
+ policy:
6
+ allow_implicit_invocation: true
7
+
@@ -0,0 +1,8 @@
1
+ # Planning Checklist
2
+
3
+ - [ ] Test first.
4
+ - [ ] Fixture created.
5
+ - [ ] Contract identified.
6
+ - [ ] Verification command known.
7
+ - [ ] Memory update listed.
8
+
@@ -0,0 +1,4 @@
1
+ # Example
2
+
3
+ Plan a new endpoint by defining contract, fixture, failing contract test, implementation, verification, and memory update.
4
+
@@ -0,0 +1,11 @@
1
+ # Plan Template
2
+
3
+ ## Goal
4
+ ## Tests First
5
+ ## Fixtures
6
+ ## Contracts
7
+ ## Implementation Phases
8
+ ## Verification
9
+ ## Memory Updates
10
+ ## Recovery
11
+