@gannonh/kata 1.0.3 → 1.0.4

package/agents/kata-executor.md

@@ -5,17 +5,6 @@ tools: Read, Write, Edit, Bash, Grep, Glob
 color: yellow
 ---
 
-<kata_path>
-**IMPORTANT:** Before reading any Kata file (templates, references, workflows), resolve the base path:
-
-```bash
-KATA_BASE=$(if [ -n "$CLAUDE_PLUGIN_ROOT" ]; then echo "$CLAUDE_PLUGIN_ROOT/kata"; elif [ -d ~/.claude/kata ]; then echo ~/.claude/kata; else echo ./.claude/kata; fi) && echo $KATA_BASE
-```
-
-Use the output as `$KATA_BASE` for all file paths below. For example:
-- `$KATA_BASE/templates/summary.md` instead of `~/.claude/kata/templates/summary.md`
-</kata_path>
-
 <role>
 You are a Kata plan executor. You execute PLAN.md files atomically, creating per-task commits, handling deviations automatically, pausing at checkpoints, and producing SUMMARY.md files.
 
@@ -364,7 +353,7 @@ Type "done" when authenticated.
 Before any `checkpoint:human-verify`, ensure verification environment is ready. If plan lacks server startup task before checkpoint, ADD ONE (deviation Rule 3).
 
 For full automation-first patterns, server lifecycle, CLI handling, and error recovery:
-**See @$KATA_BASE/references/checkpoints.md**
+**See @~/.claude/kata/references/checkpoints.md**
 
 **Quick reference:**
 - Users NEVER run CLI commands - Claude does all automation
@@ -621,7 +610,7 @@ After all tasks complete, create `{phase}-{plan}-SUMMARY.md`.
 
 **Location:** `.planning/phases/XX-name/{phase}-{plan}-SUMMARY.md`
 
-**Use template from:** @$KATA_BASE/templates/summary.md
+**Use template from:** @~/.claude/kata/templates/summary.md
 
 **Frontmatter population:**
 

package/agents/kata-planner.md

@@ -5,17 +5,6 @@ tools: Read, Write, Bash, Glob, Grep, WebFetch, mcp__context7__*
 color: green
 ---
 
-<kata_path>
-**IMPORTANT:** Before reading any Kata file (templates, references, workflows), resolve the base path:
-
-```bash
-KATA_BASE=$(if [ -n "$CLAUDE_PLUGIN_ROOT" ]; then echo "$CLAUDE_PLUGIN_ROOT/kata"; elif [ -d ~/.claude/kata ]; then echo ~/.claude/kata; else echo ./.claude/kata; fi) && echo $KATA_BASE
-```
-
-Use the output as `$KATA_BASE` for all file paths below. For example:
-- `$KATA_BASE/templates/summary.md` instead of `~/.claude/kata/templates/summary.md`
-</kata_path>
-
 <role>
 You are a Kata planner. You create executable phase plans with task breakdown, dependency analysis, and goal-backward verification.
 
@@ -418,8 +407,8 @@ Output: [What artifacts will be created]
 </objective>
 
 <execution_context>
-@$KATA_BASE/workflows/execute-plan.md
-@$KATA_BASE/templates/summary.md
+@~/.claude/kata/workflows/execute-plan.md
+@~/.claude/kata/templates/summary.md
 </execution_context>
 
 <context>

package/agents/kata-research-synthesizer.md

@@ -5,17 +5,6 @@ tools: Read, Write, Bash
 color: purple
 ---
 
-<kata_path>
-**IMPORTANT:** Before reading any Kata file (templates, references, workflows), resolve the base path:
-
-```bash
-KATA_BASE=$(if [ -n "$CLAUDE_PLUGIN_ROOT" ]; then echo "$CLAUDE_PLUGIN_ROOT/kata"; elif [ -d ~/.claude/kata ]; then echo ~/.claude/kata; else echo ./.claude/kata; fi) && echo $KATA_BASE
-```
-
-Use the output as `$KATA_BASE` for all file paths below. For example:
-- `$KATA_BASE/templates/summary.md` instead of `~/.claude/kata/templates/summary.md`
-</kata_path>
-
 <role>
 You are a Kata research synthesizer. You read the outputs from 4 parallel researcher agents and synthesize them into a cohesive SUMMARY.md.
 

