@kontourai/flow-agents 1.1.0 → 1.2.0

package/evals/integration/test_bundle_install.sh

@@ -310,20 +310,20 @@ NODE
 done
 
 for dir in "$KIRO_DEST" "$BASE_DEST" "$CLAUDE_DEST" "$CODEX_DEST"; do
-  if [[ -f "$dir/scripts/flow-kit.js" ]] \
-    && node "$dir/scripts/flow-kit.js" list --dest "$dir" >/tmp/flow-kit-list.out 2>&1 \
-    && node "$dir/scripts/flow-kit.js" status --dest "$dir" >/tmp/flow-kit-status.out 2>&1 \
-    && rg -q 'No local Flow Kits installed' /tmp/flow-kit-list.out \
-    && rg -q 'No local Flow Kits installed' /tmp/flow-kit-status.out; then
+  if [[ -f "$dir/scripts/kit.js" ]] \
+    && node "$dir/scripts/kit.js" list --dest "$dir" >/tmp/kit-list.out 2>&1 \
+    && node "$dir/scripts/kit.js" status --dest "$dir" >/tmp/kit-status.out 2>&1 \
+    && rg -q 'No local Flow Kits installed' /tmp/kit-list.out \
+    && rg -q 'No local Flow Kits installed' /tmp/kit-status.out; then
     _pass "$dir includes local Flow Kit CLI and empty list/status works"
   else
     _fail "$dir local Flow Kit CLI list/status smoke failed"
   fi
 done
 
-if [[ -f "$CODEX_DEST/scripts/flow-kit.js" ]] \
+if [[ -f "$CODEX_DEST/scripts/kit.js" ]] \
   && [[ -f "$CODEX_DEST/build/src/runtime-adapters.js" ]] \
-  && node "$CODEX_DEST/scripts/flow-kit.js" activate --dest "$CODEX_DEST" --format json >/tmp/codex-runtime-activation.json 2>&1 \
+  && node "$CODEX_DEST/scripts/kit.js" activate --dest "$CODEX_DEST" --format json >/tmp/codex-runtime-activation.json 2>&1 \
   && node - "$CODEX_DEST" /tmp/codex-runtime-activation.json <<'NODE'
 const fs = require("node:fs");
 const path = require("node:path");
@@ -344,7 +344,6 @@ then
   _pass "Codex installed bundle activates Builder Kit through codex-local"
 else
   _fail "Codex installed bundle runtime activation failed"
-  sed -n '1,180p' /tmp/codex-runtime-activation.json 2>/dev/null || true
 fi
 
 if node - "$KIRO_DEST" "$BASE_DEST" "$CLAUDE_DEST" "$CODEX_DEST" <<'NODE'
@@ -714,8 +713,11 @@ else
   _fail "Codex core-pack agent filtering failed"
 fi
 
-if [[ -d "$CODEX_CORE_DEST/.codex/skills/plan-work" && ! -d "$CODEX_CORE_DEST/.codex/skills/deliver" ]]; then
-  _pass "Codex core-pack install keeps core skills and prunes optional skills"
+# Kit-owned skills (plan-work, deliver) are always present regardless of pack filter.
+# Pack filtering only prunes skills declared in packs.json (the tool-skills).
+# The development-pack tool-skill agentic-engineering should be pruned in a core-only install.
+if [[ -d "$CODEX_CORE_DEST/.codex/skills/plan-work" && -d "$CODEX_CORE_DEST/.codex/skills/deliver" && ! -d "$CODEX_CORE_DEST/.codex/skills/agentic-engineering" ]]; then
+  _pass "Codex core-pack install: kit-skills present, dev-only tool-skill pruned"
 else
   _fail "Codex core-pack skill filtering failed"
 fi
@@ -746,8 +748,11 @@ else
   _fail "opencode core-pack agent filtering failed (tool-planner.md missing)"
 fi
 
-if [[ -d "$OPENCODE_CORE_DEST/.opencode/skills/plan-work" && ! -d "$OPENCODE_CORE_DEST/.opencode/skills/deliver" ]]; then
-  _pass "opencode core-pack install keeps core skills and prunes optional skills"
+# Kit-owned skills (plan-work, deliver) are always present regardless of pack filter.
+# Pack filtering only prunes skills declared in packs.json (the tool-skills).
+# The development-pack tool-skill agentic-engineering should be pruned in a core-only install.
+if [[ -d "$OPENCODE_CORE_DEST/.opencode/skills/plan-work" && -d "$OPENCODE_CORE_DEST/.opencode/skills/deliver" && ! -d "$OPENCODE_CORE_DEST/.opencode/skills/agentic-engineering" ]]; then
+  _pass "opencode core-pack install: kit-skills present, dev-only tool-skill pruned"
 else
   _fail "opencode core-pack skill filtering failed"
 fi

package/evals/integration/test_console_learning_projection.sh

@@ -146,7 +146,7 @@ if jq -e '
   $ext.routing.deferred == 1 and
   ($ext.routing.targets | sort) == ["eval", "skill"] and
   ($ext.routing.statuses | sort) == ["deferred", "open"] and
-  ($ext.routing.refs | sort) == ["github:kontourai/flow-agents#96", "skills/learning-review/SKILL.md"] and
+  ($ext.routing.refs | sort) == ["github:kontourai/flow-agents#96", "kits/builder/skills/learning-review/SKILL.md"] and
   $ext.correction.needed == true and
   $ext.correction.type == "workflow" and
   $ext.correction.recurrence_key == "console-learning-projection.recurrence-metadata" and

package/evals/integration/test_flow_kit_install_git.sh

