agent-bios 0.15.0 → 0.17.0

package/compose/domains.json

@@ -10,113 +10,115 @@
     "office-work": "Office artifacts: spreadsheet processing"
   },
   "bullets": [
-    {"anchor": "Prefer concise Korean responses", "tier": "env-personal", "domains": []},
-    {"anchor": "Keep file changes within the requested scope", "tier": "core", "domains": []},
-    {"anchor": "First identify the goal, scope, ambiguities", "tier": "core", "domains": []},
-    {"anchor": "Resolve ambiguity from context when safe", "tier": "core", "domains": []},
-    {"anchor": "For simple requests, choose the most direct", "tier": "core", "domains": []},
-    {"anchor": "For non-trivial requests, compare 2-4 methods", "tier": "core", "domains": []},
-    {"anchor": "Mark one default method", "tier": "core", "domains": []},
-    {"anchor": "Execute the chosen method accurately", "tier": "core", "domains": []},
-    {"anchor": "Return to understanding if a discovery breaks", "tier": "core", "domains": []},
-    {"anchor": "Reconsider the method if the selected approach", "tier": "core", "domains": []},
-    {"anchor": "Log non-blocking discoveries and continue", "tier": "core", "domains": []},
-    {"anchor": "If the same loopback happens twice", "tier": "core", "domains": []},
-    {"anchor": "Compare the result with the selected", "tier": "core", "domains": []},
-    {"anchor": "Ask decision questions in outcome terms", "tier": "core", "domains": []},
-    {"anchor": "When the user may not know the domain", "tier": "core", "domains": []},
-    {"anchor": "Present 2-4 meaningful options", "tier": "core", "domains": []},
-    {"anchor": "For each option, state what changes", "tier": "core", "domains": []},
-    {"anchor": "Translate technical terms into plain consequences", "tier": "core", "domains": []},
-    {"anchor": "Ask for the user's goal or constraint", "tier": "core", "domains": []},
-    {"anchor": "Evaluate user suggestions for goal fit", "tier": "core", "domains": []},
-    {"anchor": "Distinguish implementation feasibility from recommendation", "tier": "core", "domains": []},
-    {"anchor": "Do not default to a restrictive lens", "tier": "core", "domains": []},
-    {"anchor": "Treat user suggestions, inherited premises, prior diagnoses", "tier": "core", "domains": []},
-    {"anchor": "For structured-output, runtime-authority, capability-surface", "tier": "domain", "domains": ["llm-pipeline-dev"]},
-    {"anchor": "Use instructions to describe intended work", "tier": "domain", "domains": ["llm-pipeline-dev"]},
-    {"anchor": "Use the LLM for semantic work", "tier": "domain", "domains": ["llm-pipeline-dev"]},
-    {"anchor": "Use the capability surface for structural constraints", "tier": "domain", "domains": ["llm-pipeline-dev"]},
-    {"anchor": "Enforce constraints through the capability surface", "tier": "domain", "domains": ["llm-pipeline-dev"]},
-    {"anchor": "Use tools/code for deterministic work", "tier": "domain", "domains": ["llm-pipeline-dev"]},
-    {"anchor": "When exactness, freshness, scale, repeatability", "tier": "domain", "domains": ["llm-pipeline-dev"]},
-    {"anchor": "Let the LLM design merge, projection", "tier": "domain", "domains": ["llm-pipeline-dev"]},
-    {"anchor": "For required structured or machine-consumed outputs", "tier": "domain", "domains": ["llm-pipeline-dev"]},
-    {"anchor": "Let tools/code own ids, paths, serialization", "tier": "domain", "domains": ["llm-pipeline-dev"]},
-    {"anchor": "Keep deterministic values out of LLM authority", "tier": "domain", "domains": ["llm-pipeline-dev"]},
-    {"anchor": "For simple stable explanations or planning", "tier": "domain", "domains": ["llm-pipeline-dev"]},
-    {"anchor": "Treat a produced field, flag, signal", "tier": "domain", "domains": ["llm-pipeline-dev"]},
-    {"anchor": "Hard-block only deterministically decidable structural", "tier": "domain", "domains": ["llm-pipeline-dev"]},
-    {"anchor": "Runtime/code may enforce the contract", "tier": "domain", "domains": ["llm-pipeline-dev"]},
-    {"anchor": "When adding, changing, renaming, splitting, or exposing anything lasting or shared", "tier": "domain", "domains": ["builder-base"]},
-    {"anchor": "Before fixing a review finding or test failure", "tier": "domain", "domains": ["builder-base"]},
-    {"anchor": "For `.xlsx` editing, generation, reconciliation", "tier": "domain", "domains": ["office-work"]},
-    {"anchor": "For development work, read and use", "tier": "domain", "domains": ["builder-base"]},
-    {"anchor": "For mock, fixture, fake, stub, simulated-provider", "tier": "domain", "domains": ["builder-base"]},
-    {"anchor": "Own the full lifecycle of what you create", "tier": "domain", "domains": ["builder-base"]},
-    {"anchor": "Land risky or behavior-changing work behind", "tier": "domain", "domains": ["builder-base"]},
-    {"anchor": "For composing a review request, packet", "tier": "domain", "domains": ["builder-base"]},
-    {"anchor": "After every meaningful code, ontology, config", "tier": "domain", "domains": ["builder-base"]},
-    {"anchor": "For choosing verification depth, the per-domain mix, the case space, what makes a completion criterion falsifiable", "tier": "domain", "domains": ["builder-base"]},
-    {"anchor": "Report the checks run, results", "tier": "core", "domains": []},
-    {"anchor": "Trust a green check only when it traversed", "tier": "domain", "domains": ["builder-base"]},
-    {"anchor": "Before comparing two of anything", "tier": "domain", "domains": ["builder-base"]},
-    {"anchor": "For concrete shell/CLI traps", "tier": "domain", "domains": ["builder-base"]},
-    {"anchor": "Ambient state — the active shell", "tier": "domain", "domains": ["builder-base"]},
-    {"anchor": "Before relying on any model id", "tier": "domain", "domains": ["builder-base"]},
-    {"anchor": "Scope destructive actions (kill, rm, force-push", "tier": "domain", "domains": ["builder-base"]},
-    {"anchor": "Never accept secrets through transcript- or history-logged channels", "tier": "core", "domains": []},
-    {"anchor": "When a secret must be supplied", "tier": "domain", "domains": ["builder-base"]},
-    {"anchor": "Treat a coarse runtime signal", "tier": "domain", "domains": ["builder-base"]},
-    {"anchor": "Standing spawn policy: check the spawn gates", "tier": "domain", "domains": ["multi-agent-orchestration"]},
-    {"anchor": "Down-spawns carry a machine-checkable done-when", "tier": "domain", "domains": ["multi-agent-orchestration"]},
-    {"anchor": "For work spanning multiple models or CLI agents", "tier": "domain", "domains": ["multi-agent-orchestration"]},
-    {"anchor": "For composing a prompt, packet, or tool description", "tier": "domain", "domains": ["multi-agent-orchestration"]},
-    {"anchor": "Allocate models by difficulty", "tier": "domain", "domains": ["multi-agent-orchestration"]},
-    {"anchor": "Judge a review by how much independence", "tier": "domain", "domains": ["multi-agent-orchestration"]},
-    {"anchor": "dual-provider frontier design drafts", "tier": "domain", "domains": ["multi-agent-orchestration"]},
-    {"anchor": "Never retry-storm a live rate limit", "tier": "domain", "domains": ["multi-agent-orchestration"]},
-    {"anchor": "On any resumed, cleared, or relocated session", "tier": "domain", "domains": ["multi-agent-orchestration"]},
-    {"anchor": "Keep runtime code, active docs, and execution-facing", "tier": "domain", "domains": ["builder-base"]},
-    {"anchor": "For where a comment, a compatibility note, deprecated behavior, a rejected alternative", "tier": "domain", "domains": ["builder-base"]},
-    {"anchor": "For SVG diagrams, service blueprints", "tier": "domain", "domains": ["visualization-docs"]},
-    {"anchor": "When a concept is easier to understand visually", "tier": "domain", "domains": ["visualization-docs"]},
-    {"anchor": "Use HTML for comparisons, flows, state changes", "tier": "domain", "domains": ["visualization-docs"]},
-    {"anchor": "Keep HTML self-contained, accessible, and minimal", "tier": "domain", "domains": ["visualization-docs"]},
-    {"anchor": "Use plain text when it is clearer", "tier": "domain", "domains": ["visualization-docs"]},
-    {"anchor": "For the detailed `IMPLEMENTATION_MAP.html` construction rules", "tier": "domain", "domains": ["visualization-docs"]},
-    {"anchor": "In repos with implementation code", "tier": "domain", "domains": ["visualization-docs"]},
-    {"anchor": "`learn!` — session learning", "tier": "core", "domains": []}
+    {"anchor": "Prefer concise Korean responses", "tier": "env-personal", "domains": [], "item_id": "rule-001"},
+    {"anchor": "Keep file changes within the requested scope", "tier": "core", "domains": [], "item_id": "rule-002"},
+    {"anchor": "First identify the goal, scope, ambiguities", "tier": "core", "domains": [], "item_id": "rule-003"},
+    {"anchor": "Resolve ambiguity from context when safe", "tier": "core", "domains": [], "item_id": "rule-004"},
+    {"anchor": "For simple requests, choose the most direct", "tier": "core", "domains": [], "item_id": "rule-005"},
+    {"anchor": "For non-trivial requests, compare 2-4 methods", "tier": "core", "domains": [], "item_id": "rule-006"},
+    {"anchor": "Mark one default method", "tier": "core", "domains": [], "item_id": "rule-007"},
+    {"anchor": "Execute the chosen method accurately", "tier": "core", "domains": [], "item_id": "rule-008"},
+    {"anchor": "Return to understanding if a discovery breaks", "tier": "core", "domains": [], "item_id": "rule-009"},
+    {"anchor": "Reconsider the method if the selected approach", "tier": "core", "domains": [], "item_id": "rule-010"},
+    {"anchor": "Log non-blocking discoveries and continue", "tier": "core", "domains": [], "item_id": "rule-011"},
+    {"anchor": "If the same loopback happens twice", "tier": "core", "domains": [], "item_id": "rule-012"},
+    {"anchor": "Compare the result with the selected", "tier": "core", "domains": [], "item_id": "rule-013"},
+    {"anchor": "Ask decision questions in outcome terms", "tier": "core", "domains": [], "item_id": "rule-014"},
+    {"anchor": "When the user may not know the domain", "tier": "core", "domains": [], "item_id": "rule-015"},
+    {"anchor": "Present 2-4 meaningful options", "tier": "core", "domains": [], "item_id": "rule-016"},
+    {"anchor": "For each option, state what changes", "tier": "core", "domains": [], "item_id": "rule-017"},
+    {"anchor": "Translate technical terms into plain consequences", "tier": "core", "domains": [], "item_id": "rule-018"},
+    {"anchor": "Ask for the user's goal or constraint", "tier": "core", "domains": [], "item_id": "rule-019"},
+    {"anchor": "Evaluate user suggestions for goal fit", "tier": "core", "domains": [], "item_id": "rule-020"},
+    {"anchor": "Distinguish implementation feasibility from recommendation", "tier": "core", "domains": [], "item_id": "rule-021"},
+    {"anchor": "Do not default to a restrictive lens", "tier": "core", "domains": [], "item_id": "rule-022"},
+    {"anchor": "Treat user suggestions, inherited premises, prior diagnoses", "tier": "core", "domains": [], "item_id": "rule-023"},
+    {"anchor": "For structured-output, runtime-authority, capability-surface", "tier": "domain", "domains": ["llm-pipeline-dev"], "item_id": "rule-024"},
+    {"anchor": "Use instructions to describe intended work", "tier": "domain", "domains": ["llm-pipeline-dev"], "item_id": "rule-025"},
+    {"anchor": "Use the LLM for semantic work", "tier": "domain", "domains": ["llm-pipeline-dev"], "item_id": "rule-026"},
+    {"anchor": "Use the capability surface for structural constraints", "tier": "domain", "domains": ["llm-pipeline-dev"], "item_id": "rule-027"},
+    {"anchor": "Enforce constraints through the capability surface", "tier": "domain", "domains": ["llm-pipeline-dev"], "item_id": "rule-028"},
+    {"anchor": "Use tools/code for deterministic work", "tier": "domain", "domains": ["llm-pipeline-dev"], "item_id": "rule-029"},
+    {"anchor": "When exactness, freshness, scale, repeatability", "tier": "domain", "domains": ["llm-pipeline-dev"], "item_id": "rule-030"},
+    {"anchor": "Let the LLM design merge, projection", "tier": "domain", "domains": ["llm-pipeline-dev"], "item_id": "rule-031"},
+    {"anchor": "For required structured or machine-consumed outputs", "tier": "domain", "domains": ["llm-pipeline-dev"], "item_id": "rule-032"},
+    {"anchor": "Let tools/code own ids, paths, serialization", "tier": "domain", "domains": ["llm-pipeline-dev"], "item_id": "rule-033"},
+    {"anchor": "Keep deterministic values out of LLM authority", "tier": "domain", "domains": ["llm-pipeline-dev"], "item_id": "rule-034"},
+    {"anchor": "For simple stable explanations or planning", "tier": "domain", "domains": ["llm-pipeline-dev"], "item_id": "rule-035"},
+    {"anchor": "Treat a produced field, flag, signal", "tier": "domain", "domains": ["llm-pipeline-dev"], "item_id": "rule-036"},
+    {"anchor": "Hard-block only deterministically decidable structural", "tier": "domain", "domains": ["llm-pipeline-dev"], "item_id": "rule-037"},
+    {"anchor": "Runtime/code may enforce the contract", "tier": "domain", "domains": ["llm-pipeline-dev"], "item_id": "rule-038"},
+    {"anchor": "When adding, changing, renaming, splitting, or exposing anything lasting or shared", "tier": "domain", "domains": ["builder-base"], "item_id": "rule-039"},
+    {"anchor": "Before fixing a review finding or test failure", "tier": "domain", "domains": ["builder-base"], "item_id": "rule-040"},
+    {"anchor": "For `.xlsx` editing, generation, reconciliation", "tier": "domain", "domains": ["office-work"], "item_id": "rule-041"},
+    {"anchor": "For development work, read and use", "tier": "domain", "domains": ["builder-base"], "item_id": "rule-042"},
+    {"anchor": "For mock, fixture, fake, stub, simulated-provider", "tier": "domain", "domains": ["builder-base"], "item_id": "rule-043"},
+    {"anchor": "Own the full lifecycle of what you create", "tier": "domain", "domains": ["builder-base"], "item_id": "rule-044"},
+    {"anchor": "Land risky or behavior-changing work behind", "tier": "domain", "domains": ["builder-base"], "item_id": "rule-045"},
+    {"anchor": "For composing a review request, packet", "tier": "domain", "domains": ["builder-base"], "item_id": "rule-046"},
+    {"anchor": "After every meaningful code, ontology, config", "tier": "domain", "domains": ["builder-base"], "item_id": "rule-047"},
+    {"anchor": "For choosing verification depth, the per-domain mix, the case space, what makes a completion criterion falsifiable", "tier": "domain", "domains": ["builder-base"], "item_id": "rule-048"},
+    {"anchor": "Report the checks run, results", "tier": "core", "domains": [], "item_id": "rule-049"},
+    {"anchor": "Trust a green check only when it traversed", "tier": "domain", "domains": ["builder-base"], "item_id": "rule-050"},
+    {"anchor": "Before comparing two of anything", "tier": "domain", "domains": ["builder-base"], "item_id": "rule-051"},
+    {"anchor": "For concrete shell/CLI traps", "tier": "domain", "domains": ["builder-base"], "item_id": "rule-052"},
+    {"anchor": "Ambient state — the active shell", "tier": "domain", "domains": ["builder-base"], "item_id": "rule-053"},
+    {"anchor": "Before relying on any model id", "tier": "domain", "domains": ["builder-base"], "item_id": "rule-054"},
+    {"anchor": "Scope destructive actions (kill, rm, force-push", "tier": "domain", "domains": ["builder-base"], "item_id": "rule-055"},
+    {"anchor": "Never accept secrets through transcript- or history-logged channels", "tier": "core", "domains": [], "item_id": "rule-056"},
+    {"anchor": "When a secret must be supplied", "tier": "domain", "domains": ["builder-base"], "item_id": "rule-057"},
+    {"anchor": "Treat a coarse runtime signal", "tier": "domain", "domains": ["builder-base"], "item_id": "rule-058"},
+    {"anchor": "Standing spawn policy: check the spawn gates", "tier": "domain", "domains": ["multi-agent-orchestration"], "item_id": "rule-059"},
+    {"anchor": "Down-spawns carry a machine-checkable done-when", "tier": "domain", "domains": ["multi-agent-orchestration"], "item_id": "rule-060"},
+    {"anchor": "For work spanning multiple models or CLI agents", "tier": "domain", "domains": ["multi-agent-orchestration"], "item_id": "rule-061"},
+    {"anchor": "For composing a prompt, packet, or tool description", "tier": "domain", "domains": ["multi-agent-orchestration"], "item_id": "rule-062"},
+    {"anchor": "Allocate models by difficulty", "tier": "domain", "domains": ["multi-agent-orchestration"], "item_id": "rule-063"},
+    {"anchor": "Judge a review by how much independence", "tier": "domain", "domains": ["multi-agent-orchestration"], "item_id": "rule-064"},
+    {"anchor": "dual-provider frontier design drafts", "tier": "domain", "domains": ["multi-agent-orchestration"], "item_id": "rule-065"},
+    {"anchor": "Never retry-storm a live rate limit", "tier": "domain", "domains": ["multi-agent-orchestration"], "item_id": "rule-066"},
+    {"anchor": "On any resumed, cleared, or relocated session", "tier": "domain", "domains": ["multi-agent-orchestration"], "item_id": "rule-067"},
+    {"anchor": "Keep runtime code, active docs, and execution-facing", "tier": "domain", "domains": ["builder-base"], "item_id": "rule-068"},
+    {"anchor": "For where a comment, a compatibility note, deprecated behavior, a rejected alternative", "tier": "domain", "domains": ["builder-base"], "item_id": "rule-069"},
+    {"anchor": "For SVG diagrams, service blueprints", "tier": "domain", "domains": ["visualization-docs"], "item_id": "rule-070"},
+    {"anchor": "When a concept is easier to understand visually", "tier": "domain", "domains": ["visualization-docs"], "item_id": "rule-071"},
+    {"anchor": "Use HTML for comparisons, flows, state changes", "tier": "domain", "domains": ["visualization-docs"], "item_id": "rule-072"},
+    {"anchor": "Keep HTML self-contained, accessible, and minimal", "tier": "domain", "domains": ["visualization-docs"], "item_id": "rule-073"},
+    {"anchor": "Use plain text when it is clearer", "tier": "domain", "domains": ["visualization-docs"], "item_id": "rule-074"},
+    {"anchor": "For the detailed `IMPLEMENTATION_MAP.html` construction rules", "tier": "domain", "domains": ["visualization-docs"], "item_id": "rule-075"},
+    {"anchor": "In repos with implementation code", "tier": "domain", "domains": ["visualization-docs"], "item_id": "rule-076"},
+    {"anchor": "`learn!` — session learning", "tier": "core", "domains": [], "item_id": "rule-077"}
   ],
   "guides": {
-    "claude-prompting.md": {"tier": "domain", "domains": ["multi-agent-orchestration"], "handles": ["per-family prompting guide", "계열별 prompting guide"]},
-    "cli-multi-model-workflow.md": {"tier": "domain", "domains": ["multi-agent-orchestration"], "handles": ["multi-model guide", "multi-model 가이드"]},
-    "coding-staged-workflow.md": {"tier": "domain", "domains": ["builder-base"]},
-    "concept-economy.md": {"tier": "domain", "domains": ["builder-base"]},
-    "documentation-hygiene.md": {"tier": "domain", "domains": ["builder-base"]},
-    "gpt-prompting.md": {"tier": "domain", "domains": ["multi-agent-orchestration"], "handles": ["prompting guides for gpt-family"]},
-    "implementation-map.md": {"tier": "domain", "domains": ["visualization-docs"]},
-    "llm-capability-boundary-examples.md": {"tier": "domain", "domains": ["llm-pipeline-dev"]},
-    "llm-capability-boundary-patterns.md": {"tier": "domain", "domains": ["llm-pipeline-dev"]},
-    "llm-capability-boundary.md": {"tier": "domain", "domains": ["llm-pipeline-dev"]},
-    "mock-realization-boundary.md": {"tier": "domain", "domains": ["builder-base"]},
-    "review-defect-criteria.md": {"tier": "domain", "domains": ["builder-base"]},
-    "review-request.md": {"tier": "domain", "domains": ["builder-base"]},
-    "session-distill-workflow.md": {"tier": "infra", "domains": []},
-    "learning-flow.md": {"tier": "infra", "domains": []},
-    "svg-visualization-guide.md": {"tier": "domain", "domains": ["visualization-docs"]},
-    "verification-discipline.md": {"tier": "domain", "domains": ["builder-base"]},
-    "tooling-gotchas.md": {"tier": "domain", "domains": ["builder-base"]}
+    "claude-prompting.md": {"tier": "domain", "domains": ["multi-agent-orchestration"], "handles": ["per-family prompting guide", "계열별 prompting guide"], "item_id": "guide-claude-prompting"},
+    "cli-multi-model-workflow.md": {"tier": "domain", "domains": ["multi-agent-orchestration"], "handles": ["multi-model guide", "multi-model 가이드"], "item_id": "guide-cli-multi-model-workflow"},
+    "coding-staged-workflow.md": {"tier": "domain", "domains": ["builder-base"], "item_id": "guide-coding-staged-workflow"},
+    "concept-economy.md": {"tier": "domain", "domains": ["builder-base"], "item_id": "guide-concept-economy"},
+    "documentation-hygiene.md": {"tier": "domain", "domains": ["builder-base"], "item_id": "guide-documentation-hygiene"},
+    "gpt-prompting.md": {"tier": "domain", "domains": ["multi-agent-orchestration"], "handles": ["prompting guides for gpt-family"], "item_id": "guide-gpt-prompting"},
+    "implementation-map.md": {"tier": "domain", "domains": ["visualization-docs"], "item_id": "guide-implementation-map"},
+    "llm-capability-boundary-examples.md": {"tier": "domain", "domains": ["llm-pipeline-dev"], "item_id": "guide-llm-capability-boundary-examples"},
+    "llm-capability-boundary-patterns.md": {"tier": "domain", "domains": ["llm-pipeline-dev"], "item_id": "guide-llm-capability-boundary-patterns"},
+    "llm-capability-boundary.md": {"tier": "domain", "domains": ["llm-pipeline-dev"], "item_id": "guide-llm-capability-boundary"},
+    "mock-realization-boundary.md": {"tier": "domain", "domains": ["builder-base"], "item_id": "guide-mock-realization-boundary"},
+    "review-defect-criteria.md": {"tier": "domain", "domains": ["builder-base"], "item_id": "guide-review-defect-criteria"},
+    "review-request.md": {"tier": "domain", "domains": ["builder-base"], "item_id": "guide-review-request"},
+    "session-distill-workflow.md": {"tier": "infra", "domains": [], "item_id": "guide-session-distill-workflow"},
+    "learning-flow.md": {"tier": "infra", "domains": [], "item_id": "guide-learning-flow"},
+    "svg-visualization-guide.md": {"tier": "domain", "domains": ["visualization-docs"], "item_id": "guide-svg-visualization-guide"},
+    "slide-writing.md": {"tier": "domain", "domains": ["office-work", "visualization-docs"], "item_id": "skill-slide-writing"},
+    "verification-discipline.md": {"tier": "domain", "domains": ["builder-base"], "item_id": "guide-verification-discipline"},
+    "tooling-gotchas.md": {"tier": "domain", "domains": ["builder-base"], "item_id": "guide-tooling-gotchas"}
   },
   "hooks": {
-    "tooling-gotchas-hook.py": {"tier": "domain", "domains": ["builder-base"], "source_guide": "tooling-gotchas.md"}
+    "tooling-gotchas-hook.py": {"tier": "domain", "domains": ["builder-base"], "source_guide": "tooling-gotchas.md", "item_id": "hook-tooling-gotchas-hook"}
   },
   "agents": {
-    "frontier.md": {"tier": "domain", "domains": ["multi-agent-orchestration"]},
-    "sweep.md": {"tier": "domain", "domains": ["multi-agent-orchestration"]},
-    "workhorse.md": {"tier": "domain", "domains": ["multi-agent-orchestration"]}
+    "frontier.md": {"tier": "domain", "domains": ["multi-agent-orchestration"], "item_id": "agent-frontier"},
+    "sweep.md": {"tier": "domain", "domains": ["multi-agent-orchestration"], "item_id": "agent-sweep"},
+    "workhorse.md": {"tier": "domain", "domains": ["multi-agent-orchestration"], "item_id": "agent-workhorse"}
   },
   "skills": {
-    "repo-charter": {"tier": "domain", "domains": ["builder-base"]}
+    "understand": {"tier": "core", "domains": [], "item_id": "skill-understand"},
+    "repo-charter": {"tier": "domain", "domains": ["builder-base"], "item_id": "skill-repo-charter"}
   }
 }

