opencodekit 0.2.3 → 0.2.4

package/README.md

@@ -247,7 +247,8 @@ 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
+- **Templates**: `.opencode/memory/_templates/` - PRD, observation, and session-summary templates
+- **Memory Tools**: `.opencode/tool/` - memory-read, memory-update, memory-search, observation
 
 ---
 

package/dist/index.js

@@ -750,7 +750,7 @@ var cac = (name = "") => new CAC(name);
 // package.json
 var package_default = {
   name: "opencodekit",
-  version: "0.2.3",
+  version: "0.2.4",
   description: "CLI tool for bootstrapping and managing OpenCodeKit projects",
   type: "module",
   repository: {

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

@@ -100,13 +100,53 @@
 
 ```
 .opencode/memory/
-  _templates/     # Task templates
+  _templates/     # Task templates (prd, observation, session-summary)
   handoffs/       # Phase transitions
   research/       # Research findings
+  observations/   # Structured observations
+```
+
+### Memory Tools
+
+| Tool            | Use For                          |
+| --------------- | -------------------------------- |
+| `memory-read`   | Load previous context, templates |
+| `memory-update` | Save learnings, handoffs         |
+| `memory-search` | Search across all memory files   |
+| `observation`   | Create structured observations   |
+
+### Observations
+
+Record important findings with structured metadata:
+
+```
+observation(
+  type: "decision",     # decision, bugfix, feature, pattern, discovery, learning, warning
+  title: "Use JWT auth",
+  content: "Decided to use JWT because...",
+  concepts: "auth, security",
+  files: "src/auth.ts",
+  bead_id: "bd-abc123"
+)
+```
+
+**When to create observations:**
+
+- Major architectural decisions
+- Bug root causes discovered
+- Patterns worth reusing
+- Gotchas and warnings for future
+
+### Memory Search
+
+Find past decisions, research, or handoffs:
+
+```
+memory-search(query: "authentication")
+memory-search(query: "bugfix", type: "observations")
+memory-search(query: "session", type: "handoffs")
 ```
 
-- `memory-read` - Load previous context
-- `memory-update` - Save learnings
 - Task tracking uses Beads (`bd` CLI)
 
 ## Session Management

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

@@ -56,7 +56,7 @@ 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.
+Use the PRD template from `.opencode/memory/_templates/prd.md` as the base structure.
 
 Write `.beads/artifacts/<bead-id>/spec.md`:
 
@@ -116,7 +116,26 @@ For **Deep** mode, add:
 [To be filled during /research phase]
 ```
 
-## Phase 5: Report
+## Phase 5: Review Spec
+
+Present the spec for approval:
+
+```
+Spec Preview:
+━━━━━━━━━━━━━
+
+[Show full spec.md content]
+
+━━━━━━━━━━━━━
+Approve spec? (yes/modify)
+```
+
+**STOP and wait for human response.**
+
+If "modify": Iterate on spec based on feedback until approved.
+If "yes": Proceed to report.
+
+## Phase 6: Report
 
 ```
 Created: <bead-id>

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

@@ -35,7 +35,7 @@ bd edit <bead-id> --note "GitHub issue: #$ARGUMENTS"
 
 ## Create Spec from PRD Template
 
-Use `.opencode/memory/_templates/task-prd.md` as the base structure.
+Use `.opencode/memory/_templates/prd.md` as the base structure.
 
 Save to `.beads/artifacts/<bead-id>/spec.md`:
 

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

@@ -17,9 +17,12 @@ Read artifacts:
 ```bash
 cat .beads/artifacts/<bead-id>/spec.md
 cat .beads/artifacts/<bead-id>/research.md
+cat .beads/artifacts/<bead-id>/design.md 2>/dev/null
 ```
 
-If missing: "Run `/research <bead-id>` first."
+If spec.md missing: "Run `/create <bead-id>` first."
+If research.md missing: "Run `/research <bead-id>` first."
+If design.md exists: Resume from saved design options.
 
 ## Phase 2: Generate Design Options
 
@@ -68,7 +71,77 @@ Present 2-3 approaches:
 **Recommendation:** Option [A/B] because [reason].
 ```
 
-## Phase 3: Get Approval
+## Phase 3: Save Design Document
+
+Save design options to `.beads/artifacts/<bead-id>/design.md`:
+
+```markdown
+# Design Options: [Title]
+
+**Bead:** <bead-id>
+**Date:** <date>
+**Status:** Pending Approval
+
+## Problem Statement
+
+[What we're solving - from spec.md]
+
+## Options Considered
+
+### Option A: [Name]
+
+**Approach:** [1-2 sentence description]
+
+**Changes:**
+
+- `src/foo.ts` - [what changes]
+- `src/bar.ts` - [what changes]
+
+**Pros:**
+
+- [pro 1]
+- [pro 2]
+
+**Cons:**
+
+- [con 1]
+
+**Effort:** [S/M/L]
+
+---
+
+### Option B: [Name]
+
+**Approach:** [1-2 sentence description]
+
+**Changes:**
+
+- `src/baz.ts` - [what changes]
+
+**Pros:**
+
+- [pro 1]
+
+**Cons:**
+
+- [con 1]
+- [con 2]
+
+**Effort:** [S/M/L]
+
+---
+
+## Recommendation
+
+Option [A/B] because [reason].
+
+## Decision
+
+**Chosen:** [To be filled after approval]
+**Rationale:** [To be filled after approval]
+```
+
+## Phase 4: Get Approval
 
 **STOP and wait for human response.**
 
@@ -78,7 +151,15 @@ Pick an option (A/B/C), modify, or "none" to propose alternatives.
 
 Do not proceed until user confirms.
 
-## Phase 4: Create Plan
+## Phase 5: Update Design Decision
+
+After approval, update `.beads/artifacts/<bead-id>/design.md`:
+
+- Change **Status:** to `Approved`
+- Fill in **Chosen:** with selected option
+- Fill in **Rationale:** with user's reasoning
+
+## Phase 6: Create Plan
 
 After approval, write `.beads/artifacts/<bead-id>/plan.md`:
 
@@ -136,7 +217,7 @@ After approval, write `.beads/artifacts/<bead-id>/plan.md`:
 - [Risk 1] - [mitigation]
 ```
 
-## Phase 5: Update Bead
+## Phase 7: Update Bead
 
 ```bash
 bd edit <bead-id> --note "Plan approved: [option name]. [step count] steps."

package/dist/template/.opencode/memory/_templates/observation.md

@@ -0,0 +1,39 @@
+# Observation Template
+
+**Type:** [decision | bugfix | feature | pattern | discovery | learning | warning]
+**Created:** [timestamp]
+**Bead:** [optional bead-id]
+**Concepts:** `tag1`, `tag2`, `tag3`
+**Files:** `path/to/file1.ts`, `path/to/file2.ts`
+
+---
+
+## Context
+
+[What situation prompted this observation? What were you working on?]
+
+## Observation
+
+[The core insight, decision, or learning. Be specific and actionable.]
+
+## Rationale
+
+[Why is this important? What alternatives were considered?]
+
+## Future Reference
+
+[How should this inform future decisions? Any follow-up actions?]
+
+---
+
+## Type Definitions
+
+| Type      | Icon | Use For                              |
+| --------- | ---- | ------------------------------------ |
+| decision  | 🎯   | Architectural or design choices made |
+| bugfix    | 🐛   | Bug root causes and solutions        |
+| feature   | ✨   | Feature implementation notes         |
+| pattern   | 🔄   | Recurring patterns or conventions    |
+| discovery | 💡   | Unexpected findings or insights      |
+| learning  | 📚   | Lessons learned from experience      |
+| warning   | ⚠️   | Pitfalls to avoid, gotchas           |

package/dist/template/.opencode/tool/memory-search.ts

@@ -0,0 +1,140 @@
+import path from "path";
+import { tool } from "@opencode-ai/plugin";
+import fs from "fs/promises";
+
+interface SearchResult {
+	file: string;
+	matches: { line: number; content: string }[];
+}
+
+async function searchDirectory(
+	dir: string,
+	pattern: RegExp,
+	results: SearchResult[],
+	baseDir: string,
+): Promise<void> {
+	try {
+		const entries = await fs.readdir(dir, { withFileTypes: true });
+
+		for (const entry of entries) {
+			const fullPath = path.join(dir, entry.name);
+
+			if (entry.isDirectory()) {
+				// Skip hidden directories except _templates
+				if (entry.name.startsWith(".") && entry.name !== "_templates") {
+					continue;
+				}
+				await searchDirectory(fullPath, pattern, results, baseDir);
+			} else if (entry.name.endsWith(".md")) {
+				const content = await fs.readFile(fullPath, "utf-8");
+				const lines = content.split("\n");
+				const matches: { line: number; content: string }[] = [];
+
+				lines.forEach((line, index) => {
+					if (pattern.test(line)) {
+						matches.push({
+							line: index + 1,
+							content: line.trim().substring(0, 150),
+						});
+					}
+				});
+
+				if (matches.length > 0) {
+					const relativePath = path.relative(baseDir, fullPath);
+					results.push({ file: relativePath, matches });
+				}
+			}
+		}
+	} catch {
+		// Directory doesn't exist or not readable
+	}
+}
+
+export default tool({
+	description:
+		"Search across all memory files using keywords or patterns. Returns matching files with line numbers and context. Useful for finding past decisions, research, or handoffs.",
+	args: {
+		query: tool.schema
+			.string()
+			.describe(
+				"Search query: keywords or regex pattern (e.g., 'authentication', 'bugfix.*session')",
+			),
+		type: tool.schema
+			.string()
+			.optional()
+			.describe(
+				"Filter by type: 'all' (default), 'handoffs', 'research', 'templates', 'observations', 'beads'",
+			),
+		limit: tool.schema
+			.number()
+			.optional()
+			.describe("Max results per file (default: 5)"),
+	},
+	execute: async (args: { query: string; type?: string; limit?: number }) => {
+		const memoryDir = path.join(process.cwd(), ".opencode/memory");
+		const beadsDir = path.join(process.cwd(), ".beads/artifacts");
+		const globalMemoryDir = path.join(
+			process.env.HOME || "",
+			".config/opencode/memory",
+		);
+
+		const limit = args.limit || 5;
+
+		// Create case-insensitive regex from query
+		let pattern: RegExp;
+		try {
+			pattern = new RegExp(args.query, "i");
+		} catch {
+			// Escape special chars if not valid regex
+			const escaped = args.query.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+			pattern = new RegExp(escaped, "i");
+		}
+
+		const results: SearchResult[] = [];
+
+		// Handle type filtering
+		if (args.type === "beads") {
+			// Search only bead artifacts
+			await searchDirectory(beadsDir, pattern, results, beadsDir);
+		} else if (args.type && args.type !== "all") {
+			const typeMap: Record<string, string> = {
+				handoffs: "handoffs",
+				research: "research",
+				templates: "_templates",
+				observations: "observations",
+			};
+			const subdir = typeMap[args.type];
+			if (subdir) {
+				const searchDir = path.join(memoryDir, subdir);
+				await searchDirectory(searchDir, pattern, results, memoryDir);
+			}
+		} else {
+			// Search all: memory + beads
+			await searchDirectory(memoryDir, pattern, results, memoryDir);
+			await searchDirectory(beadsDir, pattern, results, beadsDir);
+			await searchDirectory(globalMemoryDir, pattern, results, globalMemoryDir);
+		}
+
+		if (results.length === 0) {
+			return `No matches found for "${args.query}" in memory files.\n\nTip: Try broader search terms or check available types: handoffs, research, templates, observations, beads`;
+		}
+
+		// Build output
+		let output = `# Memory Search: "${args.query}"\n\n`;
+		output += `Found ${results.length} file(s) with matches.\n\n`;
+
+		for (const result of results) {
+			output += `## ${result.file}\n\n`;
+			const matchesToShow = result.matches.slice(0, limit);
+			for (const match of matchesToShow) {
+				output += `- **Line ${match.line}:** ${match.content}\n`;
+			}
+			if (result.matches.length > limit) {
+				output += `- ... and ${result.matches.length - limit} more matches\n`;
+			}
+			output += "\n";
+		}
+
+		return output;
+	},
+});

