codexkit 1.0.0 → 1.0.1

package/.codex/.template-manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.0",
+  "version": "1.0.1",
   "generator": "codexkit",
   "files": {
     "templates/global/AGENTS.override.md": "11039408f8776171820ce34165b5da6d52a703d26a938fb773e231a159eefe2c",
@@ -8,7 +8,7 @@
     "templates/project/AGENTS.md.template": "acb5ea31fd561ddbbc79c6baf6de98b990bbac693ba6d836406d270a1f27a981",
     ".codex/config.toml": "4f87b2685b6daefea111792f5845388f7f0bbc2c0153d1d4c7428f795d437274",
     ".codex/.env.example": "1827612829279fad025404b763ea214412bd5cd53474ad315909a8c275f12b84",
-    ".codex/.version": "59854984853104df5c353e2f681a15fc7924742f9a2e468c29af248dce45ce03",
+    ".codex/.version": "44e161e4495cac2cf7858043e9e6418e9579f0ddcfae826f9a372622968ce066",
     ".codex/agents/builder.toml": "90da25e01967639be3d7b5a204be69d1dfa67ea3fea2d6bf93e0deb7be3bbb8b",
     ".codex/agents/debugger.toml": "d709c5f64ae2ec8ee901766441b9687ce9ea40d5a8966aec594d757dc5327d9e",
     ".codex/agents/general.toml": "a2fa240c01bcc33272c585d1bfa996cf1c0686204b7cc909f0fd1cdad1f5c830",
@@ -378,6 +378,10 @@
     ".codex/skills/prd-task/SKILL.md": "265bfa4b625008107214da07d5e6631081ffbe532e07366418c28fc8f7dfd927",
     ".codex/skills/prd-task/references/prd-schema.json": "11852d540895c380e41f7d5144b66c39a6b9814cc9577a97c20fdcf5d32dca5c",
     ".codex/skills/prd/SKILL.md": "78d08475e17e2780c7490fa0ab94ae47056f22c5f327289a752155e9a8ca16b9",
+    ".codex/skills/prompt-leverage/SKILL.md": "6fb4e770d1369d9a749a4b069411943a3282a105116744437b7be61e02c7ab58",
+    ".codex/skills/prompt-leverage/agents/openai.yaml": "d9f369a441454d08c3bce3370ab9d1b8b99affe504cbbbbf9e5d0f391f99cdb6",
+    ".codex/skills/prompt-leverage/references/framework.md": "077c15695ee6d81ea98ea1e4a9784e2608d14458c4492a186fd00aabce866f45",
+    ".codex/skills/prompt-leverage/scripts/augment_prompt.py": "f358e722d0b01c9102c1ca39a3b56e3499162ee40284be6407222ac7a158ed84",
     ".codex/skills/ralph/SKILL.md": "2fbb90ecff8a6e72647a50eafb20969c5e32fbba4ff2299890858f0bdc030f27",
     ".codex/skills/react-best-practices/AGENTS.md": "abcae0302cfe0b942865a3638f228d62176fc85a07665a78ba70082306488d56",
     ".codex/skills/react-best-practices/README.md": "9eafb2123d3b8b2aef41fba0db2648a3f4f49996f8c7c8bb2c86263befd8b48a",
@@ -599,7 +603,7 @@
     ".codex/context/conventions.md": "5e4ae568d3e20adf1fb6a3461ef2b63032516c19e8ca5f464a4e1f9a96579dce",
     ".codex/context/current-priorities.md": "a08fde77471c58fce21efeab4f1e64ed39f96ba0d634219f5d437396287ea662",
     ".codex/context/decision-log.md": "c5e635447d7f288f610a38c000f646fd7d5c9137e46c578e4769a0ba0ebcf5d4",
-    ".codex/context/gotchas.md": "b9862dad721e8d6eab8944c42e934e8549debd34b8a47369c0beb074af522b82",
+    ".codex/context/gotchas.md": "8dca6e3ab28e3441c407b8338e994d1638a79f41e82b6abfc12e8e9bb054a320",
     ".codex/context/index.md": "dd75cdaff5d758ba3634b18e39050446e74064bbbd835d90212b685aaf10e64f",
     ".codex/context/session-context.md": "c8b82907ea2b3769a1143031adc831b0b2ed25645df2f681f8eb930995a7337c",
     ".codex/context/worklog.md": "2059df0ad6cf2fd0df7765440526b23007f65b4acf6af901ce24636948c81807",
@@ -618,7 +622,7 @@
     ".codex/memory/_templates/tasks.md": "54119ce84fd0aa6ecd0148355f33808c061147da774475c94bf7e47bb18f73dd",
     ".codex/memory/_templates/tech-stack.md": "06cfafa736d9f32876aecfad9cfe54785a4db7dcecf94abdb09b7895761d763f",
     ".codex/memory/_templates/user.md": "4156bd3195edab1b196ac3f398ca7ec90295b91c3a5b028673be065463e5fdaf",
-    ".codex/memory/project/gotchas.md": "1a4f9d60f2d80cc7edb8f5a37577f7d1b5757a6dcc4864eeb70f620aa80e89d0",
+    ".codex/memory/project/gotchas.md": "05ce128ced24deffbb51a8b7167000c4e4816c4e3275a98f439fddb0e95c2bd6",
     ".codex/memory/project/project.md": "94a76028472946ba9782534de4920e9a77cfdf0f4daa063a97569660ccc06e21",
     ".codex/memory/project/roadmap.md": "6027b3bd3eaeed02b16a59037e760200ce8505f3007375faf2543b4b58bcee6e",
     ".codex/memory/project/state.md": "4c07c283fe11527bfe9f8195cfbc268b5e31326b8089cf271a473f0ad83b5f1b",

package/.codex/.version

@@ -1 +1 @@
-1.0.0
+1.0.1

package/.codex/context/gotchas.md

@@ -20,7 +20,8 @@ Known edge cases, footguns, and "I wish I knew this earlier" items.
 
 - Custom prompts are deprecated — use Skills for new workflows
 - Prompts only load from `~/.codex/prompts/` (user-level), not project directory
-- Project prompts in `.codex/prompts/` serve as documentation/reference
+- `codexkit install` bootstraps `~/.codex/prompts/` automatically for the current user when shared inventory is absent
+- Project prompts in `.codex/prompts/` remain the local source-of-truth/reference copy
 
 ## Beads
 

package/.codex/memory/project/gotchas.md

@@ -1,5 +1,5 @@
 # Gotchas
 
-- Keep skill source of truth in `.codex/skills/`; if install creates `.agents/skills`, treat it as disposable local wiring only.
+- Keep skill source of truth in `.codex/skills/`; Codexkit project installs no longer create a sibling `.agents/skills` tree.
 - Validate install scripts after changing prompts, hooks, or agent definitions.
 - Do not claim memory automation works unless the underlying files and scripts exist.

package/.template-manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.0",
+  "version": "1.0.1",
   "generator": "codexkit",
   "files": {
     "templates/global/AGENTS.override.md": "11039408f8776171820ce34165b5da6d52a703d26a938fb773e231a159eefe2c",
@@ -8,7 +8,7 @@
     "templates/project/AGENTS.md.template": "acb5ea31fd561ddbbc79c6baf6de98b990bbac693ba6d836406d270a1f27a981",
     ".codex/config.toml": "4f87b2685b6daefea111792f5845388f7f0bbc2c0153d1d4c7428f795d437274",
     ".codex/.env.example": "1827612829279fad025404b763ea214412bd5cd53474ad315909a8c275f12b84",
-    ".codex/.version": "59854984853104df5c353e2f681a15fc7924742f9a2e468c29af248dce45ce03",
+    ".codex/.version": "44e161e4495cac2cf7858043e9e6418e9579f0ddcfae826f9a372622968ce066",
     ".codex/agents/builder.toml": "90da25e01967639be3d7b5a204be69d1dfa67ea3fea2d6bf93e0deb7be3bbb8b",
     ".codex/agents/debugger.toml": "d709c5f64ae2ec8ee901766441b9687ce9ea40d5a8966aec594d757dc5327d9e",
     ".codex/agents/general.toml": "a2fa240c01bcc33272c585d1bfa996cf1c0686204b7cc909f0fd1cdad1f5c830",
@@ -378,6 +378,10 @@
     ".codex/skills/prd-task/SKILL.md": "265bfa4b625008107214da07d5e6631081ffbe532e07366418c28fc8f7dfd927",
     ".codex/skills/prd-task/references/prd-schema.json": "11852d540895c380e41f7d5144b66c39a6b9814cc9577a97c20fdcf5d32dca5c",
     ".codex/skills/prd/SKILL.md": "78d08475e17e2780c7490fa0ab94ae47056f22c5f327289a752155e9a8ca16b9",
+    ".codex/skills/prompt-leverage/SKILL.md": "6fb4e770d1369d9a749a4b069411943a3282a105116744437b7be61e02c7ab58",
+    ".codex/skills/prompt-leverage/agents/openai.yaml": "d9f369a441454d08c3bce3370ab9d1b8b99affe504cbbbbf9e5d0f391f99cdb6",
+    ".codex/skills/prompt-leverage/references/framework.md": "077c15695ee6d81ea98ea1e4a9784e2608d14458c4492a186fd00aabce866f45",
+    ".codex/skills/prompt-leverage/scripts/augment_prompt.py": "f358e722d0b01c9102c1ca39a3b56e3499162ee40284be6407222ac7a158ed84",
     ".codex/skills/ralph/SKILL.md": "2fbb90ecff8a6e72647a50eafb20969c5e32fbba4ff2299890858f0bdc030f27",
     ".codex/skills/react-best-practices/AGENTS.md": "abcae0302cfe0b942865a3638f228d62176fc85a07665a78ba70082306488d56",
     ".codex/skills/react-best-practices/README.md": "9eafb2123d3b8b2aef41fba0db2648a3f4f49996f8c7c8bb2c86263befd8b48a",
@@ -599,7 +603,7 @@
     ".codex/context/conventions.md": "5e4ae568d3e20adf1fb6a3461ef2b63032516c19e8ca5f464a4e1f9a96579dce",
     ".codex/context/current-priorities.md": "a08fde77471c58fce21efeab4f1e64ed39f96ba0d634219f5d437396287ea662",
     ".codex/context/decision-log.md": "c5e635447d7f288f610a38c000f646fd7d5c9137e46c578e4769a0ba0ebcf5d4",
-    ".codex/context/gotchas.md": "b9862dad721e8d6eab8944c42e934e8549debd34b8a47369c0beb074af522b82",
+    ".codex/context/gotchas.md": "8dca6e3ab28e3441c407b8338e994d1638a79f41e82b6abfc12e8e9bb054a320",
     ".codex/context/index.md": "dd75cdaff5d758ba3634b18e39050446e74064bbbd835d90212b685aaf10e64f",
     ".codex/context/session-context.md": "c8b82907ea2b3769a1143031adc831b0b2ed25645df2f681f8eb930995a7337c",
     ".codex/context/worklog.md": "2059df0ad6cf2fd0df7765440526b23007f65b4acf6af901ce24636948c81807",
@@ -618,7 +622,7 @@
     ".codex/memory/_templates/tasks.md": "54119ce84fd0aa6ecd0148355f33808c061147da774475c94bf7e47bb18f73dd",
     ".codex/memory/_templates/tech-stack.md": "06cfafa736d9f32876aecfad9cfe54785a4db7dcecf94abdb09b7895761d763f",
     ".codex/memory/_templates/user.md": "4156bd3195edab1b196ac3f398ca7ec90295b91c3a5b028673be065463e5fdaf",
-    ".codex/memory/project/gotchas.md": "1a4f9d60f2d80cc7edb8f5a37577f7d1b5757a6dcc4864eeb70f620aa80e89d0",
+    ".codex/memory/project/gotchas.md": "05ce128ced24deffbb51a8b7167000c4e4816c4e3275a98f439fddb0e95c2bd6",
     ".codex/memory/project/project.md": "94a76028472946ba9782534de4920e9a77cfdf0f4daa063a97569660ccc06e21",
     ".codex/memory/project/roadmap.md": "6027b3bd3eaeed02b16a59037e760200ce8505f3007375faf2543b4b58bcee6e",
     ".codex/memory/project/state.md": "4c07c283fe11527bfe9f8195cfbc268b5e31326b8089cf271a473f0ad83b5f1b",

package/CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.0.1] — 2026-03-15
+
+### Fixed
+
+- `codexkit install` no longer scaffolds a sibling `.agents/` tree in target projects
+- Project installs now bootstrap user-scoped prompt discovery into `~/.codex/prompts`, so `/prompts:...` works without requiring `codexkit install-global`
+- Installer, validator, docs, and integration tests now reflect the project-only install contract correctly
+
 ## [1.0.0] — 2026-03-14
 
 ### Added

package/README.md

@@ -111,7 +111,7 @@ codexkit bead-sync br-123
 codexkit run --profile explore
 ```
 
-> **Important:** `codexkit install` is enough for a project-local setup. `codexkit install-global` is optional and only needed when you want multiple repos to reuse shared inventory from `~/.codex/`.
+> **Important:** `codexkit install` is enough for a project-local setup. It scaffolds the project into `.codex/` and bootstraps prompt discovery into `~/.codex/prompts` for the current user. `codexkit install-global` is optional and only needed when you want multiple repos to reuse shared inventory from `~/.codex/`.
 > **MCP auth:** keep project MCP secrets in `.codex/.env` and start Codex with `codexkit run`. Do not assume `codex` will auto-load project `.env` files by itself.
 > **No root env file:** Codexkit does not use `./.env` or `./.env.example` for MCP bootstrap. The supported location is `.codex/.env`.
 > **Git-based access:** GitHub-based npm installs and private archive flows still require repository or artifact access. The public npm package does not.
@@ -200,7 +200,7 @@ See [docs/profiles.md](docs/profiles.md) for detailed descriptions and customiza
 
 19 structured workflow entry points — the **"what"** of your development process.
 
-> **Note:** Prompts require global installation. Run `bash install/install-global.sh`, use an authorized archive-based remote install with `--global`, or use `codexkit install-global`.
+> **Note:** Codex prompt discovery is user-scoped at `~/.codex/prompts`. `codexkit install` bootstraps that prompt directory automatically for the current user, while `codexkit install-global` installs the full shared inventory.
 
 | Category          | Prompt            | Purpose                                           |
 | ----------------- | ----------------- | ------------------------------------------------- |

package/install/install-project.sh

@@ -80,6 +80,37 @@ root_shared_inventory_available() {
     [ -d "$GLOBAL_CODEX_DIR/skills" ]
 }
 
+bootstrap_user_prompt_discovery() {
+    local copied=0
+    local prompt_file target source_path
+
+    [ -d "$REPO_DIR/.codex/prompts" ] || return 0
+
+    mkdir -p "$GLOBAL_CODEX_DIR/prompts"
+
+    for prompt_file in "$REPO_DIR/.codex/prompts"/*.md; do
+        [ -f "$prompt_file" ] || continue
+        target="$GLOBAL_CODEX_DIR/prompts/$(basename "$prompt_file")"
+        source_path=".codex/prompts/$(basename "$prompt_file")"
+
+        if should_copy "$target" "$source_path"; then
+            cp "$prompt_file" "$target"
+            echo "  BOOTSTRAPPED ~/.codex/prompts/$(basename "$prompt_file")"
+            copied=$((copied + 1))
+        elif $UPGRADE; then
+            echo "  KEPT ~/.codex/prompts/$(basename "$prompt_file") (customized)"
+        else
+            echo "  KEPT ~/.codex/prompts/$(basename "$prompt_file")"
+        fi
+    done
+
+    if [ "$copied" -gt 0 ]; then
+        echo "  Prompt discovery bootstrap: synced $copied prompt files into ~/.codex/prompts"
+    else
+        echo "  Prompt discovery bootstrap: ~/.codex/prompts already ready"
+    fi
+}
+
 write_seed_file() {
     local target="$1"
     local key="$2"
@@ -364,7 +395,7 @@ elif ! $FULL_LOCAL; then
 fi
 
 if $USE_SHARED_ROOT; then
-    for legacy_dir in "$PROJECT_DIR/.codex/agents" "$PROJECT_DIR/.codex/prompts" "$PROJECT_DIR/.codex/skills" "$PROJECT_DIR/.agents/skills"; do
+    for legacy_dir in "$PROJECT_DIR/.codex/agents" "$PROJECT_DIR/.codex/prompts" "$PROJECT_DIR/.codex/skills" "$PROJECT_DIR/.agents"; do
         if [ -e "$legacy_dir" ]; then
             echo "  KEPT $legacy_dir (legacy local shared inventory)"
         fi
@@ -375,7 +406,6 @@ fi
 mkdir -p "$PROJECT_DIR/.codex"/{context,hooks,scripts,mcp,memory,plans}
 if ! $USE_SHARED_ROOT; then
     mkdir -p "$PROJECT_DIR/.codex"/{agents,prompts,skills}
-    mkdir -p "$PROJECT_DIR/.agents"
 fi
 
 # Copy config template
@@ -467,6 +497,10 @@ if ! $USE_SHARED_ROOT && [ -d "$REPO_DIR/.codex/prompts" ]; then
     done
 fi
 
+if ! $USE_SHARED_ROOT; then
+    bootstrap_user_prompt_discovery
+fi
+
 # Copy hook scripts
 if [ -d "$REPO_DIR/.codex/hooks" ]; then
     for hook_file in "$REPO_DIR/.codex/hooks"/*.sh; do
@@ -586,16 +620,8 @@ if [ -d "$REPO_DIR/.codex/mcp" ]; then
     done
 fi
 
-# Create .agents/skills symlink (Codex CLI discovery bridge) for self-contained installs.
-if ! $USE_SHARED_ROOT && [ ! -e "$PROJECT_DIR/.agents/skills" ]; then
-    ln -s ../.codex/skills "$PROJECT_DIR/.agents/skills"
-    echo "  CREATED .agents/skills → .codex/skills"
-elif ! $USE_SHARED_ROOT && [ -L "$PROJECT_DIR/.agents/skills" ]; then
-    echo "  KEPT .agents/skills symlink"
-elif ! $USE_SHARED_ROOT; then
-    echo "  KEPT .agents/skills directory"
-elif [ -e "$PROJECT_DIR/.agents/skills" ]; then
-    echo "  KEPT .agents/skills legacy bridge"
+if [ -e "$PROJECT_DIR/.agents" ]; then
+    echo "  KEPT .agents (legacy compatibility path)"
 fi
 
 # ─── Custom template overlay ────────────────────────────────────────────
@@ -696,7 +722,8 @@ if $USE_SHARED_ROOT; then
 else
     echo "    .codex/agents/         (agent roles)"
     echo "    .codex/prompts/        (workflow prompts)"
-    echo "    .agents/skills/        (skills)"
+    echo "    ~/.codex/prompts/      (prompt discovery bootstrap)"
+    echo "    .codex/skills/         (skills)"
 fi
 echo "    .codex/context/        (project knowledge)"
 echo "    .codex/memory/         (durable project memory)"

package/install/patch.sh

@@ -163,7 +163,7 @@ project_uses_full_local_inventory() {
     ) || (
         [ -d "$PROJECT_DIR/.codex/skills" ] &&
         find "$PROJECT_DIR/.codex/skills" -type f | grep -q .
-    ) || [ -e "$PROJECT_DIR/.agents/skills" ]
+    )
 }
 
 iter_managed_pairs() {

package/install/validate.sh

@@ -7,7 +7,6 @@ PASS=0
 FAIL=0
 WARN=0
 GLOBAL_CODEX_DIR="${HOME}/.codex"
-GLOBAL_AGENT_BRIDGE="${HOME}/.agents/skills"
 IS_SOURCE_REPO=false
 if [ -d ".git" ] && [ -f "package.json" ]; then
     IS_SOURCE_REPO=true
@@ -55,7 +54,7 @@ have_root_shared_inventory() {
 }
 
 project_has_local_shared_inventory() {
-    [ -d ".codex/agents" ] || [ -d ".codex/prompts" ] || [ -d ".codex/skills" ] || [ -e ".agents/skills" ]
+    [ -d ".codex/agents" ] || [ -d ".codex/prompts" ] || [ -d ".codex/skills" ]
 }
 
 path_sha256() {
@@ -348,19 +347,10 @@ for dir in agents prompts skills; do
     fi
 done
 
-# Check .agents/skills discovery bridge
-if [ -L ".agents/skills" ]; then
-    check ".agents/skills symlink exists (Codex CLI discovery)" "pass"
-elif [ -d ".agents/skills" ]; then
-    check ".agents/skills exists as directory" "pass"
+if [ -e ".agents" ]; then
+    check ".agents exists locally (legacy compatibility path still present)" "warn"
 else
-    if [ -d ".git" ] && [ -d ".codex/skills" ]; then
-        check ".agents/skills missing in source repo (canonical-only layout; install-project.sh creates bridge in target projects)" "pass"
-    elif [ -L "$GLOBAL_AGENT_BRIDGE" ] || [ -d "$GLOBAL_AGENT_BRIDGE" ] || $ROOT_SHARED_AVAILABLE; then
-        check ".agents/skills provided by root shared inventory" "pass"
-    else
-        check ".agents/skills missing (run install-project.sh to create discovery bridge in target projects)" "warn"
-    fi
+    check "No project-local .agents compatibility bridge detected" "pass"
 fi
 
 # ─── Agent roles ─────────────────────────────────────────────────
@@ -417,6 +407,15 @@ fi
 prompt_count=$(find "$PROMPT_ROOT" -name "*.md" 2>/dev/null | wc -l | tr -d ' ')
 check "Found $prompt_count prompts" "pass"
 
+if [ -d "$GLOBAL_CODEX_DIR/prompts" ]; then
+    global_prompt_count=$(find "$GLOBAL_CODEX_DIR/prompts" -maxdepth 1 -type f -name '*.md' 2>/dev/null | wc -l | tr -d ' ')
+    check "User prompt discovery available at ~/.codex/prompts ($global_prompt_count files)" "pass"
+elif $IS_SOURCE_REPO; then
+    check "User prompt discovery unavailable in source repo validation (expected without install-project.sh target)" "pass"
+else
+    check "User prompt discovery missing at ~/.codex/prompts (run install-project.sh or install-global.sh with the intended HOME)" "warn"
+fi
+
 # ─── Context docs ────────────────────────────────────────────────
 echo ""
 echo "Context docs:"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codexkit",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Professional configuration kit for OpenAI Codex CLI",
   "license": "MIT",
   "keywords": [