package/compose/register-hooks.py

@@ -1,15 +1,13 @@
 #!/usr/bin/env python3
-"""Register the manifest's hooks in a deployed settings.json (full-install path).
+"""Legacy utility: merge canonical hook registrations into Claude settings.
 
-The packaged path gets this for free: assemble.py composes the corpus and calls
-merge_settings on the way out. A full install never runs the assembler, so the
-hook files were deployed and nothing ever registered them — they sat on disk and
-never fired. This runs the assembler's own merge so both paths register
-identically, under the same name-based ownership rule.
+The private installer registers no global host hooks. Explicit native session
+activation is shared by Claude and Codex through corpus_catalog/corpus_session.
+This compatibility utility retains the legacy Claude settings.json ownership
+and merge behavior by calling the assembler's merge_settings implementation.
 
 Usage: register-hooks.py <repo> <claude-dir>
-Exit 0 on success; non-zero (with a message) if the merge could not run, which
-the installer reports as a note rather than failing the whole install.
+Exit 0 on success; non-zero with a message if the legacy merge cannot run.
 """
 import importlib.util
 import json

package/install.sh

@@ -389,7 +389,37 @@ assemble_corpus() {
     if [ -f "$CLAUDE_DIR/central/bundle.md" ]; then
       printf '%s\n' "$CLAUDE_DIR/central/bundle.md" >> "$MANIFEST"
     fi
-    for sub in guides hooks agents; do
+    # A guide can carry a same-stem companion tree.  The assembler owns that structure, so
+    # manifest it through its resolver rather than flattening `guides/*.md`: uninstall needs
+    # every deployed script/asset by its exact path, and must not claim a user-created sibling
+    # merely because it sits below one of our guide directories.
+    local source_guides="$REPO/claude/guides" codex_guides="$REPO/codex/guides"
+    manifest_guide_members() {
+      # Pin the installed resolver file independently of the selected content tree.
+      python3 - "$REPO/compose/assemble.py" "$1" "$2" <<'PY'
+import pathlib
+import sys
+
+assembler, source, dest = map(pathlib.Path, sys.argv[1:])
+sys.path.insert(0, str(assembler.parent))
+from assemble import GuideMemberError, guide_member_map
+
+try:
+    members = guide_member_map(source)
+except GuideMemberError as exc:
+    raise SystemExit(f"invalid guide bundle source: {exc}")
+for paths in members.values():
+    for rel in paths:
+        target = dest / rel
+        if target.is_file():
+            print(target)
+PY
+    }
+    if ! manifest_guide_members "$source_guides" "$CLAUDE_DIR/central/guides" >> "$MANIFEST"; then
+      log "could not enumerate assembled Claude guide members for the manifest"
+      return 1
+    fi
+    for sub in hooks agents; do
       for s in "$REPO"/claude/"$sub"/*; do
         [ -f "$s" ] || continue
         dst="$CLAUDE_DIR/central/$sub/$(basename "$s")"
@@ -398,16 +428,10 @@ assemble_corpus() {
         if [ -f "$dst" ]; then printf '%s\n' "$dst" >> "$MANIFEST"; fi
       done
     done
-    for g in "$REPO"/codex/guides/*.md; do
-      [ -f "$g" ] || continue
-      dst="$CODEX_DIR/guides/$(basename "$g")"
-      # if-form, not `[ -f ] && printf`: when the alphabetically LAST guide is
-      # not deployed (a partial domain selection on a fresh machine), the
-      # compound's false status became the loop's, the loop's became the
-      # function's, and the install died silently right after ASSEMBLED —
-      # a latent first-user bug the I9 scenario exposed.
-      if [ -f "$dst" ]; then printf '%s\n' "$dst" >> "$MANIFEST"; fi
-    done
+    if ! manifest_guide_members "$codex_guides" "$CODEX_DIR/guides" >> "$MANIFEST"; then
+      log "could not enumerate assembled Codex guide members for the manifest"
+      return 1
+    fi
   fi
   return 0
 }
@@ -1718,7 +1742,11 @@ cmd_update() {
   if [ -e "$REPO/.git" ]; then
     log "Updating from git..."
     run git -C "$REPO" pull --ff-only
-    cmd_install
+    if [ "${AGENT_BIOS_LEGACY_INSTALL:-0}" = 1 ]; then
+      cmd_install
+    else
+      python3 "$REPO/compose/corpus_install.py" --repo "$REPO" install
+    fi
   else
     log "Installed as an npm package. Update with:"
     log "  npm install -g agent-bios@latest && agent-bios install"
@@ -1730,11 +1758,18 @@ cmd_update() {
 
 usage() {
   cat <<'EOF'
-agent-bios — deploy the Claude/Codex instruction SSOT into $HOME (by copy).
-
-  agent-bios install     deploy into this environment (backs up + verifies)
-  agent-bios onboard     interactive domain selection + install + activation canary
-  agent-bios verify      check the deployed state matches the source
+agent-bios — manage private corpus content for explicitly activated sessions.
+
+  agent-bios install     store a private runtime and corpus baseline
+  agent-bios onboard     select domains for future activated sessions
+  agent-bios corpus      open Corpus Studio; list/show/plan/apply also work non-TTY
+  agent-bios understand  list corpus learning bundles; --help shows session/discovery commands
+  agent-bios shell       show the optional zsh connection status
+  agent-bios shell restore   make bare claude/codex open the launcher TUI
+  agent-bios shell remove    return bare claude/codex to their native CLI
+  agent-bios migrate     preview legacy global cleanup; --apply --yes applies it
+  agent-bios reset       preview reset; --apply --yes --expected-revision REV applies it
+  agent-bios verify      verify the private runtime, baseline, and managed files
   agent-bios learn       submit a session learning (reads the JSON record on
                          stdin; this is what the learn! flow calls, and it
                          works from any directory, unlike a repo-relative path)
@@ -1745,9 +1780,20 @@ agent-bios — deploy the Claude/Codex instruction SSOT into $HOME (by copy).
   agent-bios update --check   ask the registry for the latest version and cache it
                       for the launcher's badge; sends the package name and nothing
                       else, runs at most daily, AGENT_BIOS_UPDATE_CHECK=0 disables it
-  agent-bios uninstall   remove deployed files and the zsh hook
+  agent-bios uninstall   remove the private runtime; preserve personal and session data
   agent-bios help
 
+Launcher (run in an interactive terminal):
+  agent-launch claude    open the Claude launch TUI
+  agent-launch codex     open the Codex launch TUI
+  agent-launch --corpus  open Corpus Studio directly
+  agent-launch --understand BUNDLE claude   start a corpus understanding session
+  agent-launch --preset balanced claude   launch with a named preset
+
+Shell connection is opt-in and changes only zsh startup wiring, not global
+AGENTS.md/CLAUDE.md. Restore/remove it from the TUI's Shell connection menu or
+the commands above. After restoring, open a new terminal or reload .zshrc.
+
 Flags: --dry-run       print actions without changing anything
        --domains a,b  assemble ONLY the named domain packages (plus core+infra);
                       with onboard, 'none' means core+infra only. The selection
@@ -1783,6 +1829,26 @@ EOF
 CMD="${1:-help}"
 if [ $# -gt 0 ]; then shift; fi
 
+# Private installation is the new user path. The explicit legacy flag exists only
+# while maintained install fixtures and pre-migration environments exercise the old
+# writer. No private operation falls through to a global writer.
+if [ "$CMD" = "corpus" ]; then
+  exec python3 "$REPO/compose/corpus.py" --repo "$REPO" "$@" <&3
+fi
+if [ "$CMD" = "shell" ]; then
+  exec python3 "$REPO/launch/shell_integration.py" "$@" <&3
+fi
+if [ "$CMD" = "understand" ]; then
+  exec python3 "$REPO/compose/corpus_understand.py" --repo "$REPO" "$@" <&3
+fi
+if [ "${AGENT_BIOS_LEGACY_INSTALL:-0}" != 1 ]; then
+  case "$CMD" in
+    install|onboard|verify|status|uninstall|migrate|reset)
+      exec python3 "$REPO/compose/corpus_install.py" --repo "$REPO" "$CMD" "$@" <&3
+      ;;
+  esac
+fi
+
 # `learn` forwards its arguments and stdin straight to the collector, so it must
 # bypass the flag parser below (which rejects anything it does not know). This
 # subcommand is the only PATH-reachable entry to capture: the corpus guide used