codex-genesis-harness 0.1.6 → 0.1.7

package/.codex/skills/genesis-planning/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: planning-skill
+name: genesis-planning
 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.
 ---
 
@@ -44,3 +44,28 @@ Planning implementation before tests, omitting fixtures, and leaving verificatio
 ## Recovery workflow
 If a plan becomes invalid, update the failing test and fixture first, then revise phases.
 
+---
+
+## 🏗️ 5-Phase MVP Roadmap Standards
+
+When decomposing large-scale features or initializing new project modules, you must enforce the **5-Phase MVP Roadmap Standard** using the provided templates:
+
+1. **Phase 1: Core Foundation & Base Setup** (Templates: `phase-1-core.md`, `phase-2-auth.md`)
+   - Establish environment skeletons, base CLI arguments, dependency configurations, and contract JSON structures.
+   - Core DB migrations, model schemes, and basic configurations.
+2. **Phase 2: Contract-First & Skeletal Tests** (Template: `phase-3-features.md`)
+   - Compile exhaustive contract endpoints (`contracts/api/`) and mock fixture skeletons (`fixtures/api/`).
+   - Auto-generate test skeletons in `tests/integration/` (RED state).
+3. **Phase 3: Logic Implementation & Self-Healing** (Template: `phase-3-features.md`)
+   - Implement minimal code handlers, controllers, or service endpoints.
+   - Execute closed-loop Verify-Fix cycles autonomously until all tests turn GREEN.
+4. **Phase 4: Multi-Agent & External Integrations** (Template: `phase-4-integrations.md`)
+   - Wire up external components, API sync triggers, or media providers.
+5. **Phase 5: E2E Visual QA & Release Readiness** (Template: `phase-5-readiness.md`)
+   - Execute full Playwright E2E smoke tests, visual regression checks, and packaging checklists.
+
+### Related Planning Assets
+* **Checklist**: `checklists/mvp-readiness.md`
+* **Example**: `examples/5-phase-roadmap-example.md`
+* **Templates**: `templates/phase-1-core.md`, `phase-2-auth.md`, `phase-3-features.md`, `phase-4-integrations.md`, `phase-5-readiness.md`
+

package/.codex/skills/genesis-release/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: release-skill
+name: genesis-release
 description: Prepare Codex harness package releases with version checks, package dry-runs, npm publish readiness, release notes, verification evidence, and rollback notes. Use before publishing or tagging releases.
 ---
 
@@ -44,3 +44,26 @@ Publishing cache files, missing executable scripts, and omitting npm 2FA/token r
 ## Recovery workflow
 If publish fails, capture error, update known problems, do not change version until root cause is fixed.
 
+---
+
+## 🚀 Automated Release & Deployment Orchestration
+
+This skill incorporates the **Release & Deployment Orchestration Standard** to manage production-ready releases and rollbacks using the provided templates and playbooks:
+
+1. **Release Checklists** (`checklists/pre-release-validation.md`, `checklists/post-deployment-verification.md`)
+   - Mandatory gates before staging/production merges.
+   - Comprehensive post-deployment validations (health checks, API connectivity).
+2. **Release Playbooks** (`playbooks/semantic-versioning-automation.md`, `playbooks/canary-deployment-orchestration.md`)
+   - Executable guidelines for version bump calculations (v1.0.0 → v1.1.0) and git tags.
+   - Closed-loop canary deployments (5% to 100% routing steps, metrics checks, instant triggers).
+3. **Observability Tracking** (`observability/release-tracking.md`)
+   - Structured release audits, recording versions, commit hashes, pipelines results, and rollout windows.
+4. **Release Templates** (`templates/deployment-strategy-template.md`, `templates/release-runbook-template.md`)
+   - Runbooks for critical steps and standardized strategy sheets.
+
+### Related Release Assets
+* **Checklists**: `checklists/checklist.md`, `checklists/pre-release-validation.md`, `checklists/post-deployment-verification.md`
+* **Playbooks**: `playbooks/semantic-versioning-automation.md`, `playbooks/canary-deployment-orchestration.md`
+* **Observability**: `observability/release-tracking.md`
+* **Templates**: `templates/release-checklist-template.md`, `templates/deployment-strategy-template.md`, `templates/release-runbook-template.md`
+

package/.codex/skills/{ui-ux-test-skill → genesis-ui-ux-test}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: ui-ux-test-skill
+name: genesis-ui-ux-test
 description: Create UI smoke, e2e, interaction, validation, API synchronization, and visual regression tests before frontend changes. Use for screens, flows, forms, dashboards, and UI regressions.
 ---
 

