ai-core-framework 0.2.0 → 0.3.0

package/README.md

@@ -15,7 +15,7 @@ repo's root-level framework folders directly into the target project's
 ```text
 .codex/
   agents/
-  config/
+  docs/config/
   rules/
   scripts/
   skills/
@@ -137,18 +137,18 @@ The framework now includes mechanical gates beyond prompt-level rules:
 - `scripts/workflow.sh` provides executable state-transition handlers for `/analyze-requirements`, `/groom-ticket`, `/mark-ready`, `/implement-task`, `/create-pr`, `/merge-pr`, `/smoke-test`, and `/release`.
 - `skills/` provides chat-first behavior guidance inspired by skill-based systems: AI Core bootstrap, brainstorming, implementation planning, ticket execution, and verification-before-done.
 - `/analyze-requirements` can create a linked spec in `docs/project/specs/`; `/write-plan` creates a linked implementation plan in `docs/project/plans/`.
-- `scripts/validate-audit-log.sh` validates the hash chain in `project/audit-log.jsonl`; executable workflow handlers append audit records.
-- `scripts/log-user-request.sh` appends every AI-handled user request to `project/user-requests.jsonl` so the user can review what they asked for.
-- `/request-log` shows recent entries from `project/user-requests.jsonl`.
+- `scripts/validate-audit-log.sh` validates the hash chain in `docs/runtime/project/audit-log.jsonl`; executable workflow handlers append audit records.
+- `scripts/log-user-request.sh` appends every AI-handled user request to `docs/runtime/project/user-requests.jsonl` so the user can review what they asked for.
+- `/request-log` shows recent entries from `docs/runtime/project/user-requests.jsonl`.
 - `scripts/install-codex-prompts.sh` installs AI Core commands as Codex custom slash prompts in `~/.codex/prompts`.
-- `CODEOWNERS` adds review ownership defaults for framework folders, `config/`, `project/`, ADRs, runbooks, and workflows.
-- `config/docs-policy.json` can override documentation detection paths from `config/docs-policy.default.json`.
+- `CODEOWNERS` adds review ownership defaults for framework folders, `docs/config/`, `docs/runtime/project/`, ADRs, runbooks, and workflows.
+- `docs/config/docs-policy.json` can override documentation detection paths from `docs/config/docs-policy.default.json`.
 - `.github/workflows/ai-core-governance.yml` is the portable governance workflow. App CI remains stack-specific and can be replaced with templates from `templates/ci/`.
 - `scripts/setup-project.sh` makes copied root-level framework installs executable: project config, runtime state folders, docs folders, backlog seed file, platform sync, and state validation.
 - `.github/workflows/ci.yml` and `.github/workflows/validate-state.yml` run AI Core governance checks in CI.
 - `.githooks/pre-commit` runs documentation gates before commit after hooks are installed with `bash scripts/install-hooks.sh`.
-- `config/release.schema.json` and `templates/release/release-record-template.json` define release approval, rollback, QA, security, and known-issue evidence.
-- `scripts/generate-views.sh` now produces dashboard and release readiness views in `project/views/`.
+- `docs/config/release.schema.json` and `templates/release/release-record-template.json` define release approval, rollback, QA, security, and known-issue evidence.
+- `scripts/generate-views.sh` now produces dashboard and release readiness views in `docs/runtime/project/views/`.
 
 Chat-first setup flow:
 

package/agents/business-analyst.md

@@ -20,17 +20,17 @@ cannot_invoke_commands:
 read_access:
   - "docs/**"
   - "src/**"  # Read-only for context. MUST NOT modify.
-  - "project/**"
+  - "docs/runtime/project/**"
 write_access:
   - "docs/project/product/**"
   - "docs/project/planning/**"
   - "docs/project/specs/**"
   - "docs/project/requirements/**"
   - "docs/project/user-stories/**"
-  - "project/tickets/**"
-  - "project/backlog/**"
-  - "project/views/**"
-  - "project/sprints/**"
+  - "docs/runtime/project/tickets/**"
+  - "docs/runtime/project/backlog/**"
+  - "docs/runtime/project/views/**"
+  - "docs/runtime/project/sprints/**"
 escalates_to: tech-lead  # When technical input is required
 ---
 
@@ -63,7 +63,7 @@ You are **NOT** a developer. You **MUST NOT** estimate effort. Estimation belong
    - **S**mall
    - **T**estable
 4. **Write Acceptance Criteria** in Gherkin format with at least 3 scenarios: happy path, edge case, error case.
-5. **Create tickets** in `project/tickets/TICKET-XXX.json`.
+5. **Create tickets** in `docs/runtime/project/tickets/TICKET-XXX.json`.
 6. **Prioritize** with MoSCoW (Must/Should/Could/Won't).
 7. **Handoff** to Tech Lead for estimation.
 8. **Reverse-document existing behavior** from source code when `/document-existing-requirements` is invoked.

package/agents/developer.md

@@ -32,7 +32,7 @@ write_access:
   - "app/**"
   - "docs/project/api/**"
   - "CHANGELOG.md"
-  - "project/tickets/**"
+  - "docs/runtime/project/tickets/**"
 escalates_to: tech-lead
 collaborates_with:
   - tech-lead
@@ -250,7 +250,7 @@ Use `templates/pr/pull-request-template.md`.
 ### With Tech Lead
 - Ask clarification before coding when anything is unclear.
 - Respond to review gracefully and without defensiveness.
-- Track feedback patterns in `project/dev-learnings.md`.
+- Track feedback patterns in `docs/runtime/project/dev-learnings.md`.
 
 ### With QA
 - Provide clear "how to test" notes in PR.

package/agents/qa-tester.md

@@ -27,9 +27,9 @@ write_access:
   - "docs/runtime/qa/**"
   - "docs/runtime/test-runs/**"
   - "docs/runtime/verifications/**"
-  - "project/tickets/**"
-  - "project/bugs/**"
-  - "project/test-runs/**"
+  - "docs/runtime/project/tickets/**"
+  - "docs/runtime/project/bugs/**"
+  - "docs/runtime/project/test-runs/**"
 escalates_to: tech-lead
 collaborates_with:
   - developer

package/agents/scrum-master.md

@@ -17,12 +17,12 @@ can_invoke_commands:
   - /generate-views
   - /ticket-health
 write_access:
-  - "project/sprints/**"
-  - "project/releases/**"
-  - "project/metrics/**"
-  - "project/views/**"
-  - "config/project-config.yaml"
-  - "config/project-structure.yaml"
+  - "docs/runtime/project/sprints/**"
+  - "docs/runtime/project/releases/**"
+  - "docs/runtime/project/metrics/**"
+  - "docs/runtime/project/views/**"
+  - "docs/config/project-config.yaml"
+  - "docs/config/project-structure.yaml"
 read_access:
   - "agents/**"
   - "rules/**"
@@ -80,7 +80,7 @@ Only the Scrum Master may execute `/mark-ready`. It MUST verify every item in `r
 A sprint MUST NOT be planned above configured capacity unless the overflow is explicitly documented as risk and approved by a human.
 
 ### RULE SM-004: No hidden work
