ai-core-framework 0.1.0 → 0.2.0

package/README.md

@@ -8,8 +8,8 @@ npx ai-core-framework
 ```
 
 Run the command from the root of the project that should receive AI Core. The
-installer asks which AI CLI to target. Version 0.1 supports Codex and copies the
-contents of this repo's `core/` directory directly into the target project's
+installer asks which AI CLI to target. Version 0.1 supports Codex and copies this
+repo's root-level framework folders directly into the target project's
 `.codex/` directory:
 
 ```text
@@ -131,23 +131,23 @@ The framework now includes mechanical gates beyond prompt-level rules:
 
 - `scripts/validate-state.sh` validates ticket state transitions, backlog rank integrity, dependency ordering, blocked-ticket unblock evidence, DONE-ticket DoD fields, QA evidence, and release governance records.
 - `scripts/validate-docs.sh` validates documentation obligations from diffs and ticket metadata, including API docs, README/setup docs, migration runbooks, ADRs, changelog/release notes, and DONE-ticket documentation evidence.
-- `scripts/validate-permissions.sh` validates state-history command execution against `core/commands/**` role metadata and blocks obvious self-approval.
-- `core/scripts/` is now the canonical portable script source. Root `scripts/` copies are installed for convenience by setup.
-- `core/scripts/ai-core.sh` is a lightweight command runner that checks command role metadata before dispatching executable handlers.
-- `core/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`.
-- `core/skills/` provides chat-first behavior guidance inspired by skill-based systems: AI Core bootstrap, brainstorming, implementation planning, ticket execution, and verification-before-done.
+- `scripts/validate-permissions.sh` validates state-history command execution against `commands/**` role metadata and blocks obvious self-approval.
+- `scripts/` is the canonical portable script source.
+- `scripts/ai-core.sh` is a lightweight command runner that checks command role metadata before dispatching executable handlers.
+- `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/`.
-- `core/scripts/validate-audit-log.sh` validates the hash chain in `project/audit-log.jsonl`; executable workflow handlers append audit records.
-- `core/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.
+- `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`.
-- `core/scripts/install-codex-prompts.sh` installs AI Core commands as Codex custom slash prompts in `~/.codex/prompts`.
-- `CODEOWNERS` adds review ownership defaults for `core/`, `config/`, `project/`, ADRs, runbooks, and workflows.
-- `config/docs-policy.json` can override documentation detection paths from `core/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 `core/templates/ci/`.
-- `scripts/setup-project.sh` and `core/scripts/setup-project.sh` make copied `core/` installs executable: project config, runtime state folders, docs folders, backlog seed file, platform sync, and state validation.
+- `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`.
+- `.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`.
-- `core/config/release.schema.json` and `core/templates/release/release-record-template.json` define release approval, rollback, QA, security, and known-issue evidence.
+- `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/`.
 
 Chat-first setup flow:
@@ -168,6 +168,6 @@ guide /analyze-requirements "User can reset password"
 next TICKET-001
 ```
 
-The normal interface is the AI chat window. The AI should infer the correct role from command metadata (`owner_agent` / `requires_agents`) and may use `core/scripts/ai-core.sh` internally for deterministic execution and validation. Users should not need to type `bash ...` or `AI_AGENT=...`.
+The normal interface is the AI chat window. The AI should infer the correct role from command metadata (`owner_agent` / `requires_agents`) and may use `scripts/ai-core.sh` internally for deterministic execution and validation. Users should not need to type `bash ...` or `AI_AGENT=...`.
 
 `guide` runs one step, reports the completed command, ticket state before/after, updated `project` files, validation results, and the suggested next chat command. It asks before continuing and does not auto-run steps that still need placeholders such as `<story_points>` or `<pr_url>`.

package/{core/agents → agents}/business-analyst.md

@@ -94,7 +94,7 @@ Every User Story **MUST** pass INVEST. If it does not, you **MUST** split it int
 A ticket **MUST NOT** transition to `READY` unless it has ≥3 AC scenarios.
 
 ### RULE BA-004: Template enforcement
-You **MUST** use `core/templates/requirements/user-story-template.md`. Freestyle formats are **FORBIDDEN**.
+You **MUST** use `templates/requirements/user-story-template.md`. Freestyle formats are **FORBIDDEN**.
 
 ### RULE BA-005: Bug severity required
 If the input is a **bug report**, you **MUST** determine severity:

package/{core/agents → agents}/scrum-master.md

@@ -24,7 +24,11 @@ write_access:
   - "config/project-config.yaml"
   - "config/project-structure.yaml"
 read_access:
-  - "core/**"
+  - "agents/**"
+  - "rules/**"
+  - "skills/**"
+  - "templates/**"
+  - "workflows/**"
   - "docs/**"
 forbidden:
   - "Make technical architecture decisions"
@@ -67,10 +71,10 @@ The Scrum Master MUST NOT:
 ## 🔒 Hard Rules
 
 ### RULE SM-001: State machine integrity
-Every ticket transition MUST follow `core/rules/06-approval-gates.md`. The Scrum Master MUST run `/validate-state` before sprint start and before release.
+Every ticket transition MUST follow `rules/06-approval-gates.md`. The Scrum Master MUST run `/validate-state` before sprint start and before release.
 
 ### RULE SM-002: DoR gate ownership
-Only the Scrum Master may execute `/mark-ready`. It MUST verify every item in `core/rules/07-definition-of-ready.md`.
+Only the Scrum Master may execute `/mark-ready`. It MUST verify every item in `rules/07-definition-of-ready.md`.
 
 ### RULE SM-003: Capacity is a hard constraint
 A sprint MUST NOT be planned above configured capacity unless the overflow is explicitly documented as risk and approved by a human.

package/bin/ai-core-framework.js

@@ -8,7 +8,7 @@ const { stdin, stdout } = require('node:process');
 const { installCodex } = require('../lib/install-codex');
 
 const packageRoot = path.resolve(__dirname, '..');
-const sourceCoreDir = path.join(packageRoot, 'core');
+const sourceFrameworkDir = packageRoot;
 
 function normalizeAnswer(answer) {
   return answer.trim().toLowerCase();
@@ -54,8 +54,8 @@ async function main() {
   const rl = createPrompter();
 
   try {
-    if (!fs.existsSync(sourceCoreDir)) {
-      throw new Error(`Package is missing core assets: ${sourceCoreDir}`);
+    if (!fs.existsSync(path.join(sourceFrameworkDir, 'skills'))) {
+      throw new Error(`Package is missing framework assets: ${sourceFrameworkDir}`);
     }
 
     const selectedCli = await chooseCli(rl);
@@ -71,7 +71,7 @@ async function main() {
 
     const result = await installCodex({
       targetDir,
-      sourceCoreDir,
+      sourceFrameworkDir,
       confirm: (question) => askConflict(rl, question),
     });
 

package/hooks/hooks-cursor.json

@@ -0,0 +1,16 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|clear|compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"${CURSOR_PLUGIN_ROOT}/hooks/session-start\"",
+            "async": false
+          }
+        ]
+      }
+    ]
+  }
+}

package/hooks/hooks.json

@@ -0,0 +1,16 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|clear|compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/session-start\"",
+            "async": false
+          }
+        ]
+      }
+    ]
+  }
+}

package/hooks/session-start

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
+SKILL_FILE="${PLUGIN_ROOT}/skills/using-ai-core/SKILL.md"
+
+if [ ! -f "$SKILL_FILE" ]; then
+  context="AI Core is installed, but skills/using-ai-core/SKILL.md was not found. Ask the user to run /setup-project or verify plugin installation."
+else
+  content=$(sed 's/\\/\\\\/g; s/"/\\"/g; s/$/\\n/' "$SKILL_FILE" | tr -d '\n')
+  context="<AI_CORE_BOOTSTRAP>\\nYou are using AI Core. Read and follow this bootstrap skill before workflow work:\\n\\n${content}</AI_CORE_BOOTSTRAP>"
+fi
+
+if [ -n "${CURSOR_PLUGIN_ROOT:-}" ]; then
+  printf '{\n  "additional_context": "%s"\n}\n' "$context"
+elif [ -n "${CLAUDE_PLUGIN_ROOT:-}" ]; then
+  printf '{\n  "hookSpecificOutput": {\n    "hookEventName": "SessionStart",\n    "additionalContext": "%s"\n  }\n}\n' "$context"
+else
+  printf '{\n  "additionalContext": "%s"\n}\n' "$context"
+fi

package/lib/install-codex.js

@@ -1,6 +1,18 @@
 const fs = require('node:fs');
 const path = require('node:path');
 
+const FRAMEWORK_ENTRIES = [
+  'agents',
+  'config',
+  'hooks',
+  'rules',
+  'scripts',
+  'skills',
+  'templates',
+  'workflows',
+  'README.md',
+];
+
 function listFiles(rootDir) {
   const files = [];
 
@@ -20,13 +32,33 @@ function listFiles(rootDir) {
   return files;
 }
 
-async function installCodex({ targetDir = process.cwd(), sourceCoreDir, confirm }) {
-  if (!sourceCoreDir) {
-    throw new Error('sourceCoreDir is required');
+function listFrameworkFiles(sourceFrameworkDir) {
+  const files = [];
+
+  for (const entry of FRAMEWORK_ENTRIES) {
+    const entryPath = path.join(sourceFrameworkDir, entry);
+
+    if (!fs.existsSync(entryPath)) {
+      continue;
+    }
+
+    if (fs.statSync(entryPath).isDirectory()) {
+      files.push(...listFiles(entryPath));
+    } else {
+      files.push(entryPath);
+    }
+  }
+
+  return files;
+}
+
+async function installCodex({ targetDir = process.cwd(), sourceFrameworkDir, confirm }) {
+  if (!sourceFrameworkDir) {
+    throw new Error('sourceFrameworkDir is required');
   }
 
-  if (!fs.existsSync(sourceCoreDir) || !fs.statSync(sourceCoreDir).isDirectory()) {
-    throw new Error(`Source core directory not found: ${sourceCoreDir}`);
+  if (!fs.existsSync(sourceFrameworkDir) || !fs.statSync(sourceFrameworkDir).isDirectory()) {
+    throw new Error(`Source framework directory not found: ${sourceFrameworkDir}`);
   }
 
   const targetCodexDir = path.join(targetDir, '.codex');
@@ -39,8 +71,8 @@ async function installCodex({ targetDir = process.cwd(), sourceCoreDir, confirm
 
   fs.mkdirSync(targetCodexDir, { recursive: true });
 
-  for (const sourceFile of listFiles(sourceCoreDir)) {
-    const relativePath = path.relative(sourceCoreDir, sourceFile);
+  for (const sourceFile of listFrameworkFiles(sourceFrameworkDir)) {
+    const relativePath = path.relative(sourceFrameworkDir, sourceFile);
     const targetFile = path.join(targetCodexDir, relativePath);
     let shouldCopy = true;
     let overwriting = false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-core-framework",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Chat-first enterprise AI SDLC framework installer for AI coding CLIs.",
   "license": "MIT",
   "author": {
@@ -19,8 +19,15 @@
   },
   "files": [
     "bin/",
-    "core/",
+    "agents/",
+    "config/",
+    "hooks/",
     "lib/",
+    "rules/",
+    "scripts/",
+    "skills/",
+    "templates/",
+    "workflows/",
     "README.md",
     ".codex-plugin/",
     ".claude-plugin/",

package/{core/rules → rules}/00-global-rules.md

@@ -36,7 +36,7 @@ If a rule says **MUST** or **MUST NOT**, it is mandatory and has **NO EXCEPTIONS
 **Allowed exceptions**:
 - Fix typos in comments
 - Fix formatting or lint issues, with a separate commit: `style(chore): ...`
-- Update files in `core/`, which is the meta-framework
+- Update files in root-level framework folders, which are the meta-framework
 
 **If the user requests code without a ticket:**
 ```