package/dist/template/.opencode/tool/observation.ts

@@ -0,0 +1,155 @@
+import path from "path";
+import { tool } from "@opencode-ai/plugin";
+import fs from "fs/promises";
+
+// Observation types following claude-mem patterns
+type ObservationType =
+	| "decision"
+	| "bugfix"
+	| "feature"
+	| "pattern"
+	| "discovery"
+	| "learning"
+	| "warning";
+
+const TYPE_ICONS: Record<ObservationType, string> = {
+	decision: "🎯",
+	bugfix: "🐛",
+	feature: "✨",
+	pattern: "🔄",
+	discovery: "💡",
+	learning: "📚",
+	warning: "⚠️",
+};
+
+export default tool({
+	description:
+		"Create a structured observation for future reference. Observations are categorized by type (decision, bugfix, feature, pattern, discovery, learning, warning) and stored in .opencode/memory/observations/.",
+	args: {
+		type: tool.schema
+			.string()
+			.describe(
+				"Observation type: decision, bugfix, feature, pattern, discovery, learning, warning",
+			),
+		title: tool.schema.string().describe("Brief title for the observation"),
+		content: tool.schema
+			.string()
+			.describe("Detailed observation content with context"),
+		concepts: tool.schema
+			.string()
+			.optional()
+			.describe(
+				"Comma-separated concept tags (e.g., 'authentication, oauth, security')",
+			),
+		files: tool.schema
+			.string()
+			.optional()
+			.describe(
+				"Comma-separated related files (e.g., 'src/auth.ts, src/login.ts')",
+			),
+		bead_id: tool.schema
+			.string()
+			.optional()
+			.describe("Related bead ID for traceability"),
+	},
+	execute: async (args: {
+		type: string;
+		title: string;
+		content: string;
+		concepts?: string;
+		files?: string;
+		bead_id?: string;
+	}) => {
+		const obsDir = path.join(process.cwd(), ".opencode/memory/observations");
+
+		// Validate type
+		const validTypes: ObservationType[] = [
+			"decision",
+			"bugfix",
+			"feature",
+			"pattern",
+			"discovery",
+			"learning",
+			"warning",
+		];
+		const obsType = args.type.toLowerCase() as ObservationType;
+		if (!validTypes.includes(obsType)) {
+			return `Error: Invalid observation type '${args.type}'.\nValid types: ${validTypes.join(", ")}`;
+		}
+
+		// Generate filename: YYYY-MM-DD-type-slug.md
+		const now = new Date();
+		const dateStr = now.toISOString().split("T")[0];
+		const slug = args.title
+			.toLowerCase()
+			.replace(/[^a-z0-9]+/g, "-")
+			.replace(/^-|-$/g, "")
+			.substring(0, 40);
+		const filename = `${dateStr}-${obsType}-${slug}.md`;
+		const filePath = path.join(obsDir, filename);
+
+		// Parse concepts and files
+		const concepts = args.concepts
+			? args.concepts.split(",").map((c) => c.trim())
+			: [];
+		const files = args.files ? args.files.split(",").map((f) => f.trim()) : [];
+
+		// Build observation content
+		const icon = TYPE_ICONS[obsType];
+		let observation = `# ${icon} ${args.title}\n\n`;
+		observation += `**Type:** ${obsType}\n`;
+		observation += `**Created:** ${now.toISOString()}\n`;
+
+		if (args.bead_id) {
+			observation += `**Bead:** ${args.bead_id}\n`;
+		}
+
+		if (concepts.length > 0) {
+			observation += `**Concepts:** ${concepts.map((c) => `\`${c}\``).join(", ")}\n`;
+		}
+
+		if (files.length > 0) {
+			observation += `**Files:** ${files.map((f) => `\`${f}\``).join(", ")}\n`;
+		}
+
+		observation += `\n---\n\n`;
+		observation += args.content;
+		observation += `\n`;
+
+		try {
+			// Ensure directory exists
+			await fs.mkdir(obsDir, { recursive: true });
+
+			// Write observation
+			await fs.writeFile(filePath, observation, "utf-8");
+
+			let beadUpdate = "";
+
+			// Update bead notes if bead_id provided
+			if (args.bead_id) {
+				try {
+					const { execSync } = await import("child_process");
+					const noteContent = `${icon} ${obsType}: ${args.title}`;
+					execSync(
+						`bd edit ${args.bead_id} --note "${noteContent.replace(/"/g, '\\"')}"`,
+						{
+							cwd: process.cwd(),
+							encoding: "utf-8",
+							timeout: 5000,
+						},
+					);
+					beadUpdate = `\nBead updated: ${args.bead_id}`;
+				} catch {
+					beadUpdate = `\nWarning: Could not update bead ${args.bead_id}`;
+				}
+			}
+
+			return `✓ Observation saved: ${filename}\n\nType: ${icon} ${obsType}\nTitle: ${args.title}\nConcepts: ${concepts.join(", ") || "none"}\nFiles: ${files.join(", ") || "none"}${beadUpdate}\n\nPath: ${filePath}`;
+		} catch (error) {
+			if (error instanceof Error) {
+				return `Error saving observation: ${error.message}`;
+			}
+			return `Unknown error saving observation`;
+		}
+	},
+});