package/agents/kata-roadmapper.md

@@ -5,17 +5,6 @@ tools: Read, Write, Bash, Glob, Grep
 color: purple
 ---
 
-<kata_path>
-**IMPORTANT:** Before reading any Kata file (templates, references, workflows), resolve the base path:
-
-```bash
-KATA_BASE=$(if [ -n "$CLAUDE_PLUGIN_ROOT" ]; then echo "$CLAUDE_PLUGIN_ROOT/kata"; elif [ -d ~/.claude/kata ]; then echo ~/.claude/kata; else echo ./.claude/kata; fi) && echo $KATA_BASE
-```
-
-Use the output as `$KATA_BASE` for all file paths below. For example:
-- `$KATA_BASE/templates/summary.md` instead of `~/.claude/kata/templates/summary.md`
-</kata_path>
-
 <role>
 You are a Kata roadmapper. You create project roadmaps that map requirements to phases with goal-backward success criteria.
 

package/kata/VERSION

@@ -1 +1 @@
-1.0.3
+1.0.4

package/kata/templates/codebase/structure.md

@@ -216,7 +216,7 @@ kata/
 
 **New Workflow:**
 - Implementation: `kata/workflows/{name}.md`
-- Usage: Reference from command with `@$KATA_BASE/workflows/{name}.md`
+- Usage: Reference from command with `@~/.claude/kata/workflows/{name}.md`
 
 **New Reference Document:**
 - Implementation: `kata/references/{name}.md`

package/kata/templates/phase-prompt.md

@@ -1,16 +1,5 @@
 # Phase Prompt Template
 
-<kata_path>
-**IMPORTANT:** Before reading any Kata file (templates, references, workflows), resolve the base path:
-
-```bash
-KATA_BASE=$(if [ -n "$CLAUDE_PLUGIN_ROOT" ]; then echo "$CLAUDE_PLUGIN_ROOT/kata"; elif [ -d ~/.claude/kata ]; then echo ~/.claude/kata; else echo ./.claude/kata; fi) && echo $KATA_BASE
-```
-
-Use the output as `$KATA_BASE` for all file paths below. For example:
-- `$KATA_BASE/templates/summary.md` instead of `~/.claude/kata/templates/summary.md`
-</kata_path>
-
 > **Note:** Planning methodology is in `agents/kata-planner.md`.
 > This template defines the PLAN.md output format that the agent produces.
 
@@ -48,10 +37,10 @@ Output: [What artifacts will be created]
 </objective>
 
 <execution_context>
-@$KATA_BASE/workflows/execute-plan.md
-@$KATA_BASE/templates/summary.md
+@~/.claude/kata/workflows/execute-plan.md
+@~/.claude/kata/templates/summary.md
 [If plan contains checkpoint tasks (type="checkpoint:*"), add:]
-@$KATA_BASE/references/checkpoints.md
+@~/.claude/kata/references/checkpoints.md
 </execution_context>
 
 <context>
@@ -86,7 +75,7 @@ Output: [What artifacts will be created]
   <done>[Acceptance criteria]</done>
 </task>
 
-<!-- For checkpoint task examples and patterns, see @$KATA_BASE/references/checkpoints.md -->
+<!-- For checkpoint task examples and patterns, see @~/.claude/kata/references/checkpoints.md -->
 <!-- Key rule: Claude starts dev server BEFORE human-verify checkpoints. User only visits URLs. -->
 
 <task type="checkpoint:decision" gate="blocking">
@@ -383,9 +372,9 @@ Output: Working dashboard component.
 </objective>
 
 <execution_context>
-@$KATA_BASE/workflows/execute-plan.md
-@$KATA_BASE/templates/summary.md
-@$KATA_BASE/references/checkpoints.md
+@~/.claude/kata/workflows/execute-plan.md
+@~/.claude/kata/templates/summary.md
+@~/.claude/kata/references/checkpoints.md
 </execution_context>
 
 <context>

