@gannonh/kata 1.1.2 → 1.1.4

package/agents/kata-entity-generator.md

@@ -8,7 +8,7 @@ color: cyan
 <role>
 You are a Kata entity generator. You create semantic documentation for source files that captures PURPOSE (what the code does and why it exists), not just syntax.
 
-You are spawned by `/kata:analyze-codebase` with a list of file paths.
+You are spawned by `/kata:mapping-codebases` with a list of file paths.
 
 Your job: Read each file, analyze its purpose, write entity markdown to `.planning/intel/entities/`, return statistics only.
 </role>

package/commands/kata/adding-phases.md

@@ -0,0 +1,20 @@
+---
+name: kata:adding-phases
+description: Add phase to end of current milestone in roadmap
+version: 0.1.0
+argument-hint: <description>
+disable-model-invocation: true
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+## Step 1: Parse Context
+
+Phase Description: "$ARGUMENTS"
+
+## Step 2: Invoke Skill
+
+Run the following skill to add the phase:
+`Skill("kata-adding-phases")`

package/commands/kata/adding-todos.md

@@ -0,0 +1,20 @@
+---
+name: kata:adding-todos
+description: Capture idea or task as todo from current conversation context
+argument-hint: [optional description]
+version: 0.1.0
+disable-model-invocation: true
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+## Step 1: Parse Context
+
+Arguments: "$ARGUMENTS"
+
+## Step 2: Invoke Skill
+
+Run the following skill:
+`Skill("kata-adding-todos")`

package/commands/kata/auditing-milestones.md

@@ -0,0 +1,20 @@
+---
+name: kata:auditing-milestones
+description: Audit milestone completion against original intent before archiving
+argument-hint: [version]
+version: 0.1.0
+disable-model-invocation: true
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+## Step 1: Parse Context
+
+Arguments: "$ARGUMENTS"
+
+## Step 2: Invoke Skill
+
+Run the following skill:
+`Skill("kata-auditing-milestones")`

package/commands/kata/checking-todos.md

@@ -0,0 +1,20 @@
+---
+name: kata:checking-todos
+description: List pending todos and select one to work on
+argument-hint: [area filter]
+version: 0.1.0
+disable-model-invocation: true
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+## Step 1: Parse Context
+
+Arguments: "$ARGUMENTS"
+
+## Step 2: Invoke Skill
+
+Run the following skill:
+`Skill("kata-checking-todos")`

package/commands/kata/completing-milestones.md

@@ -0,0 +1,20 @@
+---
+name: kata:completing-milestones
+description: Archive completed milestone and prepare for next version
+argument-hint: <version>
+version: 0.1.0
+disable-model-invocation: true
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+## Step 1: Parse Context
+
+Arguments: "$ARGUMENTS"
+
+## Step 2: Invoke Skill
+
+Run the following skill:
+`Skill("kata-completing-milestones")`

package/commands/kata/configuring-settings.md

@@ -0,0 +1,20 @@
+---
+name: kata:configuring-settings
+description: Configure Kata workflow toggles and model profile
+argument-hint: <description>
+version: 0.1.0
+disable-model-invocation: true
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+## Step 1: Parse Context
+
+Arguments: "$ARGUMENTS"
+
+## Step 2: Invoke Skill
+
+Run the following skill:
+`Skill("kata-configuring-settings")`

package/commands/kata/debugging.md

@@ -0,0 +1,20 @@
+---
+name: kata:debugging
+description: Systematic debugging with persistent state across context resets
+argument-hint: [issue description]
+version: 0.1.0
+disable-model-invocation: true
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+## Step 1: Parse Context
+
+Arguments: "$ARGUMENTS"
+
+## Step 2: Invoke Skill
+
+Run the following skill:
+`Skill("kata-debugging")`

package/commands/kata/discussing-phases.md

@@ -0,0 +1,20 @@
+---
+name: kata:discussing-phases
+description: Gather phase context through adaptive questioning before planning
+argument-hint: <phase>
+version: 0.1.0
+disable-model-invocation: true
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+## Step 1: Parse Context
+
+Arguments: "$ARGUMENTS"
+
+## Step 2: Invoke Skill
+
+Run the following skill:
+`Skill("kata-discussing-phases")`

package/commands/kata/executing-phases.md

