codex-genesis-harness 0.1.0

package/.codex/skills/project-genesis-harness/resources/project-template.md

@@ -0,0 +1,38 @@
+# Project
+
+## What This Project Is
+
+TBD
+
+## Target Users
+
+TBD
+
+## Core Value
+
+TBD
+
+## Product Scope
+
+- [ ] TBD
+
+## Out Of Scope
+
+- [ ] TBD
+
+## Constraints
+
+- [ ] TBD
+
+## Assumptions
+
+- [ ] TBD
+
+## Current Milestone
+
+TBD
+
+## Success Criteria
+
+- [ ] TBD
+

package/.codex/skills/project-genesis-harness/resources/quality-score-template.md

@@ -0,0 +1,11 @@
+# Quality Score
+
+| Area | Score | Issues | Next Action |
+|---|---:|---|---|
+| Architecture | 0/10 | TBD | TBD |
+| Tests | 0/10 | TBD | TBD |
+| Docs Sync | 0/10 | TBD | TBD |
+| Security | 0/10 | TBD | TBD |
+| Maintainability | 0/10 | TBD | TBD |
+| Observability | 0/10 | TBD | TBD |
+

package/.codex/skills/project-genesis-harness/resources/requirements-template.md

@@ -0,0 +1,26 @@
+# Requirements
+
+## Functional Requirements
+
+- [ ] TBD
+
+## Non-Functional Requirements
+
+- [ ] TBD
+
+## User Stories
+
+- [ ] As a user, I want TBD so that TBD.
+
+## Acceptance Criteria
+
+- [ ] TBD
+
+## Edge Cases
+
+- [ ] TBD
+
+## Known Unknowns
+
+- [ ] TBD
+

package/.codex/skills/project-genesis-harness/resources/research-template.md

@@ -0,0 +1,26 @@
+# Research
+
+## Question
+
+TBD
+
+## Local Codebase Findings
+
+- [ ] TBD
+
+## External Findings
+
+- [ ] TBD
+
+## Sources
+
+- TBD
+
+## Decision Impact
+
+TBD
+
+## Risks
+
+- [ ] TBD
+

package/.codex/skills/project-genesis-harness/resources/review-template.md

@@ -0,0 +1,22 @@
+# Review
+
+## Changed Files Reviewed
+
+- [ ] TBD
+
+## Findings
+
+| Severity | File | Issue | Required Action |
+|---|---|---|---|
+| TBD | TBD | TBD | TBD |
+
+## Cleanup Performed
+
+- [ ] Removed unnecessary files/code
+- [ ] Removed debug logs
+- [ ] Removed unrelated changes
+
+## Residual Risks
+
+- [ ] TBD
+

package/.codex/skills/project-genesis-harness/resources/spec-changelog-template.md

@@ -0,0 +1,6 @@
+# Spec Changelog
+
+| Date/Time | Change | Reason | Impacted Docs | Impacted Tests | Migration Notes |
+|---|---|---|---|---|---|
+| TBD | Initial harness setup | Project initialization | TBD | TBD | TBD |
+

package/.codex/skills/project-genesis-harness/resources/stack-template.md

@@ -0,0 +1,33 @@
+# Stack
+
+## Detected Stack
+
+Language:
+Framework:
+Runtime:
+Database:
+Package manager:
+Test framework:
+Lint:
+Typecheck:
+Build:
+Deployment:
+
+## Version Constraints
+
+- [ ] TBD
+
+## Local Development Commands
+
+```sh
+# start
+# test
+# lint
+# typecheck
+# build
+```
+
+## Tooling Gaps
+
+- [ ] TBD
+

package/.codex/skills/project-genesis-harness/resources/verification-template.md

@@ -0,0 +1,26 @@
+# Verification
+
+## Test Contract
+
+- [ ] Normal input/output
+- [ ] Edge cases
+- [ ] Invalid inputs
+- [ ] Expected errors
+- [ ] Acceptance tests
+
+## Commands
+
+```sh
+# TBD
+```
+
+## Results
+
+| Command | Result | Evidence |
+|---|---|---|
+| TBD | TBD | TBD |
+
+## Manual Verification
+
+- [ ] TBD
+

