@haposoft/cafekit 0.13.3 → 0.14.0

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

@@ -68,7 +68,6 @@ Leverage these specific tools or sub-agents to execute the workflow effectively:
 - `AskUserQuestion`: Use this to enforce the "One Question at a Time" rule and to present multiple choices.
 - `hapo:inspect`: Mandatory first pass for repo-aware brainstorming.
 - `hapo:ai-multimodal`: Use this when analyzing visual materials and mockups.
-- `hapo:generate-graph`: Use when a diagram would make architecture, flows, or trade-offs easier to validate.
 - `repomix --remote`: Use this bash command to summarize external Github repositories if a URL is provided.
 - `psql`: Query database schemas to understand existing data structures.
 - `brainstormer`: Call only for medium/high-complexity architecture trade-offs.
@@ -155,7 +154,7 @@ Always name the simplest viable option and explain the trade-off that makes it p
 
 If the topic involves UI layouts, interactive elements, visual styling, architecture diagrams, or spatial flows:
 - Use `hapo:ai-multimodal` for supplied images, videos, PDFs, or mockups.
-- Use `hapo:generate-graph` when a diagram would make trade-offs clearer.
+- Use a Mermaid diagram in the design doc when it would make trade-offs clearer.
 - Do not force text-only guesswork for visual choices.
 - Visual aids support the brainstorm; they do not bypass user approval.
 

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

@@ -7,7 +7,7 @@ when_to_use: "Invoke to read, create, or edit Word .docx documents."
 category: document-skills
 keywords: [docx, word, document, office]
 metadata:
-  author: haposoft
+  author: "Anthropic, PBC — adapted by Haposoft"
   version: "1.0.0"
 ---
 # DOCX creation, editing, and analysis

package/src/claude/skills/frontend-design/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: hapo:frontend-design
 description: Create polished frontend interfaces from designs/screenshots/videos. Use for web components, 3D experiences, replicating UI designs, quick prototypes, immersive interfaces, avoiding AI slop.
-license: Complete terms in LICENSE.txt
+license: MIT
 user-invocable: true
 when_to_use: "Invoke to translate mockups or screenshots into UI implementation."
 category: frontend

package/src/claude/skills/frontend-design/references/ai-multimodal-overview.md

@@ -79,7 +79,7 @@ Extract design systems systematically from high-quality references:
 4. Extract color palettes with hex codes
 5. Test integration with UI elements
 
-**Model**: gemini-2.5-flash (vision understanding)
+**Model**: gemma-4-31b-it (vision understanding)
 
 ### For Design Extraction
 **See**: `design-extraction.md`
@@ -90,7 +90,7 @@ Extract design systems systematically from high-quality references:
 4. Extract motion guidelines from videos (if applicable)
 5. Document actionably with CSS-ready specifications
 
-**Model**: gemini-2.5-flash (vision understanding)
+**Model**: gemma-4-31b-it (vision understanding)
 
 ## Integration with Other Skills
 
@@ -139,7 +139,7 @@ python scripts/gemini_batch_process.py \
   --task analyze \
   --prompt "[evaluation criteria]" \
   --output docs/assets/analysis.md \
-  --model gemini-2.5-flash
+  --model gemma-4-31b-it
 ```
 
 **Extract design guidelines**:
@@ -149,7 +149,7 @@ python scripts/gemini_batch_process.py \
   --task analyze \
   --prompt "[extraction criteria from design-extraction.md]" \
   --output docs/design-guidelines/extracted.md \
-  --model gemini-2.5-flash
+  --model gemma-4-31b-it
 ```
 
 ## Remember

package/src/claude/skills/frontend-design/references/analysis-techniques.md

@@ -23,7 +23,7 @@ python scripts/gemini_batch_process.py \
   --task analyze \
   --prompt "Rank these variations 1-3 with scores. Identify winner." \
   --output docs/assets/batch-analysis.md \