package/package.json

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

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

@@ -1,128 +0,0 @@
-# Memory System README
-
-## Overview
-
-The memory/ directory provides persistent cross-session context for OpenCode agents. This enables continuity and learning over time.
-
-## Structure
-
-```
-memory/
-├── _templates/                  # Document templates
-│   ├── spec.md                 # Template for task specifications
-│   ├── research.md             # Template for research documents
-│   └── session.md              # Template for session memory
-├── memory.md                    # Current project state and session learnings
-├── todo.md                      # Task tracking and progress
-├── development-guidelines.md    # Code conventions and patterns
-├── architecture-decisions.md    # Why we built it this way
-├── blockers.md                  # Known issues and workarounds
-│
-├── research/                    # Research findings and analysis
-│   ├── YYYY-MM-DD-topic.md     # Research documents
-│   └── cache-topic.md          # Research cache files
-│
-├── design-guidelines.md        # Design system and UI standards
-├── decisions/                   # Architectural decision records
-│   └── database-choice.md       # Example: Why PostgreSQL
-│
-└── plans/                       # Strategic planning documents
-    └── q4-roadmap.md            # Example: Quarterly objectives
-```
-
-**Subdirectories:** Use to organize knowledge by category and prevent flat directory bloat.
-
-## Usage
-
-### For Agents
-
-**At Session Start:**
-
-1. Read `memory.md` for current project context
-2. Check `todo.md` for active tasks
-3. Review `blockers.md` for known issues
-
-**During Session:**
-
-- Consult `development-guidelines.md` for coding standards
-- Reference `architecture-decisions.md` for design rationale
-- Reference `design-guidelines.md` for design standards
-- Update progress in `todo.md`
-- Save research to `research/YYYY-MM-DD-topic.md` (auto-created by /research command)
-- Document decisions in `decisions/choice-name.md`
-- Create specs using templates from `_templates/spec.md`
-
-**At Session End:**
-
-- Update `memory.md` with new learnings
-- Mark completed tasks in `todo.md`
-- Document new blockers or resolve existing ones
-
-### For Humans
-
-**Quick Status Check:**
-
-```bash
-# See current state
-cat memory/memory.md
-
-# Check active tasks
-cat memory/todo.md
-
-# Review blockers
-cat memory/blockers.md
-```
-
-**Update Memory:**
-Edit files directly or use memory-update tool - agents will read on next session.
-
-**Examples:**
-
-```bash
-# Read research notes
-memory-read research/opencode-sessions
-
-# Create new research note
-memory-update research/new-topic content="# Research Notes\n..."
-
-# Add decision record
-memory-update decisions/database-choice content="# Why PostgreSQL\n..."
-
-# Tools auto-create subdirectories and strip .md extension
-```
-
-## Memory Lifecycle
-
-### Compaction (When memory.md > 5000 words)
-
-1. Distill to critical facts only
-2. Archive detailed history to dated file: `memory-archive-YYYY-MM-DD.md`
-3. Keep current state lean and focused
-
-### Rotation
-
-- Archive completed tasks monthly
-- Move resolved blockers to history section
-- Keep active memory under 5000 words
-
-## Integration Points
-
-- **Plan Agent:** Reads memory.md before creating plans
-- **Build Agent:** Updates memory.md after major completions
-- **All Agents:** Consult development-guidelines.md for standards
-- **Design Agent:** Consults design-guidelines.md for design standards
-
-## Best Practices
-
-1. **Be Specific:** "Uses React 18 Server Components" vs "Uses React"
-2. **Date Decisions:** Track when and why choices were made
-3. **Keep Current:** Update after significant progress, not every trivial change
-4. **Prune Regularly:** Remove obsolete information
-5. **Link Context:** Reference related files/specs when relevant
-
-## Future Enhancements
-
-- Automatic memory compaction triggers
-- Memory-read and memory-update tools
-- Integration with task ledgers
-- Progress monitoring and re-planning triggers