package/kata/workflows/discovery-phase.md

@@ -1,14 +1,3 @@
-<kata_path>
-**IMPORTANT:** Before reading any Kata file (templates, references, workflows), resolve the base path:
-
-```bash
-KATA_BASE=$(if [ -n "$CLAUDE_PLUGIN_ROOT" ]; then echo "$CLAUDE_PLUGIN_ROOT/kata"; elif [ -d ~/.claude/kata ]; then echo ~/.claude/kata; else echo ./.claude/kata; fi) && echo $KATA_BASE
-```
-
-Use the output as `$KATA_BASE` for all file paths below. For example:
-- `$KATA_BASE/templates/summary.md` instead of `~/.claude/kata/templates/summary.md`
-</kata_path>
-
 <purpose>
 Execute discovery at the appropriate depth level.
 Produces DISCOVERY.md (for Level 2-3) that informs PLAN.md creation.

package/kata/workflows/execute-plan.md

@@ -1,14 +1,3 @@
-<kata_path>
-**IMPORTANT:** Before reading any Kata file (templates, references, workflows), resolve the base path:
-
-```bash
-KATA_BASE=$(if [ -n "$CLAUDE_PLUGIN_ROOT" ]; then echo "$CLAUDE_PLUGIN_ROOT/kata"; elif [ -d ~/.claude/kata ]; then echo ~/.claude/kata; else echo ./.claude/kata; fi) && echo $KATA_BASE
-```
-
-Use the output as `$KATA_BASE` for all file paths below. For example:
-- `$KATA_BASE/templates/summary.md` instead of `~/.claude/kata/templates/summary.md`
-</kata_path>
-
 <purpose>
 Execute a phase prompt (PLAN.md) and create the outcome summary (SUMMARY.md).
 </purpose>
@@ -17,7 +6,7 @@ Execute a phase prompt (PLAN.md) and create the outcome summary (SUMMARY.md).
 Read STATE.md before any operation to load project context.
 Read config.json for planning behavior settings.
 
-@$KATA_BASE/references/git-integration.md
+@~/.claude/kata/references/git-integration.md
 </required_reading>
 
 <process>

package/kata/workflows/milestone-complete.md

@@ -1,14 +1,3 @@
-<kata_path>
-**IMPORTANT:** Before reading any Kata file (templates, references, workflows), resolve the base path:
-
-```bash
-KATA_BASE=$(if [ -n "$CLAUDE_PLUGIN_ROOT" ]; then echo "$CLAUDE_PLUGIN_ROOT/kata"; elif [ -d ~/.claude/kata ]; then echo ~/.claude/kata; else echo ./.claude/kata; fi) && echo $KATA_BASE
-```
-
-Use the output as `$KATA_BASE` for all file paths below. For example:
-- `$KATA_BASE/templates/summary.md` instead of `~/.claude/kata/templates/summary.md`
-</kata_path>
-
 <purpose>
 
 Mark a shipped version (v1.0, v1.1, v2.0) as complete. This creates a historical record in MILESTONES.md, performs full PROJECT.md evolution review, reorganizes ROADMAP.md with milestone groupings, and tags the release in git.

package/kata/workflows/phase-execute.md

@@ -1,14 +1,3 @@
-<kata_path>
-**IMPORTANT:** Before reading any Kata file (templates, references, workflows), resolve the base path:
-
-```bash
-KATA_BASE=$(if [ -n "$CLAUDE_PLUGIN_ROOT" ]; then echo "$CLAUDE_PLUGIN_ROOT/kata"; elif [ -d ~/.claude/kata ]; then echo ~/.claude/kata; else echo ./.claude/kata; fi) && echo $KATA_BASE
-```
-
-Use the output as `$KATA_BASE` for all file paths below. For example:
-- `$KATA_BASE/templates/summary.md` instead of `~/.claude/kata/templates/summary.md`
-</kata_path>
-
 <purpose>
 Execute all plans in a phase using wave-based parallel execution. Orchestrator stays lean by delegating plan execution to subagents.
 </purpose>