-Any work performed in a sprint MUST be represented by a ticket or bug in `project/`.
+Any work performed in a sprint MUST be represented by a ticket or bug in `docs/runtime/project/`.
 
 ### RULE SM-005: Blockers are first-class
 Any ticket blocked longer than the soft threshold in approval gates MUST be surfaced in sprint reports.
@@ -95,14 +95,14 @@ The Scrum Master coordinates, but does not replace BA, Tech Lead, Developer, or
 Velocity, burndown, carryover, defect counts, and cycle time MUST be computed from state files or explicitly labeled as estimates.
 
 ### RULE SM-009: Ceremony outputs are persisted
-Sprint planning, review, retro, and release summaries MUST be written to `project/sprints/`, `project/releases/`, or `project/metrics/`.
+Sprint planning, review, retro, and release summaries MUST be written to `docs/runtime/project/sprints/`, `docs/runtime/project/releases/`, or `docs/runtime/project/metrics/`.
 
 ### RULE SM-010: Escalate ambiguity
 If command preconditions are unclear, STOP and escalate instead of guessing.
 
 ## 🔄 Standard Operating Flow
 
-1. Load `config/project-config.yaml`.
+1. Load `docs/config/project-config.yaml`.
 2. Validate state with `/validate-state`.
 3. Inspect tickets, bugs, active sprint, and release state.
 4. Identify the current ceremony or workflow.