@@ -14,7 +14,7 @@ trap 'rm -rf "$TMP_DIR"' EXIT
 pass() { echo "  ✓ $1"; }
 fail() { echo "  ✗ $1"; errors=$((errors + 1)); }
 
-CLI="$ROOT/scripts/flow-kit.js"
+CLI="$ROOT/scripts/kit.js"
 VALID_SRC="$ROOT/evals/fixtures/flow-kit-repository/valid-local-kit"
 DEST="$TMP_DIR/install-dest"
 mkdir -p "$DEST"
@@ -33,7 +33,7 @@ echo "  (fixture repo: $FILE_URL)"
 
 # --- Test 1: basic install-git from file:// URL ---
 install_out="$TMP_DIR/install-git.out"
-if flow_agents_node "$CLI" install-git "$FILE_URL" --dest "$DEST" >"$install_out" 2>&1; then
+if flow_agents_node "$CLI" install "$FILE_URL" --dest "$DEST" >"$install_out" 2>&1; then
   pass "install-git from file:// URL succeeds"
 else
   fail "install-git from file:// URL failed"
@@ -72,7 +72,7 @@ fi
 # --- Test 2: idempotent re-install from same URL ---
 idempotent_out="$TMP_DIR/idempotent.out"
 registry_hash_before="$(shasum -a 256 "$REGISTRY" | awk '{print $1}')"
-if flow_agents_node "$CLI" install-git "$FILE_URL" --dest "$DEST" >"$idempotent_out" 2>&1 \
+if flow_agents_node "$CLI" install "$FILE_URL" --dest "$DEST" >"$idempotent_out" 2>&1 \
   && grep -q "already installed" "$idempotent_out" \
   && [[ "$registry_hash_before" == "$(shasum -a 256 "$REGISTRY" | awk '{print $1}')" ]]; then
   pass "install-git same-URL reinstall is idempotent"
@@ -93,7 +93,7 @@ cp -R "$VALID_SRC" "$FIXTURE_WORKING2"
 git clone -q --bare "$FIXTURE_WORKING2" "$FIXTURE_REPO2"
 FILE_URL2="file://$FIXTURE_REPO2"
 
-if flow_agents_node "$CLI" install-git "${FILE_URL2}#v1.0" --dest "$DEST2" >"$ref_out" 2>&1; then
+if flow_agents_node "$CLI" install "${FILE_URL2}#v1.0" --dest "$DEST2" >"$ref_out" 2>&1; then
   pass "install-git with #ref fragment succeeds"
 else
   fail "install-git with #ref fragment failed"
@@ -119,7 +119,7 @@ fi
 ref_flag_out="$TMP_DIR/ref-flag.out"
 DEST3="$TMP_DIR/dest-with-ref-flag"
 mkdir -p "$DEST3"
-if flow_agents_node "$CLI" install-git "$FILE_URL2" --ref v1.0 --dest "$DEST3" >"$ref_flag_out" 2>&1; then
+if flow_agents_node "$CLI" install "$FILE_URL2" --ref v1.0 --dest "$DEST3" >"$ref_flag_out" 2>&1; then
   pass "install-git with --ref flag succeeds"
 else
   fail "install-git with --ref flag failed"
@@ -128,7 +128,7 @@ fi
 
 # --- Test 5: missing git URL exits non-zero ---
 missing_url_out="$TMP_DIR/missing-url.out"
-if flow_agents_node "$CLI" install-git --dest "$DEST" >"$missing_url_out" 2>&1; then
+if flow_agents_node "$CLI" install --dest "$DEST" >"$missing_url_out" 2>&1; then
   fail "install-git with no URL should exit non-zero"
   sed -n '1,40p' "$missing_url_out"
 else
@@ -137,7 +137,7 @@ fi
 
 # --- Test 6: invalid git URL exits non-zero ---
 invalid_url_out="$TMP_DIR/invalid-url.out"
-if flow_agents_node "$CLI" install-git "file:///nonexistent-repo-that-does-not-exist" --dest "$DEST" >"$invalid_url_out" 2>&1; then
+if flow_agents_node "$CLI" install "file:///nonexistent-repo-that-does-not-exist" --dest "$DEST" >"$invalid_url_out" 2>&1; then
   fail "install-git with invalid URL should exit non-zero"
   sed -n '1,40p' "$invalid_url_out"
 else

package/evals/integration/test_flow_kit_repository.sh

@@ -55,15 +55,15 @@ echo "=== Flow Kit Repository Fixture Checks ==="
 expect_pass "valid-local-kit"
 expect_fail "invalid-schema-version" '\.schema_version must be "1\.0"'
 expect_fail "invalid-missing-schema-version" '\.schema_version must be "1\.0"'
-expect_fail "invalid-id" '\.id must be a stable kebab-case string'
-expect_fail "invalid-missing-id" '\.id must be a stable kebab-case string'
+expect_fail "invalid-id" '\.id must be a kebab-case string'
+expect_fail "invalid-missing-id" '\.id must be a kebab-case string'
 expect_fail "invalid-name" '\.name must be a non-empty string'
 expect_fail "invalid-missing-flow" 'flows\[0\]\.path points at missing Flow Definition'
 expect_fail "invalid-absolute-path" 'flows\[0\]\.path must be relative'
-expect_fail "invalid-traversal" "flows\\[0\\]\\.path must stay inside the kit directory"
+expect_fail "invalid-traversal" "flows\\[0\\]\\.path must not contain"
 expect_fail "invalid-malformed-json" 'invalid JSON'
 expect_fail "invalid-asset-section" '\.docs must be a list'