@@ -62,12 +62,12 @@ If a rule says **MUST** or **MUST NOT**, it is mandatory and has **NO EXCEPTIONS
 | Project structure map | `config/project-structure.yaml` |
 | Refactor plans | `docs/runtime/refactor/<name>-refactor-plan.md` |
 | Architecture decisions | `docs/runtime/adr/NNN-title.md` |
-| Agent capabilities | `core/agents/<agent>.md` (frontmatter) |
+| Agent capabilities | `agents/<agent>.md` (frontmatter) |
 | Coverage threshold | `config/project-config.yaml` → `quality.coverage_threshold` |
 
 If information is needed in multiple places, **reference** the canonical location. **MUST NOT** copy it.
 
-`core/` is 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 `project/`, `config/`, `docs/project/`, or `docs/runtime/`.
 
 ---
 
@@ -97,7 +97,7 @@ User workflow interaction happens in the AI chat window.
 
 When user types `/command ...`, `guide /command ...`, or `next TICKET-XXX`, AI **MUST** treat it as an AI Core workflow request, infer the right agent from command metadata, execute any internal scripts itself when needed, and report the result back in chat.
 
-AI **MUST NOT** require the user to type shell wrappers such as `bash core/scripts/ai-core.sh` or environment variables such as `AI_AGENT=...` for normal workflow usage. Those are internal implementation details for AI tooling and CI.
+AI **MUST NOT** require the user to type shell wrappers such as `bash scripts/ai-core.sh` or environment variables such as `AI_AGENT=...` for normal workflow usage. Those are internal implementation details for AI tooling and CI.
 
 ### G-004b: Always output the execution plan
 Before executing a complex command, the AI **MUST** output a short plan:
@@ -141,11 +141,11 @@ The log record **MUST** include:
 - User request text, sanitized for secrets
 - Detected slash command, if any
 - Detected ticket ID, if any
-- Hash chain fields when using `core/scripts/log-user-request.sh`
+- Hash chain fields when using `scripts/log-user-request.sh`
 
 The AI **MUST** use:
 ```bash
-bash core/scripts/log-user-request.sh "<user request text>"
+bash scripts/log-user-request.sh "<user request text>"
 ```
 
 If the script is unavailable, the AI **MUST** still write an equivalent JSONL record manually. If the request contains secrets, credentials, tokens, passwords, customer PII, or payment data, the AI **MUST** redact those values before logging.

package/{core/rules → rules}/04-documentation.md

@@ -54,7 +54,7 @@ Known misleading docs for changed behavior MUST be fixed before release.
 ## 🛠️ Enforcement
 
 - Developer checklist in `/implement-task`.
-- PR template in `core/templates/pr/`.
+- PR template in `templates/pr/`.
 - Tech Lead review.
 - Release checklist in `/release`.
 - `bash scripts/validate-docs.sh` blocks missing documentation evidence in CI and pre-commit.

package/{core/scripts → scripts}/ai-core.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# core/scripts/ai-core.sh
+# scripts/ai-core.sh
 #
 # Lightweight command runner for executable AI Core commands.
 #
@@ -21,7 +21,7 @@ log_warn() { echo -e "${YELLOW}!${NC}  $1"; }
 log_fail() { echo -e "${RED}x${NC}  $1"; }
 
 AI_CORE_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-PROJECT_ROOT="$(dirname "$AI_CORE_DIR")"
