ai-core-framework 0.3.0 → 0.4.0

package/README.md

@@ -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 `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/validate-audit-log.sh` validates the hash chain in `docs/runtime/audit-log.jsonl`; executable workflow handlers append audit records.
+- `scripts/log-user-request.sh` appends every AI-handled user request to `docs/runtime/user-requests.jsonl` so the user can review what they asked for.
+- `/request-log` shows recent entries from `docs/runtime/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, `docs/config/`, `docs/runtime/project/`, ADRs, runbooks, and workflows.
+- `CODEOWNERS` adds review ownership defaults for framework folders, `docs/config/`, `docs/runtime/`, 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`.
 - `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/`.
+- `scripts/generate-views.sh` now produces dashboard and release readiness views in `docs/runtime/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.
-  - "docs/runtime/project/**"
+  - "docs/runtime/**"
 write_access:
   - "docs/project/product/**"
   - "docs/project/planning/**"
   - "docs/project/specs/**"
   - "docs/project/requirements/**"
   - "docs/project/user-stories/**"
-  - "docs/runtime/project/tickets/**"
-  - "docs/runtime/project/backlog/**"
-  - "docs/runtime/project/views/**"
-  - "docs/runtime/project/sprints/**"
+  - "docs/runtime/tickets/**"
+  - "docs/runtime/backlog/**"
+  - "docs/runtime/views/**"
+  - "docs/runtime/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 `docs/runtime/project/tickets/TICKET-XXX.json`.
+5. **Create tickets** in `docs/runtime/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"
-  - "docs/runtime/project/tickets/**"
+  - "docs/runtime/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 `docs/runtime/project/dev-learnings.md`.
+- Track feedback patterns in `docs/runtime/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/**"
-  - "docs/runtime/project/tickets/**"
-  - "docs/runtime/project/bugs/**"
-  - "docs/runtime/project/test-runs/**"
+  - "docs/runtime/tickets/**"
+  - "docs/runtime/bugs/**"
+  - "docs/runtime/test-runs/**"
 escalates_to: tech-lead
 collaborates_with:
   - developer

package/agents/scrum-master.md

@@ -17,10 +17,10 @@ can_invoke_commands:
   - /generate-views
   - /ticket-health
 write_access:
-  - "docs/runtime/project/sprints/**"
-  - "docs/runtime/project/releases/**"
-  - "docs/runtime/project/metrics/**"
-  - "docs/runtime/project/views/**"
+  - "docs/runtime/sprints/**"
+  - "docs/runtime/releases/**"
+  - "docs/runtime/metrics/**"
+  - "docs/runtime/views/**"
   - "docs/config/project-config.yaml"
   - "docs/config/project-structure.yaml"
 read_access:
@@ -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 `docs/runtime/project/`.
+Any work performed in a sprint MUST be represented by a ticket or bug in `docs/runtime/`.
 
 ### 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,7 +95,7 @@ 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 `docs/runtime/project/sprints/`, `docs/runtime/project/releases/`, or `docs/runtime/project/metrics/`.
+Sprint planning, review, retro, and release summaries MUST be written to `docs/runtime/sprints/`, `docs/runtime/releases/`, or `docs/runtime/metrics/`.
 
 ### RULE SM-010: Escalate ambiguity
 If command preconditions are unclear, STOP and escalate instead of guessing.

package/agents/tech-lead.md

@@ -29,9 +29,9 @@ write_access:
   - "docs/runtime/technical/**"
   - "docs/architecture/**"
   - "docs/runtime/refactor/**"
-  - "docs/runtime/project/tickets/**"
-  - "docs/runtime/project/backlog/**"
-  - "docs/runtime/project/prs/**"
+  - "docs/runtime/tickets/**"
+  - "docs/runtime/backlog/**"
+  - "docs/runtime/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 `docs/runtime/project/tickets/TICKET-042.json`
+- Ticket JSON from `docs/runtime/tickets/TICKET-042.json`
 - Full AC
 - Related code, if referenced by the ticket
 

package/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 docs/runtime/project/backlog/backlog.json",
+  "description": "Project-specific backlog ordering and prioritization schema for docs/runtime/backlog/backlog.json",
   "type": "object",
   "required": ["version", "updated_at", "updated_by", "items"],
   "additionalProperties": true,

package/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 docs/runtime/project/releases/",
+  "description": "Schema for release records in docs/runtime/releases/",
   "type": "object",
   "required": [
     "version",

package/docs/config/ticket.schema.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-core-framework",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Chat-first enterprise AI SDLC framework installer for AI coding CLIs.",
   "license": "MIT",
   "author": {

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 `docs/runtime/project/tickets/` with:
+**MUST NOT** write or modify production code (files in `src/`, `lib/`, `app/`) unless there is an active ticket in `docs/runtime/tickets/` with:
 - `status` ∈ `[IN_PROGRESS]`
 - `assignee` = current agent
 
@@ -52,12 +52,12 @@ If a rule says **MUST** or **MUST NOT**, it is mandatory and has **NO EXCEPTIONS
 
 | Info | Canonical location |
 |------|-------------------|
-| 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` |
+| Backlog order and prioritization | `docs/runtime/backlog/backlog.json` |
+| Ticket details and state history | `docs/runtime/tickets/TICKET-XXX.json` |
+| Sprint info | `docs/runtime/sprints/SPRINT-XXX.json` |
+| Bug details | `docs/runtime/bugs/BUG-XXX.json` |
+| Release records | `docs/runtime/releases/vX.Y.Z.json` |
+| User request log | `docs/runtime/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` |
@@ -67,7 +67,7 @@ If a rule says **MUST** or **MUST NOT**, it is mandatory and has **NO EXCEPTIONS
 
 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 `docs/runtime/project/`, `docs/config/`, `docs/project/`, or `docs/runtime/`.
