@haposoft/cafekit 0.8.1 → 0.8.3

package/src/claude/skills/inspect/references/external-gemini-inspection.md

@@ -11,7 +11,7 @@ SCALE ≥ 6   → Use internal discovery instead
 
 ## Configuration
 
-Read from `packages/spec/src/claude/runtime.json`:
+Read from `.claude/runtime.json`:
 ```json
 {
   "gemini": {
@@ -62,17 +62,17 @@ If not installed, ask user:
 1. **Yes** - Provide installation instructions (may need manual auth steps)
 2. **No** - Fall back to internal discovery (`internal-inspection.md`)
 
-## Spawning Parallel Bash Agents
+## Running Parallel Gemini Commands
 
-Use `Agent` tool with `subagent_type: "Bash"` to spawn parallel agents:
+Use the `Bash` tool for each scoped Gemini command. Run them in the same tool turn when the runtime supports parallel tool calls; otherwise run them sequentially. Do not use `Agent` with `subagent_type: "Bash"` — `Bash` is a tool, not a subagent.
 
 ```
-Agent 1: subagent_type="Bash", prompt="Run: gemini -y -m gemini-3-flash-preview '[prompt1]'"
-Agent 2: subagent_type="Bash", prompt="Run: gemini -y -m gemini-3-flash-preview '[prompt2]'"
-Agent 3: subagent_type="Bash", prompt="Run: gemini -y -m gemini-3-flash-preview '[prompt3]'"
+Bash: gemini -y -m gemini-3-flash-preview '[prompt1]'
+Bash: gemini -y -m gemini-3-flash-preview '[prompt2]'
+Bash: gemini -y -m gemini-3-flash-preview '[prompt3]'
 ```
 
-Spawn all in single message for parallel execution.
+Group by independent scopes so each command can return a focused report.
 
 ## Prompt Guidelines
 
@@ -107,11 +107,11 @@ Do not expand beyond the provided scope.
 
 User: "Find database migration files" with `ext`
 
-Spawn 3 parallel Bash agents via Agent tool:
+Run 3 scoped Gemini CLI commands:
 ```
-Agent 1 (Bash): "Run: gemini -y -m gemini-3-flash-preview 'Search db/, migrations/ for migration files'"
-Agent 2 (Bash): "Run: gemini -y -m gemini-3-flash-preview 'Search lib/, src/ for database schema files'"
-Agent 3 (Bash): "Run: gemini -y -m gemini-3-flash-preview 'Search config/ for database configuration'"
+Bash: gemini -y -m gemini-3-flash-preview 'Search db/, migrations/ for migration files'
+Bash: gemini -y -m gemini-3-flash-preview 'Search lib/, src/ for database schema files'
+Bash: gemini -y -m gemini-3-flash-preview 'Search config/ for database configuration'
 ```
 
 ## Reading File Content

package/src/claude/skills/research/SKILL.md

@@ -19,7 +19,7 @@ Before delegating, briefly assess the `[topic]`.
 - If solid, proceed.
 
 ### Phase 2: Agent Delegation
-Call the `TaskCreate` tool to spin up the `researcher` subagent.
+Call the `Agent` tool to invoke the `researcher` subagent. Use `TaskCreate` only for task-list tracking when the workflow needs persistent task state.
 **Instructions to pass to Researcher:**
 ```text
 Conduct comprehensive research on: [topic]

package/src/claude/skills/specs/SKILL.md

@@ -159,12 +159,12 @@ flowchart TD
   - the request has 2-3 viable architectures and no user-approved direction
   - the feature spans 3+ independent subsystems and needs decomposition
   - the user is explicitly asking to explore, compare, debate, or decide
-- **Multimodal & Document Auto-Ingestion (MANDATORY)**: If the input includes file paths or URLs pointing to images, audio, video, or Office documents, you MUST spawn the matching subagent to extract content BEFORE proceeding:
-  - `.mp3`, `.wav`, `.mp4`, `.mov`, `.jpg`, `.png`, `.webp` → `Task(subagent_type="hapo:ai-multimodal", prompt="Transcribe/Analyze [path]")`
-  - `.pdf` → `Task(subagent_type="hapo:pdf", prompt="Extract text and tables from [path]")`
-  - `.docx` → `Task(subagent_type="hapo:docx", prompt="Extract content from [path]")`
-  - `.pptx` → `Task(subagent_type="hapo:pptx", prompt="Extract slide content from [path]")`
-  - `.xlsx`, `.csv` → `Task(subagent_type="hapo:xlsx", prompt="Extract data from [path]")`
+- **Multimodal & Document Auto-Ingestion (MANDATORY)**: If the input includes file paths or URLs pointing to images, audio, video, or Office documents, activate the matching skill workflow to extract content BEFORE proceeding:
+  - `.mp3`, `.wav`, `.mp4`, `.mov`, `.jpg`, `.png`, `.webp` → use `hapo:ai-multimodal` to transcribe/analyze the file
+  - `.pdf` → use `hapo:pdf` to extract text and tables
+  - `.docx` → use `hapo:docx` to extract document content
+  - `.pptx` → use `hapo:pptx` to extract slide content
+  - `.xlsx`, `.csv` → use `hapo:xlsx` to extract data
   - *Append the extracted findings into your working memory as the enriched "description".*
 - If description < 20 words or lacks concrete nouns → ask 1-2 clarifying questions
 - If task is too simple → warn user that a spec may not be needed

package/src/claude/skills/specs/references/codebase-analysis.md

@@ -37,7 +37,7 @@ The scout must be narrow and question-driven. Do not scan the whole repo just be
 2. **The "Blind Flight" Halt:** If ALL 4 mandatory docs are missing in a non-empty repository:
    - **DO NOT** blindly use `inspector` to scan the whole repo.
    - **HALT** the spec process immediately.
-   - Ask the User: *"No codebase documentation found. Exploring blind will drain tokens and produce inaccurate specs. Shall I trigger `docs-keeper` or `/hapo:docs` to generate a baseline `codebase-summary.md` first?"*
+   - Ask the User: *"No codebase documentation found. Exploring blind will drain tokens and produce inaccurate specs. Shall I call the `docs-keeper` agent to generate a baseline `codebase-summary.md` first?"*
 
 ## Scout Output Contract
 

package/src/claude/skills/test/SKILL.md

@@ -75,7 +75,7 @@ See `references/execution-strategy.md` Phase C for full phase breakdown.
 
 Delegate execution to `test-runner` agent:
 ```
-Task(subagent_type="test-runner",
+Agent(subagent_type="test-runner",
   prompt="Run tests. Scope: [blast-radius|full|ui]. Target: [path|url]. Return structured verdict.",
   description="Test [feature]")
 ```