-  --model gemini-2.5-flash
+  --model gemma-4-31b-it
 ```
 
 ## Contextual Testing
@@ -46,7 +46,7 @@ python scripts/gemini_batch_process.py \
 4. Overall visual hierarchy effectiveness
 Provide WCAG contrast ratio estimates." \
   --output docs/assets/ui-integration-test.md \
-  --model gemini-2.5-flash
+  --model gemma-4-31b-it
 ```
 
 ## A/B Testing Analysis
@@ -71,7 +71,7 @@ Compare for:
 
 Recommend which to A/B test in production and why." \
   --output docs/assets/ab-test-analysis.md \
-  --model gemini-2.5-flash
+  --model gemma-4-31b-it
 ```
 
 ## Iteration Strategy

package/src/claude/skills/frontend-design/references/asset-generation.md

@@ -95,7 +95,7 @@ python scripts/gemini_batch_process.py \
 5. Professional quality (rate 1-10)
 6. Specific weaknesses or improvements needed" \
   --output docs/assets/hero-evaluation.md \
-  --model gemini-2.5-flash
+  --model gemma-4-31b-it
 ```
 
 ### Step 5: Iterate or Integrate
@@ -311,7 +311,7 @@ python scripts/gemini_batch_process.py \
   --task analyze \
   --prompt "Rate 1-10 for aesthetic quality, color harmony, text overlay suitability" \
   --output docs/assets/analysis-1.md \
-  --model gemini-2.5-flash
+  --model gemma-4-31b-it
 
 # 3. If score ≥ 7/10, generate production version
 python scripts/gemini_batch_process.py \

package/src/claude/skills/frontend-design/references/design-extraction-overview.md

@@ -27,7 +27,7 @@ python scripts/gemini_batch_process.py \
   --task analyze \
   --prompt "[see extraction-prompts.md for detailed prompt]" \
   --output docs/design-guidelines/extracted-design-system.md \
-  --model gemini-2.5-flash
+  --model gemma-4-31b-it
 ```
 
 ### Multi-Screen System Extraction
@@ -37,7 +37,7 @@ python scripts/gemini_batch_process.py \
   --task analyze \
   --prompt "[see extraction-prompts.md for multi-screen prompt]" \
   --output docs/design-guidelines/complete-design-system.md \
-  --model gemini-2.5-flash
+  --model gemma-4-31b-it
 ```
 
 ### Video Motion Analysis
@@ -47,7 +47,7 @@ python scripts/gemini_batch_process.py \
   --task analyze \
   --prompt "[see extraction-prompts.md for motion prompt]" \
   --output docs/design-guidelines/motion-system.md \
-  --model gemini-2.5-flash
+  --model gemma-4-31b-it
 ```
 
 ### Competitive Analysis
@@ -57,7 +57,7 @@ python scripts/gemini_batch_process.py \
   --task analyze \
   --prompt "[see extraction-prompts.md for competitive prompt]" \
   --output docs/design-guidelines/competitive-analysis.md \
-  --model gemini-2.5-flash
+  --model gemma-4-31b-it
 ```
 
 ## Detailed References

package/src/claude/skills/frontend-design/references/extraction-best-practices.md

@@ -85,7 +85,7 @@ python scripts/gemini_batch_process.py \
 - All animation timings
 Output as CSS variables ready for implementation." \
   --output docs/design-guidelines/brand-design-system.md \
-  --model gemini-2.5-flash
+  --model gemma-4-31b-it
 ```
 
 ### Trend Analysis
@@ -103,7 +103,7 @@ python scripts/gemini_batch_process.py \
 5. Animation patterns
 Identify what's trending in 2024 web design." \
   --output docs/design-guidelines/trend-analysis.md \
-  --model gemini-2.5-flash
+  --model gemma-4-31b-it
 ```
 
 ### Historical Evolution