package/CHANGELOG.md

@@ -6,6 +6,20 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ---
 
+## [0.1.7] - 2026-06-01
+
+### Changed
+- **Skill Consolidation**: Merged overlapping skills to resolve duplicated slash commands and clean up the architecture.
+  - `genesis-docs` consolidated into `genesis-docs-automation`.
+  - `genesis-mvp-planning` consolidated into `genesis-planning`.
+  - `genesis-release-orchestration` consolidated into `genesis-release`.
+  - `genesis-research` consolidated into `genesis-research-first`.
+  - `genesis-state-machine` consolidated into `genesis-harness`.
+- **Harness & Verification Improvements**: Updated tests and scripts (`verify.sh`, `run-evals.sh`, `install.sh`, `uninstall.sh`, `genesis-harness.js`) to reflect the consolidated folder structure.
+- **Documentation**: Updated `README.md`, `README.EN.md`, `README.VI.md`, and `AGENTS.md` to reflect the new standardized skill set.
+
+---
+
 ## [0.1.6] - 2026-06-01
 
 ### Added

package/README.EN.md

@@ -133,9 +133,9 @@ Genesis Codex Harness introduces five groundbreaking architectural subsystems to
 
 ---
 
-## 🚀 Next-Gen Harness Engineering Upgrades (v0.1.6)
+## 🚀 Next-Gen Harness Engineering Upgrades (v0.1.7)
 
-Genesis v0.1.6 introduces five advanced, state-of-the-art tools under `scripts/` to enforce type-safety, automate tests, establish visual-code integrity, protect token consumption, and enable self-healing loop memory recall:
+Genesis v0.1.7 introduces five advanced, state-of-the-art tools under `scripts/` to enforce type-safety, automate tests, establish visual-code integrity, protect token consumption, and enable self-healing loop memory recall:
 
 1. **Visual Architecture AST Sync (`scripts/spec_visual_sync.js`)**: Bidirectional compiler that syncs Mermaid ERD database diagrams (`database-erd.mmd`) to API contracts JSON schemas (`contracts/api/`) and vice-versa, establishing absolute visual-to-code design integrity.
 2. **Contract-Driven Test Auto-Generator (`scripts/test_generator.js`)**: Automatically compiles fully executable Mocha/Jest integration test suites in `tests/integration/` directly from your API contracts JSON response schemas, providing instant TDD "RED" skeletons.
@@ -599,7 +599,7 @@ Genesis:
 
 ---
 
-## 📚 25 Skills (All Available)
+## 📚 21 Skills (All Available)
 
 Each skill follows the standard naming convention in `.codex/skills/`:
 
@@ -611,17 +611,13 @@ Each skill follows the standard naming convention in `.codex/skills/`:
 | **genesis-api-sync** | Automate bi-directional contract & codebase synchronization | When endpoints are updated |
 | **genesis-spec-propagation** | Automatically cascade design specification updates downstream | When specs change |
 | **genesis-docs-automation** | Automatically synchronize system technical docs | Triggers after tests pass |
-| **ui-ux-test-skill** | Design and validate UI user journeys and visual test specs | Before frontend implementation |
+| **genesis-ui-ux-test** | Design and validate UI user journeys and visual test specs | Before frontend implementation |
 | **genesis-debug-guide** | Systematic, evidence-based debugging and troubleshooting | On compile errors or test failures |
 | **genesis-pipeline-orchestration** | Orchestrate multi-phase software development lifecycle | Complex multi-phase projects |
 | **genesis-architecture** | High-level system design and architecture decisions (ADRs) | Major design changes |
 | **genesis-planning** | Breakdown complex business requirements into micro-plans | Preparing large features |
-| **genesis-mvp-planning** | Automate the setup of a 5-Phase MVP Roadmap post-initialization | Runs right after initialization |
 | **genesis-codebase-map** | Build comprehensive dependency graphs and architecture maps | Navigating large codebases |
-| **genesis-docs** | Generate exhaustive technical engineering summaries | End of phase / release |
-| **genesis-research** | Search official docs, packages, and code patterns | Finding best practices |
-| **genesis-release** | Manage semantic versioning and Git release tags | Preparing releases |
-| **genesis-release-orchestration** | Generate release checklists, rollback plans, and runbooks | Before production deployment |
+| **genesis-release** | Manage semantic versioning, Git tags, runbooks, and rollback plans | Preparing releases & deployments |
 | **genesis-performance-profiling** | Measure system latency and execute runtime optimization | Before performance tuning |
 | **genesis-observability-automation** | Log autonomous decisions, ADR history, and tool outputs | Maintaining execution trace |
 | **genesis-ai-provider** | Monitor, budget, and optimize LLM token consumption | Safeguarding API token limits |