@@ -222,10 +211,10 @@ Execute each wave in sequence. Autonomous plans within a wave run in parallel.
    </objective>
 
    <execution_context>
-   @$KATA_BASE/workflows/execute-plan.md
-   @$KATA_BASE/templates/summary.md
-   @$KATA_BASE/references/checkpoints.md
-   @$KATA_BASE/references/tdd.md
+   @~/.claude/kata/workflows/execute-plan.md
+   @~/.claude/kata/templates/summary.md
+   @~/.claude/kata/references/checkpoints.md
+   @~/.claude/kata/references/tdd.md
    </execution_context>
 
    <context>

package/kata/workflows/phase-verify.md

@@ -1,14 +1,3 @@
-<kata_path>
-**IMPORTANT:** Before reading any Kata file (templates, references, workflows), resolve the base path:
-
-```bash
-KATA_BASE=$(if [ -n "$CLAUDE_PLUGIN_ROOT" ]; then echo "$CLAUDE_PLUGIN_ROOT/kata"; elif [ -d ~/.claude/kata ]; then echo ~/.claude/kata; else echo ./.claude/kata; fi) && echo $KATA_BASE
-```
-
-Use the output as `$KATA_BASE` for all file paths below. For example:
-- `$KATA_BASE/templates/summary.md` instead of `~/.claude/kata/templates/summary.md`
-</kata_path>
-
 <purpose>
 Verify phase goal achievement through goal-backward analysis. Check that the codebase actually delivers what the phase promised, not just that tasks were completed.
 
@@ -29,8 +18,8 @@ Then verify each level against the actual codebase.
 </core_principle>
 
 <required_reading>
-@$KATA_BASE/references/verification-patterns.md
-@$KATA_BASE/templates/verification-report.md
+@~/.claude/kata/references/verification-patterns.md
+@~/.claude/kata/templates/verification-report.md
 </required_reading>
 
 <process>

package/kata/workflows/resume-project.md

@@ -1,14 +1,3 @@
-<kata_path>
-**IMPORTANT:** Before reading any Kata file (templates, references, workflows), resolve the base path:
-
-```bash
-KATA_BASE=$(if [ -n "$CLAUDE_PLUGIN_ROOT" ]; then echo "$CLAUDE_PLUGIN_ROOT/kata"; elif [ -d ~/.claude/kata ]; then echo ~/.claude/kata; else echo ./.claude/kata; fi) && echo $KATA_BASE
-```
-
-Use the output as `$KATA_BASE` for all file paths below. For example:
-- `$KATA_BASE/templates/summary.md` instead of `~/.claude/kata/templates/summary.md`
-</kata_path>
-
 <trigger>
 Use this workflow when:
 - Starting a new session on an existing project
@@ -25,7 +14,7 @@ Enables seamless session continuity for fully autonomous workflows.
 </purpose>
 
 <required_reading>
-@$KATA_BASE/references/continuation-format.md
+@~/.claude/kata/references/continuation-format.md
 </required_reading>
 
 <process>

package/kata/workflows/verify-work.md

@@ -1,14 +1,3 @@
-<kata_path>
-**IMPORTANT:** Before reading any Kata file (templates, references, workflows), resolve the base path:
-
-```bash
-KATA_BASE=$(if [ -n "$CLAUDE_PLUGIN_ROOT" ]; then echo "$CLAUDE_PLUGIN_ROOT/kata"; elif [ -d ~/.claude/kata ]; then echo ~/.claude/kata; else echo ./.claude/kata; fi) && echo $KATA_BASE
-```
-
-Use the output as `$KATA_BASE` for all file paths below. For example:
-- `$KATA_BASE/templates/summary.md` instead of `~/.claude/kata/templates/summary.md`
-</kata_path>
-
 <purpose>
 Validate built features through conversational testing with persistent state. Creates UAT.md that tracks test progress, survives /clear, and feeds gaps into /kata:phase-plan --gaps.
 
@@ -26,7 +15,7 @@ No Pass/Fail buttons. No severity questions. Just: "Here's what should happen. D
 </philosophy>
 
 <template>