@@ -0,0 +1,20 @@
+---
+name: kata:executing-phases
+description: Execute all plans in a phase with wave-based parallelization
+argument-hint: <phase-number> [--gaps-only]
+version: 0.1.0
+disable-model-invocation: true
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+## Step 1: Parse Context
+
+Arguments: "$ARGUMENTS"
+
+## Step 2: Invoke Skill
+
+Run the following skill:
+`Skill("kata-executing-phases")`

package/commands/kata/executing-quick-tasks.md

@@ -0,0 +1,20 @@
+---
+name: kata:executing-quick-tasks
+description: Execute a quick task with Kata guarantees (atomic commits, state tracking) but skip optional agents
+argument-hint: <description>
+version: 0.1.0
+disable-model-invocation: true
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+## Step 1: Parse Context
+
+Arguments: "$ARGUMENTS"
+
+## Step 2: Invoke Skill
+
+Run the following skill:
+`Skill("kata-executing-quick-tasks")`

package/commands/kata/inserting-phases.md

@@ -0,0 +1,20 @@
+---
+name: kata:inserting-phases
+description: Insert urgent work as decimal phase (e.g., 72.1) between existing phases
+argument-hint: <after> <description>
+version: 0.1.0
+disable-model-invocation: true
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+## Step 1: Parse Context
+
+Arguments: "$ARGUMENTS"
+
+## Step 2: Invoke Skill
+
+Run the following skill:
+`Skill("kata-inserting-phases")`

package/commands/kata/listing-phase-assumptions.md

@@ -0,0 +1,20 @@
+---
+name: kata:listing-phase-assumptions
+description: Surface Claude's assumptions about a phase approach before planning
+argument-hint: [phase]
+version: 0.1.0
+disable-model-invocation: true
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+## Step 1: Parse Context
+
+Arguments: "$ARGUMENTS"
+
+## Step 2: Invoke Skill
+
+Run the following skill:
+`Skill("kata-listing-phase-assumptions")`

package/commands/kata/mapping-codebases.md

@@ -0,0 +1,20 @@
+---
+name: kata:mapping-codebases
+description: Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents
+argument-hint: [optional: specific area to map, e.g., 'api' or 'auth']
+version: 0.1.0
+disable-model-invocation: true
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+## Step 1: Parse Context
+
+Arguments: "$ARGUMENTS"
+
+## Step 2: Invoke Skill
+
+Run the following skill:
+`Skill("kata-mapping-codebases")`

package/commands/kata/pausing-work.md

@@ -0,0 +1,20 @@
+---
+name: kata:pausing-work
+description: Create context handoff when pausing work mid-phase
+argument-hint: <description>
+version: 0.1.0
+disable-model-invocation: true
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+## Step 1: Parse Context
+
+Arguments: "$ARGUMENTS"
+
+## Step 2: Invoke Skill
+
+Run the following skill:
+`Skill("kata-pausing-work")`

package/commands/kata/planning-milestone-gaps.md

@@ -0,0 +1,20 @@
+---
+name: kata:planning-milestone-gaps
+description: Create phases to close all gaps identified by milestone audit
+argument-hint: <description>
+version: 0.1.0
+disable-model-invocation: true
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+## Step 1: Parse Context
+
+Arguments: "$ARGUMENTS"
+
+## Step 2: Invoke Skill
+
+Run the following skill:
+`Skill("kata-planning-milestone-gaps")`

package/commands/kata/planning-phases.md

@@ -0,0 +1,20 @@
+---
+name: kata:planning-phases
+description: Create detailed execution plan for a phase (PLAN.md) with verification loop
+argument-hint: [phase] [--research] [--skip-research] [--gaps] [--skip-verify]
+version: 0.1.0
+disable-model-invocation: true
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+## Step 1: Parse Context
+
+Arguments: "$ARGUMENTS"
+
+## Step 2: Invoke Skill
+
+Run the following skill:
+`Skill("kata-planning-phases")`

package/commands/kata/providing-help.md

@@ -0,0 +1,20 @@
+---
+name: kata:providing-help
+description: Show available Kata commands and usage guide
+argument-hint: <description>
+version: 0.1.0
+disable-model-invocation: true
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+## Step 1: Parse Context
+
+Arguments: "$ARGUMENTS"
+
+## Step 2: Invoke Skill
+
+Run the following skill:
+`Skill("kata-providing-help")`