@@ -765,7 +761,7 @@ Thank you so much for supporting the development of this project! ❤️
 - ✅ **Skills**: 25 fully implemented & verified (added 5-Phase MVP Roadmap planner, advanced self-healing and compaction engines)
 - ✅ **Test Coverage**: 80%+ required
 - ✅ **Token Savings**: 40-60%
-- ✅ **Production Ready**: Yes (v0.1.6)
+- ✅ **Production Ready**: Yes (v0.1.7)
 - ✅ **Auto-Research Enforcement**: Active
 - ✅ **Auto-Debug Verification**: Active
 - ✅ **Auto-Spec-Propagation**: Active
@@ -777,7 +773,7 @@ Thank you so much for supporting the development of this project! ❤️
 
 MIT License - See [LICENSE](LICENSE)
 
-**Genesis Codex Harness** - Build production software with Codex | v0.1.6 | June 2026
+**Genesis Codex Harness** - Build production software with Codex | v0.1.7 | June 2026
 
 ---
 

package/README.VI.md

@@ -132,9 +132,9 @@ Genesis Codex Harness giới thiệu 5 phân hệ kỹ thuật mang tính đột
 
 ---
 
-## 🚀 Nâng Cấp Kỹ Nghệ Harness Thế Hệ Mới (v0.1.6)
+## 🚀 Nâng Cấp Kỹ Nghệ Harness Thế Hệ Mới (v0.1.7)
 
-Phiên bản Genesis v0.1.6 giới thiệu năm công cụ cao cấp, đột phá trong thư mục `scripts/` nhằm áp đặt an toàn kiểu dữ liệu, tự động hóa test, thiết lập sự đồng nhất giữa sơ đồ trực quan và mã nguồn, chủ động kiểm soát token và khôi phục nhanh bài học sửa lỗi của Ralph Loop:
+Phiên bản Genesis v0.1.7 giới thiệu năm công cụ cao cấp, đột phá trong thư mục `scripts/` nhằm áp đặt an toàn kiểu dữ liệu, tự động hóa test, thiết lập sự đồng nhất giữa sơ đồ trực quan và mã nguồn, chủ động kiểm soát token và khôi phục nhanh bài học sửa lỗi của Ralph Loop:
 
 1. **Đồng bộ Sơ đồ Trực quan 2 Chiều (`scripts/spec_visual_sync.js`)**: Trình biên dịch hai chiều tự động đồng bộ hóa sơ đồ cơ sở dữ liệu ERD Mermaid (`database-erd.mmd`) sang các tệp JSON API contracts (`contracts/api/`) và ngược lại, bảo vệ tính nhất quán thiết kế tuyệt đối.
 2. **Trình Tự Động Sinh Test từ Hợp Đồng (`scripts/test_generator.js`)**: Tự động biên dịch và tạo cấu trúc các bộ kiểm thử tích hợp (Node.js/Jest) hoàn chỉnh tại `tests/integration/` trực tiếp từ các file response contract JSON, hỗ trợ lập tức kịch bản TDD "RED" skeleton.
@@ -599,7 +599,7 @@ Genesis:
 
 ---
 
-## 📚 25 Skills (Tất Cả)
+## 📚 21 Skills (Tất Cả)
 
 Mỗi skill tuân theo naming quy chuẩn trong thư mục `.codex/skills/`:
 
@@ -611,17 +611,13 @@ Mỗi skill tuân theo naming quy chuẩn trong thư mục `.codex/skills/`:
 | **genesis-api-sync** | Đồng bộ hóa API contract và codebase tự động | Khi cập nhật endpoint |
 | **genesis-spec-propagation** | Tự động lan tỏa thay đổi đặc tả xuống hạ nguồn | Khi spec thay đổi |
 | **genesis-docs-automation** | Tự động hóa đồng bộ tài liệu hệ thống | Tự động chạy sau khi test pass |
-| **ui-ux-test-skill** | Thiết kế và xác thực UI flows, kịch bản test giao diện | Trước khi triển khai giao diện |
+| **genesis-ui-ux-test** | Thiết kế và xác thực UI flows, kịch bản test giao diện | Trước khi triển khai giao diện |
 | **genesis-debug-guide** | Hướng dẫn chẩn đoán và khắc phục lỗi có hệ thống | Khi code lỗi hoặc test fail |
 | **genesis-pipeline-orchestration** | Điều phối pipeline phát triển nhiều giai đoạn | Quản lý đa giai đoạn |
 | **genesis-architecture** | Thiết kế hệ thống và ghi nhận quyết định kiến trúc (ADR) | Quyết định thiết kế lớn |