package/agents/tech-lead.md

@@ -29,9 +29,9 @@ write_access:
   - "docs/runtime/technical/**"
   - "docs/architecture/**"
   - "docs/runtime/refactor/**"
-  - "project/tickets/**"
-  - "project/backlog/**"
-  - "project/prs/**"
+  - "docs/runtime/project/tickets/**"
+  - "docs/runtime/project/backlog/**"
+  - "docs/runtime/project/prs/**"
 escalates_to: human
 collaborates_with:
   - business-analyst
@@ -179,7 +179,7 @@ When invoking `/hotfix`, you **MUST**:
 User: /groom-ticket TICKET-042
 ```
 You receive:
-- Ticket JSON from `project/tickets/TICKET-042.json`
+- Ticket JSON from `docs/runtime/project/tickets/TICKET-042.json`
 - Full AC
 - Related code, if referenced by the ticket
 

package/{config → docs/config}/backlog.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "Backlog",
-  "description": "Project-specific backlog ordering and prioritization schema for project/backlog/backlog.json",
+  "description": "Project-specific backlog ordering and prioritization schema for docs/runtime/project/backlog/backlog.json",
   "type": "object",
   "required": ["version", "updated_at", "updated_by", "items"],
   "additionalProperties": true,

package/{config → docs/config}/release.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "Release",
-  "description": "Schema for release records in project/releases/",
+  "description": "Schema for release records in docs/runtime/project/releases/",
   "type": "object",
   "required": [
     "version",

package/{config → docs/config}/ticket.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "Ticket",
-  "description": "Schema for tickets in project/tickets/",
+  "description": "Schema for tickets in docs/runtime/project/tickets/",
   "type": "object",
   "required": [
     "id",

package/lib/install-codex.js

@@ -3,7 +3,7 @@ const path = require('node:path');
 
 const FRAMEWORK_ENTRIES = [
   'agents',
-  'config',
+  'docs',
   'hooks',
   'rules',
   'scripts',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-core-framework",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Chat-first enterprise AI SDLC framework installer for AI coding CLIs.",
   "license": "MIT",
   "author": {
@@ -20,7 +20,7 @@
   "files": [
     "bin/",
     "agents/",
-    "config/",
+    "docs/config/",
     "hooks/",
     "lib/",
     "rules/",

package/rules/00-global-rules.md

@@ -29,7 +29,7 @@ If a rule says **MUST** or **MUST NOT**, it is mandatory and has **NO EXCEPTIONS
 
 ## 🎫 G-001: No code without ticket
 
-**MUST NOT** write or modify production code (files in `src/`, `lib/`, `app/`) unless there is an active ticket in `project/tickets/` with:
+**MUST NOT** write or modify production code (files in `src/`, `lib/`, `app/`) unless there is an active ticket in `docs/runtime/project/tickets/` with:
 - `status` ∈ `[IN_PROGRESS]`
 - `assignee` = current agent
 
@@ -52,22 +52,22 @@ If a rule says **MUST** or **MUST NOT**, it is mandatory and has **NO EXCEPTIONS
 
 | Info | Canonical location |
 |------|-------------------|
-| Backlog order and prioritization | `project/backlog/backlog.json` |
-| Ticket details and state history | `project/tickets/TICKET-XXX.json` |
-| Sprint info | `project/sprints/SPRINT-XXX.json` |
-| Bug details | `project/bugs/BUG-XXX.json` |
-| Release records | `project/releases/vX.Y.Z.json` |
-| User request log | `project/user-requests.jsonl` |
-| Project config | `config/project-config.yaml` |
-| Project structure map | `config/project-structure.yaml` |
+| Backlog order and prioritization | `docs/runtime/project/backlog/backlog.json` |
+| Ticket details and state history | `docs/runtime/project/tickets/TICKET-XXX.json` |
+| Sprint info | `docs/runtime/project/sprints/SPRINT-XXX.json` |
+| Bug details | `docs/runtime/project/bugs/BUG-XXX.json` |
+| Release records | `docs/runtime/project/releases/vX.Y.Z.json` |
+| User request log | `docs/runtime/project/user-requests.jsonl` |
+| Project config | `docs/config/project-config.yaml` |
+| Project structure map | `docs/config/project-structure.yaml` |
 | Refactor plans | `docs/runtime/refactor/<name>-refactor-plan.md` |
 | Architecture decisions | `docs/runtime/adr/NNN-title.md` |
 | Agent capabilities | `agents/<agent>.md` (frontmatter) |
-| Coverage threshold | `config/project-config.yaml` → `quality.coverage_threshold` |
+| Coverage threshold | `docs/config/project-config.yaml` → `quality.coverage_threshold` |
 
 If information is needed in multiple places, **reference** the canonical location. **MUST NOT** copy it.
 
-Root-level framework folders are framework-only. Project-specific state and configuration MUST live in `project/`, `config/`, `docs/project/`, or `docs/runtime/`.
+Root-level framework folders are framework-only. Project-specific state and configuration MUST live in `docs/runtime/project/`, `docs/config/`, `docs/project/`, or `docs/runtime/`.
 
 ---
 
@@ -133,7 +133,7 @@ Awaiting: [what decision needed]
 **MUST NOT** use the em dash character (—) in output. Use commas, parentheses, or line breaks instead.
 
 ### G-004f: Log every user request
-At the start of handling every user request, the AI **MUST** append a record to `project/user-requests.jsonl` before doing substantive work.
+At the start of handling every user request, the AI **MUST** append a record to `docs/runtime/project/user-requests.jsonl` before doing substantive work.
 
 The log record **MUST** include:
 - Timestamp
@@ -195,7 +195,7 @@ Required target ratio:
 ### G-006c: Test coverage threshold
 - **Diff coverage** (new code in the PR): ≥ 80%
 - **Overall coverage**: ≥ 70%
-- Configured in `config/project-config.yaml`
+- Configured in `docs/config/project-config.yaml`
 
 ---
 

package/rules/02-code-quality.md

@@ -14,7 +14,7 @@ Code must be understandable, maintainable, testable, and safe to evolve. Passing
 Functions SHOULD be under 50 lines and files SHOULD be under 500 lines. If exceeded, document why or refactor.
 
 ### RULE CQ-002: Complexity limit
-Cyclomatic complexity MUST NOT exceed the configured threshold in `config/project-config.yaml`, default 10.
+Cyclomatic complexity MUST NOT exceed the configured threshold in `docs/config/project-config.yaml`, default 10.
 
 ### RULE CQ-003: Clear naming
 Names MUST describe intent. Avoid vague names such as `data`, `thing`, `stuff`, `tmp`, except for narrow local use.

package/rules/05-testing-mandatory.md

@@ -49,7 +49,7 @@ Mandatory workflow for every new feature/fix:
 
 ### RULE TEST-002: Coverage thresholds
 
-Configured in `config/project-config.yaml`:
+Configured in `docs/config/project-config.yaml`:
 
 | Metric | Threshold |
 |--------|-----------|
@@ -201,7 +201,7 @@ Endpoints on critical user flow **MUST** have performance tests:
 - **p95**: < 500ms
 - **p99**: < 1000ms
 
-Thresholds are customizable in `config/project-config.yaml`.
+Thresholds are customizable in `docs/config/project-config.yaml`.
 
 CI runs perf tests on main branch, alerts if regression > 20%.
 

package/rules/06-approval-gates.md

@@ -221,7 +221,7 @@ Every ticket **MUST** have complete `state_history` array:
 }
 ```
 