package/commands/kata/removing-phases.md

@@ -0,0 +1,20 @@
+---
+name: kata:removing-phases
+description: Remove a future phase from roadmap and renumber subsequent phases
+argument-hint: <phase-number>
+version: 0.1.0
+disable-model-invocation: true
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+## Step 1: Parse Context
+
+Arguments: "$ARGUMENTS"
+
+## Step 2: Invoke Skill
+
+Run the following skill:
+`Skill("kata-removing-phases")`

package/commands/kata/researching-phases.md

@@ -0,0 +1,20 @@
+---
+name: kata:researching-phases
+description: Research how to implement a phase (standalone - usually use /kata:planning-phases instead)
+argument-hint: [phase]
+version: 0.1.0
+disable-model-invocation: true
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+## Step 1: Parse Context
+
+Arguments: "$ARGUMENTS"
+
+## Step 2: Invoke Skill
+
+Run the following skill:
+`Skill("kata-researching-phases")`

package/commands/kata/resuming-work.md

@@ -0,0 +1,20 @@
+---
+name: kata:resuming-work
+description: Resume work from previous session with full context restoration
+argument-hint: <description>
+version: 0.1.0
+disable-model-invocation: true
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+## Step 1: Parse Context
+
+Arguments: "$ARGUMENTS"
+
+## Step 2: Invoke Skill
+
+Run the following skill:
+`Skill("kata-resuming-work")`

package/commands/kata/setting-profiles.md

@@ -0,0 +1,20 @@
+---
+name: kata:setting-profiles
+description: Switch model profile for Kata agents (quality/balanced/budget)
+argument-hint: <description>
+version: 0.1.0
+disable-model-invocation: true
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+## Step 1: Parse Context
+
+Arguments: "$ARGUMENTS"
+
+## Step 2: Invoke Skill
+
+Run the following skill:
+`Skill("kata-setting-profiles")`

package/commands/kata/showing-whats-new.md

@@ -0,0 +1,20 @@
+---
+name: kata:showing-whats-new
+description: See what's new in Kata since your installed version
+argument-hint: <description>
+version: 0.1.0
+disable-model-invocation: true
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+## Step 1: Parse Context
+
+Arguments: "$ARGUMENTS"
+
+## Step 2: Invoke Skill
+
+Run the following skill:
+`Skill("kata-showing-whats-new")`

package/commands/kata/starting-milestones.md

@@ -0,0 +1,20 @@
+---
+name: kata:starting-milestones
+description: Start a new milestone cycle — update PROJECT.md and route to requirements
+argument-hint: [milestone name, e.g., 'v1.1 Notifications']
+version: 0.1.0
+disable-model-invocation: true
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+## Step 1: Parse Context
+
+Arguments: "$ARGUMENTS"
+
+## Step 2: Invoke Skill
+
+Run the following skill:
+`Skill("kata-starting-milestones")`

package/commands/kata/starting-projects.md

@@ -0,0 +1,20 @@
+---
+name: kata:starting-projects
+description: Initialize a new project with deep context gathering and PROJECT.md
+argument-hint: <description>
+version: 0.1.0
+disable-model-invocation: true
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+## Step 1: Parse Context
+
+Arguments: "$ARGUMENTS"
+
+## Step 2: Invoke Skill
+
+Run the following skill:
+`Skill("kata-starting-projects")`

package/commands/kata/tracking-progress.md

@@ -0,0 +1,20 @@
+---
+name: kata:tracking-progress
+description: Check project progress, show context, and route to next action (execute or plan)
+argument-hint: <description>
+version: 0.1.0
+disable-model-invocation: true
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+## Step 1: Parse Context
+
+Arguments: "$ARGUMENTS"
+
+## Step 2: Invoke Skill
+
+Run the following skill:
+`Skill("kata-tracking-progress")`

package/commands/kata/updating.md

@@ -0,0 +1,20 @@
+---
+name: kata:updating
+description: Update Kata to latest version with changelog display
+argument-hint: <description>
+version: 0.1.0
+disable-model-invocation: true
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+## Step 1: Parse Context
+
+Arguments: "$ARGUMENTS"
+
+## Step 2: Invoke Skill
+
+Run the following skill:
+`Skill("kata-updating")`

package/commands/kata/verifying-work.md