-| **genesis-planning** | Lập kế hoạch phân rã công việc khoa học | Chuẩn bị feature phức tạp |
-| **genesis-mvp-planning** | Tự động lập kế hoạch và phân rã Lộ trình 5-Phase MVP | Chạy ngay sau khi khởi tạo dự án |
+| **genesis-planning** | Lập kế hoạch phân rã công việc và Lộ trình 5-Phase MVP | Chuẩn bị feature phức tạp & thiết lập lộ trình |
 | **genesis-codebase-map** | Vẽ bản đồ kiến trúc codebase | Tìm hiểu codebase lớn |
-| **genesis-docs** | Tạo tài liệu kỹ thuật chi tiết | Kết thúc giai đoạn / release |
-| **genesis-research** | Nghiên cứu công nghệ, thư viện phù hợp | Tìm kiếm best practices |
-| **genesis-release** | Quản lý quy trình phát hành phiên bản | Version control + git tag |
-| **genesis-release-orchestration** | Tự động hóa lập kế hoạch và runbook phát hành | Chuẩn bị deploy hệ thống |
+| **genesis-release** | Quản lý phiên bản, runbooks, và kế hoạch khôi phục (rollback) | Chuẩn bị phát hành & triển khai |
 | **genesis-performance-profiling** | Đo lường hiệu suất và tối ưu hóa thời gian chạy | Trước khi tối ưu hiệu năng |
 | **genesis-observability-automation** | Tự động ghi chép quyết định (ADR) và log hành vi hệ thống | Ghi chép lịch sử vận hành |
 | **genesis-ai-provider** | Theo dõi và tối ưu hóa lượng token tiêu thụ | Giám sát chi phí API |
@@ -754,10 +750,10 @@ Cảm ơn bạn rất nhiều vì đã đồng hành cùng sự phát triển c
 
 - ✅ **Architecture**: 10/10 (research-first + auto-debug + auto-spec-propagation + auto-docs + validation gates)
 - ✅ **Codex-Only Enforcement**: 100%
-- ✅ **25 Skills**: Hoàn toàn kế thừa và triển khai đầy đủ (đã bổ sung lộ trình 5-Phase MVP, tự chữa lành & nén context)
+- ✅ **21 Skills**: Hoàn toàn kế thừa và triển khai đầy đủ (đã bổ sung lộ trình 5-Phase MVP, tự chữa lành & nén context)
 - ✅ **Test Coverage**: 80%+ required
 - ✅ **Token Savings**: 40-60%
-- ✅ **Production Ready**: Yes (v0.1.6)
+- ✅ **Production Ready**: Yes (v0.1.7)
 - ✅ **Auto-Research Enforcement**: Active
 - ✅ **Auto-Debug Verification**: Active
 - ✅ **Auto-Spec-Propagation**: Active
@@ -769,7 +765,7 @@ Cảm ơn bạn rất nhiều vì đã đồng hành cùng sự phát triển c
 
 MIT License - Xem [LICENSE](LICENSE)
 
-**Genesis Codex Harness** - Xây dựng phần mềm production với Codex | v0.1.6 | Tháng 6, 2026
+**Genesis Codex Harness** - Xây dựng phần mềm production với Codex | v0.1.7 | Tháng 6, 2026
 
 ---
 

package/README.md

@@ -30,8 +30,8 @@ To cater to all developers, Genesis features separate, highly exhaustive step-by
 
 | Language | Primary Link | Content Included |
 | :--- | :--- | :--- |
-| 🇬🇧 **English** | [README.EN.md](README.EN.md) | Exhaustive runbooks, all 25 skill details, learning paths, & production workflows. |
-| 🇻🇳 **Tiếng Việt** | [README.VI.md](README.VI.md) | Cẩm nang chi tiết bằng Tiếng Việt, giải nghĩa 25 skills, quy trình TDD chuẩn. |
+| 🇬🇧 **English** | [README.EN.md](README.EN.md) | Exhaustive runbooks, all 21 skill details, learning paths, & production workflows. |
+| 🇻🇳 **Tiếng Việt** | [README.VI.md](README.VI.md) | Cẩm nang chi tiết bằng Tiếng Việt, giải nghĩa 21 skills, quy trình TDD chuẩn. |
 
 ---
 