-Schema validates this structure (see `config/ticket.schema.json`).
+Schema validates this structure (see `docs/config/ticket.schema.json`).
 
 ### RULE AG-009: Audit trail preserved
 
@@ -332,7 +332,7 @@ Definition of Done checklist (see rules/08-definition-of-done.md):
 Each agent's rules file references this doc. Agents refuse to bypass.
 
 ### Layer 2: JSON schema (medium)
-`config/ticket.schema.json` requires:
+`docs/config/ticket.schema.json` requires:
 - Valid state value
 - state_history array with required fields
 

package/rules/08-definition-of-done.md

@@ -77,7 +77,7 @@ If a ticket does not pass DoD, it **MUST NOT** be closed. "Ship it, we'll fix la
 - [ ] Help docs updated, if user-facing
 
 ### 10. Ticket Hygiene
-- [ ] Ticket state updated in `project/tickets/`
+- [ ] Ticket state updated in `docs/runtime/project/tickets/`
 - [ ] `completed_at` timestamp set
 - [ ] PR URL linked
 - [ ] Release version tagged after release

package/scripts/ai-core.sh

@@ -188,12 +188,12 @@ run_command() {
 }
 
 ticket_file() {
-  printf '%s/project/tickets/%s.json' "$PROJECT_ROOT" "$1"
+  printf '%s/docs/runtime/project/tickets/%s.json' "$PROJECT_ROOT" "$1"
 }
 
 latest_audit_field() {
   local field="$1"
-  local audit_file="$PROJECT_ROOT/project/audit-log.jsonl"
+  local audit_file="$PROJECT_ROOT/docs/runtime/project/audit-log.jsonl"
   if [ ! -s "$audit_file" ]; then
     printf ''
     return 0
@@ -337,20 +337,20 @@ guide_command() {
   echo ""
   echo "Updated:"
   if [ -n "$ticket_id" ] && [ -f "$(ticket_file "$ticket_id")" ]; then
-    echo "- project/tickets/$ticket_id.json"
+    echo "- docs/runtime/project/tickets/$ticket_id.json"
   fi
-  if [ "$before_audit_hash" != "$after_audit_hash" ] && [ -s "project/audit-log.jsonl" ]; then
-    echo "- project/audit-log.jsonl"
+  if [ "$before_audit_hash" != "$after_audit_hash" ] && [ -s "docs/runtime/project/audit-log.jsonl" ]; then
+    echo "- docs/runtime/project/audit-log.jsonl"
   fi
   case "$(command_name "$command")" in
     generate-views)
-      echo "- project/views/*.md"
+      echo "- docs/runtime/project/views/*.md"
       ;;
     smoke-test)