package/dist/template/.opencode/memory/_templates/handoff.md

@@ -1,33 +0,0 @@
-# Handoff: [Phase Name]
-
-**Date:** YYYY-MM-DD
-**From:** [Current phase/agent]
-**To:** [Next phase/agent]
-**Task:** [Task ID if applicable]
-
-## Summary
-
-[1-2 sentences: What was accomplished in this phase]
-
-## Relevant Files
-
-- `@path/to/file1` - [Why needed]
-- `@path/to/file2` - [Why needed]
-
-## Key Decisions
-
-- [Decision 1]: [Rationale]
-- [Decision 2]: [Rationale]
-
-## Constraints
-
-- [Constraint that must be followed]
-- [Limitation to be aware of]
-
-## Next Instructions
-
-[Clear prompt for the next agent - what exactly to do next]
-
-## Open Questions
-
-- [Unresolved question for next phase]

package/dist/template/.opencode/memory/_templates/research.md

@@ -1,29 +0,0 @@
-# Research: [Topic]
-
-**Date:** YYYY-MM-DD
-**Context:** [Why this research was needed]
-
-## Question
-
-[The specific question or problem being researched]
-
-## Findings
-
-### [Finding 1]
-
-- [Key insight]
-- Source: [URL or document]
-
-### [Finding 2]
-
-- [Key insight]
-- Source: [URL or document]
-
-## Decision
-
-[Clear recommendation based on findings]
-
-## Next Steps
-
-1. [Action item]
-2. [Action item]