-expect_fail "invalid-duplicate-flow" "flows\\[1\\]\\.id duplicates"
+expect_fail "invalid-duplicate-flow" "flows\\[1\\]\\.path duplicates"
 
 echo ""
 echo "=== Builder Kit Shared Validation Check ==="

package/evals/integration/test_kit_conformance_levels.sh

@@ -23,7 +23,7 @@ run_inspect() {
   local output="$2"
   # Route through the main CLI to avoid import.meta.url path-resolution issues.
   flow_agents_build_ts 2>/dev/null
-  node "$FLOW_AGENTS_EVAL_ROOT/build/src/cli.js" flow-kit inspect "$kit_dir" >"$output" 2>&1
+  node "$FLOW_AGENTS_EVAL_ROOT/build/src/cli.js" kit inspect "$kit_dir" >"$output" 2>&1
 }
 
 # ===================================================================

package/evals/integration/test_local_flow_kit_install.sh

@@ -12,7 +12,7 @@ trap 'rm -rf "$TMP_DIR"' EXIT
 pass() { echo "  ✓ $1"; }
 fail() { echo "  ✗ $1"; errors=$((errors + 1)); }
 
-CLI="$ROOT/scripts/flow-kit.js"
+CLI="$ROOT/scripts/kit.js"
 VALID_SRC="$ROOT/evals/fixtures/flow-kit-repository/valid-local-kit"
 INVALID_SRC="$ROOT/evals/fixtures/flow-kit-repository/invalid-missing-flow"
 DEST="$TMP_DIR/install-dest"
@@ -23,7 +23,7 @@ mkdir -p "$DEST"
 echo "=== Local Flow Kit Install Checks ==="
 
 install_output="$TMP_DIR/install.out"
-if flow_agents_node "$CLI" install-local "$VALID_SRC" --dest "$DEST" >"$install_output" 2>&1; then
+if flow_agents_node "$CLI" install "$VALID_SRC" --dest "$DEST" >"$install_output" 2>&1; then
   pass "valid local kit installs into temp destination"
 else
   fail "valid local kit install failed"
@@ -52,7 +52,7 @@ fi
 
 registry_hash_before_invalid="$(shasum -a 256 "$REGISTRY" | awk '{print $1}')"
 invalid_output="$TMP_DIR/invalid.out"
-if flow_agents_node "$CLI" install-local "$INVALID_SRC" --dest "$DEST" >"$invalid_output" 2>&1; then
+if flow_agents_node "$CLI" install "$INVALID_SRC" --dest "$DEST" >"$invalid_output" 2>&1; then
   fail "invalid local kit install should fail"
   sed -n '1,160p' "$invalid_output"
 elif rg -q 'Flow Kit repository validation failed' "$invalid_output" \
@@ -65,7 +65,7 @@ fi
 
 registry_hash_before_idempotent="$(shasum -a 256 "$REGISTRY" | awk '{print $1}')"
 idempotent_output="$TMP_DIR/idempotent.out"
-if flow_agents_node "$CLI" install-local "$VALID_SRC" --dest "$DEST" >"$idempotent_output" 2>&1 \
+if flow_agents_node "$CLI" install "$VALID_SRC" --dest "$DEST" >"$idempotent_output" 2>&1 \
   && rg -q "already installed" "$idempotent_output" \
   && [[ "$registry_hash_before_idempotent" == "$(shasum -a 256 "$REGISTRY" | awk '{print $1}')" ]]; then
   pass "same-source reinstall is idempotent"
@@ -79,7 +79,7 @@ cp -R "$VALID_SRC" "$CONFLICT_SRC"
 printf '\nconflict copy\n' >> "$CONFLICT_SRC/docs/README.md"
 conflict_output="$TMP_DIR/conflict.out"
 registry_hash_before_conflict="$(shasum -a 256 "$REGISTRY" | awk '{print $1}')"
-if flow_agents_node "$CLI" install-local "$CONFLICT_SRC" --dest "$DEST" >"$conflict_output" 2>&1; then
+if flow_agents_node "$CLI" install "$CONFLICT_SRC" --dest "$DEST" >"$conflict_output" 2>&1; then
   fail "different source with existing kit id should conflict"
   sed -n '1,160p' "$conflict_output"
 elif rg -q 'conflict: kit' "$conflict_output" \
@@ -91,7 +91,7 @@ else
 fi
 
 force_conflict_output="$TMP_DIR/force-conflict.out"
-if flow_agents_node "$CLI" install-local "$CONFLICT_SRC" --dest "$DEST" --force >"$force_conflict_output" 2>&1; then
+if flow_agents_node "$CLI" install "$CONFLICT_SRC" --dest "$DEST" --force >"$force_conflict_output" 2>&1; then
   fail "--force should not replace a different-source duplicate id"
   sed -n '1,160p' "$force_conflict_output"
 elif rg -q 'conflict: kit' "$force_conflict_output" \
@@ -103,7 +103,7 @@ else
 fi
 
 update_output="$TMP_DIR/update.out"
-if flow_agents_node "$CLI" install-local "$CONFLICT_SRC" --dest "$DEST" --update >"$update_output" 2>&1 \
+if flow_agents_node "$CLI" install "$CONFLICT_SRC" --dest "$DEST" --update >"$update_output" 2>&1 \
   && rg -q "updated local kit" "$update_output" \
   && rg -q "$CONFLICT_SRC" "$REGISTRY"; then
   pass "explicit update replaces duplicate id source"

package/evals/integration/test_publish_change_helper.sh

@@ -112,7 +112,7 @@ status=$?
 
 for risk in runtime schema package hook security; do
   case "$risk" in