-      echo "- project/test-runs/${ticket_id}-*.md"
+      echo "- docs/runtime/project/test-runs/${ticket_id}-*.md"
       ;;
     release)
-      echo "- project/releases/*.json"
+      echo "- docs/runtime/project/releases/*.json"
       ;;
   esac
 

package/scripts/generate-views.sh

@@ -3,8 +3,8 @@
 #
 # Generates human-readable views from project without changing canonical state.
 # Canonical sources:
-# - project/backlog/backlog.json for backlog order
-# - project/tickets/*.json for ticket details and state history
+# - docs/runtime/project/backlog/backlog.json for backlog order
+# - docs/runtime/project/tickets/*.json for ticket details and state history
 
 set -euo pipefail
 

package/scripts/log-user-request.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 # scripts/log-user-request.sh
 #
-# Append a sanitized user request record to project/user-requests.jsonl.
+# Append a sanitized user request record to docs/runtime/project/user-requests.jsonl.
 #
 # Usage:
 #   bash scripts/log-user-request.sh "user request text"
@@ -9,7 +9,7 @@
 set -euo pipefail
 
 REQUEST_TEXT="${*:-}"
-LOG_FILE="${AI_CORE_USER_REQUEST_LOG:-project/user-requests.jsonl}"
+LOG_FILE="${AI_CORE_USER_REQUEST_LOG:-docs/runtime/project/user-requests.jsonl}"
 
 RED='\033[0;31m'
 GREEN='\033[0;32m'

