opencodekit 0.3.3 → 0.5.0

package/dist/template/.opencode/command/revert-feature.md

@@ -0,0 +1,127 @@
+---
+description: Smart git-aware revert for a bead/feature
+argument-hint: "<bead-id> [--phase=N] [--task=N] [--soft]"
+agent: build
+model: proxypal/gemini-3-flash-preview
+---
+
+# Revert Feature: $ARGUMENTS
+
+Intelligently revert changes for a bead with git awareness.
+
+## Instructions
+
+Parse from `$ARGUMENTS`:
+
+- Bead ID (required)
+- `--phase=N`: Revert only specific phase
+- `--task=N`: Revert only specific task
+- `--soft`: Stage reverts without committing
+
+## Workflow
+
+### Step 1: Analyze Bead History
+
+```bash
+bd show [bead-id] --history
+```
+
+Identify:
+
+- All commits associated with this bead
+- Files changed per phase/task
+- Current phase and task
+
+### Step 2: Determine Revert Scope
+
+**Full revert (no flags):**
+
+- All commits for this bead
+- Reset bead status to initial
+
+**Phase revert (--phase=N):**
+
+- Only commits tagged with phase N
+- Reset bead to previous phase
+
+**Task revert (--task=N):**
+
+- Only commits for specific task
+- Keep bead in current phase
+
+### Step 3: Git Analysis
+
+```bash
+# Find commits for this bead
+git log --oneline --all --grep="[bead-id]"
+
+# Show files that would be affected
+git diff --stat [commit-range]
+```
+
+Present:
+
+- Commits to revert
+- Files affected
+- Potential conflicts
+
+### Step 4: Confirm and Execute
+
+Ask for confirmation before reverting.
+
+**Hard revert (default):**
+
+```bash
+git revert --no-commit [commits...]
+git commit -m "revert: [bead-id] [scope]"
+```
+
+**Soft revert (--soft):**
+
+```bash
+git revert --no-commit [commits...]
+# Leave changes staged for review
+```
+
+### Step 5: Update Bead
+
+```bash
+bd update [bead-id] --status reverted --note "Reverted [scope]"
+```
+
+## Safety Checks
+
+Before reverting:
+
+- [ ] Check for uncommitted changes
+- [ ] Verify bead exists and has commits
+- [ ] Check for dependent beads
+- [ ] Identify potential merge conflicts
+
+If conflicts detected:
+
+1. List conflicting files
+2. Offer to abort or continue with manual resolution
+3. Provide conflict resolution guidance
+
+## Output
+
+Report:
+
+- Commits reverted
+- Files restored
+- Bead status updated
+- Next steps
+
+## Related Commands
+
+```bash
+# View bead history
+bd show [bead-id] --history
+
+# Check current status
+bd status
+
+# Re-implement after revert
+/implement [bead-id]
+```

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

@@ -1,52 +1,44 @@
 ---
-description: Review UI/UX design or mockup with optional bead tracking
-argument-hint: "[bead-id] [path to image or component]"
+description: Review UI/UX design for quality and aesthetics
+argument-hint: "<image-or-component-path> [bead-id]"
 agent: vision
+model: proxypal/gemini-3-pro-preview
 ---
 
 # UI Review: $ARGUMENTS
 
-use_skill("ui-ux-research")
 use_skill("frontend-aesthetics")
+use_skill("visual-analysis")
 
-## Parse Arguments
+Review UI/UX design for quality, aesthetics, and best practices.
 
-Extract bead ID (if provided) and path/component from `$ARGUMENTS`. If a bead ID is present, findings will be recorded to the bead.
+## Instructions
 
-## How to Analyze
+Parse image/component path and optional bead ID from `$ARGUMENTS`.
 
-First, determine what you're reviewing. If it's an image or screenshot, start Gemini in interactive mode and reference the image to analyze it. If it's component code, analyze it directly with local tools. For large codebases spanning many files, use Gemini's non-interactive mode to scan the entire directory.
+## What to Evaluate
 