@@ -119,7 +119,7 @@ python scripts/gemini_batch_process.py \
 3. How trends influenced changes
 4. Lessons for our design evolution" \
   --output docs/design-guidelines/evolution-analysis.md \
-  --model gemini-2.5-flash
+  --model gemma-4-31b-it
 ```
 
 ## Common Pitfalls

package/src/claude/skills/frontend-design/references/technical-accessibility.md

@@ -71,7 +71,7 @@ python scripts/gemini_batch_process.py \
 
 Provide specific recommendations for adjustments." \
   --output docs/assets/integration-analysis.md \
-  --model gemini-2.5-flash
+  --model gemma-4-31b-it
 ```
 
 ## Next.js Integration Example

package/src/claude/skills/frontend-design/references/technical-optimization.md

@@ -24,7 +24,7 @@ Use ultra model (1 generation):
 
 ## Analysis Model Strategy
 
-- Use gemini-2.5-flash for all analysis (vision understanding)
+- Use gemma-4-31b-it for all analysis (vision understanding)
 - **Cost**: ~$0.001 per analysis
 - **Speed**: ~2-5 seconds per analysis
 - **Token-efficient**: Images count as ~258-1548 tokens

package/src/claude/skills/frontend-design/references/technical-overview.md

@@ -52,7 +52,7 @@ python scripts/gemini_batch_process.py --files docs/assets/[image].png \
   --task analyze \
   --prompt "[evaluation criteria]" \
   --output docs/assets/analysis.md \
-  --model gemini-2.5-flash
+  --model gemma-4-31b-it
 
 # Optimize
 python scripts/media_optimizer.py \
@@ -65,7 +65,7 @@ python scripts/gemini_batch_process.py --files docs/assets/[image].png \
   --task analyze \
   --prompt "Extract 5-8 dominant colors with hex codes. Classify as primary/accent/neutral." \
   --output docs/assets/color-palette.md \
-  --model gemini-2.5-flash
+  --model gemma-4-31b-it
 ```
 
 ## Responsive Image Strategies

package/src/claude/skills/frontend-design/references/technical-workflows.md

@@ -24,7 +24,7 @@ python scripts/gemini_batch_process.py \
   suitability for overlaying white text, professional quality.
   List any improvements needed." \
   --output docs/assets/hero-evaluation.md \
-  --model gemini-2.5-flash
+  --model gemma-4-31b-it
 
 # 3. If score ≥ 7/10, optimize for web
 python scripts/media_optimizer.py \
@@ -59,7 +59,7 @@ python scripts/gemini_batch_process.py \
   --task analyze \
   --prompt "[use extraction prompt from extraction-prompts.md]" \
   --output docs/design-guidelines/competitor-analysis.md \
-  --model gemini-2.5-flash
+  --model gemma-4-31b-it
 
 # 2. Generate asset based on extracted guidelines
 # (Review competitor-analysis.md for color palette, aesthetic)
@@ -77,7 +77,7 @@ python scripts/gemini_batch_process.py \
   --prompt "Compare to competitor design. Rate differentiation (1-10).
   Are we too similar or successfully distinct?" \
   --output docs/assets/differentiation-analysis.md \
-  --model gemini-2.5-flash
+  --model gemma-4-31b-it
 
 # 4. Extract colors from our final asset for CSS
 python scripts/gemini_batch_process.py \
@@ -85,7 +85,7 @@ python scripts/gemini_batch_process.py \
   --task analyze \
   --prompt "[use color extraction prompt from visual-analysis-overview.md]" \
   --output docs/assets/color-palette.md \
-  --model gemini-2.5-flash
+  --model gemma-4-31b-it
 ```
 
 ## Example 3: A/B Test Assets
@@ -116,7 +116,7 @@ python scripts/gemini_batch_process.py \
   3. Conversion potential
   Recommend which to test." \
   --output docs/assets/ab-comparison.md \
-  --model gemini-2.5-flash
+  --model gemma-4-31b-it
 
 # Generate production version of winner
 python scripts/gemini_batch_process.py \