-    runtime) path="scripts/flow-kit.js" ;;
+    runtime) path="scripts/kit.js" ;;
     schema) path="schemas/workflow-evidence.schema.json" ;;
     package) path="package.json" ;;
     hook) path="scripts/hooks/quality-gate.js" ;;

package/evals/integration/test_pull_work_provider.sh

@@ -52,7 +52,7 @@ status=$?
 [[ "$(json_query "$TMPDIR_EVAL/normalized.json" "items.5.planned_base_sha")" == "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" ]] && pass "marker normalizes planned_base_sha" || fail "marker normalizes planned_base_sha"
 [[ "$(json_query "$TMPDIR_EVAL/normalized.json" "items.5.planned_at")" == "2026-06-03T03:23:14Z" ]] && pass "marker normalizes planned_at" || fail "marker normalizes planned_at"
 [[ "$(json_query "$TMPDIR_EVAL/normalized.json" "items.5.planning_artifact_ref")" == ".flow-agents/idea-to-backlog-source-revision-structured-blockers/idea-to-backlog-source-revision-structured-blockers--plan.md" ]] && pass "marker normalizes planning_artifact_ref" || fail "marker normalizes planning_artifact_ref"
-[[ "$(json_query "$TMPDIR_EVAL/normalized.json" "items.5.planning_scope_refs.0")" == "skills/idea-to-backlog/SKILL.md" ]] && pass "marker normalizes planning_scope_refs" || fail "marker normalizes planning_scope_refs"
+[[ "$(json_query "$TMPDIR_EVAL/normalized.json" "items.5.planning_scope_refs.0")" == "kits/builder/skills/idea-to-backlog/SKILL.md" ]] && pass "marker normalizes planning_scope_refs" || fail "marker normalizes planning_scope_refs"
 [[ "$(json_query "$TMPDIR_EVAL/normalized.json" "items.5.source_revisions.1.repo")" == "kontourai/flow" ]] && pass "marker preserves repo-scoped source_revisions" || fail "marker preserves repo-scoped source_revisions"
 [[ "$(json_query "$TMPDIR_EVAL/normalized.json" "items.5.blockers.0.ref.owner")" == "kontourai" ]] && pass "structured blocker preserves provider owner" || fail "structured blocker preserves provider owner"
 [[ "$(json_query "$TMPDIR_EVAL/normalized.json" "items.5.blockers.0.ref.repo")" == "flow" ]] && pass "structured blocker preserves provider repo" || fail "structured blocker preserves provider repo"

package/evals/integration/test_runtime_adapter_activation.sh

@@ -12,7 +12,7 @@ trap 'rm -rf "$TMP_DIR"' EXIT
 pass() { echo "  ✓ $1"; }
 fail() { echo "  ✗ $1"; errors=$((errors + 1)); }
 
-CLI="$ROOT/scripts/flow-kit.js"
+CLI="$ROOT/scripts/kit.js"
 DEST="$TMP_DIR/runtime-dest"
 MIXED_SRC="$ROOT/evals/fixtures/flow-kit-repository/mixed-runtime-kit"
 OUT="$TMP_DIR/activation.json"
@@ -22,7 +22,7 @@ mkdir -p "$DEST"
 
 echo "=== Runtime Adapter Activation Checks ==="
 
-if flow_agents_node "$CLI" install-local "$MIXED_SRC" --dest "$DEST" >"$TMP_DIR/install.out" 2>&1; then
+if flow_agents_node "$CLI" install "$MIXED_SRC" --dest "$DEST" >"$TMP_DIR/install.out" 2>&1; then
   pass "mixed local kit installs into temp destination"
 else
   fail "mixed local kit install failed"
@@ -146,7 +146,7 @@ STRANDS_OUT="$TMP_DIR/strands-activation.json"
 mkdir -p "$STRANDS_DEST"
 
 # Install the mixed kit into strands dest so we can assert skills land there too
-if flow_agents_node "$CLI" install-local "$MIXED_SRC" --dest "$STRANDS_DEST" >"$TMP_DIR/strands-install.out" 2>&1; then
+if flow_agents_node "$CLI" install "$MIXED_SRC" --dest "$STRANDS_DEST" >"$TMP_DIR/strands-install.out" 2>&1; then
   pass "mixed local kit installs into strands temp destination"
 else
   fail "mixed local kit install failed (strands dest)"

package/evals/lib/node.sh

@@ -45,10 +45,10 @@ flow_agents_node() {
       node "$FLOW_AGENTS_EVAL_ROOT/build/src/cli/validate-source-tree.js" "$@"
       return
       ;;
-    */scripts/flow-kit.js|scripts/flow-kit.js)
+    */scripts/kit.js|scripts/kit.js)
       shift
       flow_agents_build_ts || return
-      node "$FLOW_AGENTS_EVAL_ROOT/build/src/cli/flow-kit.js" "$@"
+      node "$FLOW_AGENTS_EVAL_ROOT/build/src/cli/kit.js" "$@"
       return
       ;;
     */scripts/effective-backlog-settings.js|scripts/effective-backlog-settings.js)

package/evals/static/test_workflow_skills.sh

