opencodekit 0.19.5 → 0.20.0

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

@@ -56,9 +56,10 @@ br list --status=in_progress
 
 ```bash
 br show $ARGUMENTS
-ls .beads/artifacts/$ARGUMENTS/
 ```
 
+Read `.beads/artifacts/$ARGUMENTS/` to check what artifacts exist.
+
 Verify `prd.md` exists and has real content (not just placeholders). If missing or incomplete, tell user to run `/create` first.
 
 ## Phase 3: Claim
@@ -107,18 +108,15 @@ Map bead type to branch prefix:
 | task      | task          |
 | epic      | epic          |
 
+Create the branch:
+
 ```bash
-PREFIX=$(case "$BEAD_TYPE" in
-  feature) echo "feat" ;;
-  bug) echo "fix" ;;
-  task) echo "task" ;;
-  epic) echo "epic" ;;
-  *) echo "task" ;;
-esac)
-TITLE_SLUG=$(echo "$TITLE" | tr '[:upper:]' '[:lower:]' | tr ' ' '-')
-git checkout -b $PREFIX/$ARGUMENTS-$TITLE_SLUG
+# Example: feat/br-42-add-auth
+git checkout -b $PREFIX/$BEAD_ID-$TITLE_SLUG
 ```
 
+Slugify the title (lowercase, spaces to hyphens) and use the bead type to determine the prefix.
+
 **If worktree selected:**
 
 ```typescript

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

@@ -63,7 +63,7 @@ git log --oneline -5
 ```
 
 ```typescript
-find_sessions({ query: "today", limit: 5 });
+find_sessions({ query: "<project-name or recent-bead-keywords>", limit: 5 });
 ```
 
 ---

package/dist/template/.opencode/command/ui-slop-check.md

@@ -19,12 +19,12 @@ skill({ name: "accessibility-audit" }); // Keyboard/focus/contrast checks
 
 ## Parse Arguments
 
-| Argument        | Default | Description                                        |
-| --------------- | ------- | -------------------------------------------------- | ----------------------------------------------------------- |
-| `[path          | auto]`  | `auto`                                             | Specific file/dir to audit, or auto-detect changed UI files |
-| `--staged`      | false   | Audit staged changes only (`git diff --cached`)    |
-| `--since=<ref>` | `HEAD`  | Compare against ref (`main`, `HEAD~1`, commit SHA) |
-| `--full-report` | false   | Include all categories even when no issues found   |
+| Argument        | Default | Description                                                   |
+| --------------- | ------- | ------------------------------------------------------------- |
+| `[path\|auto]`  | `auto`  | Specific file/dir to audit, or auto-detect changed UI files   |
+| `--staged`      | false   | Audit staged changes only (`git diff --cached`)               |
+| `--since=<ref>` | `HEAD`  | Compare against ref (`main`, `HEAD~1`, commit SHA)            |
+| `--full-report` | false   | Include all categories even when no issues found              |
 
 ## Phase 1: Resolve Target Files
 

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

@@ -45,11 +45,10 @@ skill({ name: "verification-before-completion" });
 Before running any gates, check if a recent verification is still valid:
 
 ```bash
-# Compute current state fingerprint (commit hash + full diff + untracked files)
-CURRENT_STAMP=$(printf '%s\n%s\n%s' \
+# Compute current state fingerprint (commit hash + diff)
+CURRENT_STAMP=$(printf '%s\n%s' \
   "$(git rev-parse HEAD)" \
   "$(git diff HEAD -- '*.ts' '*.tsx' '*.js' '*.jsx')" \
-  "$(git ls-files --others --exclude-standard -- '*.ts' '*.tsx' '*.js' '*.jsx' | xargs cat 2>/dev/null)" \
   | shasum -a 256 | cut -d' ' -f1)
 LAST_STAMP=$(tail -1 .beads/verify.log 2>/dev/null | awk '{print $1}')
 ```
@@ -70,9 +69,10 @@ Verification: cached PASS (no changes since <timestamp from verify.log>)
 
 ```bash
 br show $ARGUMENTS
-ls .beads/artifacts/$ARGUMENTS/
 ```
 
+Read `.beads/artifacts/$ARGUMENTS/` to check what artifacts exist.
+
 Read the PRD and any other artifacts (plan.md, research.md, design.md).
 
 **Verify guards:**

package/dist/template/.opencode/dcp-prompts/defaults/compress-message.md

@@ -39,3 +39,4 @@ During general cleanup, compress all medium and high-priority messages that are
 Optimize for reducing context footprint, not for grouping messages by topic.
 Do not compress away still-active instructions, unresolved questions, or constraints that are likely to matter soon.
 Prioritize the earliest messages in the context as they will be the least relevant to the active task.
+General cleanup should be done periodically between other normal compression tool passes, not as the primary form of compression.