+PROJECT_ROOT="$AI_CORE_DIR"
 
 usage() {
   cat <<'EOF'
@@ -32,10 +32,10 @@ Usage:
     next TICKET-XXX
 
   Internal runner form:
-  bash core/scripts/ai-core.sh [--agent role] run /command [args...]
-  bash core/scripts/ai-core.sh [--agent role] guide /command [args...]
-  bash core/scripts/ai-core.sh [--agent role] next TICKET-XXX
-  bash core/scripts/ai-core.sh list
+  bash scripts/ai-core.sh [--agent role] run /command [args...]
+  bash scripts/ai-core.sh [--agent role] guide /command [args...]
+  bash scripts/ai-core.sh [--agent role] next TICKET-XXX
+  bash scripts/ai-core.sh list
 
 Environment:
   AI_AGENT=<agent-role>   Optional internal override. Runner auto-selects owner_agent by default.
@@ -60,7 +60,21 @@ command_file_for() {
   local command="$1"
   local name
   name=$(command_name "$command")
-  find "$AI_CORE_DIR/commands" -name "$name.md" -type f | head -1
+
+  if [ -d "$AI_CORE_DIR/commands" ]; then
+    find "$AI_CORE_DIR/commands" -name "$name.md" -type f | head -1
+    return 0
+  fi
+
+  if [ -d "$AI_CORE_DIR/skills" ]; then
+    find "$AI_CORE_DIR/skills" -name 'SKILL.md' -type f -print0 |
+      while IFS= read -r -d '' file; do
+        if awk -v command="/$name" '$1 == "command:" && $2 == command { found=1 } END { exit found ? 0 : 1 }' "$file"; then
+          printf '%s\n' "$file"
+          break
+        fi
+      done
+  fi
 }
 
 allowed_agents_for_command() {
@@ -388,12 +402,20 @@ next_command() {
 }
 
 list_commands() {
-  find "$AI_CORE_DIR/commands" -name '*.md' -type f |
-    grep -v '/README.md$' |
-    sed "s#^$AI_CORE_DIR/commands/##" |
-    sed 's#/# #g; s#\.md$##' |
-    awk '{ print "/" $NF }' |
-    sort
+  {
+    if [ -d "$AI_CORE_DIR/commands" ]; then
+      find "$AI_CORE_DIR/commands" -name '*.md' -type f |
+        grep -v '/README.md$' |
+        sed "s#^$AI_CORE_DIR/commands/##" |
+        sed 's#/# #g; s#\.md$##' |
+        awk '{ print "/" $NF }'
+    fi
+
+    if [ -d "$AI_CORE_DIR/skills" ]; then
+      find "$AI_CORE_DIR/skills" -name 'SKILL.md' -type f -print0 |
+        xargs -0 awk '$1 == "command:" { print $2 }'
+    fi
+  } | sort -u
 }
 
 main() {

package/{core/scripts → scripts}/install-codex-prompts.sh

@@ -1,11 +1,11 @@
 #!/usr/bin/env bash
-# core/scripts/install-codex-prompts.sh
+# scripts/install-codex-prompts.sh
 #
 # Installs AI Core command wrappers as Codex custom slash prompts.
 #
 # Usage:
-#   bash core/scripts/install-codex-prompts.sh
-#   CODEX_PROMPTS_DIR=~/.codex/prompts bash core/scripts/install-codex-prompts.sh
+#   bash scripts/install-codex-prompts.sh
+#   CODEX_PROMPTS_DIR=~/.codex/prompts bash scripts/install-codex-prompts.sh
 
 set -euo pipefail
 
@@ -50,9 +50,9 @@ write_prompt() {
   prompt_file="$PROMPTS_DIR/${command#/}.md"
   rel_command_file="${command_file#./}"
   fallback_command_file="${root}/${rel_command_file}"
-  fallback_rules_file="${root}/core/rules/00-global-rules.md"
-  fallback_agents_dir="${root}/core/agents"
-  fallback_log_script="${root}/core/scripts/log-user-request.sh"
+  fallback_rules_file="${root}/rules/00-global-rules.md"
+  fallback_agents_dir="${root}/agents"
+  fallback_log_script="${root}/scripts/log-user-request.sh"
   description="${display_name:-AI Core command ${command}}"
 
   cat > "$prompt_file" <<EOF
@@ -72,8 +72,8 @@ Mandatory steps:
 
 1. Log this user request first. Prefer the project-local script when it exists; otherwise use the installed AI Core fallback:
    \`\`\`bash
-   if [ -f core/scripts/log-user-request.sh ]; then
-     AI_AGENT=codex bash core/scripts/log-user-request.sh "${command} \$ARGUMENTS"
+   if [ -f scripts/log-user-request.sh ]; then
+     AI_AGENT=codex bash scripts/log-user-request.sh "${command} \$ARGUMENTS"
    else
      AI_AGENT=codex bash ${fallback_log_script} "${command} \$ARGUMENTS"
    fi
@@ -87,13 +87,13 @@ Mandatory steps:
 
 3. Read and follow the global rules. Prefer the project-local path when it exists; otherwise use the installed AI Core fallback:
    \`\`\`text
-   core/rules/00-global-rules.md
+   rules/00-global-rules.md
    ${fallback_rules_file}
    \`\`\`
 
 4. Infer the owner agent from the command frontmatter. If an agent file exists, read it before acting. Prefer the project-local path, then the installed fallback:
    \`\`\`text
-   core/agents/<owner_agent>.md
+   agents/<owner_agent>.md
    ${fallback_agents_dir}/<owner_agent>.md
    \`\`\`
 
@@ -110,16 +110,24 @@ main() {
   root="$(repo_root)"
   cd "$root"
 
-  if [ ! -d "core/commands" ]; then
-    log_fail "Missing core/commands. Run from AI Core repo root."
+  if [ ! -d "commands" ] && [ ! -d "skills" ]; then
+    log_fail "Missing commands or skills. Run from AI Core repo root."
     exit 1
   fi
 
   mkdir -p "$PROMPTS_DIR"
 
-  while IFS= read -r command_file; do
-    write_prompt "$command_file" "$root"
-  done < <(find core/commands -name '*.md' -type f | sort)
+  if [ -d "commands" ]; then
+    while IFS= read -r command_file; do
+      write_prompt "$command_file" "$root"
+    done < <(find commands -name '*.md' -type f | sort)
+  fi
+
+  if [ -d "skills" ]; then
+    while IFS= read -r command_file; do
+      write_prompt "$command_file" "$root"
+    done < <(find skills -name 'SKILL.md' -type f | sort)
+  fi
 
   log_pass "AI Core Codex prompts installed in ${PROMPTS_DIR}"
 }

package/{core/scripts → scripts}/log-user-request.sh

@@ -1,10 +1,10 @@
 #!/usr/bin/env bash
-# core/scripts/log-user-request.sh
+# scripts/log-user-request.sh
 #
 # Append a sanitized user request record to project/user-requests.jsonl.
 #
 # Usage:
-#   bash core/scripts/log-user-request.sh "user request text"
+#   bash scripts/log-user-request.sh "user request text"
 
 set -euo pipefail
 
@@ -19,7 +19,7 @@ log_pass() { echo -e "${GREEN}+${NC}  $1"; }
 log_fail() { echo -e "${RED}x${NC}  $1"; }
 
 if [ -z "$REQUEST_TEXT" ]; then
-  log_fail "Usage: bash core/scripts/log-user-request.sh \"user request text\""
+  log_fail "Usage: bash scripts/log-user-request.sh \"user request text\""
   exit 2
 fi
 

package/{core/scripts → scripts}/setup-project.sh

@@ -1,10 +1,10 @@
 #!/usr/bin/env bash
-# core/scripts/setup-project.sh
+# scripts/setup-project.sh
 #
-# Makes a copied core/ framework operational in a project.
+# Makes copied root-level framework folders operational in a project.
 #
 # Usage:
-#   bash core/scripts/setup-project.sh
+#   bash scripts/setup-project.sh
 
 set -euo pipefail
 
@@ -48,7 +48,7 @@ install_framework_scripts() {
   mkdir -p scripts
 
   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="core/scripts/$script"
+    local src="scripts/$script"
     local dst="scripts/$script"
 
     if [ ! -f "$src" ]; then
@@ -68,7 +68,7 @@ install_framework_scripts() {
 }
 
 install_governance_workflow() {
-  local src="core/templates/ci/ai-core-governance.yml"
+  local src="templates/ci/ai-core-governance.yml"
   local dst=".github/workflows/ai-core-governance.yml"
 
   if [ ! -f "$src" ]; then
@@ -103,22 +103,17 @@ main() {
   repo_root=$(git rev-parse --show-toplevel)
   cd "$repo_root"
 
-  if [ ! -d "core" ]; then
-    log_fail "Missing core directory"
-    exit 1
-  fi
-
-  if [ ! -f "core/templates/project/project-config.yaml" ] ||
-     [ ! -f "core/templates/project/project-structure.yaml" ]; then
-    log_fail "Missing core project templates"
+  if [ ! -f "templates/project/project-config.yaml" ] ||
+     [ ! -f "templates/project/project-structure.yaml" ]; then
+    log_fail "Missing framework project templates"
     exit 1
   fi
 
   mkdir -p config
-  copy_if_missing "core/templates/project/project-config.yaml" "config/project-config.yaml"
-  copy_if_missing "core/templates/project/project-structure.yaml" "config/project-structure.yaml"
-  copy_if_missing "core/templates/project/docs-policy.json" "config/docs-policy.json"
-  copy_if_missing "core/templates/project/CODEOWNERS" "CODEOWNERS"
+  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"
+  copy_if_missing "templates/project/CODEOWNERS" "CODEOWNERS"
 
   for dir in \
     project/tickets \
@@ -157,16 +152,16 @@ main() {
   install_framework_scripts
   install_governance_workflow
 
-  if [ -f "core/scripts/sync-platforms.sh" ]; then
-    bash core/scripts/sync-platforms.sh
+  if [ -f "scripts/sync-platforms.sh" ]; then
+    bash scripts/sync-platforms.sh
   else
-    log_warn "Missing core/scripts/sync-platforms.sh; platform configs not synced"
+    log_warn "Missing scripts/sync-platforms.sh; platform configs not synced"
   fi
 
-  if [ -f "core/scripts/validate-state.sh" ]; then
-    bash core/scripts/validate-state.sh
+  if [ -f "scripts/validate-state.sh" ]; then
+    bash scripts/validate-state.sh
   else
-    log_warn "Missing core/scripts/validate-state.sh; skipped state validation"
+    log_warn "Missing scripts/validate-state.sh; skipped state validation"
   fi
 
   if [ -d ".githooks" ] && [ -f "scripts/install-hooks.sh" ]; then