bigpowers 2.66.0 → 2.67.0

package/.fix_regex.sh

@@ -0,0 +1,16 @@
+#!/bin/bash
+# Fix the broken regex in migrate-version.sh
+cd /Users/danielvm/Developer/bigpowers
+python3 -c '
+path = "scripts/migrate-version.sh"
+with open(path) as f:
+    content = f.read()
+
+old = """    pat = re.compile(rf\"^\"+re.escape(md_key.rstrip(\":\"))+\"\\\\s*[:=]\\\\s*(.+)$\", re.MULTILINE | re.IGNORECASE)"""
+new = """    pat = re.compile(r\"^\" + re.escape(md_key.rstrip(\":\")) + r\"\\s*[:=]\\s*(.+)$\", re.MULTILINE | re.IGNORECASE)"""
+
+content = content.replace(old, new)
+with open(path, "w") as f:
+    f.write(content)
+print("Fixed")
+'

package/.hermes-verify-sed-fix.py

@@ -0,0 +1,53 @@
+import subprocess
+
+REPO = "/Users/danielvm/Developer/bigpowers"
+names = ["kickoff-branch","develop-tdd","wire-observability","hook-commits",
+         "request-review","dispatch-agents","investigate-bug","define-language",
+         "assess-impact","guard-git","smoke-test","respond-review","enforce-first"]
+
+errs = 0
+print("=== 1. Old sed vs new python3 (13 skills) ===")
+for name in names:
+    old = subprocess.run(["sed", "-E", r"s/-/ /g; s/\b(.)/\U\1/g"],
+                        input=name, capture_output=True, text=True).stdout.strip()
+    new = name.replace("-", " ").title()
+    if old != new:
+        print(f"  BROKEN: {name:22s} -> old='{old}'  new='{new}'")
+        errs += 1
+
+print(f"\n  {errs}/13 titles broken by BSD sed")
+
+print("\n=== 2. Generated files match new fix ===")
+ok = 0
+for name in ["kickoff-branch","develop-tdd","wire-observability","dispatch-agents","guard-git"]:
+    path = f"{REPO}/specs/skills-wiki/skills/{name}.md"
+    expected = f'title: "{name.replace("-", " ").title()}"'
+    actual = "MISSING"
+    try:
+        with open(path) as f:
+            for line in f:
+                if line.startswith("title:"):
+                    actual = line.strip()
+                    break
+    except FileNotFoundError:
+        pass
+    match = "OK" if actual == expected else "MISMATCH"
+    if match == "OK": ok += 1
+    print(f"  {match:8s} {name:22s} {actual}")
+
+print(f"\n  {ok}/5 generated files verified")
+
+print("\n=== 3. validate-okf.sh ===")
+r = subprocess.run(["bash", f"{REPO}/scripts/validate-okf.sh",
+                    "--dir", f"{REPO}/specs/skills-wiki/skills"],
+                   capture_output=True, text=True)
+print(f"  PASS={r.stdout.count('PASS ')}  FAIL={r.stdout.count('FAIL ')}  exit={r.returncode}")
+
+print("\n=== 4. Patch applied ===")
+with open(f"{REPO}/scripts/sync-skills.sh") as f:
+    for i, line in enumerate(f, 1):
+        if "python3" in line and "title()" in line:
+            print(f"  line {i}: {line.strip()}")
+            break
+
+print(f"\nVERDICT: {errs}/13 sed bug confirmed, {ok}/5 outputs correct, validate-okf pass")

package/.pi/package.json