@@ -146,5 +146,5 @@ python scripts/gemini_batch_process.py \
   --task analyze \
   --prompt "Rank these variations 1-3 with scores. Identify winner." \
   --output docs/assets/batch-analysis.md \
-  --model gemini-2.5-flash
+  --model gemma-4-31b-it
 ```

package/src/claude/skills/frontend-design/references/visual-analysis-overview.md

@@ -19,7 +19,7 @@ python scripts/gemini_batch_process.py \
   --task analyze \
   --prompt "[see analysis-prompts.md for detailed prompt]" \
   --output docs/assets/analysis-report.md \
-  --model gemini-2.5-flash
+  --model gemma-4-31b-it
 ```
 
 ### Compare Multiple Variations
@@ -29,7 +29,7 @@ python scripts/gemini_batch_process.py \
   --task analyze \
   --prompt "[see analysis-prompts.md for comparison prompt]" \
   --output docs/assets/comparison-analysis.md \
-  --model gemini-2.5-flash
+  --model gemma-4-31b-it
 ```
 
 ### Extract Color Palette
@@ -39,7 +39,7 @@ python scripts/gemini_batch_process.py \
   --task analyze \
   --prompt "Extract 5-8 dominant colors with hex codes. Classify as primary/accent/neutral. Suggest CSS variable names." \
   --output docs/assets/color-palette.md \
-  --model gemini-2.5-flash
+  --model gemma-4-31b-it
 ```
 
 ## Decision Framework

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

@@ -25,7 +25,7 @@ Fast, token-efficient codebase discovery using parallel agents to find files nee
 - Starting debugging session requiring file relationships understanding
 - User asks about project structure or where functionality lives
 - Before changes that might affect multiple codebase parts
-- Before review/debug/impact-analysis when affected files are unclear
+- Before review/debug/impact analysis when affected files are unclear
 
 ## Preflight Scope Gate (MANDATORY - All Modes)
 
@@ -122,12 +122,12 @@ Read from `.claude/runtime.json`:
 ```json
 {
   "gemini": {
-    "model": "gemini-3-flash-preview"
+    "model": "gemma-4-31b-it"
   }
 }
 ```
 
-Default model: `gemini-3-flash-preview`
+Default model: `gemma-4-31b-it`
 
 **Note:** This file is automatically installed when you run `npx @haposoft/cafekit`.
 

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

@@ -15,12 +15,12 @@ Read from `.claude/runtime.json`:
 ```json
 {
   "gemini": {
-    "model": "gemini-3-flash-preview"
+    "model": "gemma-4-31b-it"
   }
 }
 ```
 
-Default model: `gemini-3-flash-preview`
+Default model: `gemma-4-31b-it`
 
 **Note:** This file is automatically installed when you run `npx @haposoft/cafekit`.
 
@@ -48,7 +48,7 @@ gemini -y -m <model> "[prompt]"
 
 ### Example
 ```bash
-gemini -y -m gemini-3-flash-preview "Search src/ for authentication files. List paths with brief descriptions."
+gemini -y -m gemma-4-31b-it "Search src/ for authentication files. List paths with brief descriptions."
 ```
 
 ## Installation Check
@@ -67,9 +67,9 @@ If not installed, ask user:
 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.
 
 ```
-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]'
+Bash: gemini -y -m gemma-4-31b-it '[prompt1]'
+Bash: gemini -y -m gemma-4-31b-it '[prompt2]'
+Bash: gemini -y -m gemma-4-31b-it '[prompt3]'
 ```
 
 Group by independent scopes so each command can return a focused report.
@@ -109,9 +109,9 @@ User: "Find database migration files" with `ext`
 
 Run 3 scoped Gemini CLI commands:
 ```
-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'
+Bash: gemini -y -m gemma-4-31b-it 'Search db/, migrations/ for migration files'
+Bash: gemini -y -m gemma-4-31b-it 'Search lib/, src/ for database schema files'
+Bash: gemini -y -m gemma-4-31b-it 'Search config/ for database configuration'
 ```
 
 ## Reading File Content

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