@@ -52,19 +52,19 @@ require_status() {
 
 echo "=== Workflow Skill Contract Checks ==="
 
-IDEA="$ROOT/skills/idea-to-backlog/SKILL.md"
-BUILDER_SHAPE="$ROOT/skills/builder-shape/SKILL.md"
-PULL="$ROOT/skills/pull-work/SKILL.md"
-DESIGN_PROBE="$ROOT/skills/design-probe/SKILL.md"
-PICKUP_PROBE="$ROOT/skills/pickup-probe/SKILL.md"
-EVIDENCE="$ROOT/skills/evidence-gate/SKILL.md"
-RELEASE="$ROOT/skills/release-readiness/SKILL.md"
-LEARNING="$ROOT/skills/learning-review/SKILL.md"
-DELIVER="$ROOT/skills/deliver/SKILL.md"
-PLAN_WORK="$ROOT/skills/plan-work/SKILL.md"
-EXECUTE_PLAN="$ROOT/skills/execute-plan/SKILL.md"
-REVIEW_WORK="$ROOT/skills/review-work/SKILL.md"
-VERIFY_WORK="$ROOT/skills/verify-work/SKILL.md"
+IDEA="$ROOT/kits/builder/skills/idea-to-backlog/SKILL.md"
+BUILDER_SHAPE="$ROOT/kits/builder/skills/builder-shape/SKILL.md"
+PULL="$ROOT/kits/builder/skills/pull-work/SKILL.md"
+DESIGN_PROBE="$ROOT/kits/builder/skills/design-probe/SKILL.md"
+PICKUP_PROBE="$ROOT/kits/builder/skills/pickup-probe/SKILL.md"
+EVIDENCE="$ROOT/kits/builder/skills/evidence-gate/SKILL.md"
+RELEASE="$ROOT/kits/builder/skills/release-readiness/SKILL.md"
+LEARNING="$ROOT/kits/builder/skills/learning-review/SKILL.md"
+DELIVER="$ROOT/kits/builder/skills/deliver/SKILL.md"
+PLAN_WORK="$ROOT/kits/builder/skills/plan-work/SKILL.md"
+EXECUTE_PLAN="$ROOT/kits/builder/skills/execute-plan/SKILL.md"
+REVIEW_WORK="$ROOT/kits/builder/skills/review-work/SKILL.md"
+VERIFY_WORK="$ROOT/kits/builder/skills/verify-work/SKILL.md"
 MAP="$ROOT/docs/skills-map.md"
 ROOT_CONTEXT="$ROOT/CONTEXT.md"
 CONTEXT_MAP="$ROOT/docs/context-map.md"
@@ -146,6 +146,7 @@ while IFS= read -r guidance_surface; do
 done < <(
   {
     find "$ROOT/skills" -type f -name '*.md'
+    find "$ROOT/kits" -path "*/skills/*/SKILL.md" -type f
     find "$ROOT/context/contracts" -maxdepth 1 -type f -name '*.md'
     find "$ROOT/agents" -maxdepth 1 -type f -name '*.json'
     printf '%s\n' "$ROOT/packaging/manifest.json"
@@ -553,7 +554,7 @@ echo ""
 echo "--- builder-shape ---"
 require_text "$BUILDER_SHAPE" '^name: "builder-shape"$' "frontmatter name"
 require_text "$BUILDER_SHAPE" 'Builder Kit `shape` flow' "defines Builder Kit shape product surface"
-require_text "$BUILDER_SHAPE" 'skills/idea-to-backlog/SKILL.md' "delegates to idea-to-backlog"
+require_text "$BUILDER_SHAPE" 'kits/builder/skills/idea-to-backlog/SKILL.md' "delegates to idea-to-backlog"
 require_text "$BUILDER_SHAPE" 'kits/builder/flows/shape.flow.json' "links Builder Kit Flow Definition"
 require_text "$BUILDER_SHAPE" 'raw idea.*current conversation context|current conversation context.*raw idea' "accepts raw idea or conversation context"
 require_text "$BUILDER_SHAPE" 'Probe/alignment' "uses Probe alignment language"
@@ -1102,7 +1103,6 @@ require_text "$PACKS_MANIFEST" '"name": "core"' "pack manifest defines core pack
 require_text "$PACKS_MANIFEST" '"default": true' "pack manifest defines default pack"
 require_text "$PACKS_MANIFEST" '"name": "development"' "pack manifest defines development pack"
 require_text "$PACKS_MANIFEST" '"eval-rebuild"' "pack manifest includes eval-rebuild"
-require_text "$PACKS_MANIFEST" '"explore"' "pack manifest includes explore"
 require_text "$ROOT/scripts/build-universal-bundles.js" 'FLOW_AGENTS_PACKS' "bundle installer supports pack filtering"
 require_text "$ROOT/evals/integration/test_bundle_install.sh" 'core-pack install keeps core agents' "bundle install test covers pack filtering"
 require_text "$CONTEXT_MAP" 'Context Loading Rules' "context map includes loading rules"

package/integrations/strands/flow_agents_strands/steering.py

@@ -211,7 +211,7 @@ class SteeringContext:
         """
         Surface activated kit flows from the strands-local runtime path.
 
-        Reads .flow-agents/runtime/strands/flows/ (written by `flow-kit activate
+        Reads .flow-agents/runtime/strands/flows/ (written by `flow-agents kit activate
         --adapter strands-local`) and emits a brief hint listing active kit flows
         by id and description so the agent is aware of available workflow guidance.
         """

package/integrations/strands-ts/src/hooks.ts

@@ -189,7 +189,7 @@ export class FlowAgentsHooks {
    *
    * Includes activated kit flows discovered from the strands-local runtime
    * path (.flow-agents/runtime/strands/flows/) written by
-   * `flow-kit activate --adapter strands-local`.
+   * `flow-agents kit activate --adapter strands-local`.
    *
    * Callers should prepend this to the Agent's system prompt:
    *

package/kits/builder/kit.json

@@ -15,5 +15,22 @@
       "path": "flows/build.flow.json",
       "description": "Pull ready work through design probing, planning, implementation, verification, pull request readiness, merge readiness, and learning."
     }
+  ],
+  "skills": [
+    { "id": "builder.builder-shape", "path": "skills/builder-shape/SKILL.md", "description": "Invoke Builder Kit shape from a raw idea or the current conversation context." },
+    { "id": "builder.deliver", "path": "skills/deliver/SKILL.md", "description": "Delivery workflow — selected work to delivered code." },
+    { "id": "builder.design-probe", "path": "skills/design-probe/SKILL.md", "description": "One-question-at-a-time design probing interview." },
+    { "id": "builder.evidence-gate", "path": "skills/evidence-gate/SKILL.md", "description": "Evaluate whether completed work is trustworthy enough for human review, merge, or release." },
+    { "id": "builder.execute-plan", "path": "skills/execute-plan/SKILL.md", "description": "Parallel execution primitive — plan artifact path to implemented code." },
+    { "id": "builder.fix-bug", "path": "skills/fix-bug/SKILL.md", "description": "Bug fix orchestrator — diagnose, plan, execute, review, verify, loop." },
+    { "id": "builder.idea-to-backlog", "path": "skills/idea-to-backlog/SKILL.md", "description": "Turn raw ideas into shaped, prioritized, executable GitHub issue backlog." },
+    { "id": "builder.learning-review", "path": "skills/learning-review/SKILL.md", "description": "Capture post-merge learnings and feed them back into backlog, skills, tests, or knowledge." },
+    { "id": "builder.pickup-probe", "path": "skills/pickup-probe/SKILL.md", "description": "Builder Kit work-item/docs/provider-grounded Probe specialization before plan-work." },
+    { "id": "builder.plan-work", "path": "skills/plan-work/SKILL.md", "description": "Code planning primitive — goal + directory to structured execution plan." },
+    { "id": "builder.pull-work", "path": "skills/pull-work/SKILL.md", "description": "Select ready GitHub issues from the executable backlog for implementation." },
+    { "id": "builder.release-readiness", "path": "skills/release-readiness/SKILL.md", "description": "Decide whether evidence-backed work is ready to merge, release, deploy, or hold." },
+    { "id": "builder.review-work", "path": "skills/review-work/SKILL.md", "description": "Review primitive — code, security, dependency, architecture critique before verification." },
+    { "id": "builder.tdd-workflow", "path": "skills/tdd-workflow/SKILL.md", "description": "Test-driven development — RED, GREEN, REFACTOR with git checkpoints." },
+    { "id": "builder.verify-work", "path": "skills/verify-work/SKILL.md", "description": "Verification primitive — session file path to structured evidence verdict." }
   ]
 }

package/{skills → kits/builder/skills}/builder-shape/SKILL.md

@@ -11,7 +11,7 @@ Invoke the Builder Kit `shape` flow for raw product ideas, vague build goals, cu
 
 - Product surface: let the user ask for "Builder Kit shape", "builder shape", or "shape this with Builder Kit" without naming `idea-to-backlog`.
 - Proactive suggestion: when a user starts planning a feature, product, PRD, roadmap item, or vague build idea without naming a workflow, briefly suggest Builder Kit shape as the structured path before implementation. Phrase it as an option, not a forced gate, unless the request is too ambiguous to plan responsibly.
-- Delegation: use `skills/idea-to-backlog/SKILL.md` as the shaping primitive. Do not duplicate or replace its workflow, artifact contract, issue shape, or gate rules.
+- Delegation: use `kits/builder/skills/idea-to-backlog/SKILL.md` as the shaping primitive. Do not duplicate or replace its workflow, artifact contract, issue shape, or gate rules.
 - Product-level auto-guidance: when the user invokes Builder Kit shape, guide them through `design-probe` alignment and then the `idea-to-backlog` workflow directly; do not require them to type `design-probe` or `idea-to-backlog` as additional skill names.
 - do not require them to type `idea-to-backlog`; Builder Kit shape owns the user-facing route into that primitive.
 - Flow reference: link every Builder Kit shape artifact to the Builder Kit Flow Definition at `kits/builder/flows/shape.flow.json`.
@@ -19,7 +19,7 @@ Invoke the Builder Kit `shape` flow for raw product ideas, vague build goals, cu
 - Probe/alignment: when the idea, user outcome, constraints, non-goals, success signal, risk, or bundle relationship is unclear, run `design-probe` style alignment before continuing.
 - Default stop: stop at the backlog gate by default. Do not create GitHub issues, sync to a project, or hand off to `pull-work` unless the user explicitly asks for that next step.
 - Boundary: do not run Builder Kit build execution, remote kit install, package extraction, downstream delivery workflows, `plan-work`, `execute-plan`, `review-work`, `verify-work`, `evidence-gate`, or release workflows from this invocation.
-- Compatibility: Direct `idea-to-backlog` usage remains valid and should behave exactly as described in `skills/idea-to-backlog/SKILL.md`.
+- Compatibility: Direct `idea-to-backlog` usage remains valid and should behave exactly as described in `kits/builder/skills/idea-to-backlog/SKILL.md`.
 - Primitive recovery: if a user invokes `idea-to-backlog` or another primitive with missing shaping context and appears to want the product flow, explain that Builder Kit shape is the entry point and offer to route there.
 
 ## Invocation
@@ -33,7 +33,7 @@ Use this skill when the user says things like:
 
 When activated:
 
-1. Read `skills/idea-to-backlog/SKILL.md`.
+1. Read `kits/builder/skills/idea-to-backlog/SKILL.md`.
 2. State that Builder Kit shape delegates to `idea-to-backlog` and uses `kits/builder/flows/shape.flow.json`.
 3. Gather the raw idea or current conversation context.
 4. If needed, use `design-probe`: ask one Probe/alignment question at a time before shaping. Prefer questions that clarify user outcome, constraints, non-goals, success criteria, risk, or whether bundled ideas truly belong together.
@@ -72,5 +72,5 @@ For Builder Kit shape invocations, also include:
 Issue sync is explicit-only.
 
 - If the user did not ask to create or sync issues, set `backlog_links` to `not_requested` or an empty recorded status and stop at the backlog gate.
-- If the user asks to create or sync issues, follow the GitHub issue rules in `skills/idea-to-backlog/SKILL.md`.
+- If the user asks to create or sync issues, follow the GitHub issue rules in `kits/builder/skills/idea-to-backlog/SKILL.md`.
 - If provider details are missing, ask for them instead of assuming a GitHub repository, project, labels, milestone, or assignee.

package/{skills → kits/builder/skills}/idea-to-backlog/SKILL.md

@@ -217,7 +217,7 @@ Provider-neutral marker example:
       "planned_at": "2026-06-03T03:23:14Z",
       "planning_artifact_ref": ".flow-agents/example/example--idea-to-backlog.md",
       "planning_scope_refs": [
-        "skills/idea-to-backlog/SKILL.md",
+        "kits/builder/skills/idea-to-backlog/SKILL.md",
         "context/contracts/work-item-contract.md"
       ]
     }

