opencodekit 0.2.1 → 0.2.3

package/README.md

@@ -247,6 +247,7 @@ You've successfully set up OpenCodeKit when:
 - **Custom Commands**: `.opencode/command/` - All 45+ workflow commands
 - **Skills System**: `.opencode/skills/` - 24 skills (8 core, 7 stack, 9 specialized)
 - **Memory System**: `.opencode/memory/` - Persistent cross-session knowledge
+- **Templates**: `.opencode/memory/_templates/` - PRD and task templates for `/create` and `/issue` commands
 
 ---
 

package/dist/index.js

@@ -750,7 +750,7 @@ var cac = (name = "") => new CAC(name);
 // package.json
 var package_default = {
   name: "opencodekit",
-  version: "0.2.1",
+  version: "0.2.3",
   description: "CLI tool for bootstrapping and managing OpenCodeKit projects",
   type: "module",
   repository: {
@@ -2896,7 +2896,7 @@ var OPENCODE_THEMES = [
   { value: "one-dark", label: "One Dark", hint: "atom inspired" },
   { value: "orng", label: "Orng", hint: "orange accent" },
   { value: "palenight", label: "Palenight", hint: "purple dark" },
-  { value: "rosepine", label: "Rosé Pine", hint: "soft pink" },
+  { value: "rosepine", label: "Rose Pine", hint: "soft pink" },
   { value: "solarized", label: "Solarized", hint: "precision colors" },
   { value: "synthwave84", label: "Synthwave '84", hint: "retro neon" },
   { value: "tokyonight", label: "Tokyo Night", hint: "vibrant dark" },
@@ -2908,6 +2908,7 @@ async function editTheme(configPath) {
   const config = loadConfig(configPath);
   const currentTheme = config.theme || "system";
   f2.info(`Current theme: ${import_picocolors7.default.cyan(currentTheme)}`);
+  const validTheme = OPENCODE_THEMES.some((t) => t.value === currentTheme) ? currentTheme : "system";
   const selectedTheme = await ie({
     message: "Select theme",
     options: OPENCODE_THEMES.map((t) => ({
@@ -2915,7 +2916,7 @@ async function editTheme(configPath) {
       label: t.label,
       hint: t.hint
     })),
-    initialValue: currentTheme
+    initialValue: validTheme
   });
   if (lD(selectedTheme)) {
     ue("Cancelled");

package/dist/template/.opencode/.env.example

@@ -5,7 +5,7 @@
 # ============================================================================
 
 # Configure bash command timeout (default: 120000ms = 2 minutes)
-OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS=300000
+export OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS=300000
 export OPENCODE_DISABLE_AUTOCOMPACT=0  # Disable broken compaction
 export OPENCODE_DISABLE_PRUNE=0        # Disable potentially buggy pruning
 export OPENCODE_EXPERIMENTAL_TURN_SUMMARY=1

package/dist/template/.opencode/AGENTS.md

@@ -21,6 +21,7 @@
 | External research | @scout      | research, compare, docs for, API for, best practices |
 | Code review/debug | @review     | review, audit, debug, why broken, root cause         |
 | Architecture      | @planner    | design, architect, plan, structure, phases           |
+| UI/UX design      | @designer   | mockup, UI review, accessibility, aesthetics, visual |
 
 **Execute directly**: Single-file edits, explicit commands, answering from loaded context.
 

package/dist/template/.opencode/agent/build.md

@@ -73,3 +73,4 @@ Before claiming completion:
 - Library docs/patterns → @scout
 - Code review/debugging → @review
 - Architecture planning → @planner
+- UI/UX analysis, mockups → @designer

package/dist/template/.opencode/agent/designer.md

@@ -0,0 +1,148 @@
+---
+description: UI/UX design specialist for mockup analysis, design system research, and aesthetic guidance. Use this agent for visual analysis, accessibility audits, and anti-AI-slop design recommendations.
+mode: subagent
+temperature: 0.3
+tools:
+  bash: true
+  edit: false
+  write: false
+  patch: false
+  glob: true
+  grep: true
+  read: true
+  list: true
+  webfetch: true
+  websearch: true
+  task: true
+  todowrite: true
+  todoread: true
+  gkg*: true
+  context7*: true
+  codesearch: true
+  gh_grep*: true
+  memory-read: true
+  memory-update: true
+---
+
+# Designer Agent
+
+UI/UX design specialist for mockup analysis, design system research, and aesthetic guidance.
+
+## Strengths
+
+- Mockup and screenshot analysis via Gemini CLI
+- Design system audit and consistency review
+- Accessibility assessment (WCAG compliance)
+- Typography, color, and motion guidance
+- Anti-AI-slop aesthetic recommendations
+
+## Guidelines
+
+- Use `gemini-cli` with `gemini-3-pro-image-preview` model for image analysis
+- Apply `frontend-aesthetics` skill to avoid generic AI aesthetics
+- Apply `ui-ux-research` skill for systematic design analysis
+- Read-only role: analyze and recommend, don't implement
+- Delegate implementation to @build agent
+- Keep responses focused on actionable design guidance
+
+## Gemini CLI Usage
+
+### Image Analysis (Mockups, Screenshots)
+
+Start interactive mode for image analysis:
+
+```bash
+gemini
+```
+
+Then reference the image:
+
+```
+@mockup.png Analyze this UI design for:
+1. Typography choices and hierarchy
+2. Color palette and contrast
+3. Spacing and layout consistency
+4. Accessibility concerns
+5. Areas that feel "AI-generated" or generic
+```
+
+### Codebase-Wide Design Audit
+
+For scanning component directories:
+
+```bash
+gemini -p "@src/components/ Audit the design system for consistency in typography, colors, spacing, and component patterns"
+```
+
+### Model Selection
+
+- Default: `gemini-3-pro-image-preview` (best for visual analysis)
+- Alternative: `gemini -m gemini-2.5-flash` for faster, simpler queries
+
+## Design Principles
+
+### Avoid AI Slop
+
+Watch for these generic patterns:
+
+- Inter/Roboto as primary fonts
+- Purple/blue gradients everywhere
+- Flat white backgrounds with no texture
+- Stock illustration style
+- No micro-interactions or motion
+- Cookie-cutter card layouts
+
+### Recommend Instead
+
+- Distinctive typography (GT Walsheim, Söhne, custom fonts)
+- Purposeful color with texture and depth
+- Atmospheric backgrounds with subtle gradients
+- Meaningful animations and transitions
+- Layout variety and visual hierarchy
+- Brand-appropriate iconography
+
+## Accessibility Checklist
+
+- [ ] Color contrast meets WCAG AA (4.5:1 for text)
+- [ ] Focus indicators visible
+- [ ] Touch targets >= 44px
+- [ ] Motion respects prefers-reduced-motion
+- [ ] ARIA labels on interactive elements
+- [ ] Keyboard navigation works
+
+## Tool Priority
+
+1. **Gemini CLI** for image and large codebase analysis
+2. **Read/Glob** for component and style inspection
+3. **Webfetch/Websearch** for design inspiration and patterns
+
+## Output Format
+
+Provide design feedback as:
+
+1. **Summary**: Overall assessment (1-2 sentences)
+2. **Issues**: Specific problems found with severity
+3. **Recommendations**: Actionable fixes with code examples where helpful
+4. **References**: Links to design patterns or inspiration if relevant
+
+## Delegation
+
+- Implementation work → @build
+- External library research → @scout
+- Code review after changes → @review
+
+## DO
+
+- Analyze images thoroughly before providing feedback
+- Reference specific elements (colors, fonts, spacing values)
+- Provide before/after comparisons when suggesting changes
+- Consider responsive design implications
+- Check accessibility for all recommendations
+
+## DON'T
+
+- Write or edit code directly (delegate to @build)
+- Make generic suggestions without specifics
+- Ignore accessibility in pursuit of aesthetics
+- Recommend trends without considering brand fit
+- Skip mobile/responsive considerations

package/dist/template/.opencode/agent/rush.md

@@ -73,6 +73,7 @@ Before mutations (edit, write, delete):
 | Library docs, patterns  | @scout      |
 | Code review, debugging  | @review     |
 | Architecture, 3+ phases | @planner    |
+| UI/UX, mockups, visuals | @designer   |
 
 ## Execute Directly
 

package/dist/template/.opencode/command/create.md

@@ -56,40 +56,64 @@ bd create "[title]" -t [type] -p [priority] -d "[description]" --json
 mkdir -p .beads/artifacts/<bead-id>
 ```
 
+Use the PRD template from `.opencode/memory/_templates/task-prd.md` as the base structure.
+
 Write `.beads/artifacts/<bead-id>/spec.md`:
 
 ```markdown
 # [Title]
 
 **Bead:** <bead-id>
-**Mode:** [Quick/Deep]
+**Created:** [date]
+**Status:** To Do
+
+## Goal
+
+[1-2 sentences: What exactly are we building and why?]
+
+## Scope
 
-## Problem
+### In-Scope:
 
-[1-2 sentences]
+- [What we ARE doing]
 
-## Requirements
+### Out-of-Scope:
 
-- [Requirement 1]
-- [Requirement 2]
+- [What we are NOT doing]
+
+## User Flow
+
+1. [Step 1: What user sees/does]
+2. [Step 2]
+3. [Step 3]
 
 ## Success Criteria
 
-- [ ] [Criterion 1]
-- [ ] [Criterion 2]
+- [ ] [Specific, measurable criterion 1]
+- [ ] [Specific, measurable criterion 2]
+- [ ] [Specific, measurable criterion 3]
+
+## Dependencies
+
+- [List any prerequisites or blocking tasks]
+
+## Notes
+
+[Additional context or constraints]
 ```
 
+For **Quick** mode, simplify: Goal, Success Criteria, Notes only.
+
 For **Deep** mode, add:
 
 ```markdown
-## Scope
-
-**In:** [What we ARE doing]
-**Out:** [What we are NOT doing]
-
 ## Open Questions
 
 - [Question for research phase]
+
+## Technical Approach
+
+[To be filled during /research phase]
 ```
 
 ## Phase 5: Report

package/dist/template/.opencode/command/design.md

@@ -1,7 +1,7 @@
 ---
 description: Design with brainstorming
 argument-hint: "[topic or task-id]"
-agent: review
+agent: designer
 ---
 
 # Design: $ARGUMENTS

package/dist/template/.opencode/command/fix-ui.md

@@ -8,10 +8,10 @@ agent: build
 
 use_skill("frontend-aesthetics")
 
-1. **Analyze:**
-   - If screenshots/videos provided, describe issue in detail
-   - For large UI analysis, use Gemini CLI: `gemini` then `@[image] Analyze issue`
-2. **Research:** Check design guidelines, component patterns
+1. **Analyze:** Delegate to @designer for initial assessment
+   - If screenshots/videos provided, @designer describes issue in detail
+   - For large UI analysis, @designer uses Gemini CLI: `gemini` then `@[image] Analyze issue`
+2. **Research:** @designer checks design guidelines, component patterns
    - Apply `frontend-aesthetics` criteria (typography, color, motion, backgrounds)
 3. **Fix:** Implement step by step
    - Avoid generic AI aesthetics (Inter font, purple gradients, flat backgrounds)

package/dist/template/.opencode/command/issue.md

@@ -33,26 +33,55 @@ Save the bead ID for subsequent commands. Add the GitHub issue reference:
 bd edit <bead-id> --note "GitHub issue: #$ARGUMENTS"
 ```
 
-## Implementation Plan
+## Create Spec from PRD Template
+
+Use `.opencode/memory/_templates/task-prd.md` as the base structure.
 
 Save to `.beads/artifacts/<bead-id>/spec.md`:
 
-1. **Files to change:** Identify affected code
-2. **Testing strategy:** How to verify fix
-3. **Risks/edge cases:** What could go wrong
+```markdown
+# [Issue Title]
+
+**Bead:** <bead-id>
+**Created:** [date]
+**Status:** To Do
+**GitHub Issue:** #$ARGUMENTS
+
+## Goal
+
+[What exactly are we fixing/building and why?]
+
+## Scope
+
+### In-Scope:
+
+- [Files to change]
+- [Specific functionality to fix/add]
 
-## Action Plan
+### Out-of-Scope:
 
-1. Create branch: `git checkout -b issue-$ARGUMENTS`
-2. Implementation steps (ordered)
-3. Testing approach
-4. Documentation updates
+- [What we are NOT touching]
 
-## Acceptance Criteria
+## User Flow
 
-- [ ] Concrete deliverables
-- [ ] Test cases to verify
-- [ ] Performance considerations
+1. [How user encounters the issue]
+2. [Expected behavior after fix]
+
+## Success Criteria
+
+- [ ] [Specific fix verified]
+- [ ] [Test cases pass]
+- [ ] [No regression]
+
+## Dependencies
+
+- [List any prerequisites or blocking tasks]
+
+## Notes
+
+- **Risks/edge cases:** [What could go wrong]
+- **Testing strategy:** [How to verify fix]
+```
 
 ## Discovered Work
 

package/dist/template/.opencode/command/research-ui.md

@@ -1,7 +1,7 @@
 ---
 description: Large-scale UI/UX research using Gemini CLI with bead artifact storage
 argument-hint: "[bead-id] [research topic or path]"
-agent: review
+agent: designer
 ---
 
 # Research UI: $ARGUMENTS

package/dist/template/.opencode/command/ui-review.md

@@ -1,7 +1,7 @@
 ---
 description: Review UI/UX design or mockup with optional bead tracking
 argument-hint: "[bead-id] [path to image or component]"
-agent: review
+agent: designer
 ---
 
 # UI Review: $ARGUMENTS

package/dist/template/.opencode/opencode.json

@@ -1,23 +1,23 @@
 {
   "$schema": "https://opencode.ai/config.json",
   "agent": {
-    "general": {
-      "disable": true
-    },
-    "plan": {
-      "disable": true
-    },
     "build": {
       "description": "Primary development agent with full codebase access",
       "model": "proxypal/gemini-claude-opus-4-5-thinking"
     },
-    "rush": {
-      "description": "Fast primary agent for small, well-defined tasks",
-      "model": "zai-coding-plan/glm-4.6"
+    "designer": {
+      "description": "UI/UX design specialist for mockup analysis and aesthetic guidance",
+      "model": "proxypal/gemini-3-pro-preview"
     },
     "explore": {
       "description": "Fast codebase search specialist"
     },
+    "general": {
+      "disable": true
+    },
+    "plan": {
+      "disable": true
+    },
     "planner": {
       "description": "Strategic planning agent for architecture and design",
       "model": "proxypal/gpt-5.2"
@@ -26,6 +26,10 @@
       "description": "Code review, debugging, and security audit specialist",
       "model": "proxypal/gemini-2.5-flash-lite"
     },
+    "rush": {
+      "description": "Fast primary agent for small, well-defined tasks",
+      "model": "zai-coding-plan/glm-4.6"
+    },
     "scout": {
       "description": "External research specialist for library docs and patterns",
       "model": "proxypal/gemini-claude-sonnet-4-5"
@@ -82,6 +86,7 @@
       "headers": {
         "CONTEXT7_API_KEY": "{env:CONTEXT7_API_KEY}"
       },
+      "timeout": 10000,
       "type": "remote",
       "url": "https://mcp.context7.com/mcp"
     },
@@ -424,3 +429,4 @@
     ]
   }
 }
+

package/dist/template/.opencode/package.json

@@ -11,7 +11,7 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "@opencode-ai/plugin": "1.0.152"
+    "@opencode-ai/plugin": "1.0.153"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencodekit",
-	"version": "0.2.1",
+	"version": "0.2.3",
 	"description": "CLI tool for bootstrapping and managing OpenCodeKit projects",
 	"type": "module",
 	"repository": {