@@ -0,0 +1,20 @@
+---
+name: kata:verifying-work
+description: Validate built features through conversational UAT
+argument-hint: [phase number, e.g., '4']
+version: 0.1.0
+disable-model-invocation: true
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+## Step 1: Parse Context
+
+Arguments: "$ARGUMENTS"
+
+## Step 2: Invoke Skill
+
+Run the following skill:
+`Skill("kata-verifying-work")`

package/package.json

@@ -1,17 +1,11 @@
 {
   "name": "@gannonh/kata",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "type": "module",
   "description": "Spec-driven development framework for Claude Code.",
   "scripts": {
-    "test": "node --test --test-reporter spec ./tests/build.test.js",
     "test:smoke": "node --test --test-reporter spec ./tests/smoke.test.js",
-    "test:all": "node --test --test-reporter spec ./tests/build.test.js ./tests/smoke.test.js",
-    "build": "node scripts/build.js all",
-    "build:plugin": "node scripts/build.js plugin",
-    "build:npm": "node scripts/build.js npm",
-    "build:hooks": "node scripts/build-hooks.cjs",
-    "prepublishOnly": "npm run build:hooks"
+    "test:all": "node --test --test-reporter spec ./tests/build.test.js ./tests/smoke.test.js"
   },
   "bin": {
     "kata": "bin/install.js"
@@ -21,6 +15,7 @@
     "bin",
     "kata",
     "agents",
+    "commands",
     "hooks",
     "skills"
   ],

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

@@ -2,7 +2,7 @@
 name: kata-adding-phases
 description: Use this skill to add planned work discovered during execution to the end of the current milestone in the roadmap. This skill appends sequential phases to the current milestone's phase list, automatically calculating the next phase number. Triggers include "add phase", "append phase", "new phase", and "create phase". This skill updates ROADMAP.md and STATE.md accordingly.
 version: 0.1.0
-user-invocable: true
+user-invocable: false
 disable-model-invocation: false
 allowed-tools:
   - Read

package/skills/kata-adding-todos/SKILL.md

@@ -2,7 +2,7 @@
 name: kata-adding-todos
 description: Use this skill to capture an idea, task, or issue that surfaces during a Kata session as a structured todo for later work. This skill creates markdown todo files in the .planning/todos/pending directory with relevant metadata and content extracted from the conversation. Triggers include "add todo", "capture todo", "new todo", and "create todo". 
 version: 0.1.0
-user-invocable: true
+user-invocable: false
 disable-model-invocation: false
 allowed-tools:
   - Read

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

@@ -2,7 +2,7 @@
 name: kata-auditing-milestones
 description: Use this skill to verify milestone achievement against its definition of done, checking requirements coverage, cross-phase integration, and end-to-end flows. Triggers include "audit milestone", "verify milestone", "check milestone", and "milestone audit". This skill reads existing phase verification files, aggregates technical debt and gaps, and spawns an integration checker for cross-phase wiring.
 version: 0.1.0
-user-invocable: true
+user-invocable: false
 disable-model-invocation: false
 allowed-tools:
   - Read

package/skills/kata-checking-todos/SKILL.md

@@ -2,7 +2,7 @@
 name: kata-checking-todos
 description: Use this skill when reviewing pending todos, selecting a todo to work on, filtering todos by area, or deciding what to work on next. Triggers include "check todos", "list todos", "what todos", "pending todos", "show todos", "view todos", and "select todo to work on".
 version: 0.1.0
-user-invocable: true
+user-invocable: false
 disable-model-invocation: false
 allowed-tools:
   - Read

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

@@ -2,7 +2,7 @@
 name: kata-completing-milestones
 description: Use this skill when archiving a completed milestone, preparing for the next version, marking a milestone complete, shipping a version, or wrapping up milestone work. Triggers include "complete milestone", "finish milestone", "archive milestone", "ship version", "mark milestone done", and "milestone complete".
 version: 0.1.0
-user-invocable: true
+user-invocable: false
 disable-model-invocation: false
 allowed-tools:
   - Read

package/skills/kata-configuring-settings/SKILL.md

@@ -2,7 +2,7 @@
 name: kata-configuring-settings
 description: Use this skill when configure kata workflow toggles and model profile. Triggers include "settings".
 version: 0.1.0
-user-invocable: true
+user-invocable: false
 disable-model-invocation: false
 allowed-tools:
   - Read