package/dist/template/.opencode/dcp.jsonc

@@ -36,7 +36,7 @@
 	"compress": {
 		// "range" (stable) compresses spans into block summaries
 		// "message" (experimental) compresses individual raw messages
-		"mode": "message",
+		"mode": "range",
 		// "allow" (no prompt) | "ask" (prompt) | "deny" (tool not registered)
 		"permission": "allow",
 		"showCompression": false,

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

@@ -82,17 +82,15 @@
     ".opencode/memory/project/user.md",
     ".opencode/memory/project/tech-stack.md",
     ".opencode/memory/project/project.md",
-    ".opencode/memory/project/roadmap.md",
-    ".opencode/memory/project/state.md",
     ".opencode/context/git-context.md"
   ],
   "keybinds": {
-    "leader": "`",
-    "session_parent": "<leader>up"
+    "leader": "ctrl+x",
+    "session_parent": "up"
   },
   "mcp": {
     "tilth": {
-      "command": ["tilth", "--mcp", "--edit"],
+      "command": ["npx", "-y", "tilth", "--mcp", "--edit"],
       "enabled": true,
       "environment": {
         "TILTH_THREADS": "8"

package/dist/template/.opencode/skill/chrome-devtools/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: chrome-devtools
-description: Chrome DevTools for debugging, performance analysis, and browser automation. Use when debugging web apps, analyzing performance, inspecting network requests, or automating browser interactions.
+description: Use when debugging web apps in Chrome — performance profiling, network inspection, DOM debugging, or console automation. MUST load before any Chrome DevTools-based debugging session.
 version: 1.0.0
 tags: [automation, debugging]
 dependencies: []

package/dist/template/.opencode/skill/cloudflare/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cloudflare
-description: Comprehensive Cloudflare platform skill covering Workers, Pages, storage (KV, D1, R2), AI (Workers AI, Vectorize, Agents SDK), networking (Tunnel, Spectrum), security (WAF, DDoS), and infrastructure-as-code (Terraform, Pulumi). Use for any Cloudflare development task.
+description: Use when deploying to or configuring ANY Cloudflare service — Workers, Pages, KV, D1, R2, AI, Tunnel, WAF. MUST load before writing Cloudflare Workers code, wrangler configs, or infrastructure-as-code for Cloudflare.
 references:
   - workers
   - pages

package/dist/template/.opencode/skill/context-initialization/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: context-initialization
-description: Initialize GSD-style project context files from templates
-version: 1.0.0
+description: Initialize project context files from templates. Creates on-demand planning files (roadmap.md, state.md) and updates auto-injected project.md.
+version: 2.0.0
 tags: [context, workflow]
 dependencies: []
 ---
@@ -11,20 +11,19 @@ dependencies: []
 ## When to Use
 
 - When initializing project context files (project.md, roadmap.md, state.md) from templates.
+- project.md is auto-injected into every prompt; roadmap.md and state.md are on-demand.
 
 ## When NOT to Use
 
 - When context files already exist and only need minor manual edits.
 
-
 ## Process
 
 ### 1. Verify Templates
 
-```bash
-test -f .opencode/memory/_templates/project.md
-test -f .opencode/memory/_templates/roadmap.md
-test -f .opencode/memory/_templates/state.md
+```typescript
+tilth_tilth_files({ pattern: "*.md", scope: ".opencode/memory/_templates" });
+// Required templates: project.md, roadmap.md, state.md
 ```
 
 Stop if missing.
@@ -43,28 +42,28 @@ Skip if `--skip-questions` flag set.
 
 ### 3. Create Files
 
-**project.md**
+**project.md** (auto-injected — keep concise)
 
-- Read template
+- Read template via `Read({ filePath: ".opencode/memory/_templates/project.md" })`
 - Fill with answers
-- Write to `.opencode/memory/project/`
+- Write via `memory-update({ file: "project/project", content: ..., mode: "replace" })`
 
-**roadmap.md**
+**roadmap.md** (on-demand — access via `memory-read({ file: "project/roadmap" })`)
 
 - Read template
 - Parse phases into table
-- Write to `.opencode/memory/project/`
+- Write via `memory-update({ file: "project/roadmap", content: ..., mode: "replace" })`
 
-**state.md**
+**state.md** (on-demand — access via `memory-read({ file: "project/state" })`)
 
 - Read template
 - Set initial state
-- Write to `.opencode/memory/project/`
+- Write via `memory-update({ file: "project/state", content: ..., mode: "replace" })`
 
 ### 4. Verify
 
-```bash
-ls .opencode/memory/project/
+```typescript
+tilth_tilth_files({ pattern: "*.md", scope: ".opencode/memory/project" });
 ```
 
-Report created files.
+Report created files with their injection status (auto-injected vs on-demand).