package/dist/template/.opencode/memory/_templates/task-design.md

@@ -1,59 +0,0 @@
-# Design Document
-
-**Bead ID:** [bead-id]
-**Created:** [date]
-**Status:** Draft | Validated
-
-## Problem Statement
-
-What we're solving and why it matters:
-
-## Approaches Considered
-
-### Option A: [Name]
-
-- **Pros:** [advantages]
-- **Cons:** [drawbacks]
-
-### Option B: [Name]
-
-- **Pros:** [advantages]
-- **Cons:** [drawbacks]
-
-### Chosen Approach
-
-[Which option and why]
-
-## Architecture
-
-High-level structure and how components fit together:
-
-### Components
-
-- [Component 1]: [purpose]
-- [Component 2]: [purpose]
-
-### Data Flow
-
-[How data moves through the system]
-
-## Error Handling
-
-How the design handles failure cases:
-
-- [Error scenario 1]: [handling approach]
-- [Error scenario 2]: [handling approach]
-
-## Testing Strategy
-
-How we'll validate this design works:
-
-- [Testing approach 1]
-- [Testing approach 2]
-
-## Open Questions
-
-Unresolved items to address during implementation:
-
-- [ ] [Question 1]
-- [ ] [Question 2]

package/dist/template/.opencode/memory/_templates/task-review.md