@@ -7,7 +7,7 @@ when_to_use: "Invoke to read, extract, or generate PDF documents."
 category: document-skills
 keywords: [pdf, extract, document, generate]
 metadata:
-  author: haposoft
+  author: "Anthropic, PBC — adapted by Haposoft"
   version: "1.0.0"
 ---
 # PDF Processing Guide

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

@@ -7,7 +7,7 @@ when_to_use: "Invoke to read, create, or edit PowerPoint .pptx slides."
 category: document-skills
 keywords: [pptx, powerpoint, slides, office]
 metadata:
-  author: haposoft
+  author: "Anthropic, PBC — adapted by Haposoft"
   version: "1.0.0"
 ---
 # PPTX creation, editing, and analysis

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

@@ -161,7 +161,7 @@ Load `references/translation-mirror.md`. This is the only language feature in th
 ### When called WITH `--validate` argument
 
 System IMMEDIATELY jumps to **Step 8: Validation Review**.
-The system MUST NOT execute Steps 1-8. Instead, load `references/review.md` and follow it **step-by-step**.
+The system MUST NOT execute Steps 1-7. Instead, load `references/review.md` and follow it **step-by-step**.
 
 #### `--validate` Guardrails (NON-NEGOTIABLE)
 

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

@@ -7,7 +7,7 @@ when_to_use: "Invoke to read, create, or edit Excel .xlsx spreadsheets."
 category: document-skills
 keywords: [xlsx, excel, spreadsheet, office]
 metadata:
-  author: haposoft
+  author: "Anthropic, PBC — adapted by Haposoft"
   version: "1.0.0"
 ---
 # Requirements for Outputs

package/src/opencode/AGENTS.md

@@ -25,7 +25,6 @@ Use these OpenCode commands:
 - `/hotfix <issue>`: apply a narrow, scout-first production fix.
 - `/docs [--init|--update|--summarize|--reconstruct]`: maintain or reconstruct project docs.
 - `/inspect <target>`: inspect source, artifacts, or external context.
-- `/generate-graph <request>`: generate technical diagrams.
 
 The underlying CafeKit skills are still named `hapo:*` in their documentation. In OpenCode, use the commands above; each command reads the matching skill from `.opencode/skills/<skill>/SKILL.md`.
 
@@ -82,7 +81,7 @@ Use this loop for non-trivial work:
 
 - Claude Code hooks/statusline/settings do not run in OpenCode.
 - Treat `.claude/rules/*` as explicit reference material, not injected hook context.
-- When a skill says to use unavailable Claude-specific tools such as `Task`, `TodoWrite`, or `AskUserQuestion`, use OpenCode's agent/subtask flow, a concise markdown checklist, or ask the user directly.
+- Map Claude-specific tools to OpenCode built-ins: `TodoWrite` → the `todowrite` tool; `AskUserQuestion` → the `question` tool; `Task` → OpenCode's agent/subtask flow.
 - Privacy and inspect gates are instruction-level gates in OpenCode unless a project-specific OpenCode plugin adds hard enforcement.
 
 ## Operating Discipline

package/src/opencode/plugins/session.ts

@@ -153,9 +153,9 @@ function handleSessionCreated(cwd: string): void {
 function handleSessionCompacted(cwd: string): void {
   const lines = [
     "🚨 SESSION COMPRESSED — VERIFY PENDING AUTHORIZATIONS:",
-    "Any pending confirmations requested via AskUserQuestion might have been lost.",
+    "Any pending confirmations requested via the question tool might have been lost.",
     "Do not proceed without explicitly asking the user again to ensure safety.",
-    'Use AskUserQuestion: "The chat context was compressed. Do I still have permission to proceed?"',
+    'Use the question tool: "The chat context was compressed. Do I still have permission to proceed?"',
   ];
   writeBannerSection(cwd, lines.join("\n"));
   console.error(lines.join("\n"));