package/.codex/skills/project-genesis-harness/scripts/check-architecture-boundaries.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+root="${1:-.}"
+cd "$root"
+
+status=0
+for file in .planning/ARCHITECTURE.md .planning/diagrams/system-context.mmd .planning/diagrams/container-architecture.mmd; do
+  if [ ! -s "$file" ]; then
+    echo "Missing or empty architecture source: $file"
+    status=1
+  fi
+done
+
+if [ -f .planning/ARCHITECTURE.md ]; then
+  if ! grep -Eiq 'boundary|boundaries|dependency|forbidden|data flow' .planning/ARCHITECTURE.md; then
+    echo "ARCHITECTURE.md should document boundaries, dependency direction, forbidden patterns, or data flow."
+    status=1
+  fi
+fi
+
+exit "$status"
+

package/.codex/skills/project-genesis-harness/scripts/check-docs-sync.sh

@@ -0,0 +1,24 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+root="${1:-.}"
+cd "$root"
+
+if ! git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
+  echo "Not a git repository; docs sync check is limited to required files."
+  test -f .planning/SPEC_CHANGELOG.md
+  exit $?
+fi
+
+changed="$(git diff --name-only HEAD 2>/dev/null || git diff --name-only)"
+docs_changed="$(printf '%s\n' "$changed" | grep -E '^(\.planning/|docs/|README\.md|AGENTS\.md)' || true)"
+code_changed="$(printf '%s\n' "$changed" | grep -Ev '^(\.planning/|docs/|README\.md|AGENTS\.md)$' || true)"
+
+if [ -n "$code_changed" ] && [ -z "$docs_changed" ]; then
+  echo "Code changed but no planning/docs files changed."
+  echo "$code_changed"
+  exit 1
+fi
+
+echo "Docs sync check passed or no code changes detected."
+

package/.codex/skills/project-genesis-harness/scripts/check-no-debug-logs.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+root="${1:-.}"
+cd "$root"
+
+exclude='\.planning/|\.codex/skills/|node_modules/|vendor/|\.git/|build/|dist/|coverage/'
+pattern='console\.log|debugger;|var_dump\(|dd\(|print_r\(|pdb\.set_trace\(|binding\.pry|puts\s+["'\'']DEBUG|System\.out\.println'
+
+if command -v rg >/dev/null 2>&1; then
+  matches="$(rg -n --hidden -g '!.planning' -g '!.codex/skills' -g '!node_modules' -g '!vendor' -g '!dist' -g '!build' -g '!coverage' "$pattern" . || true)"
+else
+  matches="$(grep -RInE "$pattern" . 2>/dev/null | grep -Ev "$exclude" || true)"
+fi
+
+if [ -n "$matches" ]; then
+  echo "$matches"
+  exit 1
+fi
+
+echo "No obvious debug logs found."

package/.codex/skills/project-genesis-harness/scripts/check-required-planning-files.sh

@@ -0,0 +1,46 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+root="${1:-.}"
+cd "$root"
+
+required=(
+  ".planning/PROJECT.md"
+  ".planning/REQUIREMENTS.md"
+  ".planning/ROADMAP.md"
+  ".planning/STATE.md"
+  ".planning/STACK.md"
+  ".planning/ARCHITECTURE.md"
+  ".planning/DESIGN.md"
+  ".planning/API_DOCS.md"
+  ".planning/INTEGRATIONS.md"
+  ".planning/CONVENTIONS.md"
+  ".planning/PITFALLS.md"
+  ".planning/LESSONS_LEARNED.md"
+  ".planning/SPEC_CHANGELOG.md"
+  ".planning/FEATURE_INDEX.md"
+  ".planning/CHANGE_IMPACT_MATRIX.md"
+  ".planning/QUALITY_SCORE.md"
+  ".planning/ESCALATION.md"
+  ".planning/OBSERVABILITY.md"
+  ".planning/SMOKE_TESTS.md"
+  ".planning/JOURNEYS.md"
+  ".planning/SUMMARY.md"
+  ".planning/config.json"
+  ".planning/diagrams/system-context.mmd"
+  ".planning/diagrams/container-architecture.mmd"
+  ".planning/diagrams/database-erd.mmd"
+  ".planning/diagrams/deployment-flow.mmd"
+  ".planning/diagrams/roadmap-flow.mmd"
+)
+
+missing=0
+for file in "${required[@]}"; do
+  if [ ! -f "$file" ]; then
+    echo "Missing: $file"
+    missing=1
+  fi
+done
+
+exit "$missing"
+