-## What to Look For
+1. **Typography** - Avoid generic fonts (Inter/Roboto without purpose)
+2. **Colors** - Check for overused AI patterns (purple gradients, flat white)
+3. **Layout** - Hierarchy, spacing, visual rhythm
+4. **Motion** - Micro-interactions, transitions
+5. **Atmosphere** - Texture, depth, personality
+6. **Accessibility** - Contrast, focus states, ARIA
 
-Check typography first—generic fonts like Inter or Roboto are signs of "AI slop" aesthetics. Look at the color palette for overused patterns like purple gradients or flat white backgrounds. Assess whether the UI has any motion or micro-interactions, and whether backgrounds feel atmospheric or just flat.
+## Anti-Patterns to Flag
 
-For accessibility, verify color contrast meets WCAG AA minimum, check for ARIA labels on interactive elements, ensure keyboard navigation works, and confirm focus indicators are visible.
+- Cookie-cutter card layouts
+- Excessive rounded corners
+- Glassmorphism without purpose
+- Generic stock illustration style
 
-## Recommendations
-
-Provide specific, actionable improvements: suggest alternative fonts, propose color palette changes, identify opportunities for subtle animations, and recommend layout enhancements. Include code snippets when they would help clarify the suggestion.
-
-## Record Findings
-
-### With Bead ID
-
-Update the bead with review findings:
-
-```bash
-bd edit <bead-id> --note "UI Review: <summary of issues found and recommendations>"
-```
-
-If review reveals implementation tasks, create child beads:
-
-```bash
-bd create --title "<specific UI fix>" --type task --parent <bead-id>
-```
-
-### Without Bead ID
+## Output
 
-Output findings directly to the user.
+Provide:
 
-## Output
+1. Summary of issues found
+2. Specific actionable recommendations
+3. Code snippets for improvements
+4. Before/after suggestions
 
-Summarize what issues you found, what specific changes you recommend, and show before/after comparisons for significant improvements.
+If bead ID provided, record findings to the bead.

package/dist/template/.opencode/memory/project/README.md

@@ -0,0 +1,59 @@
+---
+purpose: Persistent project knowledge that survives across sessions
+updated: 2024-12-21
+---
+
+# Project Memory
+
+This directory stores persistent project knowledge that agents use across sessions.
+
+## Standard Files
+
+| File              | Purpose                                 | Update When             |
+| ----------------- | --------------------------------------- | ----------------------- |
+| `commands.md`     | Build, test, lint, deploy commands      | Discover new command    |
+| `conventions.md`  | Code patterns, commit style, PR process | Learn team pattern      |
+| `gotchas.md`      | Footguns, edge cases, warnings          | Hit unexpected behavior |
+| `architecture.md` | Key modules, directory structure        | Map new area            |
+
+## File Format
+
+Each file uses YAML frontmatter:
+
+```yaml
+---
+purpose: How this memory should influence agent behavior
+updated: YYYY-MM-DD
+---
+```
+
+## How Agents Use This
+
+- **Session start**: Agents read relevant memory files for context
+- **During work**: Agents update files when learning new information
+- **Session end**: Critical learnings persisted here survive context reset
+
+## Integration
+
+### With Commands
+
+- `/implement` - Reads conventions for code style
+- `/setup-project` - Populates these files initially
+- `/review-codebase` - Checks against conventions
+
+### With Beads
+
+```bash
+bd new feature "Add auth" --context .opencode/memory/project/
+```
+
+## Philosophy
+
+**Don't rely on implicit learning.** When agents discover:
+
+- Non-obvious behavior → Update `gotchas.md`
+- New commands → Update `commands.md`
+- Code patterns → Update `conventions.md`
+- Architecture insights → Update `architecture.md`
+
+Explicit memory beats hoping the agent remembers.