@@ -89,14 +89,14 @@ Genesis is built on five core, state-of-the-art technological breakthroughs that
 1. **Context Compaction Engine (`compact-context.sh`)**: Automatically condenses architectural decisions, API states, and task history into `.codebase/context/` when prompt window boundaries are reached, freeing up massive context space while keeping 100% decision recall.
 2. **Tool Call Offloading (`offload-log.sh`)**: Intercepts massive terminal outputs (such as verbose test suites or compiler logs) and offloads them to disk log files (`.system_generated/tasks/`), returning a clean, structural status summary back to the model.
 3. **Verify-Fix Self-Healing Loop (`run-verify-loop.sh`)**: An autonomous, closed-loop debug engine that captures test failures, reads error output from disk logs, refactors implementation code, and re-runs tests autonomously up to 5 times until the build turns green.
-4. **5-Phase MVP Planner (`genesis-mvp-planning`)**: Guarantees architectural rigor. Runs immediately post-initialization to break down requirements into 5 standard delivery phases, ensuring core contracts are validated before feature coding.
+4. **5-Phase MVP Planner (`genesis-planning`)**: Guarantees architectural rigor. Breaks down requirements into 5 standard delivery phases, ensuring core contracts are validated before feature coding.
 5. **Documentation Drift Check Validation Gates (`validation_gates.sh`)**: A hook-level scan that alerts the engineer on phase state changes if source code changes are detected without matching spec updates under `.codebase/`.
 
 ---
 
-## 🚀 Next-Gen Harness Engineering Upgrades (v0.1.6)
+## 🚀 Next-Gen Harness Engineering Upgrades (v0.1.7)
 
-Genesis v0.1.6 introduces five advanced, state-of-the-art tools under `scripts/` to enforce type-safety, automate tests, establish visual-code integrity, protect token consumption, and enable self-healing loop memory recall:
+Genesis v0.1.7 introduces five advanced, state-of-the-art tools under `scripts/` to enforce type-safety, automate tests, establish visual-code integrity, protect token consumption, and enable self-healing loop memory recall:
 
 1. **Visual Architecture AST Sync (`scripts/spec_visual_sync.js`)**: Bidirectional compiler that syncs Mermaid ERD database diagrams (`database-erd.mmd`) to API contracts JSON schemas (`contracts/api/`) and vice-versa, establishing absolute visual-to-code design integrity.
 2. **Contract-Driven Test Auto-Generator (`scripts/test_generator.js`)**: Automatically compiles fully executable Mocha/Jest integration test suites in `tests/integration/` directly from your API contracts JSON response schemas, providing instant TDD "RED" skeletons.
@@ -145,8 +145,8 @@ After installation, simply type standard commands in your Codex chat interface t
   ├── genesis-upgrade-design/             # Existing visual audit and upgrade engine
   ├── genesis-api-contract/               # Enterprise API contract designer
   ├── genesis-spec-propagation/           # Automated spec propagation engine
-  ├── genesis-mvp-planning/               # 5-Phase MVP roadmap generator [NEW v0.1.6]
-  └── ... (19 more skills, total 25 skills)
+  ├── genesis-planning/                   # 5-Phase MVP roadmap planner
+  └── ... (15 more skills, total 21 skills)
 
 .codebase/                                # Persistent repository memory system
 contracts/                                # Enterprise API, UI, and Data contracts
@@ -162,9 +162,9 @@ observability/                            # Run records and architectural ADR lo
 
 - ✅ **Architecture Rating**: `10/10` (Enforced research-first + self-healing + spec-propagation)
 - ✅ **Codex-Only Enforcement**: `100%`
-- ✅ **Skills Matrix**: 25 fully implemented, structured, and verified skills
+- ✅ **Skills Matrix**: 21 fully implemented, structured, and verified skills
 - ✅ **Token Caching Savings**: `40% to 60%` verified per enterprise project
-- ✅ **Stability & Readiness**: Production Ready (`v0.1.6` - June 2026)
+- ✅ **Stability & Readiness**: Production Ready (`v0.1.7` - June 2026)
 
 ---
 
@@ -174,5 +174,5 @@ Licensed under the [MIT License](LICENSE). Contributions, bug reports, and featu
 
 ---
 
-**Genesis Codex Harness** v0.1.6 | June 2026
+**Genesis Codex Harness** v0.1.7 | June 2026
 👉 **[Full English Guide](README.EN.md) | [Tiếng Việt Hướng Dẫn](README.VI.md)**

package/VERSION

@@ -1,2 +1,2 @@
-0.1.6
+0.1.7