package/.codex/skills/project-genesis-harness/scripts/check-spec-changelog.sh

@@ -0,0 +1,24 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+root="${1:-.}"
+cd "$root"
+
+if [ ! -f .planning/SPEC_CHANGELOG.md ]; then
+  echo "Missing .planning/SPEC_CHANGELOG.md"
+  exit 1
+fi
+
+if git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
+  changed="$(git diff --name-only HEAD 2>/dev/null || git diff --name-only)"
+  spec_affecting="$(printf '%s\n' "$changed" | grep -E 'api|route|schema|migration|model|ui|component|config|env|auth|security|integration' || true)"
+  changelog_changed="$(printf '%s\n' "$changed" | grep -x '.planning/SPEC_CHANGELOG.md' || true)"
+  if [ -n "$spec_affecting" ] && [ -z "$changelog_changed" ]; then
+    echo "Spec-affecting files changed but SPEC_CHANGELOG.md was not updated:"
+    echo "$spec_affecting"
+    exit 1
+  fi
+fi
+
+echo "Spec changelog check passed."
+

package/.codex/skills/project-genesis-harness/scripts/check-task-tracking.sh

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+root="${1:-.}"
+cd "$root"
+
+if [ ! -d .planning ]; then
+  echo "Missing .planning directory."
+  exit 1
+fi
+
+status=0
+while IFS= read -r file; do
+  case "$file" in
+    *TASKS.md|*PLAN.md|*REVIEW.md|*VERIFICATION.md|.planning/ROADMAP.md|.planning/STATE.md|.planning/SUMMARY.md)
+      if ! grep -Eq '\[( |~|x|!)\]' "$file"; then
+        echo "No checkbox tracking found: $file"
+        status=1
+      fi
+      ;;
+  esac
+done < <(find .planning -type f -name '*.md' | sort)
+
+exit "$status"
+

package/.codex/skills/project-genesis-harness/scripts/create-adr.sh

