codex-genesis-harness 0.1.6 → 0.1.7
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/CURRENT_STATE.md +8 -7
- package/.codebase/RECOVERY_POINTS.md +38 -393
- package/.codebase/beads.json +16 -0
- package/.codex/skills/genesis-ai-provider/SKILL.md +1 -1
- package/.codex/skills/genesis-api-contract/SKILL.md +1 -1
- package/.codex/skills/genesis-api-sync/SKILL.md +1 -1
- package/.codex/skills/genesis-architecture/SKILL.md +1 -1
- package/.codex/skills/genesis-codebase-map/SKILL.md +1 -1
- package/.codex/skills/genesis-debug-guide/SKILL.md +1 -1
- package/.codex/skills/genesis-design-spec/SKILL.md +3 -3
- package/.codex/skills/genesis-harness/SKILL.md +3 -2
- package/.codex/skills/genesis-harness-engineering/SKILL.md +1 -1
- package/.codex/skills/genesis-new-design/SKILL.md +2 -1
- package/.codex/skills/genesis-pipeline-orchestration/SKILL.md +1 -1
- package/.codex/skills/genesis-planning/SKILL.md +26 -1
- package/.codex/skills/genesis-release/SKILL.md +24 -1
- package/.codex/skills/{ui-ux-test-skill → genesis-ui-ux-test}/SKILL.md +1 -1
- package/CHANGELOG.md +14 -0
- package/README.EN.md +7 -11
- package/README.VI.md +9 -13
- package/README.md +10 -10
- package/VERSION +1 -1
- package/bin/genesis-harness.js +606 -6
- package/package.json +1 -1
- package/scripts/install.sh +2 -6
- package/scripts/run-evals.sh +20 -25
- package/scripts/uninstall.sh +2 -6
- package/scripts/verify.sh +6 -66
- package/.codex/skills/genesis-docs/SKILL.md +0 -46
- package/.codex/skills/genesis-docs/agents/openai.yaml +0 -7
- package/.codex/skills/genesis-mvp-planning/SKILL.md +0 -114
- package/.codex/skills/genesis-mvp-planning/agents/openai.yaml +0 -6
- package/.codex/skills/genesis-release-orchestration/SKILL.md +0 -653
- package/.codex/skills/genesis-release-orchestration/agents/openai.yaml +0 -7
- package/.codex/skills/genesis-research/SKILL.md +0 -46
- package/.codex/skills/genesis-research/agents/openai.yaml +0 -7
- /package/.codex/skills/{genesis-docs/checklists/checklist.md → genesis-docs-automation/checklists/manual-docs-checklist.md} +0 -0
- /package/.codex/skills/{genesis-docs/examples/example.md → genesis-docs-automation/examples/manual-docs-example.md} +0 -0
- /package/.codex/skills/{genesis-docs → genesis-docs-automation}/templates/docs-update-template.md +0 -0
- /package/.codex/skills/{genesis-state-machine/SKILL.md → genesis-harness/references/state-machine.md} +0 -0
- /package/.codex/skills/{genesis-mvp-planning → genesis-planning}/checklists/mvp-readiness.md +0 -0
- /package/.codex/skills/{genesis-mvp-planning → genesis-planning}/examples/5-phase-roadmap-example.md +0 -0
- /package/.codex/skills/{genesis-mvp-planning → genesis-planning}/templates/phase-1-core.md +0 -0
- /package/.codex/skills/{genesis-mvp-planning → genesis-planning}/templates/phase-2-auth.md +0 -0
- /package/.codex/skills/{genesis-mvp-planning → genesis-planning}/templates/phase-3-features.md +0 -0
- /package/.codex/skills/{genesis-mvp-planning → genesis-planning}/templates/phase-4-integrations.md +0 -0
- /package/.codex/skills/{genesis-mvp-planning → genesis-planning}/templates/phase-5-readiness.md +0 -0
- /package/.codex/skills/{genesis-release-orchestration → genesis-release}/checklists/post-deployment-verification.md +0 -0
- /package/.codex/skills/{genesis-release-orchestration → genesis-release}/checklists/pre-release-validation.md +0 -0
- /package/.codex/skills/{genesis-release-orchestration/examples/example.md → genesis-release/examples/orchestration-example.md} +0 -0
- /package/.codex/skills/{genesis-release-orchestration → genesis-release}/observability/release-tracking.md +0 -0
- /package/.codex/skills/{genesis-release-orchestration → genesis-release}/playbooks/canary-deployment-orchestration.md +0 -0
- /package/.codex/skills/{genesis-release-orchestration → genesis-release}/playbooks/semantic-versioning-automation.md +0 -0
- /package/.codex/skills/{genesis-release-orchestration → genesis-release}/templates/deployment-strategy-template.md +0 -0
- /package/.codex/skills/{genesis-release-orchestration → genesis-release}/templates/release-runbook-template.md +0 -0
- /package/.codex/skills/{genesis-research → genesis-research-first}/checklists/checklist.md +0 -0
- /package/.codex/skills/{genesis-research/examples/example.md → genesis-research-first/examples/manual-research-example.md} +0 -0
- /package/.codex/skills/{genesis-research → genesis-research-first}/templates/research-note-template.md +0 -0
- /package/.codex/skills/{ui-ux-test-skill → genesis-ui-ux-test}/agents/openai.yaml +0 -0
- /package/.codex/skills/{ui-ux-test-skill → genesis-ui-ux-test}/checklists/checklist.md +0 -0
- /package/.codex/skills/{ui-ux-test-skill → genesis-ui-ux-test}/examples/example.md +0 -0
- /package/.codex/skills/{ui-ux-test-skill → genesis-ui-ux-test}/templates/playwright-test-template.md +0 -0
package/scripts/run-evals.sh
CHANGED
|
@@ -10,25 +10,21 @@ skill_names=(
|
|
|
10
10
|
genesis-upgrade-design
|
|
11
11
|
genesis-architecture
|
|
12
12
|
genesis-planning
|
|
13
|
-
genesis-mvp-planning
|
|
14
13
|
genesis-codebase-map
|
|
15
14
|
genesis-design-spec
|
|
16
15
|
genesis-api-contract
|
|
17
|
-
ui-ux-test
|
|
16
|
+
genesis-ui-ux-test
|
|
18
17
|
genesis-harness-engineering
|
|
19
18
|
genesis-ai-provider
|
|
20
19
|
genesis-pipeline-orchestration
|
|
21
|
-
genesis-research
|
|
22
|
-
genesis-docs
|
|
23
|
-
genesis-release
|
|
24
20
|
genesis-api-sync
|
|
25
21
|
genesis-debug-guide
|
|
26
22
|
genesis-docs-automation
|
|
27
23
|
genesis-spec-propagation
|
|
28
|
-
genesis-release-orchestration
|
|
29
24
|
genesis-performance-profiling
|
|
30
25
|
genesis-observability-automation
|
|
31
26
|
genesis-research-first
|
|
27
|
+
genesis-release
|
|
32
28
|
spec-impact-engine
|
|
33
29
|
)
|
|
34
30
|
|
|
@@ -59,25 +55,7 @@ done
|
|
|
59
55
|
for skill_name in "${skill_names[@]}"; do
|
|
60
56
|
assert_file "$skill_root/$skill_name/SKILL.md"
|
|
61
57
|
assert_file "$skill_root/$skill_name/agents/openai.yaml"
|
|
62
|
-
|
|
63
|
-
expected_name="$skill_name"
|
|
64
|
-
case "$skill_name" in
|
|
65
|
-
genesis-architecture) expected_name="architecture-skill" ;;
|
|
66
|
-
genesis-planning) expected_name="planning-skill" ;;
|
|
67
|
-
genesis-codebase-map) expected_name="codebase-map-skill" ;;
|
|
68
|
-
genesis-design-spec) expected_name="design-spec-skill" ;;
|
|
69
|
-
genesis-api-contract) expected_name="api-contract-skill" ;;
|
|
70
|
-
genesis-harness-engineering) expected_name="harness-engineering-skill" ;;
|
|
71
|
-
genesis-ai-provider) expected_name="ai-provider-skill" ;;
|
|
72
|
-
genesis-pipeline-orchestration) expected_name="pipeline-orchestration-skill" ;;
|
|
73
|
-
genesis-research) expected_name="research-skill" ;;
|
|
74
|
-
genesis-docs) expected_name="docs-skill" ;;
|
|
75
|
-
genesis-release) expected_name="release-skill" ;;
|
|
76
|
-
genesis-api-sync) expected_name="api-sync-skill" ;;
|
|
77
|
-
genesis-debug-guide) expected_name="debug-guide-skill" ;;
|
|
78
|
-
esac
|
|
79
|
-
|
|
80
|
-
assert_contains "$skill_root/$skill_name/SKILL.md" "name: $expected_name"
|
|
58
|
+
assert_contains "$skill_root/$skill_name/SKILL.md" "name: $skill_name"
|
|
81
59
|
done
|
|
82
60
|
|
|
83
61
|
assert_contains "$repo_root/scripts/install.sh" '--target agents|legacy|both'
|
|
@@ -116,4 +94,21 @@ for skill_name in "${skill_names[@]}" project-genesis-harness; do
|
|
|
116
94
|
[ ! -e "$tmp/codex/skills/$skill_name" ] || fail "legacy uninstall target remains: $skill_name"
|
|
117
95
|
done
|
|
118
96
|
|
|
97
|
+
assert_contains "$repo_root/bin/genesis-harness.js" "genesis-harness remember"
|
|
98
|
+
assert_contains "$repo_root/bin/genesis-harness.js" "genesis-harness recall"
|
|
99
|
+
assert_contains "$repo_root/bin/genesis-harness.js" "genesis-harness forget"
|
|
100
|
+
assert_contains "$repo_root/bin/genesis-harness.js" "genesis-harness prime"
|
|
101
|
+
assert_contains "$repo_root/bin/genesis-harness.js" "genesis-harness view-mockup"
|
|
102
|
+
|
|
103
|
+
# Test Beads Memory Commands
|
|
104
|
+
node "$repo_root/bin/genesis-harness.js" remember evalsmoke "Verify that evals can store facts." >/dev/null
|
|
105
|
+
node "$repo_root/bin/genesis-harness.js" recall evalsmoke | grep -q "Verify that evals" || fail "recall failed to find test fact"
|
|
106
|
+
node "$repo_root/bin/genesis-harness.js" prime | grep -q "Verify that evals" || fail "prime failed to include test fact"
|
|
107
|
+
|
|
108
|
+
# Find the ID of the stored fact to forget it
|
|
109
|
+
bead_id=$(node "$repo_root/bin/genesis-harness.js" recall evalsmoke | grep -o "\[[0-9a-f]\{6\}\]" | head -n 1 | tr -d '[]')
|
|
110
|
+
node "$repo_root/bin/genesis-harness.js" forget "$bead_id" >/dev/null
|
|
111
|
+
node "$repo_root/bin/genesis-harness.js" recall evalsmoke | grep -q "Verify that evals" && fail "forget failed to delete test fact" || true
|
|
112
|
+
|
|
113
|
+
|
|
119
114
|
echo "evals passed"
|
package/scripts/uninstall.sh
CHANGED
|
@@ -7,25 +7,21 @@ skill_names=(
|
|
|
7
7
|
genesis-upgrade-design
|
|
8
8
|
genesis-architecture
|
|
9
9
|
genesis-planning
|
|
10
|
-
genesis-mvp-planning
|
|
11
10
|
genesis-codebase-map
|
|
12
11
|
genesis-design-spec
|
|
13
12
|
genesis-api-contract
|
|
14
|
-
ui-ux-test
|
|
13
|
+
genesis-ui-ux-test
|
|
15
14
|
genesis-harness-engineering
|
|
16
15
|
genesis-ai-provider
|
|
17
16
|
genesis-pipeline-orchestration
|
|
18
|
-
genesis-research
|
|
19
|
-
genesis-docs
|
|
20
|
-
genesis-release
|
|
21
17
|
genesis-api-sync
|
|
22
18
|
genesis-debug-guide
|
|
23
19
|
genesis-docs-automation
|
|
24
20
|
genesis-spec-propagation
|
|
25
|
-
genesis-release-orchestration
|
|
26
21
|
genesis-performance-profiling
|
|
27
22
|
genesis-observability-automation
|
|
28
23
|
genesis-research-first
|
|
24
|
+
genesis-release
|
|
29
25
|
spec-impact-engine
|
|
30
26
|
project-genesis-harness
|
|
31
27
|
)
|
package/scripts/verify.sh
CHANGED
|
@@ -9,25 +9,21 @@ skill_names=(
|
|
|
9
9
|
genesis-upgrade-design
|
|
10
10
|
genesis-architecture
|
|
11
11
|
genesis-planning
|
|
12
|
-
genesis-mvp-planning
|
|
13
12
|
genesis-codebase-map
|
|
14
13
|
genesis-design-spec
|
|
15
14
|
genesis-api-contract
|
|
16
|
-
ui-ux-test
|
|
15
|
+
genesis-ui-ux-test
|
|
17
16
|
genesis-harness-engineering
|
|
18
17
|
genesis-ai-provider
|
|
19
18
|
genesis-pipeline-orchestration
|
|
20
|
-
genesis-research
|
|
21
|
-
genesis-docs
|
|
22
|
-
genesis-release
|
|
23
19
|
genesis-api-sync
|
|
24
20
|
genesis-debug-guide
|
|
25
21
|
genesis-docs-automation
|
|
26
22
|
genesis-spec-propagation
|
|
27
|
-
genesis-release-orchestration
|
|
28
23
|
genesis-performance-profiling
|
|
29
24
|
genesis-observability-automation
|
|
30
25
|
genesis-research-first
|
|
26
|
+
genesis-release
|
|
31
27
|
spec-impact-engine
|
|
32
28
|
)
|
|
33
29
|
|
|
@@ -195,7 +191,7 @@ verify_harness_skill() {
|
|
|
195
191
|
grep -q 'Definition Of Done' "$skill_dir/SKILL.md" || fail "missing Definition Of Done"
|
|
196
192
|
grep -q 'Quality Rubric' "$skill_dir/SKILL.md" || fail "missing Quality Rubric"
|
|
197
193
|
|
|
198
|
-
for ref in workflows.md planning-schema.md research-rubric.md quality-rubric.md; do
|
|
194
|
+
for ref in workflows.md planning-schema.md research-rubric.md quality-rubric.md state-machine.md; do
|
|
199
195
|
[ -f "$skill_dir/references/$ref" ] || fail "missing reference: $ref"
|
|
200
196
|
grep -q "references/$ref" "$skill_dir/SKILL.md" || fail "SKILL.md does not mention reference: $ref"
|
|
201
197
|
done
|
|
@@ -268,67 +264,11 @@ verify_one() {
|
|
|
268
264
|
genesis-new-design|genesis-upgrade-design)
|
|
269
265
|
verify_design_skill "$skill_dir" "$dir_name"
|
|
270
266
|
;;
|
|
271
|
-
genesis-architecture)
|
|
272
|
-
verify_skill_metadata "$skill_dir" "
|
|
273
|
-
verify_skill_protocol "$skill_dir"
|
|
274
|
-
;;
|
|
275
|
-
genesis-planning)
|
|
276
|
-
verify_skill_metadata "$skill_dir" "planning-skill"
|
|
277
|
-
verify_skill_protocol "$skill_dir"
|
|
278
|
-
;;
|
|
279
|
-
genesis-mvp-planning)
|
|
280
|
-
verify_skill_metadata "$skill_dir" "genesis-mvp-planning"
|
|
281
|
-
verify_minimal_skill "$skill_dir"
|
|
282
|
-
;;
|
|
283
|
-
genesis-codebase-map)
|
|
284
|
-
verify_skill_metadata "$skill_dir" "codebase-map-skill"
|
|
285
|
-
verify_skill_protocol "$skill_dir"
|
|
286
|
-
;;
|
|
287
|
-
genesis-design-spec)
|
|
288
|
-
verify_skill_metadata "$skill_dir" "design-spec-skill"
|
|
289
|
-
verify_skill_protocol "$skill_dir"
|
|
290
|
-
;;
|
|
291
|
-
genesis-api-contract)
|
|
292
|
-
verify_skill_metadata "$skill_dir" "api-contract-skill"
|
|
293
|
-
verify_skill_protocol "$skill_dir"
|
|
294
|
-
;;
|
|
295
|
-
ui-ux-test-skill)
|
|
296
|
-
verify_skill_metadata "$skill_dir" "ui-ux-test-skill"
|
|
297
|
-
verify_skill_protocol "$skill_dir"
|
|
298
|
-
;;
|
|
299
|
-
genesis-harness-engineering)
|
|
300
|
-
verify_skill_metadata "$skill_dir" "harness-engineering-skill"
|
|
301
|
-
verify_skill_protocol "$skill_dir"
|
|
302
|
-
;;
|
|
303
|
-
genesis-ai-provider)
|
|
304
|
-
verify_skill_metadata "$skill_dir" "ai-provider-skill"
|
|
305
|
-
verify_skill_protocol "$skill_dir"
|
|
306
|
-
;;
|
|
307
|
-
genesis-pipeline-orchestration)
|
|
308
|
-
verify_skill_metadata "$skill_dir" "pipeline-orchestration-skill"
|
|
309
|
-
verify_skill_protocol "$skill_dir"
|
|
310
|
-
;;
|
|
311
|
-
genesis-research)
|
|
312
|
-
verify_skill_metadata "$skill_dir" "research-skill"
|
|
313
|
-
verify_skill_protocol "$skill_dir"
|
|
314
|
-
;;
|
|
315
|
-
genesis-docs)
|
|
316
|
-
verify_skill_metadata "$skill_dir" "docs-skill"
|
|
317
|
-
verify_skill_protocol "$skill_dir"
|
|
318
|
-
;;
|
|
319
|
-
genesis-release)
|
|
320
|
-
verify_skill_metadata "$skill_dir" "release-skill"
|
|
321
|
-
verify_skill_protocol "$skill_dir"
|
|
322
|
-
;;
|
|
323
|
-
genesis-api-sync)
|
|
324
|
-
verify_skill_metadata "$skill_dir" "api-sync-skill"
|
|
267
|
+
genesis-architecture|genesis-planning|genesis-codebase-map|genesis-design-spec|genesis-api-contract|genesis-ui-ux-test|genesis-harness-engineering|genesis-ai-provider|genesis-pipeline-orchestration|genesis-api-sync)
|
|
268
|
+
verify_skill_metadata "$skill_dir" "$dir_name"
|
|
325
269
|
verify_skill_protocol "$skill_dir"
|
|
326
270
|
;;
|
|
327
|
-
genesis-debug-guide)
|
|
328
|
-
verify_skill_metadata "$skill_dir" "debug-guide-skill"
|
|
329
|
-
verify_playbook_skill "$skill_dir"
|
|
330
|
-
;;
|
|
331
|
-
genesis-docs-automation|genesis-spec-propagation|genesis-release-orchestration|genesis-performance-profiling|genesis-observability-automation)
|
|
271
|
+
genesis-debug-guide|genesis-docs-automation|genesis-spec-propagation|genesis-performance-profiling|genesis-observability-automation|genesis-release)
|
|
332
272
|
verify_skill_metadata "$skill_dir" "$dir_name"
|
|
333
273
|
verify_playbook_skill "$skill_dir"
|
|
334
274
|
;;
|
|
@@ -1,46 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: docs-skill
|
|
3
|
-
description: Keep Codex harness docs synchronized with skills, contracts, tests, memory, and release behavior. Use after any workflow, public interface, install, verification, or package behavior change.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Docs Skill
|
|
7
|
-
|
|
8
|
-
## Purpose
|
|
9
|
-
Keep docs short, accurate, and linked to source-of-truth artifacts.
|
|
10
|
-
|
|
11
|
-
## When to use
|
|
12
|
-
Use after changing skills, CLI behavior, contracts, fixtures, tests, repository memory, or publish flow.
|
|
13
|
-
|
|
14
|
-
## When NOT to use
|
|
15
|
-
Do not use to duplicate full architecture manuals in `AGENTS.md`.
|
|
16
|
-
|
|
17
|
-
## Inputs required
|
|
18
|
-
Changed files, public behavior, verification results, and affected users.
|
|
19
|
-
|
|
20
|
-
## Outputs required
|
|
21
|
-
Updated README, AGENTS map, codebase memory, changelog-style summary, and changed docs list.
|
|
22
|
-
|
|
23
|
-
## Required tests
|
|
24
|
-
Run docs-related verification and package dry-run when docs affect packaging or install instructions.
|
|
25
|
-
|
|
26
|
-
## Required fixtures
|
|
27
|
-
Update templates/examples when docs describe reusable workflows.
|
|
28
|
-
|
|
29
|
-
## Required contract updates
|
|
30
|
-
Update contracts when docs describe new interface behavior.
|
|
31
|
-
|
|
32
|
-
## Required codebase map updates
|
|
33
|
-
Update `.codebase/CURRENT_STATE.md`, `MODULE_INDEX.md`, or summaries as needed.
|
|
34
|
-
|
|
35
|
-
## Token saving rules
|
|
36
|
-
Keep docs concise. Link to templates and contracts instead of repeating them.
|
|
37
|
-
|
|
38
|
-
## Acceptance criteria
|
|
39
|
-
Docs match behavior and do not duplicate large internal manuals.
|
|
40
|
-
|
|
41
|
-
## Common mistakes
|
|
42
|
-
Letting AGENTS.md grow too large, documenting unverified behavior, and missing install docs.
|
|
43
|
-
|
|
44
|
-
## Recovery workflow
|
|
45
|
-
If docs drift, add verify assertions or checklist items that catch the drift next time.
|
|
46
|
-
|
|
@@ -1,114 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: genesis-mvp-planning
|
|
3
|
-
description: "Define, structure, and automate the creation of a standard 5-Phase MVP Roadmap right after project initialization. Guarantees a decision-complete path to production-ready launch."
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Genesis MVP 5-Phase Planning Skill
|
|
7
|
-
|
|
8
|
-
## Purpose
|
|
9
|
-
|
|
10
|
-
The `genesis-mvp-planning` skill is designed to transition a newly initialized project into a structured, decision-complete **5-Phase MVP Roadmap**. Instead of leaving the repository with only a blank generic Phase 0 (Foundation) folder, this skill maps out the entire lifecycle of a production-ready Minimum Viable Product across exactly 5 logical, sequential phases.
|
|
11
|
-
|
|
12
|
-
---
|
|
13
|
-
|
|
14
|
-
## When to use
|
|
15
|
-
|
|
16
|
-
Use the `genesis-mvp-planning` skill when:
|
|
17
|
-
- You have just run `/genesis-init` (or `/init`) and need to map out the implementation timeline.
|
|
18
|
-
- You want to scope an application specifically to its MVP (Minimum Viable Product) boundaries.
|
|
19
|
-
- You want to establish clear gates and milestones for each stage of the project lifecycle.
|
|
20
|
-
|
|
21
|
-
---
|
|
22
|
-
|
|
23
|
-
## When NOT to use
|
|
24
|
-
|
|
25
|
-
Do NOT use the `genesis-mvp-planning` skill when:
|
|
26
|
-
- The project is already midway through development with a pre-existing mature roadmap.
|
|
27
|
-
- The task is a minor, single-file bug fix or simple refactoring that doesn't affect the project timeline.
|
|
28
|
-
- The roadmap has already been fully approved and is currently active.
|
|
29
|
-
|
|
30
|
-
---
|
|
31
|
-
|
|
32
|
-
## Inputs required
|
|
33
|
-
|
|
34
|
-
Before running this planning skill, ensure the following inputs are gathered:
|
|
35
|
-
- **Project Brief / Intent**: Clear understanding of what application is being built and target users.
|
|
36
|
-
- **Technology Stack**: Backend, frontend, database, auth provider, and deployment target.
|
|
37
|
-
- **Core MVP Features List**: The primary business value proposition that must be delivered.
|
|
38
|
-
|
|
39
|
-
---
|
|
40
|
-
|
|
41
|
-
## Outputs required
|
|
42
|
-
|
|
43
|
-
Executing this skill creates the following structured deliverables:
|
|
44
|
-
- `.planning/ROADMAP.md`: Updated roadmap with 5 distinct phases defined.
|
|
45
|
-
- `.planning/phases/PHASE_1_CORE/`: Planning directory for Phase 1 (Foundation & API Core).
|
|
46
|
-
- `.planning/phases/PHASE_2_AUTH/`: Planning directory for Phase 2 (Authentication & Security).
|
|
47
|
-
- `.planning/phases/PHASE_3_FEATURES/`: Planning directory for Phase 3 (Core MVP Features).
|
|
48
|
-
- `.planning/phases/PHASE_4_INTEGRATIONS/`: Planning directory for Phase 4 (Third-Party Integrations).
|
|
49
|
-
- `.planning/phases/PHASE_5_READINESS/`: Planning directory for Phase 5 (Production Readiness & Observability).
|
|
50
|
-
|
|
51
|
-
---
|
|
52
|
-
|
|
53
|
-
## Required tests
|
|
54
|
-
|
|
55
|
-
The planning deliverables are validated using:
|
|
56
|
-
- [ ] `test/planning/roadmap-structure.test.js`: Verifies `ROADMAP.md` contains all 5 phases with valid status checkboxes.
|
|
57
|
-
- [ ] `test/planning/phase-completeness.test.js`: Verifies each phase directory contains standard `SPEC.md`, `PLAN.md`, and `TASKS.md`.
|
|
58
|
-
|
|
59
|
-
---
|
|
60
|
-
|
|
61
|
-
## Required fixtures
|
|
62
|
-
|
|
63
|
-
- `fixtures/planning/roadmap-expected.md`: The canonical structure of a 5-Phase MVP roadmap.
|
|
64
|
-
- `fixtures/planning/phase-config-expected.json`: Complete configuration template mapping out the 5 phases.
|
|
65
|
-
|
|
66
|
-
---
|
|
67
|
-
|
|
68
|
-
## Required contract updates
|
|
69
|
-
|
|
70
|
-
Update the following files if phase boundary standards change:
|
|
71
|
-
- `contracts/planning/roadmap.schema.json`: Schema validator for `ROADMAP.md` files.
|
|
72
|
-
- `contracts/planning/phase.schema.json`: Schema validator for individual phase directories.
|
|
73
|
-
|
|
74
|
-
---
|
|
75
|
-
|
|
76
|
-
## Required codebase map updates
|
|
77
|
-
|
|
78
|
-
After mapping out the 5-Phase MVP:
|
|
79
|
-
- **`.codebase/CURRENT_STATE.md`**: Update current phase to Phase 1, and add the full 5-phase overview.
|
|
80
|
-
- **`.codebase/MODULE_INDEX.md`**: Add references to each of the 5 phase directories.
|
|
81
|
-
|
|
82
|
-
---
|
|
83
|
-
|
|
84
|
-
## Token saving rules
|
|
85
|
-
|
|
86
|
-
1. **Reuse templates**: Do not rewrite the basic structure of the phases. Use the provided phase templates in `templates/`.
|
|
87
|
-
2. **Summarize context**: Do not read every detail of the repository. Use `SUMMARY.md` and module index.
|
|
88
|
-
3. **Draft sequentially**: Plan one phase at a time to keep prompt sizes small.
|
|
89
|
-
|
|
90
|
-
---
|
|
91
|
-
|
|
92
|
-
## Acceptance criteria
|
|
93
|
-
|
|
94
|
-
The 5-Phase MVP roadmap is ACCEPTED when:
|
|
95
|
-
- [ ] `ROADMAP.md` is updated with 5 clearly defined phases, dates, and success criteria.
|
|
96
|
-
- [ ] All 5 phase planning folders (`PHASE_1_CORE` to `PHASE_5_READINESS`) are created and populated.
|
|
97
|
-
- [ ] No feature code is written before the 5 phase boundaries are validated.
|
|
98
|
-
|
|
99
|
-
---
|
|
100
|
-
|
|
101
|
-
## Common mistakes
|
|
102
|
-
|
|
103
|
-
### Mistake 1: Starting Phase 3 (Core Features) before Phase 1 (API Core)
|
|
104
|
-
- **Problem**: Writing UI screens without verified backend models and schemas leads to massive rework.
|
|
105
|
-
- **Fix**: Complete Phase 1 and 2 to establish a solid database and API contract first.
|
|
106
|
-
|
|
107
|
-
---
|
|
108
|
-
|
|
109
|
-
## Recovery workflow
|
|
110
|
-
|
|
111
|
-
### Recovery 1: Phase drift or timeline changes
|
|
112
|
-
1. Mark the affected phase as `[!] blocked` in `ROADMAP.md`.
|
|
113
|
-
2. Document the change in `SPEC_CHANGELOG.md`.
|
|
114
|
-
3. Adjust downstream phase boundaries accordingly.
|
|
@@ -1,6 +0,0 @@
|
|
|
1
|
-
interface:
|
|
2
|
-
display_name: "Genesis MVP Planning"
|
|
3
|
-
short_description: "— Xây dựng lộ trình 5 Phase phát triển sản phẩm MVP"
|
|
4
|
-
default_prompt: "Use $genesis-mvp-planning to map out the 5 essential phases of a production-ready MVP."
|
|
5
|
-
policy:
|
|
6
|
-
allow_implicit_invocation: true
|