@@ -1,73 +0,0 @@
-# Task Review Template
-
-**Task ID:** [auto-generated]
-**Completed:** [date]
-**Status:** Done
-
-## What Changed
-
-### Files Modified:
-
-- `src/[file1.js]` - [brief description of changes]
-- `src/[file2.js]` - [brief description of changes]
-- `tests/[test.js]` - [brief description of changes]
-
-### Logic Added:
-
-- [New functionality implemented]
-- [Key algorithms or business logic]
-- [Data flow changes]
-
-### Files Created:
-
-- [List any new files created]
-
-## What Skipped
-
-### Intentionally Not Done:
-
-- [Feature X - reason: out of scope for this task]
-- [Optimization Y - reason: will be separate task]
-- [Test case Z - reason: requires additional setup]
-
-### Known Limitations:
-
-- [Limitation 1 - temporary workaround]
-- [Limitation 2 - technical debt introduced]
-- [Limitation 3 - performance considerations]
-
-## Inconsistencies with Architecture
-
-### Deviations from Spec:
-
-- [What was supposed to happen vs what actually happened]
-- [Why the deviation was necessary]
-- [Impact on overall architecture]
-
-### Unexpected Challenges:
-
-- [Problem 1 encountered and how solved]
-- [Problem 2 encountered and how solved]
-- [Problem 3 encountered and how solved]
-
-## Validation Results
-
-### Success Criteria Met:
-
-- [x] [Criteria 1 from PRD - how verified]
-- [x] [Criteria 2 from PRD - how verified]
-- [x] [Criteria 3 from PRD - how verified]
-
-### Test Results:
-
-- [Test suite results summary]
-- [Performance benchmarks]
-- [Security validations]
-
-## Next Micro-Task
-
-[Immediate next step or follow-up task needed]
-
-## Lessons Learned
-
-[What worked well, what didn't, what to improve for future tasks]

package/dist/template/.opencode/memory/_templates/task-spec.md

@@ -1,71 +0,0 @@
-# Task Spec Template
-
-**Task ID:** [auto-generated]
-**PRD:** [link to task-XXX-prd.md]
-**Created:** [date]
-
-## Architecture Plan
-
-Where this feature plugs into the repo, which layers it touches, expected file paths:
-
-### Files to Create/Modify:
-
-- `src/[path/to/file1.js]` - [purpose]
-- `src/[path/to/file2.js]` - [purpose]
-- `tests/[path/to/test.js]` - [purpose]
-
-### Integration Points:
-
-- [Existing module/service it connects to]
-- [Database schema changes needed]
-- [API endpoints affected]
-
-## Constraints
-
-### Naming Conventions:
-
-- Functions: [pattern, e.g., camelCase]
-- Files: [pattern, e.g., kebab-case]
-- Variables: [pattern, e.g., descriptive names]
-
-### Framework Requirements:
-
-- Must use: [required libraries/patterns]
-- Must NOT use: [forbidden libraries/patterns]
-- Must follow: [specific patterns, e.g., controllers → services → repository]
-
-### Code Style:
-
-- [Linting rules to follow]
-- [Testing patterns required]
-- [Documentation requirements]
-
-## Edge Cases
-
-Every scenario I know devs forget when in a rush:
-
-- [Edge case 1: what happens when X fails]
-- [Edge case 2: handling of invalid input Y]
-- [Edge case 3: performance under load Z]
-- [Edge case 4: error recovery scenarios]
-- [Edge case 5: security considerations]
-
-## Testing Notes
-
-Expected inputs/outputs, how to validate behavior, what logs/errors should look like:
-
-### Test Cases:
-
-- [Test case 1: normal flow]
-- [Test case 2: error conditions]
-- [Test case 3: edge cases]
-
-### Validation:
-
-- [How to verify it works correctly]
-- [Expected logs/messages]
-- [Performance benchmarks]
-
-### Rollback Plan:
-
-- [How to undo changes if something goes wrong]

package/dist/template/.opencode/memory/design-guidelines.md

@@ -1,281 +0,0 @@
-# Design Guidelines
-
-**Project:** [Project Name]
-**Last Updated:** YYYY-MM-DD
-**Version:** 1.0
-
----
-
-## Design System Overview
-
-[Design system description and philosophy]
-
----
-
-## Typography
-
-### Font Guidelines
-
-- **Primary Font:** [Font name] (Google Fonts)
-- **Fallback Fonts:** [Font options]
-- **Sizes:**
-  - Headings: [Size guidelines]
-  - Body: [Size guidelines]
-  - Small: [Size guidelines]
-- **Weights:** [Weight guidelines]
-- **Line Height:** [Line height guidelines]
-
-### Usage Rules
-
-- **IMPORTANT:** Predict font names from screenshots, don't default to Inter/Roboto
-- Use distinctive fonts that match brand identity
-- Ensure readability across all devices
-
----
-
-## Color Palette
-
-### Primary Colors
-
-- **Primary:** [Hex code] - [Usage description]
-- **Secondary:** [Hex code] - [Usage description]
-- **Accent:** [Hex code] - [Usage description]
-
-### Neutral Colors
-
-- **Background:** [Hex codes]
-- **Text:** [Hex codes]
-- **Borders:** [Hex codes]
-
-### Usage Rules
-
-- **IMPORTANT:** Avoid purple gradients on white backgrounds
-- Use cohesive color palettes
-- Ensure WCAG 2.1 AA contrast minimum
-
----
-
-## Layout & Spacing
-
-### Grid System
-
-- **Framework:** [Bootstrap 5 / Custom CSS Grid]
-- **Columns:** 12-column responsive grid
-- **Breakpoints:** [Breakpoint values]
-
-### Spacing Scale
-
-- **Base Unit:** 4px
-- **Scale:** 4, 8, 12, 16, 20, 24, 32, 48, 64px
-- **Usage:** Consistent spacing throughout components
-
----
-
-## Components
-
-### Buttons
-
-- **Primary Style:** [Description]
-- **Secondary Style:** [Description]
-- **States:** Default, Hover, Active, Disabled, Loading
-- **Sizes:** Small, Medium, Large
-
-### Forms
-
-- **Layout:** Single column stacking on mobile
-- **Validation:** Real-time and on-submit
-- **Required Fields:** Marked with asterisk (\*)
-
-### Modals
-
-- **Max Width:** 500px
-- **Responsive:** Full-width on mobile
-- **Backdrop:** Semi-transparent overlay
-
----
-
-## Motion & Animation
-
-### Animation Principles
-
-- **Purposeful Motion:** Staggered reveals for page entry
-- **Duration:** 200-300ms for UI transitions
-- **Easing:** Ease-out for natural movement
-- **Avoid:** Scattered micro-interactions
-
-### Guidelines
-
-- Use staggered animations, not random effects
-- Layer gradients for background depth
-- Respect `prefers-reduced-motion` setting
-
----
-
-## Accessibility
-
-### Requirements
-
-- **Standard:** WCAG 2.1 AA minimum
-- **Contrast:** 4.5:1 ratio for normal text
-- **Keyboard:** Full navigation support
-- **Screen Readers:** Proper semantic HTML structure
-
-### Implementation
-
-- **ARIA Labels:** Descriptive labels for interactive elements
-- **Focus States:** Visible focus indicators
-- **Alt Text:** Meaningful descriptions for images
-
----
-
-## Asset Guidelines
-
-### Images
-
-- **Format:** WebP for photos, PNG for graphics
-- **Compression:** Optimized for web delivery
-- **Responsive:** Multiple sizes for different screen densities
-
-### Icons
-
-- **System:** [Icon system name]
-- **Sizes:** 16px, 24px, 32px, 48px
-- **Format:** SVG with fallback PNG
-
----
-
-## Code Standards
-
-### CSS Architecture
-
-- **Methodology:** BEM (Block, Element, Modifier)
-- **Variables:** CSS custom properties for theming
-- **Responsive:** Mobile-first approach
-
-### JavaScript
-
-- **Framework:** [Framework name]
-- **Pattern:** Component-based architecture
-- **Performance:** Lazy loading for heavy components
-
----
-
-## Brand Guidelines
-
-### Logo Usage
-
-- **Primary Logo:** [Usage guidelines]
-- **Clear Space:** Minimum spacing requirements
-- **Variations:** Color variations for different backgrounds
-
-### Voice & Tone
-
-- **Personality:** [Brand personality description]
-- **Language:** [Language style guidelines]
-- **Do:** [Action words]
-- **Don't:** [Words to avoid]
-
----
-
-## Testing & QA
-
-### Cross-Browser
-
-- **Target:** [Browser list]
-- **Testing:** Manual testing on each browser
-- **Fallbacks:** Graceful degradation
-
-### Device Testing
-
-- **Mobile:** iOS Safari, Chrome Mobile
-- **Tablet:** iPad, Android tablets
-- **Desktop:** Chrome, Firefox, Safari, Edge
-
----
-
-## File Organization
-
-### Template Structure
-
-```
-assets/
-├── images/
-│   ├── logos/
-│   ├── icons/
-│   └── photos/
-├── css/
-│   ├── base.css
-│   ├── components.css
-│   └── utilities.css
-└── js/
-    ├── components/
-    └── utils/
-```
-
-### Naming Conventions
-
-- **Images:** kebab-case with descriptive names
-- **CSS:** BEM methodology with clear purpose
-- **JavaScript:** PascalCase for components, camelCase for utilities
-
----
-
-## Common Patterns
-
-### Header Pattern
-
-[Header component description and usage]
-
-### Footer Pattern
-
-[Footer component description and usage]
-
-### Card Pattern
-
-[Card component description and usage]
-
-### Form Pattern
-
-[Form component description and usage]
-
----
-
-## Tools & Resources
-
-### Design Tools
-
-- **UI Design:** [Tool names]
-- **Prototyping:** [Tool names]
-- **Asset Generation:** AI-multimodal skill
-
-### Development Tools
-
-- **Code Editor:** [Editor preferences]
-- **Browser DevTools:** Chrome DevTools
-- **Version Control:** Git with feature branches
-
----
-
-## Maintenance
-
-### Update Process
-
-1. Review new components quarterly
-2. Update guidelines based on user feedback
-3. Archive deprecated patterns
-4. Update version number for breaking changes
-
-### Documentation
-
-- Keep examples up-to-date
-- Document any exceptions to guidelines
-- Maintain changelog for major updates
-
----
-
-**Last Review:** YYYY-MM-DD  
-**Next Review:** YYYY-MM-DD
-
----
-
-_Design-guidelines.md - Living document for project design standards_