@@ -0,0 +1,74 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  echo "Usage: $0 <slug> [title] [root]" >&2
+  exit 2
+}
+
+slug="${1:-}"
+title="${2:-$slug}"
+root="${3:-.}"
+[ -n "$slug" ] || usage
+
+case "$slug" in
+  *[!a-z0-9-]*|'') echo "Slug must use lowercase letters, numbers, and hyphens." >&2; exit 2 ;;
+esac
+
+cd "$root"
+mkdir -p .planning/decisions
+
+next="$(
+  find .planning/decisions -maxdepth 1 -type f -name 'ADR-[0-9][0-9][0-9]-*.md' 2>/dev/null \
+    | sed -E 's#.*/ADR-([0-9]{3})-.*#\1#' \
+    | sort -n \
+    | tail -1
+)"
+if [ -z "$next" ]; then
+  number="001"
+else
+  number="$(printf '%03d' "$((10#$next + 1))")"
+fi
+
+file=".planning/decisions/ADR-${number}-${slug}.md"
+if [ -e "$file" ]; then
+  echo "ADR already exists: $file" >&2
+  exit 1
+fi
+
+cat > "$file" <<EOF
+# ADR-${number}: $title
+
+Status: Proposed
+Date: $(date +%Y-%m-%d)
+
+## Context
+
+TBD
+
+## Decision
+
+TBD
+
+## Alternatives Considered
+
+- [ ] TBD
+
+## Consequences
+
+- [ ] TBD
+
+## Risks
+
+- [ ] TBD
+
+## Mitigation
+
+- [ ] TBD
+
+## Verification Evidence
+
+TBD
+EOF
+
+echo "$file"

package/.codex/skills/project-genesis-harness/scripts/create-bug.sh

@@ -0,0 +1,160 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  echo "Usage: $0 <slug> [summary] [root]" >&2
+  exit 2
+}
+
+slug="${1:-}"
+summary="${2:-TBD}"
+root="${3:-.}"
+[ -n "$slug" ] || usage
+
+case "$slug" in
+  *[!a-z0-9-]*|'') echo "Slug must use lowercase letters, numbers, and hyphens." >&2; exit 2 ;;
+esac
+
+cd "$root"
+mkdir -p .planning/bugs
+
+next="$(
+  find .planning/bugs -maxdepth 1 -type d -name '[0-9][0-9][0-9]-*' 2>/dev/null \
+    | sed -E 's#.*/([0-9]{3})-.*#\1#' \
+    | sort -n \
+    | tail -1
+)"
+if [ -z "$next" ]; then
+  number="001"
+else
+  number="$(printf '%03d' "$((10#$next + 1))")"
+fi
+
+dir=".planning/bugs/${number}-${slug}"
+if [ -e "$dir" ]; then
+  echo "Bug directory already exists: $dir" >&2
+  exit 1
+fi
+
+mkdir -p "$dir"
+
+cat > "$dir/REPORT.md" <<EOF
+# Bug Report: $summary
+
+## Summary
+
+$summary
+
+## Expected Behavior
+
+- [ ] TBD
+
+## Actual Behavior
+
+- [ ] TBD
+
+## Reproduction Steps
+
+- [ ] TBD
+
+## Environment
+
+TBD
+EOF
+
+cat > "$dir/ROOT_CAUSE.md" <<'EOF'
+# Root Cause
+
+## Evidence
+
+- [ ] TBD
+
+## Root Cause
+
+TBD
+
+## Failed Assumption
+
+TBD
+
+## Correct Pattern
+
+TBD
+EOF
+
+cat > "$dir/PLAN.md" <<'EOF'
+# Plan
+
+## Files To Change
+
+### File: `path/to/file`
+
+Change:
+Why:
+Risk:
+Test:
+Docs impact:
+
+## Fix Steps
+
+- [ ] TBD
+
+## Rollback Plan
+
+- [ ] TBD
+EOF
+
+cat > "$dir/TEST_CONTRACT.md" <<'EOF'
+# Test Contract
+
+- [ ] Reproduction fails before fix
+- [ ] Regression test or verification fails before fix
+- [ ] Regression test or verification passes after fix
+- [ ] Related edge case is covered
+EOF
+
+cat > "$dir/TASKS.md" <<'EOF'
+# Tasks
+
+- [ ] Read PITFALLS.md
+- [ ] Read LESSONS_LEARNED.md
+- [ ] Reproduce bug
+- [ ] Identify root cause
+- [ ] Write regression test or verification
+- [ ] Fix bug
+- [ ] Run verification
+- [ ] Update LESSONS_LEARNED.md
+- [ ] Update docs if behavior changed
+- [ ] Review changed files
+- [ ] Update STATE.md
+- [ ] Update SPEC_CHANGELOG.md if needed
+EOF
+
+cat > "$dir/VERIFICATION.md" <<'EOF'
+# Verification
+
+- [ ] Define reproduction command
+- [ ] Run failing verification before fix
+- [ ] Run passing verification after fix
+
+| Command | Result | Evidence |
+|---|---|---|
+| TBD | TBD | TBD |
+EOF
+
+cat > "$dir/REVIEW.md" <<'EOF'
+# Review
+
+- [ ] Changed files reviewed
+- [ ] Regression coverage checked
+- [ ] Docs impact checked
+- [ ] Debug logs removed
+
+## Findings
+
+| Severity | File | Issue | Follow-Up |
+|---|---|---|---|
+| TBD | TBD | TBD | TBD |
+EOF
+
+echo "$dir"