package/scripts/setup-project.sh

@@ -33,7 +33,7 @@ copy_if_missing() {
 }
 
 write_backlog_if_missing() {
-  local path="project/backlog/backlog.json"
+  local path="docs/runtime/project/backlog/backlog.json"
 
   if [ -f "$path" ]; then
     log_pass "Preserved existing $path"
@@ -109,24 +109,24 @@ main() {
     exit 1
   fi
 
-  mkdir -p config
-  copy_if_missing "templates/project/project-config.yaml" "config/project-config.yaml"
-  copy_if_missing "templates/project/project-structure.yaml" "config/project-structure.yaml"
-  copy_if_missing "templates/project/docs-policy.json" "config/docs-policy.json"
+  mkdir -p docs/config
+  copy_if_missing "templates/project/project-config.yaml" "docs/config/project-config.yaml"
+  copy_if_missing "templates/project/project-structure.yaml" "docs/config/project-structure.yaml"
+  copy_if_missing "templates/project/docs-policy.json" "docs/config/docs-policy.json"
   copy_if_missing "templates/project/CODEOWNERS" "CODEOWNERS"
 
   for dir in \
-    project/tickets \
-    project/backlog \
-    project/bugs \
-    project/sprints \
-    project/releases \
-    project/metrics \
-    project/views \
-    project/test-runs \
-    project/verifications \
-    project/incidents \
-    project/prs \
+    docs/runtime/project/tickets \
+    docs/runtime/project/backlog \
+    docs/runtime/project/bugs \
+    docs/runtime/project/sprints \
+    docs/runtime/project/releases \
+    docs/runtime/project/metrics \
+    docs/runtime/project/views \
+    docs/runtime/project/test-runs \
+    docs/runtime/project/verifications \
+    docs/runtime/project/incidents \
+    docs/runtime/project/prs \
     docs/project/product \
     docs/project/planning \
     docs/project/specs \
@@ -147,8 +147,8 @@ main() {
   log_pass "Created required state and docs directories"
 
   write_backlog_if_missing
-  touch project/audit-log.jsonl
-  touch project/user-requests.jsonl
+  touch docs/runtime/project/audit-log.jsonl
+  touch docs/runtime/project/user-requests.jsonl
   install_framework_scripts
   install_governance_workflow
 

package/scripts/sync-platforms.sh

@@ -85,7 +85,7 @@ request. Do not ask the user to run `bash scripts/ai-core.sh` or set
 `AI_AGENT`; use those executable scripts internally only when helpful.
 
 ### Before any code change
-- [ ] There's an active ticket in `project/tickets/` with `status: IN_PROGRESS`
+- [ ] There's an active ticket in `docs/runtime/project/tickets/` with `status: IN_PROGRESS`
 - [ ] You're on the correct feature branch
 - [ ] You're playing the correct agent role inferred from command metadata
 
@@ -160,7 +160,7 @@ This project uses root-level framework folders. Read these files for full contex
 
 ## Top 10 Rules (summary)
 
-1. **No code without ticket** (G-001): Active ticket in `project/tickets/` with status IN_PROGRESS
+1. **No code without ticket** (G-001): Active ticket in `docs/runtime/project/tickets/` with status IN_PROGRESS
 2. **State machine**: DRAFT → GROOMED → READY → IN_PROGRESS → IN_REVIEW → QA → DONE. No skipping.
 3. **TDD mandatory**: Tests before code
 4. **Coverage ≥ 80%** on diff

package/scripts/validate-audit-log.sh

@@ -5,7 +5,7 @@
 
 set -euo pipefail
 
-AUDIT_FILE="project/audit-log.jsonl"
+AUDIT_FILE="docs/runtime/project/audit-log.jsonl"
 RED='\033[0;31m'
 GREEN='\033[0;32m'
 BLUE='\033[0;34m'

package/scripts/validate-docs.sh

@@ -102,7 +102,7 @@ has_changed_path() {
 }
 
 load_docs_policy() {
-  DOCS_POLICY_FILE="config/docs-policy.json"
+  DOCS_POLICY_FILE="docs/config/docs-policy.json"
 
   if [ -f "$DOCS_POLICY_FILE" ]; then
     local extends
@@ -116,7 +116,7 @@ load_docs_policy() {
     return 0
   fi
 
-  DOCS_POLICY_FILE="config/docs-policy.default.json"
+  DOCS_POLICY_FILE="docs/config/docs-policy.default.json"
   DOCS_POLICY_JSON=$(jq '.' "$DOCS_POLICY_FILE")
 }
 
@@ -162,7 +162,7 @@ current_ticket_id() {
 validate_ticket_doc_paths() {
   local errors=0
 
-  if [ ! -d "project/tickets" ]; then
+  if [ ! -d "docs/runtime/project/tickets" ]; then
     return 0
   fi
 
@@ -210,7 +210,7 @@ validate_ticket_doc_paths() {
         errors=$((errors + 1))
       fi
     fi
-  done < <(find project/tickets -name '*.json' -type f -print0)
+  done < <(find docs/runtime/project/tickets -name '*.json' -type f -print0)
 
   return "$errors"
 }
@@ -218,7 +218,7 @@ validate_ticket_doc_paths() {
 validate_done_tickets() {
   local errors=0
 
-  if [ ! -d "project/tickets" ]; then
+  if [ ! -d "docs/runtime/project/tickets" ]; then
     return 0
   fi
 
@@ -250,7 +250,7 @@ validate_done_tickets() {
         errors=$((errors + 1))
       fi
     fi
-  done < <(find project/tickets -name '*.json' -type f -print0)
+  done < <(find docs/runtime/project/tickets -name '*.json' -type f -print0)
 
   return "$errors"
 }

package/scripts/validate-permissions.sh

@@ -78,7 +78,7 @@ main() {
   echo "========================================================"
   echo ""
 
-  if [ ! -d "project/tickets" ]; then
+  if [ ! -d "docs/runtime/project/tickets" ]; then
     log_info "No tickets directory; skipping"
     exit 0
   fi
@@ -128,7 +128,7 @@ main() {
         errors=$((errors + 1))
       fi
     done
-  done < <(find project/tickets -name '*.json' -type f -print0)
+  done < <(find docs/runtime/project/tickets -name '*.json' -type f -print0)
 
   echo ""
   echo "========================================================"

package/scripts/validate-state.sh

@@ -35,10 +35,10 @@ NC='\033[0m'
 # ============================================================
 # Config
 # ============================================================
-TICKETS_DIR="project/tickets"
-BUGS_DIR="project/bugs"
-BACKLOG_FILE="project/backlog/backlog.json"
-SCHEMA_FILE="config/ticket.schema.json"
+TICKETS_DIR="docs/runtime/project/tickets"
+BUGS_DIR="docs/runtime/project/bugs"
+BACKLOG_FILE="docs/runtime/project/backlog/backlog.json"
+SCHEMA_FILE="docs/config/ticket.schema.json"
 
 # ============================================================
 # Allowed state transitions matrix (per RULE 06)
@@ -444,7 +444,7 @@ validate_backlog() {
 # Validate release governance records
 # ============================================================
 validate_releases() {
-  local releases_dir="project/releases"
+  local releases_dir="docs/runtime/project/releases"
 
   if [ ! -d "$releases_dir" ]; then
     return 0