+Root-level framework folders are framework-only. Project-specific state and configuration MUST live in `docs/runtime/`, `docs/config/`, or `docs/project/`.
 
 ---
 
@@ -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 `docs/runtime/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/user-requests.jsonl` before doing substantive work.
 
 The log record **MUST** include:
 - Timestamp

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 `docs/runtime/project/tickets/`
+- [ ] Ticket state updated in `docs/runtime/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/docs/runtime/project/tickets/%s.json' "$PROJECT_ROOT" "$1"
+  printf '%s/docs/runtime/tickets/%s.json' "$PROJECT_ROOT" "$1"
 }
 
 latest_audit_field() {
   local field="$1"
-  local audit_file="$PROJECT_ROOT/docs/runtime/project/audit-log.jsonl"
+  local audit_file="$PROJECT_ROOT/docs/runtime/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 "- docs/runtime/project/tickets/$ticket_id.json"
+    echo "- docs/runtime/tickets/$ticket_id.json"
   fi
-  if [ "$before_audit_hash" != "$after_audit_hash" ] && [ -s "docs/runtime/project/audit-log.jsonl" ]; then
-    echo "- docs/runtime/project/audit-log.jsonl"
+  if [ "$before_audit_hash" != "$after_audit_hash" ] && [ -s "docs/runtime/audit-log.jsonl" ]; then
+    echo "- docs/runtime/audit-log.jsonl"
   fi
   case "$(command_name "$command")" in
     generate-views)
-      echo "- docs/runtime/project/views/*.md"
+      echo "- docs/runtime/views/*.md"
       ;;
     smoke-test)
-      echo "- docs/runtime/project/test-runs/${ticket_id}-*.md"
+      echo "- docs/runtime/test-runs/${ticket_id}-*.md"
       ;;
     release)
-      echo "- docs/runtime/project/releases/*.json"
+      echo "- docs/runtime/releases/*.json"
       ;;
   esac
 

package/scripts/generate-views.sh

@@ -3,8 +3,8 @@
 #
 # Generates human-readable views from project without changing canonical state.
 # Canonical sources:
-# - docs/runtime/project/backlog/backlog.json for backlog order
-# - docs/runtime/project/tickets/*.json for ticket details and state history
+# - docs/runtime/backlog/backlog.json for backlog order
+# - docs/runtime/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 docs/runtime/project/user-requests.jsonl.
+# Append a sanitized user request record to docs/runtime/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:-docs/runtime/project/user-requests.jsonl}"
+LOG_FILE="${AI_CORE_USER_REQUEST_LOG:-docs/runtime/user-requests.jsonl}"
 
 RED='\033[0;31m'
 GREEN='\033[0;32m'

package/scripts/setup-project.sh

@@ -32,8 +32,12 @@ copy_if_missing() {
   log_pass "Created $dst"
 }
 
+script_dir() {
+  cd "$(dirname "${BASH_SOURCE[0]}")" && pwd
+}
+
 write_backlog_if_missing() {
-  local path="docs/runtime/project/backlog/backlog.json"
+  local path="docs/runtime/backlog/backlog.json"
 
   if [ -f "$path" ]; then
     log_pass "Preserved existing $path"
@@ -46,9 +50,10 @@ write_backlog_if_missing() {
 
 install_framework_scripts() {
   mkdir -p scripts
+  local framework_root="$1"
 
   for script in ai-core.sh workflow.sh validate-state.sh validate-docs.sh validate-permissions.sh validate-audit-log.sh generate-views.sh install-codex-prompts.sh log-user-request.sh setup-project.sh; do
-    local src="scripts/$script"
+    local src="$framework_root/scripts/$script"
     local dst="scripts/$script"
 
     if [ ! -f "$src" ]; then
@@ -68,7 +73,8 @@ install_framework_scripts() {
 }
 
 install_governance_workflow() {
-  local src="templates/ci/ai-core-governance.yml"
+  local framework_root="$1"
+  local src="$framework_root/templates/ci/ai-core-governance.yml"
   local dst=".github/workflows/ai-core-governance.yml"
 
   if [ ! -f "$src" ]; then
@@ -101,32 +107,34 @@ main() {
 
   local repo_root
   repo_root=$(git rev-parse --show-toplevel)
+  local framework_root
+  framework_root="$(cd "$(script_dir)/.." && pwd)"
   cd "$repo_root"
 
-  if [ ! -f "templates/project/project-config.yaml" ] ||
-     [ ! -f "templates/project/project-structure.yaml" ]; then
+  if [ ! -f "$framework_root/templates/project/project-config.yaml" ] ||
+     [ ! -f "$framework_root/templates/project/project-structure.yaml" ]; then
     log_fail "Missing framework project templates"
     exit 1
   fi
 
   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"
+  copy_if_missing "$framework_root/templates/project/project-config.yaml" "docs/config/project-config.yaml"
+  copy_if_missing "$framework_root/templates/project/project-structure.yaml" "docs/config/project-structure.yaml"
+  copy_if_missing "$framework_root/templates/project/docs-policy.json" "docs/config/docs-policy.json"
+  copy_if_missing "$framework_root/templates/project/CODEOWNERS" "CODEOWNERS"
 
   for dir in \
-    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/runtime/tickets \
+    docs/runtime/backlog \
+    docs/runtime/bugs \
+    docs/runtime/sprints \
+    docs/runtime/releases \
+    docs/runtime/metrics \
+    docs/runtime/views \
+    docs/runtime/test-runs \
+    docs/runtime/verifications \
+    docs/runtime/incidents \
+    docs/runtime/prs \
     docs/project/product \
     docs/project/planning \
     docs/project/specs \
@@ -147,13 +155,13 @@ main() {
   log_pass "Created required state and docs directories"
 
   write_backlog_if_missing
-  touch docs/runtime/project/audit-log.jsonl
-  touch docs/runtime/project/user-requests.jsonl
-  install_framework_scripts
-  install_governance_workflow
+  touch docs/runtime/audit-log.jsonl
+  touch docs/runtime/user-requests.jsonl
+  install_framework_scripts "$framework_root"
+  install_governance_workflow "$framework_root"
 
-  if [ -f "scripts/sync-platforms.sh" ]; then
-    bash scripts/sync-platforms.sh
+  if [ -f "$framework_root/scripts/sync-platforms.sh" ]; then
+    bash "$framework_root/scripts/sync-platforms.sh"
   else
     log_warn "Missing scripts/sync-platforms.sh; platform configs not synced"
   fi

package/scripts/sync-platforms.sh

@@ -8,7 +8,7 @@
 set -euo pipefail
 
 AI_CORE_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-PROJECT_ROOT="$AI_CORE_DIR"
+PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
 
 echo "🔄 Syncing root-level framework folders to AI platforms..."
 echo "   Source: $AI_CORE_DIR"
@@ -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 `docs/runtime/project/tickets/` with `status: IN_PROGRESS`
+- [ ] There's an active ticket in `docs/runtime/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 `docs/runtime/project/tickets/` with status IN_PROGRESS
+1. **No code without ticket** (G-001): Active ticket in `docs/runtime/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="docs/runtime/project/audit-log.jsonl"
+AUDIT_FILE="docs/runtime/audit-log.jsonl"
 RED='\033[0;31m'
 GREEN='\033[0;32m'
 BLUE='\033[0;34m'

package/scripts/validate-docs.sh

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

package/scripts/validate-permissions.sh

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

package/scripts/validate-state.sh

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

package/scripts/workflow.sh

@@ -38,7 +38,7 @@ agent_name() {
 }
 
 ticket_file() {
-  printf 'docs/runtime/project/tickets/%s.json' "$1"
+  printf 'docs/runtime/tickets/%s.json' "$1"
 }
 
 slugify() {
@@ -50,7 +50,7 @@ slugify() {
 
 next_ticket_id() {
   local max_id
-  max_id=$(find docs/runtime/project/tickets -name 'TICKET-*.json' -type f 2>/dev/null |
+  max_id=$(find docs/runtime/tickets -name 'TICKET-*.json' -type f 2>/dev/null |
     sed -E 's/.*TICKET-([0-9]+)\.json/\1/' |
     sort -n |
     tail -1)
@@ -79,7 +79,7 @@ hash_value() {
 }
 
 last_audit_hash() {
-  local audit_file="docs/runtime/project/audit-log.jsonl"
+  local audit_file="docs/runtime/audit-log.jsonl"
   if [ ! -s "$audit_file" ]; then
     printf ''
     return 0
@@ -95,7 +95,7 @@ append_audit() {
   local reason="$5"
 
   mkdir -p project
-  local audit_file="docs/runtime/project/audit-log.jsonl"
+  local audit_file="docs/runtime/audit-log.jsonl"
   local at by prev payload hash
   at=$(now_utc)
   by=$(agent_name)
@@ -181,7 +181,7 @@ cmd_analyze_requirements() {
     exit 1
   fi
 
-  mkdir -p docs/runtime/project/tickets docs/project/specs
+  mkdir -p docs/runtime/tickets docs/project/specs
   local ticket_id file at by slug spec_path
   ticket_id=$(next_ticket_id)
   file=$(ticket_file "$ticket_id")
@@ -349,7 +349,7 @@ Implement the ticket scope while preserving the approved acceptance criteria and
 
 ## Current Context
 
-- Read \`docs/runtime/project/tickets/${ticket_id}.json\`.
+- Read \`docs/runtime/tickets/${ticket_id}.json\`.
 - Read the linked spec if present.
 - Inspect affected code before editing.
 
@@ -452,7 +452,7 @@ cmd_smoke_test() {
     log_fail "$ticket_id status must be QA before QA evidence is written"
     exit 1
   fi
-  [ -n "$evidence_path" ] || evidence_path="docs/runtime/project/test-runs/${ticket_id}-$(date -u +%Y%m%d%H%M%S).md"
+  [ -n "$evidence_path" ] || evidence_path="docs/runtime/test-runs/${ticket_id}-$(date -u +%Y%m%d%H%M%S).md"
   mkdir -p "$(dirname "$evidence_path")"
   if [ ! -f "$evidence_path" ]; then
     printf '# Smoke Test Evidence: %s\n\nGenerated by executable smoke-test gate at %s.\n' "$ticket_id" "$(now_utc)" > "$evidence_path"
@@ -478,8 +478,8 @@ cmd_smoke_test() {
 cmd_release() {
   local version="${1:-}"
   [ -n "$version" ] || { log_fail "Usage: /release vMAJOR.MINOR.PATCH"; exit 2; }
-  mkdir -p docs/runtime/project/releases
-  local file="docs/runtime/project/releases/${version}.json"
+  mkdir -p docs/runtime/releases
+  local file="docs/runtime/releases/${version}.json"
   if [ -f "$file" ]; then
     log_fail "Release record already exists: $file"
     exit 1

package/skills/brainstorming/SKILL.md

@@ -14,7 +14,7 @@ Use this before implementation work, feature creation, behavior changes, or larg
 3. Propose 2-3 approaches with tradeoffs and a recommendation.
 4. Present a concise design for user approval.
 5. Save the approved spec to `docs/project/specs/TICKET-XXX-<slug>.md`.
-6. Link the spec from `docs/runtime/project/tickets/TICKET-XXX.json` as `spec_path`.
+6. Link the spec from `docs/runtime/tickets/TICKET-XXX.json` as `spec_path`.
 7. Suggest `/groom-ticket TICKET-XXX`.
 
 ## Hard Gates