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.
- package/.codebase/API_CONTRACTS.md +12 -0
- package/.codebase/ARCHITECTURE.md +6 -0
- package/.codebase/CURRENT_STATE.md +6 -0
- package/.codebase/DEPENDENCY_GRAPH.md +14 -0
- package/.codebase/DOMAIN_MODELS.md +8 -0
- package/.codebase/EVOLUTION_PLAN.md +35 -0
- package/.codebase/KNOWN_PROBLEMS.md +6 -0
- package/.codebase/MODULE_INDEX.md +13 -0
- package/.codebase/PIPELINE_FLOW.md +14 -0
- package/.codebase/TEST_MATRIX.md +11 -0
- package/.codebase/UI_ROUTES.md +4 -0
- package/.codebase/context/backend-summary.md +4 -0
- package/.codebase/context/frontend-summary.md +4 -0
- package/.codebase/context/pipeline-summary.md +4 -0
- package/.codebase/context/providers-summary.md +4 -0
- package/.codebase/context/render-summary.md +4 -0
- package/.codebase/context/tests-summary.md +4 -0
- package/.codex/skills/ai-provider-skill/SKILL.md +46 -0
- package/.codex/skills/ai-provider-skill/agents/openai.yaml +7 -0
- package/.codex/skills/ai-provider-skill/checklists/checklist.md +9 -0
- package/.codex/skills/ai-provider-skill/examples/example.md +4 -0
- package/.codex/skills/ai-provider-skill/templates/provider-contract-template.md +9 -0
- package/.codex/skills/api-contract-skill/SKILL.md +46 -0
- package/.codex/skills/api-contract-skill/agents/openai.yaml +7 -0
- package/.codex/skills/api-contract-skill/checklists/checklist.md +8 -0
- package/.codex/skills/api-contract-skill/examples/example.md +4 -0
- package/.codex/skills/api-contract-skill/templates/api-contract-template.md +4 -0
- package/.codex/skills/architecture-skill/SKILL.md +46 -0
- package/.codex/skills/architecture-skill/agents/openai.yaml +7 -0
- package/.codex/skills/architecture-skill/checklists/checklist.md +8 -0
- package/.codex/skills/architecture-skill/examples/example.md +4 -0
- package/.codex/skills/architecture-skill/templates/architecture-decision-template.md +14 -0
- package/.codex/skills/codebase-map-skill/SKILL.md +46 -0
- package/.codex/skills/codebase-map-skill/agents/openai.yaml +7 -0
- package/.codex/skills/codebase-map-skill/checklists/checklist.md +7 -0
- package/.codex/skills/codebase-map-skill/examples/example.md +4 -0
- package/.codex/skills/codebase-map-skill/templates/map-update-template.md +8 -0
- package/.codex/skills/design-spec-skill/SKILL.md +46 -0
- package/.codex/skills/design-spec-skill/agents/openai.yaml +7 -0
- package/.codex/skills/design-spec-skill/checklists/checklist.md +7 -0
- package/.codex/skills/design-spec-skill/examples/example.md +4 -0
- package/.codex/skills/design-spec-skill/templates/design-spec-template.md +9 -0
- package/.codex/skills/docs-skill/SKILL.md +46 -0
- package/.codex/skills/docs-skill/agents/openai.yaml +7 -0
- package/.codex/skills/docs-skill/checklists/checklist.md +7 -0
- package/.codex/skills/docs-skill/examples/example.md +4 -0
- package/.codex/skills/docs-skill/templates/docs-update-template.md +8 -0
- package/.codex/skills/{project-genesis-harness → genesis-harness}/SKILL.md +43 -4
- package/.codex/skills/genesis-harness/agents/openai.yaml +9 -0
- package/.codex/skills/genesis-harness/checklists/checklist.md +10 -0
- package/.codex/skills/genesis-harness/examples/example.md +4 -0
- package/.codex/skills/genesis-harness/templates/harness-workflow-template.md +10 -0
- package/.codex/skills/genesis-new-design/SKILL.md +95 -0
- package/.codex/skills/genesis-new-design/agents/openai.yaml +4 -0
- package/.codex/skills/genesis-new-design/checklists/checklist.md +8 -0
- package/.codex/skills/genesis-new-design/examples/example.md +4 -0
- package/.codex/skills/genesis-new-design/templates/new-design-template.md +9 -0
- package/.codex/skills/genesis-upgrade-design/SKILL.md +97 -0
- package/.codex/skills/genesis-upgrade-design/agents/openai.yaml +4 -0
- package/.codex/skills/genesis-upgrade-design/checklists/checklist.md +8 -0
- package/.codex/skills/genesis-upgrade-design/examples/example.md +4 -0
- package/.codex/skills/genesis-upgrade-design/templates/upgrade-design-template.md +9 -0
- package/.codex/skills/harness-engineering-skill/SKILL.md +45 -0
- package/.codex/skills/harness-engineering-skill/agents/openai.yaml +7 -0
- package/.codex/skills/harness-engineering-skill/checklists/checklist.md +8 -0
- package/.codex/skills/harness-engineering-skill/examples/example.md +4 -0
- package/.codex/skills/harness-engineering-skill/templates/harness-change-template.md +8 -0
- package/.codex/skills/pipeline-orchestration-skill/SKILL.md +46 -0
- package/.codex/skills/pipeline-orchestration-skill/agents/openai.yaml +7 -0
- package/.codex/skills/pipeline-orchestration-skill/checklists/checklist.md +12 -0
- package/.codex/skills/pipeline-orchestration-skill/examples/example.md +4 -0
- package/.codex/skills/pipeline-orchestration-skill/templates/orchestration-template.md +12 -0
- package/.codex/skills/planning-skill/SKILL.md +46 -0
- package/.codex/skills/planning-skill/agents/openai.yaml +7 -0
- package/.codex/skills/planning-skill/checklists/checklist.md +8 -0
- package/.codex/skills/planning-skill/examples/example.md +4 -0
- package/.codex/skills/planning-skill/templates/plan-template.md +11 -0
- package/.codex/skills/release-skill/SKILL.md +46 -0
- package/.codex/skills/release-skill/agents/openai.yaml +7 -0
- package/.codex/skills/release-skill/checklists/checklist.md +8 -0
- package/.codex/skills/release-skill/examples/example.md +4 -0
- package/.codex/skills/release-skill/templates/release-checklist-template.md +9 -0
- package/.codex/skills/research-skill/SKILL.md +46 -0
- package/.codex/skills/research-skill/agents/openai.yaml +7 -0
- package/.codex/skills/research-skill/checklists/checklist.md +7 -0
- package/.codex/skills/research-skill/examples/example.md +4 -0
- package/.codex/skills/research-skill/templates/research-note-template.md +9 -0
- package/.codex/skills/ui-ux-test-skill/SKILL.md +46 -0
- package/.codex/skills/ui-ux-test-skill/agents/openai.yaml +7 -0
- package/.codex/skills/ui-ux-test-skill/checklists/checklist.md +8 -0
- package/.codex/skills/ui-ux-test-skill/examples/example.md +4 -0
- package/.codex/skills/ui-ux-test-skill/templates/playwright-test-template.md +4 -0
- package/.codex-plugin/plugin.json +13 -11
- package/README.md +164 -181
- package/bin/genesis-harness.js +124 -79
- package/contracts/agents/CharacterBibleAgent/error.json +1 -0
- package/contracts/agents/CharacterBibleAgent/example.json +1 -0
- package/contracts/agents/CharacterBibleAgent/request.json +1 -0
- package/contracts/agents/CharacterBibleAgent/response.json +1 -0
- package/contracts/agents/CharacterBibleAgent/schema.json +1 -0
- package/contracts/agents/ImageGenerationAgent/error.json +1 -0
- package/contracts/agents/ImageGenerationAgent/example.json +1 -0
- package/contracts/agents/ImageGenerationAgent/request.json +1 -0
- package/contracts/agents/ImageGenerationAgent/response.json +1 -0
- package/contracts/agents/ImageGenerationAgent/schema.json +1 -0
- package/contracts/agents/PipelineOrchestrator/error.json +1 -0
- package/contracts/agents/PipelineOrchestrator/example.json +1 -0
- package/contracts/agents/PipelineOrchestrator/request.json +1 -0
- package/contracts/agents/PipelineOrchestrator/response.json +1 -0
- package/contracts/agents/PipelineOrchestrator/schema.json +1 -0
- package/contracts/agents/PromptGenerationAgent/error.json +1 -0
- package/contracts/agents/PromptGenerationAgent/example.json +1 -0
- package/contracts/agents/PromptGenerationAgent/request.json +1 -0
- package/contracts/agents/PromptGenerationAgent/response.json +1 -0
- package/contracts/agents/PromptGenerationAgent/schema.json +1 -0
- package/contracts/agents/RenderAgent/error.json +1 -0
- package/contracts/agents/RenderAgent/example.json +1 -0
- package/contracts/agents/RenderAgent/request.json +1 -0
- package/contracts/agents/RenderAgent/response.json +1 -0
- package/contracts/agents/RenderAgent/schema.json +1 -0
- package/contracts/agents/ScenePlanningAgent/error.json +1 -0
- package/contracts/agents/ScenePlanningAgent/example.json +1 -0
- package/contracts/agents/ScenePlanningAgent/request.json +1 -0
- package/contracts/agents/ScenePlanningAgent/response.json +1 -0
- package/contracts/agents/ScenePlanningAgent/schema.json +1 -0
- package/contracts/agents/ScreenplayAgent/error.json +1 -0
- package/contracts/agents/ScreenplayAgent/example.json +1 -0
- package/contracts/agents/ScreenplayAgent/request.json +1 -0
- package/contracts/agents/ScreenplayAgent/response.json +1 -0
- package/contracts/agents/ScreenplayAgent/schema.json +1 -0
- package/contracts/agents/StoryAnalysisAgent/error.json +1 -0
- package/contracts/agents/StoryAnalysisAgent/example.json +1 -0
- package/contracts/agents/StoryAnalysisAgent/request.json +1 -0
- package/contracts/agents/StoryAnalysisAgent/response.json +1 -0
- package/contracts/agents/StoryAnalysisAgent/schema.json +1 -0
- package/contracts/agents/SubtitleGenerationAgent/error.json +1 -0
- package/contracts/agents/SubtitleGenerationAgent/example.json +1 -0
- package/contracts/agents/SubtitleGenerationAgent/request.json +1 -0
- package/contracts/agents/SubtitleGenerationAgent/response.json +1 -0
- package/contracts/agents/SubtitleGenerationAgent/schema.json +1 -0
- package/contracts/agents/VoiceGenerationAgent/error.json +1 -0
- package/contracts/agents/VoiceGenerationAgent/example.json +1 -0
- package/contracts/agents/VoiceGenerationAgent/request.json +1 -0
- package/contracts/agents/VoiceGenerationAgent/response.json +1 -0
- package/contracts/agents/VoiceGenerationAgent/schema.json +1 -0
- package/contracts/api/README.md +4 -0
- package/contracts/api/endpoint-template/error.json +7 -0
- package/contracts/api/endpoint-template/example.json +11 -0
- package/contracts/api/endpoint-template/request.json +7 -0
- package/contracts/api/endpoint-template/response.json +6 -0
- package/contracts/api/endpoint-template/schema.json +9 -0
- package/contracts/events/README.md +4 -0
- package/contracts/events/event-template/error.json +4 -0
- package/contracts/events/event-template/example.json +6 -0
- package/contracts/events/event-template/request.json +6 -0
- package/contracts/events/event-template/response.json +3 -0
- package/contracts/events/event-template/schema.json +8 -0
- package/contracts/ui/README.md +4 -0
- package/contracts/ui/screen-template/error.json +4 -0
- package/contracts/ui/screen-template/example.json +7 -0
- package/contracts/ui/screen-template/request.json +4 -0
- package/contracts/ui/screen-template/response.json +4 -0
- package/contracts/ui/screen-template/schema.json +8 -0
- package/fixtures/agents/agent-fixture-template.md +14 -0
- package/fixtures/api/api-fixture-template.md +14 -0
- package/fixtures/images/image-fixture-template.md +14 -0
- package/fixtures/pipeline/pipeline-fixture-template.md +14 -0
- package/fixtures/render/render-fixture-template.md +14 -0
- package/fixtures/tts/tts-fixture-template.md +14 -0
- package/fixtures/videos/video-fixture-template.md +14 -0
- package/observability/agent-runs/agent-run-template.md +22 -0
- package/observability/decision-logs/decision-log-template.md +18 -0
- package/observability/failures/failure-template.md +18 -0
- package/package.json +8 -2
- package/playwright/e2e/e2e-template.md +4 -0
- package/playwright/fixtures/ui-fixture-template.md +4 -0
- package/playwright/smoke/smoke-template.md +4 -0
- package/playwright/visual/visual-regression-template.md +4 -0
- package/scripts/install.sh +64 -39
- package/scripts/run-evals.sh +61 -22
- package/scripts/uninstall.sh +40 -20
- package/scripts/verify.sh +234 -55
- package/tests/contracts/contract-template.test.md +10 -0
- package/tests/fixtures/fixture-index.md +4 -0
- package/tests/integration/integration-template.test.md +4 -0
- package/tests/unit/unit-template.test.md +4 -0
- package/.codex/skills/project-genesis-harness/agents/openai.yaml +0 -9
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/references/planning-schema.md +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/references/quality-rubric.md +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/references/research-rubric.md +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/references/workflows.md +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/agents-template.md +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/api-docs-template.md +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/architecture-template.md +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/audit-template.md +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/bug-template.md +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/check-template.md +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/conventions-template.md +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/decision-template.md +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/design-template.md +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/escalation-template.md +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/feature-template.md +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/integrations-template.md +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/journeys-template.md +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/lessons-learned-template.md +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/observability-template.md +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/phase-template.md +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/pitfalls-template.md +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/planning-tree-template.md +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/project-template.md +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/quality-score-template.md +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/requirements-template.md +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/research-template.md +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/review-template.md +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/spec-changelog-template.md +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/stack-template.md +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/resources/verification-template.md +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/scripts/check-architecture-boundaries.sh +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/scripts/check-docs-sync.sh +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/scripts/check-no-debug-logs.sh +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/scripts/check-required-planning-files.sh +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/scripts/check-spec-changelog.sh +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/scripts/check-task-tracking.sh +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/scripts/create-adr.sh +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/scripts/create-bug.sh +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/scripts/create-feature.sh +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/scripts/detect-stack.sh +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/scripts/init-planning.sh +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/scripts/list-changed-files.sh +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/scripts/run-verification.sh +0 -0
- /package/.codex/skills/{project-genesis-harness → genesis-harness}/scripts/update-state.sh +0 -0
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
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
|
-
##
|
|
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,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,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,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,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,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,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
|
+
|