package/dist/template/.opencode/memory/project/architecture.md

@@ -0,0 +1,26 @@
+---
+purpose: Key modules, directory structure, architectural decisions
+updated: 2024-12-21
+---
+
+# Project Architecture
+
+## Directory Structure
+
+<!-- Key directories and their purpose -->
+
+## Key Modules
+
+<!-- Core files/modules and what they do -->
+
+## Data Flow
+
+<!-- How data moves through the system -->
+
+## External Dependencies
+
+<!-- Critical third-party services, APIs -->
+
+## Architectural Decisions
+
+<!-- Why things are structured this way -->

package/dist/template/.opencode/memory/project/commands.md

@@ -0,0 +1,26 @@
+---
+purpose: Build, test, lint, deploy commands discovered for this project
+updated: 2024-12-21
+---
+
+# Project Commands
+
+## Build
+
+<!-- npm run build, make, cargo build, etc. -->
+
+## Test
+
+<!-- npm test, pytest, cargo test, etc. -->
+
+## Lint
+
+<!-- npm run lint, ruff check, etc. -->
+
+## Deploy
+
+<!-- Deployment commands if applicable -->
+
+## Other
+
+<!-- Project-specific commands worth remembering -->

package/dist/template/.opencode/memory/project/conventions.md

@@ -0,0 +1,26 @@
+---
+purpose: Code patterns, commit style, PR process, team conventions
+updated: 2024-12-21
+---
+
+# Project Conventions
+
+## Code Style
+
+<!-- Naming conventions, formatting rules, import ordering -->
+
+## Commit Messages
+
+<!-- Conventional commits? Prefix style? -->
+
+## PR Process
+
+<!-- Review requirements, CI checks, merge strategy -->
+
+## Patterns to Follow
+
+<!-- Recurring patterns in this codebase -->
+
+## Patterns to Avoid
+
+<!-- Anti-patterns specific to this project -->

package/dist/template/.opencode/memory/project/gotchas.md

@@ -0,0 +1,26 @@
+---
+purpose: Footguns, edge cases, and "don't forget this" warnings
+updated: 2024-12-21
+---
+
+# Project Gotchas
+
+## Code That Looks Right But Breaks
+
+<!-- Subtle bugs, misleading APIs -->
+
+## Non-Obvious Dependencies
+
+<!-- Hidden coupling, initialization order -->
+
+## Configuration Quirks
+
+<!-- Environment variables, config files that bite -->
+
+## Time Wasters
+
+<!-- Things that will waste 2+ hours if you forget -->
+
+## Platform-Specific Issues
+
+<!-- macOS vs Linux, Node versions, etc. -->

package/dist/template/.opencode/memory/user.example.md

@@ -0,0 +1,21 @@
+---
+purpose: User identity, preferences, communication style
+updated: 2024-12-21
+---
+
+# User Profile
+
+## Identity
+<!-- Name, role, git contributor identity -->
+
+## Communication Preferences
+<!-- Concise vs detailed, tone preferences -->
+
+## Workflow Preferences
+<!-- Preferred tools, testing habits, review style -->
+
+## Technical Preferences
+<!-- Languages, frameworks, patterns they favor -->
+
+## Things to Remember
+<!-- Personal quirks, pet peeves, preferences learned -->

package/dist/template/.opencode/memory/user.md

@@ -0,0 +1,21 @@
+---
+purpose: User identity, preferences, communication style
+updated: 2024-12-21
+---
+
+# User Profile
+
+## Identity
+<!-- Name, role, git contributor identity -->
+
+## Communication Preferences
+<!-- Concise vs detailed, tone preferences -->
+
+## Workflow Preferences
+<!-- Preferred tools, testing habits, review style -->
+
+## Technical Preferences
+<!-- Languages, frameworks, patterns they favor -->
+
+## Things to Remember
+<!-- Personal quirks, pet peeves, preferences learned -->