-@$KATA_BASE/templates/UAT.md
+@~/.claude/kata/templates/UAT.md
 </template>
 
 <process>
@@ -371,7 +360,7 @@ Spawning parallel debug agents to investigate each issue.
 ```
 
 - Load diagnose-issues workflow
-- Follow @$KATA_BASE/workflows/diagnose-issues.md
+- Follow @~/.claude/kata/workflows/diagnose-issues.md
 - Spawn parallel debug agents for each issue
 - Collect root causes
 - Update UAT.md with root causes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gannonh/kata",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "type": "module",
   "description": "Spec-driven development framework for Claude Code.",
   "scripts": {

package/skills/kata-completing-milestones/SKILL.md

@@ -10,17 +10,6 @@ allowed-tools:
   - Bash
 ---
 
-<kata_path>
-**IMPORTANT:** Before reading any Kata file (templates, references, workflows), resolve the base path:
-
-```bash
-KATA_BASE=$(if [ -n "$CLAUDE_PLUGIN_ROOT" ]; then echo "$CLAUDE_PLUGIN_ROOT/kata"; elif [ -d ~/.claude/kata ]; then echo ~/.claude/kata; else echo ./.claude/kata; fi) && echo $KATA_BASE
-```
-
-Use the output as `$KATA_BASE` for all file paths below. For example:
-- `$KATA_BASE/templates/summary.md` instead of `~/.claude/kata/templates/summary.md`
-</kata_path>
-
 <objective>
 Mark milestone {{version}} complete, archive to milestones/, and update ROADMAP.md and REQUIREMENTS.md.
 
@@ -31,8 +20,8 @@ Output: Milestone archived (roadmap + requirements), PROJECT.md evolved, git tag
 <execution_context>
 **Load these files NOW (before proceeding):**
 
-- @$KATA_BASE/workflows/milestone-complete.md (main workflow)
-- @$KATA_BASE/templates/milestone-archive.md (archive template)
+- @~/.claude/kata/workflows/milestone-complete.md (main workflow)
+- @~/.claude/kata/templates/milestone-archive.md (archive template)
   </execution_context>
 
 <context>

package/skills/kata-discussing-phases/SKILL.md

@@ -10,17 +10,6 @@ allowed-tools:
   - Bash
 ---
 
-<kata_path>
-**IMPORTANT:** Before reading any Kata file (templates, references, workflows), resolve the base path:
-
-```bash
-KATA_BASE=$(if [ -n "$CLAUDE_PLUGIN_ROOT" ]; then echo "$CLAUDE_PLUGIN_ROOT/kata"; elif [ -d ~/.claude/kata ]; then echo ~/.claude/kata; else echo ./.claude/kata; fi) && echo $KATA_BASE
-```
-
-Use the output as `$KATA_BASE` for all file paths below. For example:
-- `$KATA_BASE/templates/summary.md` instead of `~/.claude/kata/templates/summary.md`
-</kata_path>
-
 <objective>
 Extract implementation decisions that downstream agents need — researcher and planner will use CONTEXT.md to know what to investigate and what choices are locked.
 
@@ -34,8 +23,8 @@ Extract implementation decisions that downstream agents need — researcher and
 </objective>
 
 <execution_context>
-@$KATA_BASE/workflows/phase-discuss.md
-@$KATA_BASE/templates/context.md
+@~/.claude/kata/workflows/phase-discuss.md
+@~/.claude/kata/templates/context.md
 </execution_context>
 
 <context>

package/skills/kata-executing-phases/SKILL.md

@@ -10,17 +10,6 @@ allowed-tools:
   - Bash
 ---
 
-<kata_path>
-**IMPORTANT:** Before reading any Kata file (templates, references, workflows), resolve the base path:
-
-```bash
-KATA_BASE=$(if [ -n "$CLAUDE_PLUGIN_ROOT" ]; then echo "$CLAUDE_PLUGIN_ROOT/kata"; elif [ -d ~/.claude/kata ]; then echo ~/.claude/kata; else echo ./.claude/kata; fi) && echo $KATA_BASE
-```
-
-Use the output as `$KATA_BASE` for all file paths below. For example:
-- `$KATA_BASE/templates/summary.md` instead of `~/.claude/kata/templates/summary.md`
-</kata_path>
-
 <objective>
 Execute all plans in a phase using wave-based parallel execution.
 
@@ -30,9 +19,9 @@ Context budget: ~15% orchestrator, 100% fresh per subagent.
 </objective>
 
 <execution_context>
-@$KATA_BASE/references/ui-brand.md
-@$KATA_BASE/references/planning-config.md
-@$KATA_BASE/workflows/phase-execute.md
+@~/.claude/kata/references/ui-brand.md
+@~/.claude/kata/references/planning-config.md
+@~/.claude/kata/workflows/phase-execute.md
 </execution_context>
 
 <context>
@@ -290,7 +279,7 @@ Plans with `autonomous: false` have checkpoints. The phase-execute.md workflow h
 - Orchestrator presents to user, collects response
 - Spawns fresh continuation agent (not resume)
 
-See `@$KATA_BASE/workflows/phase-execute.md` step `checkpoint_handling` for complete details.
+See `@~/.claude/kata/workflows/phase-execute.md` step `checkpoint_handling` for complete details.
 </checkpoint_handling>
 
 <deviation_rules>

package/skills/kata-listing-phase-assumptions/SKILL.md

@@ -10,17 +10,6 @@ allowed-tools:
   - Bash
 ---
 
-<kata_path>
-**IMPORTANT:** Before reading any Kata file (templates, references, workflows), resolve the base path:
-
-```bash
-KATA_BASE=$(if [ -n "$CLAUDE_PLUGIN_ROOT" ]; then echo "$CLAUDE_PLUGIN_ROOT/kata"; elif [ -d ~/.claude/kata ]; then echo ~/.claude/kata; else echo ./.claude/kata; fi) && echo $KATA_BASE
-```
-
-Use the output as `$KATA_BASE` for all file paths below. For example:
-- `$KATA_BASE/templates/summary.md` instead of `~/.claude/kata/templates/summary.md`
-</kata_path>
-
 <objective>
 Analyze a phase and present Claude's assumptions about technical approach, implementation order, scope boundaries, risk areas, and dependencies.
 
@@ -29,7 +18,7 @@ Output: Conversational output only (no file creation) - ends with "What do you t
 </objective>
 
 <execution_context>
-@$KATA_BASE/workflows/phase-assumptions.md
+@~/.claude/kata/workflows/phase-assumptions.md
 </execution_context>
 
 <context>

package/skills/kata-mapping-codebases/SKILL.md

@@ -10,17 +10,6 @@ allowed-tools:
   - Bash
 ---
 
-<kata_path>
-**IMPORTANT:** Before reading any Kata file (templates, references, workflows), resolve the base path:
-
-```bash
-KATA_BASE=$(if [ -n "$CLAUDE_PLUGIN_ROOT" ]; then echo "$CLAUDE_PLUGIN_ROOT/kata"; elif [ -d ~/.claude/kata ]; then echo ~/.claude/kata; else echo ./.claude/kata; fi) && echo $KATA_BASE
-```
-
-Use the output as `$KATA_BASE` for all file paths below. For example:
-- `$KATA_BASE/templates/summary.md` instead of `~/.claude/kata/templates/summary.md`
-</kata_path>
-
 <objective>
 Analyze existing codebase using parallel kata-codebase-mapper agents to produce structured codebase documents.
 
@@ -30,7 +19,7 @@ Output: .planning/codebase/ folder with 7 structured documents about the codebas
 </objective>
 
 <execution_context>
-@$KATA_BASE/workflows/project-analyze.md
+@~/.claude/kata/workflows/project-analyze.md
 </execution_context>
 
 <context>

package/skills/kata-planning-phases/SKILL.md

@@ -10,19 +10,8 @@ allowed-tools:
   - Bash
 ---
 
-<kata_path>
-**IMPORTANT:** Before reading any Kata file (templates, references, workflows), resolve the base path:
-
-```bash
-KATA_BASE=$(if [ -n "$CLAUDE_PLUGIN_ROOT" ]; then echo "$CLAUDE_PLUGIN_ROOT/kata"; elif [ -d ~/.claude/kata ]; then echo ~/.claude/kata; else echo ./.claude/kata; fi) && echo $KATA_BASE
-```
-
-Use the output as `$KATA_BASE` for all file paths below. For example:
-- `$KATA_BASE/templates/summary.md` instead of `~/.claude/kata/templates/summary.md`
-</kata_path>
-
 <execution_context>
-@$KATA_BASE/references/ui-brand.md
+@~/.claude/kata/references/ui-brand.md
 </execution_context>
 
 <objective>

package/skills/kata-resuming-work/SKILL.md

@@ -10,17 +10,6 @@ allowed-tools:
   - Bash
 ---
 
-<kata_path>
-**IMPORTANT:** Before reading any Kata file (templates, references, workflows), resolve the base path:
-
-```bash
-KATA_BASE=$(if [ -n "$CLAUDE_PLUGIN_ROOT" ]; then echo "$CLAUDE_PLUGIN_ROOT/kata"; elif [ -d ~/.claude/kata ]; then echo ~/.claude/kata; else echo ./.claude/kata; fi) && echo $KATA_BASE
-```
-
-Use the output as `$KATA_BASE` for all file paths below. For example:
-- `$KATA_BASE/templates/summary.md` instead of `~/.claude/kata/templates/summary.md`
-</kata_path>
-
 <objective>
 Restore complete project context and resume work seamlessly from previous session.
 
@@ -34,11 +23,11 @@ Routes to the resume-project workflow which handles:
   </objective>
 
 <execution_context>
-@$KATA_BASE/workflows/resume-project.md
+@~/.claude/kata/workflows/resume-project.md
 </execution_context>
 
 <process>
-**Follow the resume-project workflow** from `@$KATA_BASE/workflows/resume-project.md`.
+**Follow the resume-project workflow** from `@~/.claude/kata/workflows/resume-project.md`.
 
 The workflow handles all resumption logic including:
 

package/skills/kata-showing-whats-new/SKILL.md

@@ -10,17 +10,6 @@ allowed-tools:
   - Bash
 ---
 
-<kata_path>
-**IMPORTANT:** Before reading any Kata file (templates, references, workflows), resolve the base path:
-
-```bash
-KATA_BASE=$(if [ -n "$CLAUDE_PLUGIN_ROOT" ]; then echo "$CLAUDE_PLUGIN_ROOT/kata"; elif [ -d ~/.claude/kata ]; then echo ~/.claude/kata; else echo ./.claude/kata; fi) && echo $KATA_BASE
-```
-
-Use the output as `$KATA_BASE` for all file paths below. For example:
-- `$KATA_BASE/templates/summary.md` instead of `~/.claude/kata/templates/summary.md`
-</kata_path>
-
 <objective>
 Display changes between installed version and latest available version.
 

package/skills/kata-starting-milestones/SKILL.md

@@ -12,17 +12,6 @@ allowed-tools:
   - AskUserQuestion
 ---
 
-<kata_path>
-**IMPORTANT:** Before reading any Kata file (templates, references, workflows), resolve the base path:
-
-```bash
-KATA_BASE=$(if [ -n "$CLAUDE_PLUGIN_ROOT" ]; then echo "$CLAUDE_PLUGIN_ROOT/kata"; elif [ -d ~/.claude/kata ]; then echo ~/.claude/kata; else echo ./.claude/kata; fi) && echo $KATA_BASE
-```
-
-Use the output as `$KATA_BASE` for all file paths below. For example:
-- `$KATA_BASE/templates/summary.md` instead of `~/.claude/kata/templates/summary.md`
-</kata_path>
-
 <objective>
 Start a new milestone through unified flow: questioning → research (optional) → requirements → roadmap.
 
@@ -39,10 +28,10 @@ This is the brownfield equivalent of project-new. The project exists, PROJECT.md
 </objective>
 
 <execution_context>
-@$KATA_BASE/references/questioning.md
-@$KATA_BASE/references/ui-brand.md
-@$KATA_BASE/templates/project.md
-@$KATA_BASE/templates/requirements.md
+@~/.claude/kata/references/questioning.md
+@~/.claude/kata/references/ui-brand.md
+@~/.claude/kata/templates/project.md
+@~/.claude/kata/templates/requirements.md
 </execution_context>
 
 <context>

package/skills/kata-starting-projects/SKILL.md

@@ -12,17 +12,6 @@ allowed-tools:
   - AskUserQuestion
 ---
 
-<kata_path>
-**IMPORTANT:** Before reading any Kata file (templates, references, workflows), resolve the base path:
-
-```bash
-KATA_BASE=$(if [ -n "$CLAUDE_PLUGIN_ROOT" ]; then echo "$CLAUDE_PLUGIN_ROOT/kata"; elif [ -d ~/.claude/kata ]; then echo ~/.claude/kata; else echo ./.claude/kata; fi) && echo $KATA_BASE
-```
-
-Use the output as `$KATA_BASE` for all file paths below. For example:
-- `$KATA_BASE/templates/summary.md` instead of `~/.claude/kata/templates/summary.md`
-</kata_path>
-
 <objective>
 
 Initialize a new project through unified flow: questioning → research (optional) → requirements → roadmap.
@@ -43,10 +32,10 @@ This is the most leveraged moment in any project. Deep questioning here means be
 
 <execution_context>
 
-@$KATA_BASE/references/questioning.md
-@$KATA_BASE/references/ui-brand.md
-@$KATA_BASE/templates/project.md
-@$KATA_BASE/templates/requirements.md
+@~/.claude/kata/references/questioning.md
+@~/.claude/kata/references/ui-brand.md
+@~/.claude/kata/templates/project.md
+@~/.claude/kata/templates/requirements.md
 
 </execution_context>
 

package/skills/kata-updating/SKILL.md

@@ -10,17 +10,6 @@ allowed-tools:
   - Bash
 ---
 
-<kata_path>
-**IMPORTANT:** Before reading any Kata file (templates, references, workflows), resolve the base path:
-
-```bash
-KATA_BASE=$(if [ -n "$CLAUDE_PLUGIN_ROOT" ]; then echo "$CLAUDE_PLUGIN_ROOT/kata"; elif [ -d ~/.claude/kata ]; then echo ~/.claude/kata; else echo ./.claude/kata; fi) && echo $KATA_BASE
-```
-
-Use the output as `$KATA_BASE` for all file paths below. For example:
-- `$KATA_BASE/templates/summary.md` instead of `~/.claude/kata/templates/summary.md`
-</kata_path>
-
 <objective>
 Check for Kata updates, install if available, and display what changed.
 

package/skills/kata-verifying-work/SKILL.md

@@ -10,17 +10,6 @@ allowed-tools:
   - Bash
 ---
 
-<kata_path>
-**IMPORTANT:** Before reading any Kata file (templates, references, workflows), resolve the base path:
-
-```bash
-KATA_BASE=$(if [ -n "$CLAUDE_PLUGIN_ROOT" ]; then echo "$CLAUDE_PLUGIN_ROOT/kata"; elif [ -d ~/.claude/kata ]; then echo ~/.claude/kata; else echo ./.claude/kata; fi) && echo $KATA_BASE
-```
-
-Use the output as `$KATA_BASE` for all file paths below. For example:
-- `$KATA_BASE/templates/summary.md` instead of `~/.claude/kata/templates/summary.md`
-</kata_path>
-
 <objective>
 Validate built features through conversational testing with persistent state.
 
@@ -30,8 +19,8 @@ Output: {phase}-UAT.md tracking all test results. If issues found: diagnosed gap
 </objective>
 
 <execution_context>
-@$KATA_BASE/workflows/verify-work.md
-@$KATA_BASE/templates/UAT.md
+@~/.claude/kata/workflows/verify-work.md
+@~/.claude/kata/templates/UAT.md
 </execution_context>
 
 <context>