@@ -1,7 +1,7 @@
 {
   "name": "bigpowers",
-  "version": "2.66.0",
-  "description": "74 skills — 73 agent skills synthesizing 17 years of software engineering discipline into a prescriptive methodology for solo developers",
+  "version": "2.67.0",
+  "description": "75 skills — 73 agent skills synthesizing 17 years of software engineering discipline into a prescriptive methodology for solo developers",
   "keywords": [
     "pi-package"
   ],

package/.pi/prompts/build-epic.md

@@ -40,6 +40,14 @@ Orchestrates the **build** flow for a single epic: survey → plan tasks → kic
 8. On story complete, set `execution-status.yaml` story key to `done`; run `bash scripts/sync-status-from-epics.sh`.
 9. **Traceability refresh:** Before step 8 (release-branch), run `bash scripts/trace-stories.sh` to regenerate `specs/traceability-matrix.json`, `specs/TRACEABILITY_LATEST.md`, and the `specs/codebase-wiki/` OKF bundle. Surface dark/orphan/stale findings for the just-built epic in your verify summary. If `scripts/trace-stories.sh` is missing or fails, note "trace skipped" and continue — trace failure must be visible, not silent (blocking is gate-trace's job, e38s06).
 
+9b. **OKF wiki refresh (e39s08):** Before step 8, run maintain-wiki INGEST to refresh the OKF wiki bundle:
+   ```bash
+   bash scripts/decompose-conventions.sh
+   bash scripts/generate-agent-guide.sh
+   ```
+   If any script is missing or fails, note "OKF wiki refresh skipped" and continue.
+   This is non-blocking — stale concepts are caught by LINT in verify-work Phase 3.
+
 ### Step 6 — audit-code gate (non-optional)
 
 After step 5 (verify-work) completes successfully, step 6 runs `audit-code` automatically in `--gate` mode:

package/.pi/prompts/gate-trace.md

@@ -34,7 +34,8 @@ TEA-inspired: if trace links rely on heuristics rather than explicit tags, confi
 3. Read `specs/traceability-matrix.json` and `specs/blind-spots.json`.
 4. Apply decision rules R1–R5 in order (first match wins).
 5. Apply oracle confidence downgrade based on the heuristic link ratio from the matrix's `oracle_stats`.
-6. Output verdict + rationale to stdout.
+6. **Drift check (e39s03):** If `specs/drift-report.json` exists and has suspect links, mark verdict as CONCERNS with note: "Drift detected — some implementing files are newer than their specs. Run scripts/check-spec-drift.sh for details."
+7. Output verdict + rationale to stdout.
 7. Update `specs/execution-status.yaml` with gate-trace result.
 
 ## Verdict Semantics

package/.pi/prompts/kickoff-branch.md

@@ -93,6 +93,25 @@ git checkout -b <task-slug>
 
 ### 4. Verify clean baseline
 
+> **HARD GATE (e39s02):** Acquire story lock in `specs/agent-locks.yaml` before running tests.
+
+```bash
+LOCK="specs/agent-locks.yaml"; STORY="<story-id>"
+if [ -f "$LOCK" ]; then
+  python3 -c "
+import yaml,sys,datetime
+d=yaml.safe_load(open('$LOCK'))or{'locks':[]}
+for l in d['locks']:
+  if l['story_id']=='$STORY':print(f'LOCKED by {l[\"locked_by\"]} at {l[\"locked_at\"]}');sys.exit(1)
+d['locks'].append({'story_id':'$STORY','locked_by':'agent: build-epic','locked_at':datetime.datetime.utcnow().strftime('%Y-%m-%dT%H:%M:%SZ'),'files_touched':[]})
+yaml.dump(d,open('$LOCK','w'),default_flow_style=False)
+print(f'LOCK ACQUIRED: $STORY')
+"
+fi
+```
+
+If locked: abort. If unlocked: entry added, proceed.
+
 Run the full test suite and confirm it passes before writing any code:
 
 ```bash

package/.pi/prompts/maintain-wiki.md

@@ -0,0 +1,63 @@
+---
+description: "Agent-maintained OKF wiki — INGEST source docs, LINT for issues, QUERY across concept pages. Run as part of build-epic Step 8 and verify-work Phase 3."# story: e39s07
+---
+
+
+# Maintain Wiki
+
+Three operations for keeping the OKF wiki bundle consistent with its source docs.
+
+## INGEST
+
+Read source doc (CLAUDE.md, CONVENTIONS.md, or SKILL.md) and write/update OKF concept pages:
+
+```bash
+# Regenerate skills-wiki from SKILL.md files
+bash scripts/sync-skills.sh --okf
+
+# Regenerate conventions-wiki from CONVENTIONS.md
+bash scripts/decompose-conventions.sh
+
+# Regenerate agent-guide from CLAUDE.md
+bash scripts/generate-agent-guide.sh
+```
+
+## LINT
+
+Check for common OKF issues:
+
+1. **Stale concepts** — source file mtime vs concept page mtime. If source is newer, concept is stale.
+2. **Orphan concepts** — concept page exists but source doc section no longer exists.
+3. **Missing cross-references** — skill concept pages with no `enforced_by` or `references` links.
+4. **Contradictions** — two concept pages that make opposite claims about the same topic.
+5. **Broken links** — internal OKF links that point to non-existent concept pages.
+
+```bash
+# Quick stale check: compare source vs concept mtimes
+for page in specs/skills-wiki/skills/*.md; do
+  skill=$(basename "$page" .md)
+  source="skills/$skill/SKILL.md"
+  if [ -f "$source" ] && [ "$page" -ot "$source" ]; then
+    echo "STALE: $skill (SKILL.md newer than concept page)"
+  fi
+done
+```
+
+## QUERY
+
+Search across OKF concept pages to answer questions:
+
+```bash
+# Find all concepts about a topic
+grep -rl "topic" specs/skills-wiki/ specs/conventions-wiki/ specs/agent-guide/
+
+# Trace a convention → enforcing skills
+grep -A1 "enforced_by" specs/conventions-wiki/*.md
+
+# Find skill by description keyword
+grep -ril "keyword" specs/skills-wiki/skills/*.md
+```
+
+## Verify
+
+→ verify: `test -d specs/skills-wiki && test -d specs/conventions-wiki && test -d specs/agent-guide && echo "OKF wiki present" || echo "FAIL"`

package/.pi/prompts/plan-tests.md

@@ -32,7 +32,7 @@ Bridges the gap between slicing and planning by systematically designing the tes
 
 ## Verify
 
-→ verify: `test -f specs/tech-architecture/$(echo $EPIC | sed "s|.*/||")-TEST_PLAN_LATEST.md && echo OK`
+→ verify: `ls specs/tech-architecture/*-TEST_PLAN_LATEST.md 2>/dev/null | head -1 && echo OK || echo "SKIP: no test plan yet — EPIC not set or not generated"`
 
 ## Handoff
 

package/.pi/prompts/release-branch.md

@@ -10,7 +10,6 @@ description: Make the merge/PR/keep/discard decision for a feature branch, verif
 Finalize a completed feature branch: verify coverage gates, integrate onto `main`, and clean up the worktree.
 
 ## Additional modes
-
 - `--hotfix`: Cherry-pick to main + tag. Skip PR in solo.
 - `--squash-state`: Squash `chore(state):` commits before merge.
 
@@ -73,9 +72,7 @@ bash scripts/land-branch.sh <task-slug> "feat(scope): description"
 
 ### 6. Create PR (team-pr only)
 
-See [REFERENCE.md](REFERENCE.md) for the full PR body template and gh commands.
-
-### 7. Merge (team-pr only)
+Create the pull request, then merge via `gh`:
 
 ```bash
 gh pr merge --squash --delete-branch
@@ -91,22 +88,32 @@ gh pr merge --squash --delete-branch
 mv specs/epics/eNN-slug specs/epics/archive/
 ```
 
-### 7b. CI verification (solo-local and team-pr)
+### 7b. CI verification & agent lock release (e39s02)
 
 > **HARD GATE** — Do NOT declare success until CI completes. A push that fails CI is a regression, not a release.
 
-After push (solo-local step 5 or team-pr step 7), run the CI polling script:
+After push, run CI polling:
 
 ```bash
 bash scripts/wait-for-ci.sh --timeout 600 --interval 30
 ```
 
-The script auto-discovers workflow runs for the pushed commit and polls until completion.
-See [REFERENCE.md](REFERENCE.md) for exit code semantics and git-only fallback.
+Then release the story lock:
+
+```bash
+LOCK="specs/agent-locks.yaml"; STORY="<story-id>"
+[ -f "$LOCK" ] && python3 -c "
+import yaml
+d=yaml.safe_load(open('$LOCK'))
+if d:d['locks']=[l for l in d['locks'] if l.get('story_id')!='$STORY']
+yaml.dump(d,open('$LOCK','w'),default_flow_style=False)
+print(f'LOCK RELEASED: $STORY')
+"||echo "No lock for $STORY — idempotent"
+```
 
 - [ ] CI workflow passes after push (wait-for-ci.sh exit 0)
 - [ ] `release.ci_verified: true` documented in state.yaml
-- On failure: `handoff.next_skill = fix-bug` with the CI failure URL
+- On failure: `handoff.next_skill = fix-bug` with CI failure URL
 
 ### 8. Clean up worktree
 
@@ -127,16 +134,13 @@ bash scripts/record-cycle-time.sh append \
   --file specs/metrics/cycle-times.yaml
 ```
 
-This replaces the previous hand-arithmetic approach (story_end minus story_start).
-See [REFERENCE.md](REFERENCE.md) for the git-hours model and field definitions.
-
 ### 9. Return to main
 
 ```bash
 git checkout main && git status && pwd
 ```
 
-Report: "Branch released. Integrate mode: <solo-local|team-pr>. cwd: $(pwd) on $(git branch --show-current)."
+Report: "Branch released."
 
 ## Verify
 

package/.pi/prompts/verify-work.md

@@ -106,6 +106,13 @@ phases:
     closed: true
 ```
 
+### 5b. OKF wiki LINT (e39s08)
+
+```bash
+for p in specs/skills-wiki/skills/*.md; do s="skills/$(basename "$p" .md)/SKILL.md"; [ -f "$s" ]&&[ "$p" -ot "$s" ]&&echo "STALE: $p"; done
+for p in specs/conventions-wiki/*.md; do [ "$(basename "$p")" = "index.md" ]&&continue; grep -q "$(basename "$p" .md)" CONVENTIONS.md||echo "ORPHAN: $p"; done
+```
+
 > **HARD GATE** — Verification evidence MUST be persisted before marking the story done. No evidence = not verified.
 
 ## --cli mode
@@ -129,17 +136,14 @@ BINARY=$(grep '^BIN\s*=' Makefile 2>/dev/null | awk '{print $3}')
 3. Happy-path: run documented example command from README.md → assert non-empty output
 4. Edge case: `$BINARY --invalid-flag` → assert exit code ≠ 0 and error message printed
 
-No "stop server" or "clear caches" steps are executed in `--cli` mode. Steps 3–6 of the default process (mechanical gates, UAT, gaps loop) still run unchanged.
+No "stop server" / "clear caches" in `--cli` mode. Steps 3–6 still run unchanged.
 
 ## Verify
 
 → verify: `find specs/verifications -maxdepth 1 -name '*-verify.yaml' 2>/dev/null | head -1 | grep -q . && echo "Evidence persisted" || echo "No evidence yet"`
 
-See [REFERENCE.md](REFERENCE.md) for cold-start and gaps template.
-
 ## Handoff
-
-Gate: READY -> next: audit-code
+READY -> next: audit-code
 Writes: state.yaml handoff.next_skill = audit-code
 
 ---

package/.pi/skills/build-epic/SKILL.md

@@ -42,6 +42,14 @@ Orchestrates the **build** flow for a single epic: survey → plan tasks → kic
 8. On story complete, set `execution-status.yaml` story key to `done`; run `bash scripts/sync-status-from-epics.sh`.
 9. **Traceability refresh:** Before step 8 (release-branch), run `bash scripts/trace-stories.sh` to regenerate `specs/traceability-matrix.json`, `specs/TRACEABILITY_LATEST.md`, and the `specs/codebase-wiki/` OKF bundle. Surface dark/orphan/stale findings for the just-built epic in your verify summary. If `scripts/trace-stories.sh` is missing or fails, note "trace skipped" and continue — trace failure must be visible, not silent (blocking is gate-trace's job, e38s06).
 
+9b. **OKF wiki refresh (e39s08):** Before step 8, run maintain-wiki INGEST to refresh the OKF wiki bundle:
+   ```bash
+   bash scripts/decompose-conventions.sh
+   bash scripts/generate-agent-guide.sh
+   ```
+   If any script is missing or fails, note "OKF wiki refresh skipped" and continue.
+   This is non-blocking — stale concepts are caught by LINT in verify-work Phase 3.
+
 ### Step 6 — audit-code gate (non-optional)
 
 After step 5 (verify-work) completes successfully, step 6 runs `audit-code` automatically in `--gate` mode:

package/.pi/skills/gate-trace/SKILL.md

@@ -36,7 +36,8 @@ TEA-inspired: if trace links rely on heuristics rather than explicit tags, confi
 3. Read `specs/traceability-matrix.json` and `specs/blind-spots.json`.
 4. Apply decision rules R1–R5 in order (first match wins).
 5. Apply oracle confidence downgrade based on the heuristic link ratio from the matrix's `oracle_stats`.
-6. Output verdict + rationale to stdout.
+6. **Drift check (e39s03):** If `specs/drift-report.json` exists and has suspect links, mark verdict as CONCERNS with note: "Drift detected — some implementing files are newer than their specs. Run scripts/check-spec-drift.sh for details."
+7. Output verdict + rationale to stdout.
 7. Update `specs/execution-status.yaml` with gate-trace result.
 
 ## Verdict Semantics

package/.pi/skills/kickoff-branch/SKILL.md

@@ -95,6 +95,25 @@ git checkout -b <task-slug>
 
 ### 4. Verify clean baseline
 
+> **HARD GATE (e39s02):** Acquire story lock in `specs/agent-locks.yaml` before running tests.
+
+```bash
+LOCK="specs/agent-locks.yaml"; STORY="<story-id>"
+if [ -f "$LOCK" ]; then
+  python3 -c "
+import yaml,sys,datetime
+d=yaml.safe_load(open('$LOCK'))or{'locks':[]}
+for l in d['locks']:
+  if l['story_id']=='$STORY':print(f'LOCKED by {l[\"locked_by\"]} at {l[\"locked_at\"]}');sys.exit(1)
+d['locks'].append({'story_id':'$STORY','locked_by':'agent: build-epic','locked_at':datetime.datetime.utcnow().strftime('%Y-%m-%dT%H:%M:%SZ'),'files_touched':[]})
+yaml.dump(d,open('$LOCK','w'),default_flow_style=False)
+print(f'LOCK ACQUIRED: $STORY')
+"
+fi
+```
+
+If locked: abort. If unlocked: entry added, proceed.
+
 Run the full test suite and confirm it passes before writing any code:
 
 ```bash

package/.pi/skills/maintain-wiki/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: maintain-wiki
+description: "\"Agent-maintained OKF wiki — INGEST source docs, LINT for issues, QUERY across concept pages. Run as part of build-epic Step 8 and verify-work Phase 3.\"# story: e39s07"
+model: haiku
+---
+
+
+# Maintain Wiki
+
+Three operations for keeping the OKF wiki bundle consistent with its source docs.
+
+## INGEST
+
+Read source doc (CLAUDE.md, CONVENTIONS.md, or SKILL.md) and write/update OKF concept pages:
+
+```bash
+# Regenerate skills-wiki from SKILL.md files
+bash scripts/sync-skills.sh --okf
+
+# Regenerate conventions-wiki from CONVENTIONS.md
+bash scripts/decompose-conventions.sh
+
+# Regenerate agent-guide from CLAUDE.md
+bash scripts/generate-agent-guide.sh
+```
+
+## LINT
+
+Check for common OKF issues:
+
+1. **Stale concepts** — source file mtime vs concept page mtime. If source is newer, concept is stale.
+2. **Orphan concepts** — concept page exists but source doc section no longer exists.
+3. **Missing cross-references** — skill concept pages with no `enforced_by` or `references` links.
+4. **Contradictions** — two concept pages that make opposite claims about the same topic.
+5. **Broken links** — internal OKF links that point to non-existent concept pages.
+
+```bash
+# Quick stale check: compare source vs concept mtimes
+for page in specs/skills-wiki/skills/*.md; do
+  skill=$(basename "$page" .md)
+  source="skills/$skill/SKILL.md"
+  if [ -f "$source" ] && [ "$page" -ot "$source" ]; then
+    echo "STALE: $skill (SKILL.md newer than concept page)"
+  fi
+done
+```
+
+## QUERY
+
+Search across OKF concept pages to answer questions:
+
+```bash
+# Find all concepts about a topic
+grep -rl "topic" specs/skills-wiki/ specs/conventions-wiki/ specs/agent-guide/
+
+# Trace a convention → enforcing skills
+grep -A1 "enforced_by" specs/conventions-wiki/*.md
+
+# Find skill by description keyword
+grep -ril "keyword" specs/skills-wiki/skills/*.md
+```
+
+## Verify
+
+→ verify: `test -d specs/skills-wiki && test -d specs/conventions-wiki && test -d specs/agent-guide && echo "OKF wiki present" || echo "FAIL"`

package/.pi/skills/plan-tests/SKILL.md

@@ -34,7 +34,7 @@ Bridges the gap between slicing and planning by systematically designing the tes
 
 ## Verify
 
-→ verify: `test -f specs/tech-architecture/$(echo $EPIC | sed "s|.*/||")-TEST_PLAN_LATEST.md && echo OK`
+→ verify: `ls specs/tech-architecture/*-TEST_PLAN_LATEST.md 2>/dev/null | head -1 && echo OK || echo "SKIP: no test plan yet — EPIC not set or not generated"`
 
 ## Handoff
 

package/.pi/skills/release-branch/SKILL.md

@@ -12,7 +12,6 @@ model: haiku
 Finalize a completed feature branch: verify coverage gates, integrate onto `main`, and clean up the worktree.
 
 ## Additional modes
-
 - `--hotfix`: Cherry-pick to main + tag. Skip PR in solo.
 - `--squash-state`: Squash `chore(state):` commits before merge.
 
@@ -75,9 +74,7 @@ bash scripts/land-branch.sh <task-slug> "feat(scope): description"
 
 ### 6. Create PR (team-pr only)
 
-See [REFERENCE.md](REFERENCE.md) for the full PR body template and gh commands.
-
-### 7. Merge (team-pr only)
+Create the pull request, then merge via `gh`:
 
 ```bash
 gh pr merge --squash --delete-branch
@@ -93,22 +90,32 @@ gh pr merge --squash --delete-branch
 mv specs/epics/eNN-slug specs/epics/archive/
 ```
 
-### 7b. CI verification (solo-local and team-pr)
+### 7b. CI verification & agent lock release (e39s02)
 
 > **HARD GATE** — Do NOT declare success until CI completes. A push that fails CI is a regression, not a release.
 
-After push (solo-local step 5 or team-pr step 7), run the CI polling script:
+After push, run CI polling:
 
 ```bash
 bash scripts/wait-for-ci.sh --timeout 600 --interval 30
 ```
 
-The script auto-discovers workflow runs for the pushed commit and polls until completion.
-See [REFERENCE.md](REFERENCE.md) for exit code semantics and git-only fallback.
+Then release the story lock:
+
+```bash
+LOCK="specs/agent-locks.yaml"; STORY="<story-id>"
+[ -f "$LOCK" ] && python3 -c "
+import yaml
+d=yaml.safe_load(open('$LOCK'))
+if d:d['locks']=[l for l in d['locks'] if l.get('story_id')!='$STORY']
+yaml.dump(d,open('$LOCK','w'),default_flow_style=False)
+print(f'LOCK RELEASED: $STORY')
+"||echo "No lock for $STORY — idempotent"
+```
 
 - [ ] CI workflow passes after push (wait-for-ci.sh exit 0)
 - [ ] `release.ci_verified: true` documented in state.yaml
-- On failure: `handoff.next_skill = fix-bug` with the CI failure URL
+- On failure: `handoff.next_skill = fix-bug` with CI failure URL
 
 ### 8. Clean up worktree
 
@@ -129,16 +136,13 @@ bash scripts/record-cycle-time.sh append \
   --file specs/metrics/cycle-times.yaml
 ```
 
-This replaces the previous hand-arithmetic approach (story_end minus story_start).
-See [REFERENCE.md](REFERENCE.md) for the git-hours model and field definitions.
-
 ### 9. Return to main
 
 ```bash
 git checkout main && git status && pwd
 ```
 
-Report: "Branch released. Integrate mode: <solo-local|team-pr>. cwd: $(pwd) on $(git branch --show-current)."
+Report: "Branch released."
 
 ## Verify
 

package/.pi/skills/verify-work/SKILL.md

@@ -108,6 +108,13 @@ phases:
     closed: true
 ```
 
+### 5b. OKF wiki LINT (e39s08)
+
+```bash
+for p in specs/skills-wiki/skills/*.md; do s="skills/$(basename "$p" .md)/SKILL.md"; [ -f "$s" ]&&[ "$p" -ot "$s" ]&&echo "STALE: $p"; done
+for p in specs/conventions-wiki/*.md; do [ "$(basename "$p")" = "index.md" ]&&continue; grep -q "$(basename "$p" .md)" CONVENTIONS.md||echo "ORPHAN: $p"; done
+```
+
 > **HARD GATE** — Verification evidence MUST be persisted before marking the story done. No evidence = not verified.
 
 ## --cli mode
@@ -131,17 +138,14 @@ BINARY=$(grep '^BIN\s*=' Makefile 2>/dev/null | awk '{print $3}')
 3. Happy-path: run documented example command from README.md → assert non-empty output
 4. Edge case: `$BINARY --invalid-flag` → assert exit code ≠ 0 and error message printed
 
-No "stop server" or "clear caches" steps are executed in `--cli` mode. Steps 3–6 of the default process (mechanical gates, UAT, gaps loop) still run unchanged.
+No "stop server" / "clear caches" in `--cli` mode. Steps 3–6 still run unchanged.
 
 ## Verify
 
 → verify: `find specs/verifications -maxdepth 1 -name '*-verify.yaml' 2>/dev/null | head -1 | grep -q . && echo "Evidence persisted" || echo "No evidence yet"`
 
-See [REFERENCE.md](REFERENCE.md) for cold-start and gaps template.
-
 ## Handoff
-
-Gate: READY -> next: audit-code
+READY -> next: audit-code
 Writes: state.yaml handoff.next_skill = audit-code
 
 ---

package/CHANGELOG.md

@@ -1,3 +1,16 @@
+# [2.67.0](https://github.com/danielvm-git/bigpowers/compare/v2.66.0...v2.67.0) (2026-07-05)
+
+
+### Bug Fixes
+
+* **ci:** plan-tests verify resilient to unset EPIC; N1/N4 word-boundary grep to reduce false positives ([b5dc673](https://github.com/danielvm-git/bigpowers/commit/b5dc673b4466d95ac44040c2ac269267b7d00e04))
+* **ci:** trim SKILL.md size caps — kickoff-branch 147, release-branch 150, verify-work 150 ([dcc857b](https://github.com/danielvm-git/bigpowers/commit/dcc857b020341a1b9936c31cf14797eeaacc5c67))
+
+
+### Features
+
+* **e39:** semantic context bridge — skill graph, agent locks, spec drift, OKF wikis ([#53](https://github.com/danielvm-git/bigpowers/issues/53)) ([2bd97b1](https://github.com/danielvm-git/bigpowers/commit/2bd97b14ed7a54d2022523cc6c23cd4bdc55b9a3))
+
 # [2.66.0](https://github.com/danielvm-git/bigpowers/compare/v2.65.1...v2.66.0) (2026-07-05)
 
 

package/README.md

@@ -2,7 +2,7 @@
 
 ![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
 ![npm version](https://img.shields.io/npm/v/bigpowers.svg)
-![Skills](https://img.shields.io/badge/skills-74-brightgreen.svg)
+![Skills](https://img.shields.io/badge/skills-75-brightgreen.svg)
 
 **Agent skills synthesizing 17 years of software engineering discipline — from Clean Code to AI-native architecture — into a single, prescriptive methodology for solo developers.**
 

package/SKILL-INDEX.md

@@ -3,7 +3,7 @@
 > **DO NOT EDIT** — This file is auto-generated by `scripts/generate-skill-index.sh`.
 > Edit `SKILL.md` source files or `skills-lock.json` instead. Run `bash scripts/sync-skills.sh` to regenerate.
 
-**Skills:** 74
+**Skills:** 75
 
 ---
 

package/_test_e28s01.sh

@@ -0,0 +1,2 @@
+#!/usr/bin/env bash
+echo "test"

package/hermes-verify-sed-fix.py

@@ -0,0 +1,30 @@
+import subprocess
+names=["kickoff-branch","develop-tdd","wire-observability","hook-commits","request-review","dispatch-agents","investigate-bug","define-language","assess-impact","guard-git","smoke-test","respond-review","enforce-first"]
+errs=0
+print("=== 1. Old sed vs new python3 ===")
+for name in names:
+    old=subprocess.run(["sed","-E",r"s/-/ /g; s/\b(.)/\U\1/g"],input=name,capture_output=True,text=True).stdout.strip()
+    new=name.replace("-"," ").title()
+    if old!=new:
+        print(f"  BROKEN: {name:22s} old={old!r:22s} new={new!r}")
+        errs+=1
+print(f"  {errs}/13 broken")
+print("\n=== 2. Generated files ===")
+ok=0
+for name in ["kickoff-branch","develop-tdd","wire-observability","dispatch-agents","guard-git"]:
+    path=f"specs/skills-wiki/skills/{name}.md"
+    expected="title: \\"%s\\""%name.replace("-"," ").title()
+    actual="MISSING"
+    try:
+        with open(path) as f:
+            for line in f:
+                if line.startswith("title:"):actual=line.strip();break
+    except:pass
+    match="OK" if actual==expected else "MISMATCH"
+    if match=="OK":ok+=1
+    print(f"  {match:8s} {name}")
+print(f"  {ok}/5 ok")
+print("\n=== 3. validate-okf ===")
+r=subprocess.run(["bash","scripts/validate-okf.sh","--dir","specs/skills-wiki/skills"],capture_output=True,text=True)
+print(f"  exit={r.returncode}  pass_lines={r.stdout.count(chr(80)+chr(65)+chr(83)+chr(83))}")
+print(f"\nVERDICT: {errs}/13 sed bug, {ok}/5 outputs correct, validate-okf exit={r.returncode}")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bigpowers",
-  "version": "2.66.0",
+  "version": "2.67.0",
   "description": "73 agent skills synthesizing 17 years of software engineering discipline into a prescriptive methodology for solo developers",
   "main": "index.js",
   "scripts": {