package/kits/knowledge/kit.json

@@ -3,7 +3,7 @@
   "id": "knowledge",
   "name": "Knowledge Kit",
   "product_name": "Knowledge Kit",
-  "description": "A Flow Kit for durable, gated knowledge storage. Provides a store contract with defined record types, mutation operations, and provenance rules \u2014 plus a default adapter backed by markdown files, YAML frontmatter, wikilinks, and a graph index.",
+  "description": "A Flow Kit for durable, gated knowledge storage. Provides a store contract with defined record types, mutation operations, and provenance rules — plus a default adapter backed by markdown files, YAML frontmatter, wikilinks, and a graph index.",
   "flows": [
     {
       "id": "knowledge.store-contract",
@@ -13,17 +13,17 @@
     {
       "id": "knowledge.ingest",
       "path": "flows/ingest.flow.json",
-      "description": "Ingest raw captures: capture \u2192 classify \u2192 route. Gate on classify requires category + type='raw' classification evidence per the store contract create op."
+      "description": "Ingest raw captures: capture → classify → route. Gate on classify requires category + type='raw' classification evidence per the store contract create op."
     },
     {
       "id": "knowledge.compile",
       "path": "flows/compile.flow.json",
-      "description": "Compile classified raws into durable notes: select-raws \u2192 compile \u2192 link. Gate on compile requires provenance refs to every consumed raw record."
+      "description": "Compile classified raws into durable notes: select-raws → compile → link. Gate on compile requires provenance refs to every consumed raw record."
     },
     {
       "id": "knowledge.synthesize",
       "path": "flows/synthesize.flow.json",
-      "description": "Synthesize compiled sources into concept summaries: detect-cluster \u2192 propose \u2192 evidence-gate \u2192 apply-or-reject. Mutation-gate policy: no summary mutates without an approved proposal carrying source refs; rejection leaves store untouched."
+      "description": "Synthesize compiled sources into concept summaries: detect-cluster → propose → evidence-gate → apply-or-reject. Mutation-gate policy: no summary mutates without an approved proposal carrying source refs; rejection leaves store untouched."
     },
     {
       "id": "knowledge.consolidate",
@@ -33,7 +33,7 @@
     {
       "id": "knowledge.retire",
       "path": "flows/retire.flow.json",
-      "description": "Retire implemented or obsolete records from the working set via gated lifecycle: identify \u2192 propose-retirement \u2192 evidence-gate \u2192 apply-or-reject. Evidence required: retirement rationale + implementedByRef (when targeting 'implemented' status) or supersededByRef (optional, for 'retired'). Rejection leaves record status byte-identical. Retired records remain fully queryable with provenance via includeRetired flag."
+      "description": "Retire implemented or obsolete records from the working set via gated lifecycle: identify → propose-retirement → evidence-gate → apply-or-reject. Evidence required: retirement rationale + implementedByRef (when targeting 'implemented' status) or supersededByRef (optional, for 'retired'). Rejection leaves record status byte-identical. Retired records remain fully queryable with provenance via includeRetired flag."
     }
   ],
   "docs": [
@@ -55,7 +55,7 @@
     {
       "id": "knowledge.flow-runner",
       "path": "adapters/flow-runner/index.js",
-      "description": "Executable flow logic: capture(rawText, meta) \u2192 classified raw record; compile(rawIds[]) \u2192 compiled record with provenance links; synthesize(conceptId | topicSelector, options) \u2192 concept summary proposal with mutation gate; consolidate(snapshotId | topicSelector, options) \u2192 decision snapshot consolidation with supersede-not-delete; retire(recordId, options) \u2192 gated status lifecycle transition (active\u2192implemented\u2192retired) with working-set exclusion. Emits canonical telemetry events at gate points."
+      "description": "Executable flow logic: capture(rawText, meta) → classified raw record; compile(rawIds[]) → compiled record with provenance links; synthesize(conceptId | topicSelector, options) → concept summary proposal with mutation gate; consolidate(snapshotId | topicSelector, options) → decision snapshot consolidation with supersede-not-delete; retire(recordId, options) → gated status lifecycle transition (active→implemented→retired) with working-set exclusion. Emits canonical telemetry events at gate points."
     },
     {
       "id": "knowledge.similarity-vector",
@@ -82,7 +82,7 @@
     {
       "id": "knowledge.synthesis-suite",
       "path": "evals/synthesis/suite.test.js",
-      "description": "Eval cases for synthesize: AC1 (similar source \u2192 proposal not mutation), AC2 (rejection leaves concept byte-identical), AC3 (apply updates with provenance to all contributing sources), pluggable-similarity interface test, gate telemetry."
+      "description": "Eval cases for synthesize: AC1 (similar source → proposal not mutation), AC2 (rejection leaves concept byte-identical), AC3 (apply updates with provenance to all contributing sources), pluggable-similarity interface test, gate telemetry."
     },
     {
       "id": "knowledge.consolidation-suite",
@@ -92,7 +92,7 @@
     {
       "id": "knowledge.similarity-vector-suite",
       "path": "evals/similarity-vector/suite.test.js",
-      "description": "Eval cases for the vector similarity adapter: unit tests (cosineSimilarity math, injectable embed, threshold, fail-closed), drop-in proof (runner.synthesize with injected embed produces valid proposals), and live-gated tests (real ollama nomic-embed-text round-trip \u2014 skipped when ollama unavailable)."
+      "description": "Eval cases for the vector similarity adapter: unit tests (cosineSimilarity math, injectable embed, threshold, fail-closed), drop-in proof (runner.synthesize with injected embed produces valid proposals), and live-gated tests (real ollama nomic-embed-text round-trip — skipped when ollama unavailable)."
     },
     {
       "id": "knowledge.retirement-suite",
@@ -102,7 +102,14 @@
     {
       "id": "knowledge.entity-cards-suite",
       "path": "evals/entities/suite.test.js",
-      "description": "Eval cases for person/entity cards (issue #48): AC1-AC4 \u2014 entity extraction from Attendees lines, exact-match resolution, possible-duplicate detection, merge via propose/apply/reject (union aliases+backlinks, supersede duplicate), Obsidian people/ folder rendering, and extended contract suite (person type validity) on both adapters."
+      "description": "Eval cases for person/entity cards (issue #48): AC1-AC4 — entity extraction from Attendees lines, exact-match resolution, possible-duplicate detection, merge via propose/apply/reject (union aliases+backlinks, supersede duplicate), Obsidian people/ folder rendering, and extended contract suite (person type validity) on both adapters."
+    }
+  ],
+  "skills": [
+    {
+      "id": "knowledge.knowledge-capture",
+      "path": "skills/knowledge-capture/SKILL.md",
+      "description": "Save durable knowledge, lightweight pointers, user corrections, decisions, lessons, and source references into the knowledge base."
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kontourai/flow-agents",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Flow Agents — a Kontour product that applies Flow and Veritas discipline as a portable process layer inside the agent tools you already use: Claude Code, Codex, Kiro, opencode, pi, and GitHub Actions — with framework adapters (AWS Strands preview) on the same policy-engine contract.",
   "keywords": [
     "agents",
@@ -36,7 +36,6 @@
     "flow-agents-context-map": "build/src/cli.js",
     "flow-agents-effective-backlog-settings": "build/src/cli.js",
     "flow-agents-filter-installed-packs": "build/src/cli.js",
-    "flow-agents-flow-kit": "build/src/cli.js",
     "flow-agents-fixture-retirement-audit": "build/src/cli.js",
     "flow-agents-promote-workflow-artifact": "build/src/cli.js",
     "flow-agents-publish-change": "build/src/cli.js",
@@ -49,7 +48,8 @@
     "flow-agents-validate-hook-influence": "build/src/cli.js",
     "flow-agents-validate-source": "build/src/cli.js",
     "flow-agents-workflow-artifact-cleanup-audit": "build/src/cli.js",
-    "flow-agents-workflow-sidecar": "build/src/cli/workflow-sidecar.js"
+    "flow-agents-workflow-sidecar": "build/src/cli/workflow-sidecar.js",
+    "flow-agents-kit": "build/src/cli.js"
   },
   "files": [
     ".github/",
@@ -100,7 +100,6 @@
     "validate:package": "npm run build --silent && node build/src/cli.js validate-package",
     "workflow:sidecar": "npm run build --silent && node build/src/cli/workflow-sidecar.js",
     "workflow:validate-artifacts": "npm run build --silent && node build/src/cli/validate-workflow-artifacts.js",
-    "flow-kit": "npm run build --silent && node build/src/cli.js flow-kit",
     "effective-backlog-settings": "npm run build --silent && node build/src/cli.js effective-backlog-settings",
     "pull-work-provider": "npm run build --silent && node build/src/cli.js pull-work-provider",
     "publish-change": "npm run build --silent && node build/src/cli.js publish-change",
@@ -125,11 +124,15 @@
     "promptfoo": "PROMPTFOO_CONFIG_DIR=.promptfoo PROMPTFOO_DISABLE_WAL_MODE=true PROMPTFOO_DISABLE_TELEMETRY=true promptfoo",
     "promptfoo:view": "PROMPTFOO_CONFIG_DIR=.promptfoo PROMPTFOO_DISABLE_WAL_MODE=true PROMPTFOO_DISABLE_TELEMETRY=true promptfoo view",
     "check:content-boundary": "node scripts/check-content-boundary.cjs",
-    "prepack": "npm run build --silent && npm run validate:source --"
+    "prepack": "npm run build --silent && npm run validate:source --",
+    "kit": "npm run build --silent && node build/src/cli.js kit"
   },
   "devDependencies": {
     "@types/node": "^22.19.19",
     "promptfoo": "^0.121.15",
     "typescript": "^6.0.3"
+  },
+  "dependencies": {
+    "@kontourai/flow": "^1.2.0"
   }
 }