@every-env/compound-plugin 0.9.0 → 2.34.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (121) hide show
  1. package/.claude-plugin/marketplace.json +3 -3
  2. package/.github/workflows/publish.yml +20 -10
  3. package/.releaserc.json +31 -0
  4. package/AGENTS.md +6 -1
  5. package/CHANGELOG.md +76 -0
  6. package/CLAUDE.md +16 -3
  7. package/README.md +83 -16
  8. package/bun.lock +977 -0
  9. package/docs/plans/2026-02-14-feat-auto-detect-install-and-gemini-sync-plan.md +360 -0
  10. package/docs/plans/2026-02-25-feat-windsurf-global-scope-support-plan.md +627 -0
  11. package/docs/plans/2026-03-01-feat-ce-command-aliases-backwards-compatible-deprecation-plan.md +261 -0
  12. package/docs/plans/2026-03-01-fix-setup-skill-non-claude-llm-fallback-plan.md +140 -0
  13. package/docs/plans/2026-03-03-feat-sync-claude-mcp-all-supported-providers-plan.md +639 -0
  14. package/docs/plans/feature_opencode-commands-as-md-and-config-merge.md +574 -0
  15. package/docs/solutions/adding-converter-target-providers.md +693 -0
  16. package/docs/solutions/plugin-versioning-requirements.md +7 -3
  17. package/docs/specs/windsurf.md +477 -0
  18. package/package.json +10 -4
  19. package/plans/landing-page-launchkit-refresh.md +2 -2
  20. package/plugins/compound-engineering/.claude-plugin/plugin.json +2 -2
  21. package/plugins/compound-engineering/CHANGELOG.md +82 -1
  22. package/plugins/compound-engineering/CLAUDE.md +14 -7
  23. package/plugins/compound-engineering/README.md +10 -7
  24. package/plugins/compound-engineering/agents/research/git-history-analyzer.md +1 -1
  25. package/plugins/compound-engineering/agents/research/learnings-researcher.md +1 -1
  26. package/plugins/compound-engineering/agents/review/code-simplicity-reviewer.md +1 -1
  27. package/plugins/compound-engineering/commands/ce/brainstorm.md +145 -0
  28. package/plugins/compound-engineering/commands/ce/compound.md +240 -0
  29. package/plugins/compound-engineering/commands/ce/plan.md +636 -0
  30. package/plugins/compound-engineering/commands/ce/review.md +525 -0
  31. package/plugins/compound-engineering/commands/ce/work.md +470 -0
  32. package/plugins/compound-engineering/commands/create-agent-skill.md +1 -1
  33. package/plugins/compound-engineering/commands/deepen-plan.md +6 -6
  34. package/plugins/compound-engineering/commands/deploy-docs.md +1 -1
  35. package/plugins/compound-engineering/commands/feature-video.md +15 -6
  36. package/plugins/compound-engineering/commands/heal-skill.md +1 -1
  37. package/plugins/compound-engineering/commands/lfg.md +3 -3
  38. package/plugins/compound-engineering/commands/slfg.md +3 -3
  39. package/plugins/compound-engineering/commands/test-xcode.md +2 -2
  40. package/plugins/compound-engineering/commands/workflows/brainstorm.md +4 -123
  41. package/plugins/compound-engineering/commands/workflows/compound.md +4 -234
  42. package/plugins/compound-engineering/commands/workflows/plan.md +4 -562
  43. package/plugins/compound-engineering/commands/workflows/review.md +4 -522
  44. package/plugins/compound-engineering/commands/workflows/work.md +4 -448
  45. package/plugins/compound-engineering/skills/brainstorming/SKILL.md +3 -3
  46. package/plugins/compound-engineering/skills/create-agent-skills/workflows/add-workflow.md +6 -0
  47. package/plugins/compound-engineering/skills/create-agent-skills/workflows/create-new-skill.md +6 -0
  48. package/plugins/compound-engineering/skills/document-review/SKILL.md +1 -1
  49. package/plugins/compound-engineering/skills/file-todos/SKILL.md +1 -1
  50. package/plugins/compound-engineering/skills/git-worktree/SKILL.md +5 -5
  51. package/plugins/compound-engineering/skills/proof/SKILL.md +185 -0
  52. package/plugins/compound-engineering/skills/resolve-pr-parallel/SKILL.md +1 -1
  53. package/plugins/compound-engineering/skills/setup/SKILL.md +8 -2
  54. package/src/commands/convert.ts +101 -24
  55. package/src/commands/install.ts +102 -45
  56. package/src/commands/sync.ts +43 -62
  57. package/src/converters/claude-to-openclaw.ts +240 -0
  58. package/src/converters/claude-to-opencode.ts +12 -10
  59. package/src/converters/claude-to-qwen.ts +238 -0
  60. package/src/converters/claude-to-windsurf.ts +205 -0
  61. package/src/index.ts +2 -1
  62. package/src/parsers/claude-home.ts +55 -3
  63. package/src/sync/codex.ts +38 -62
  64. package/src/sync/commands.ts +198 -0
  65. package/src/sync/copilot.ts +14 -36
  66. package/src/sync/droid.ts +50 -9
  67. package/src/sync/gemini.ts +135 -0
  68. package/src/sync/json-config.ts +47 -0
  69. package/src/sync/kiro.ts +49 -0
  70. package/src/sync/mcp-transports.ts +19 -0
  71. package/src/sync/openclaw.ts +18 -0
  72. package/src/sync/opencode.ts +10 -30
  73. package/src/sync/pi.ts +12 -36
  74. package/src/sync/qwen.ts +66 -0
  75. package/src/sync/registry.ts +141 -0
  76. package/src/sync/skills.ts +21 -0
  77. package/src/sync/windsurf.ts +59 -0
  78. package/src/targets/index.ts +60 -1
  79. package/src/targets/openclaw.ts +96 -0
  80. package/src/targets/opencode.ts +76 -10
  81. package/src/targets/qwen.ts +64 -0
  82. package/src/targets/windsurf.ts +104 -0
  83. package/src/types/kiro.ts +3 -1
  84. package/src/types/openclaw.ts +52 -0
  85. package/src/types/opencode.ts +7 -8
  86. package/src/types/qwen.ts +51 -0
  87. package/src/types/windsurf.ts +35 -0
  88. package/src/utils/codex-agents.ts +1 -1
  89. package/src/utils/detect-tools.ts +37 -0
  90. package/src/utils/files.ts +14 -0
  91. package/src/utils/resolve-output.ts +50 -0
  92. package/src/utils/secrets.ts +24 -0
  93. package/src/utils/symlink.ts +4 -6
  94. package/tests/claude-home.test.ts +46 -0
  95. package/tests/cli.test.ts +180 -0
  96. package/tests/converter.test.ts +43 -10
  97. package/tests/detect-tools.test.ts +119 -0
  98. package/tests/openclaw-converter.test.ts +200 -0
  99. package/tests/opencode-writer.test.ts +142 -5
  100. package/tests/qwen-converter.test.ts +238 -0
  101. package/tests/resolve-output.test.ts +131 -0
  102. package/tests/sync-codex.test.ts +64 -0
  103. package/tests/sync-copilot.test.ts +60 -4
  104. package/tests/sync-droid.test.ts +44 -4
  105. package/tests/sync-gemini.test.ts +160 -0
  106. package/tests/sync-kiro.test.ts +83 -0
  107. package/tests/sync-openclaw.test.ts +51 -0
  108. package/tests/sync-qwen.test.ts +75 -0
  109. package/tests/sync-windsurf.test.ts +89 -0
  110. package/tests/windsurf-converter.test.ts +573 -0
  111. package/tests/windsurf-writer.test.ts +359 -0
  112. package/docs/css/docs.css +0 -675
  113. package/docs/css/style.css +0 -2886
  114. package/docs/index.html +0 -1046
  115. package/docs/js/main.js +0 -225
  116. package/docs/pages/agents.html +0 -649
  117. package/docs/pages/changelog.html +0 -534
  118. package/docs/pages/commands.html +0 -523
  119. package/docs/pages/getting-started.html +0 -582
  120. package/docs/pages/mcp-servers.html +0 -409
  121. package/docs/pages/skills.html +0 -611
@@ -0,0 +1,470 @@
1
+ ---
2
+ name: ce:work
3
+ description: Execute work plans efficiently while maintaining quality and finishing features
4
+ argument-hint: "[plan file, specification, or todo file path]"
5
+ ---
6
+
7
+ # Work Plan Execution Command
8
+
9
+ Execute a work plan efficiently while maintaining quality and finishing features.
10
+
11
+ ## Introduction
12
+
13
+ This command takes a work document (plan, specification, or todo file) and executes it systematically. The focus is on **shipping complete features** by understanding requirements quickly, following existing patterns, and maintaining quality throughout.
14
+
15
+ ## Input Document
16
+
17
+ <input_document> #$ARGUMENTS </input_document>
18
+
19
+ ## Execution Workflow
20
+
21
+ ### Phase 1: Quick Start
22
+
23
+ 1. **Read Plan and Clarify**
24
+
25
+ - Read the work document completely
26
+ - Review any references or links provided in the plan
27
+ - If anything is unclear or ambiguous, ask clarifying questions now
28
+ - Get user approval to proceed
29
+ - **Do not skip this** - better to ask questions now than build the wrong thing
30
+
31
+ 2. **Setup Environment**
32
+
33
+ First, check the current branch:
34
+
35
+ ```bash
36
+ current_branch=$(git branch --show-current)
37
+ default_branch=$(git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's@^refs/remotes/origin/@@')
38
+
39
+ # Fallback if remote HEAD isn't set
40
+ if [ -z "$default_branch" ]; then
41
+ default_branch=$(git rev-parse --verify origin/main >/dev/null 2>&1 && echo "main" || echo "master")
42
+ fi
43
+ ```
44
+
45
+ **If already on a feature branch** (not the default branch):
46
+ - Ask: "Continue working on `[current_branch]`, or create a new branch?"
47
+ - If continuing, proceed to step 3
48
+ - If creating new, follow Option A or B below
49
+
50
+ **If on the default branch**, choose how to proceed:
51
+
52
+ **Option A: Create a new branch**
53
+ ```bash
54
+ git pull origin [default_branch]
55
+ git checkout -b feature-branch-name
56
+ ```
57
+ Use a meaningful name based on the work (e.g., `feat/user-authentication`, `fix/email-validation`).
58
+
59
+ **Option B: Use a worktree (recommended for parallel development)**
60
+ ```bash
61
+ skill: git-worktree
62
+ # The skill will create a new branch from the default branch in an isolated worktree
63
+ ```
64
+
65
+ **Option C: Continue on the default branch**
66
+ - Requires explicit user confirmation
67
+ - Only proceed after user explicitly says "yes, commit to [default_branch]"
68
+ - Never commit directly to the default branch without explicit permission
69
+
70
+ **Recommendation**: Use worktree if:
71
+ - You want to work on multiple features simultaneously
72
+ - You want to keep the default branch clean while experimenting
73
+ - You plan to switch between branches frequently
74
+
75
+ 3. **Create Todo List**
76
+ - Use TodoWrite to break plan into actionable tasks
77
+ - Include dependencies between tasks
78
+ - Prioritize based on what needs to be done first
79
+ - Include testing and quality check tasks
80
+ - Keep tasks specific and completable
81
+
82
+ ### Phase 2: Execute
83
+
84
+ 1. **Task Execution Loop**
85
+
86
+ For each task in priority order:
87
+
88
+ ```
89
+ while (tasks remain):
90
+ - Mark task as in_progress in TodoWrite
91
+ - Read any referenced files from the plan
92
+ - Look for similar patterns in codebase
93
+ - Implement following existing conventions
94
+ - Write tests for new functionality
95
+ - Run System-Wide Test Check (see below)
96
+ - Run tests after changes
97
+ - Mark task as completed in TodoWrite
98
+ - Mark off the corresponding checkbox in the plan file ([ ] → [x])
99
+ - Evaluate for incremental commit (see below)
100
+ ```
101
+
102
+ **System-Wide Test Check** — Before marking a task done, pause and ask:
103
+
104
+ | Question | What to do |
105
+ |----------|------------|
106
+ | **What fires when this runs?** Callbacks, middleware, observers, event handlers — trace two levels out from your change. | Read the actual code (not docs) for callbacks on models you touch, middleware in the request chain, `after_*` hooks. |
107
+ | **Do my tests exercise the real chain?** If every dependency is mocked, the test proves your logic works *in isolation* — it says nothing about the interaction. | Write at least one integration test that uses real objects through the full callback/middleware chain. No mocks for the layers that interact. |
108
+ | **Can failure leave orphaned state?** If your code persists state (DB row, cache, file) before calling an external service, what happens when the service fails? Does retry create duplicates? | Trace the failure path with real objects. If state is created before the risky call, test that failure cleans up or that retry is idempotent. |
109
+ | **What other interfaces expose this?** Mixins, DSLs, alternative entry points (Agent vs Chat vs ChatMethods). | Grep for the method/behavior in related classes. If parity is needed, add it now — not as a follow-up. |
110
+ | **Do error strategies align across layers?** Retry middleware + application fallback + framework error handling — do they conflict or create double execution? | List the specific error classes at each layer. Verify your rescue list matches what the lower layer actually raises. |
111
+
112
+ **When to skip:** Leaf-node changes with no callbacks, no state persistence, no parallel interfaces. If the change is purely additive (new helper method, new view partial), the check takes 10 seconds and the answer is "nothing fires, skip."
113
+
114
+ **When this matters most:** Any change that touches models with callbacks, error handling with fallback/retry, or functionality exposed through multiple interfaces.
115
+
116
+ **IMPORTANT**: Always update the original plan document by checking off completed items. Use the Edit tool to change `- [ ]` to `- [x]` for each task you finish. This keeps the plan as a living document showing progress and ensures no checkboxes are left unchecked.
117
+
118
+ 2. **Incremental Commits**
119
+
120
+ After completing each task, evaluate whether to create an incremental commit:
121
+
122
+ | Commit when... | Don't commit when... |
123
+ |----------------|---------------------|
124
+ | Logical unit complete (model, service, component) | Small part of a larger unit |
125
+ | Tests pass + meaningful progress | Tests failing |
126
+ | About to switch contexts (backend → frontend) | Purely scaffolding with no behavior |
127
+ | About to attempt risky/uncertain changes | Would need a "WIP" commit message |
128
+
129
+ **Heuristic:** "Can I write a commit message that describes a complete, valuable change? If yes, commit. If the message would be 'WIP' or 'partial X', wait."
130
+
131
+ **Commit workflow:**
132
+ ```bash
133
+ # 1. Verify tests pass (use project's test command)
134
+ # Examples: bin/rails test, npm test, pytest, go test, etc.
135
+
136
+ # 2. Stage only files related to this logical unit (not `git add .`)
137
+ git add <files related to this logical unit>
138
+
139
+ # 3. Commit with conventional message
140
+ git commit -m "feat(scope): description of this unit"
141
+ ```
142
+
143
+ **Handling merge conflicts:** If conflicts arise during rebasing or merging, resolve them immediately. Incremental commits make conflict resolution easier since each commit is small and focused.
144
+
145
+ **Note:** Incremental commits use clean conventional messages without attribution footers. The final Phase 4 commit/PR includes the full attribution.
146
+
147
+ 3. **Follow Existing Patterns**
148
+
149
+ - The plan should reference similar code - read those files first
150
+ - Match naming conventions exactly
151
+ - Reuse existing components where possible
152
+ - Follow project coding standards (see CLAUDE.md)
153
+ - When in doubt, grep for similar implementations
154
+
155
+ 4. **Test Continuously**
156
+
157
+ - Run relevant tests after each significant change
158
+ - Don't wait until the end to test
159
+ - Fix failures immediately
160
+ - Add new tests for new functionality
161
+ - **Unit tests with mocks prove logic in isolation. Integration tests with real objects prove the layers work together.** If your change touches callbacks, middleware, or error handling — you need both.
162
+
163
+ 5. **Figma Design Sync** (if applicable)
164
+
165
+ For UI work with Figma designs:
166
+
167
+ - Implement components following design specs
168
+ - Use figma-design-sync agent iteratively to compare
169
+ - Fix visual differences identified
170
+ - Repeat until implementation matches design
171
+
172
+ 6. **Track Progress**
173
+ - Keep TodoWrite updated as you complete tasks
174
+ - Note any blockers or unexpected discoveries
175
+ - Create new tasks if scope expands
176
+ - Keep user informed of major milestones
177
+
178
+ ### Phase 3: Quality Check
179
+
180
+ 1. **Run Core Quality Checks**
181
+
182
+ Always run before submitting:
183
+
184
+ ```bash
185
+ # Run full test suite (use project's test command)
186
+ # Examples: bin/rails test, npm test, pytest, go test, etc.
187
+
188
+ # Run linting (per CLAUDE.md)
189
+ # Use linting-agent before pushing to origin
190
+ ```
191
+
192
+ 2. **Consider Reviewer Agents** (Optional)
193
+
194
+ Use for complex, risky, or large changes. Read agents from `compound-engineering.local.md` frontmatter (`review_agents`). If no settings file, invoke the `setup` skill to create one.
195
+
196
+ Run configured agents in parallel with Task tool. Present findings and address critical issues.
197
+
198
+ 3. **Final Validation**
199
+ - All TodoWrite tasks marked completed
200
+ - All tests pass
201
+ - Linting passes
202
+ - Code follows existing patterns
203
+ - Figma designs match (if applicable)
204
+ - No console errors or warnings
205
+
206
+ 4. **Prepare Operational Validation Plan** (REQUIRED)
207
+ - Add a `## Post-Deploy Monitoring & Validation` section to the PR description for every change.
208
+ - Include concrete:
209
+ - Log queries/search terms
210
+ - Metrics or dashboards to watch
211
+ - Expected healthy signals
212
+ - Failure signals and rollback/mitigation trigger
213
+ - Validation window and owner
214
+ - If there is truly no production/runtime impact, still include the section with: `No additional operational monitoring required` and a one-line reason.
215
+
216
+ ### Phase 4: Ship It
217
+
218
+ 1. **Create Commit**
219
+
220
+ ```bash
221
+ git add .
222
+ git status # Review what's being committed
223
+ git diff --staged # Check the changes
224
+
225
+ # Commit with conventional format
226
+ git commit -m "$(cat <<'EOF'
227
+ feat(scope): description of what and why
228
+
229
+ Brief explanation if needed.
230
+
231
+ 🤖 Generated with [Claude Code](https://claude.com/claude-code)
232
+
233
+ Co-Authored-By: Claude <noreply@anthropic.com>
234
+ EOF
235
+ )"
236
+ ```
237
+
238
+ 2. **Capture and Upload Screenshots for UI Changes** (REQUIRED for any UI work)
239
+
240
+ For **any** design changes, new views, or UI modifications, you MUST capture and upload screenshots:
241
+
242
+ **Step 1: Start dev server** (if not running)
243
+ ```bash
244
+ bin/dev # Run in background
245
+ ```
246
+
247
+ **Step 2: Capture screenshots with agent-browser CLI**
248
+ ```bash
249
+ agent-browser open http://localhost:3000/[route]
250
+ agent-browser snapshot -i
251
+ agent-browser screenshot output.png
252
+ ```
253
+ See the `agent-browser` skill for detailed usage.
254
+
255
+ **Step 3: Upload using imgup skill**
256
+ ```bash
257
+ skill: imgup
258
+ # Then upload each screenshot:
259
+ imgup -h pixhost screenshot.png # pixhost works without API key
260
+ # Alternative hosts: catbox, imagebin, beeimg
261
+ ```
262
+
263
+ **What to capture:**
264
+ - **New screens**: Screenshot of the new UI
265
+ - **Modified screens**: Before AND after screenshots
266
+ - **Design implementation**: Screenshot showing Figma design match
267
+
268
+ **IMPORTANT**: Always include uploaded image URLs in PR description. This provides visual context for reviewers and documents the change.
269
+
270
+ 3. **Create Pull Request**
271
+
272
+ ```bash
273
+ git push -u origin feature-branch-name
274
+
275
+ gh pr create --title "Feature: [Description]" --body "$(cat <<'EOF'
276
+ ## Summary
277
+ - What was built
278
+ - Why it was needed
279
+ - Key decisions made
280
+
281
+ ## Testing
282
+ - Tests added/modified
283
+ - Manual testing performed
284
+
285
+ ## Post-Deploy Monitoring & Validation
286
+ - **What to monitor/search**
287
+ - Logs:
288
+ - Metrics/Dashboards:
289
+ - **Validation checks (queries/commands)**
290
+ - `command or query here`
291
+ - **Expected healthy behavior**
292
+ - Expected signal(s)
293
+ - **Failure signal(s) / rollback trigger**
294
+ - Trigger + immediate action
295
+ - **Validation window & owner**
296
+ - Window:
297
+ - Owner:
298
+ - **If no operational impact**
299
+ - `No additional operational monitoring required: <reason>`
300
+
301
+ ## Before / After Screenshots
302
+ | Before | After |
303
+ |--------|-------|
304
+ | ![before](URL) | ![after](URL) |
305
+
306
+ ## Figma Design
307
+ [Link if applicable]
308
+
309
+ ---
310
+
311
+ [![Compound Engineered](https://img.shields.io/badge/Compound-Engineered-6366f1)](https://github.com/EveryInc/compound-engineering-plugin) 🤖 Generated with [Claude Code](https://claude.com/claude-code)
312
+ EOF
313
+ )"
314
+ ```
315
+
316
+ 4. **Update Plan Status**
317
+
318
+ If the input document has YAML frontmatter with a `status` field, update it to `completed`:
319
+ ```
320
+ status: active → status: completed
321
+ ```
322
+
323
+ 5. **Notify User**
324
+ - Summarize what was completed
325
+ - Link to PR
326
+ - Note any follow-up work needed
327
+ - Suggest next steps if applicable
328
+
329
+ ---
330
+
331
+ ## Swarm Mode (Optional)
332
+
333
+ For complex plans with multiple independent workstreams, enable swarm mode for parallel execution with coordinated agents.
334
+
335
+ ### When to Use Swarm Mode
336
+
337
+ | Use Swarm Mode when... | Use Standard Mode when... |
338
+ |------------------------|---------------------------|
339
+ | Plan has 5+ independent tasks | Plan is linear/sequential |
340
+ | Multiple specialists needed (review + test + implement) | Single-focus work |
341
+ | Want maximum parallelism | Simpler mental model preferred |
342
+ | Large feature with clear phases | Small feature or bug fix |
343
+
344
+ ### Enabling Swarm Mode
345
+
346
+ To trigger swarm execution, say:
347
+
348
+ > "Make a Task list and launch an army of agent swarm subagents to build the plan"
349
+
350
+ Or explicitly request: "Use swarm mode for this work"
351
+
352
+ ### Swarm Workflow
353
+
354
+ When swarm mode is enabled, the workflow changes:
355
+
356
+ 1. **Create Team**
357
+ ```
358
+ Teammate({ operation: "spawnTeam", team_name: "work-{timestamp}" })
359
+ ```
360
+
361
+ 2. **Create Task List with Dependencies**
362
+ - Parse plan into TaskCreate items
363
+ - Set up blockedBy relationships for sequential dependencies
364
+ - Independent tasks have no blockers (can run in parallel)
365
+
366
+ 3. **Spawn Specialized Teammates**
367
+ ```
368
+ Task({
369
+ team_name: "work-{timestamp}",
370
+ name: "implementer",
371
+ subagent_type: "general-purpose",
372
+ prompt: "Claim implementation tasks, execute, mark complete",
373
+ run_in_background: true
374
+ })
375
+
376
+ Task({
377
+ team_name: "work-{timestamp}",
378
+ name: "tester",
379
+ subagent_type: "general-purpose",
380
+ prompt: "Claim testing tasks, run tests, mark complete",
381
+ run_in_background: true
382
+ })
383
+ ```
384
+
385
+ 4. **Coordinate and Monitor**
386
+ - Team lead monitors task completion
387
+ - Spawn additional workers as phases unblock
388
+ - Handle plan approval if required
389
+
390
+ 5. **Cleanup**
391
+ ```
392
+ Teammate({ operation: "requestShutdown", target_agent_id: "implementer" })
393
+ Teammate({ operation: "requestShutdown", target_agent_id: "tester" })
394
+ Teammate({ operation: "cleanup" })
395
+ ```
396
+
397
+ See the `orchestrating-swarms` skill for detailed swarm patterns and best practices.
398
+
399
+ ---
400
+
401
+ ## Key Principles
402
+
403
+ ### Start Fast, Execute Faster
404
+
405
+ - Get clarification once at the start, then execute
406
+ - Don't wait for perfect understanding - ask questions and move
407
+ - The goal is to **finish the feature**, not create perfect process
408
+
409
+ ### The Plan is Your Guide
410
+
411
+ - Work documents should reference similar code and patterns
412
+ - Load those references and follow them
413
+ - Don't reinvent - match what exists
414
+
415
+ ### Test As You Go
416
+
417
+ - Run tests after each change, not at the end
418
+ - Fix failures immediately
419
+ - Continuous testing prevents big surprises
420
+
421
+ ### Quality is Built In
422
+
423
+ - Follow existing patterns
424
+ - Write tests for new code
425
+ - Run linting before pushing
426
+ - Use reviewer agents for complex/risky changes only
427
+
428
+ ### Ship Complete Features
429
+
430
+ - Mark all tasks completed before moving on
431
+ - Don't leave features 80% done
432
+ - A finished feature that ships beats a perfect feature that doesn't
433
+
434
+ ## Quality Checklist
435
+
436
+ Before creating PR, verify:
437
+
438
+ - [ ] All clarifying questions asked and answered
439
+ - [ ] All TodoWrite tasks marked completed
440
+ - [ ] Tests pass (run project's test command)
441
+ - [ ] Linting passes (use linting-agent)
442
+ - [ ] Code follows existing patterns
443
+ - [ ] Figma designs match implementation (if applicable)
444
+ - [ ] Before/after screenshots captured and uploaded (for UI changes)
445
+ - [ ] Commit messages follow conventional format
446
+ - [ ] PR description includes Post-Deploy Monitoring & Validation section (or explicit no-impact rationale)
447
+ - [ ] PR description includes summary, testing notes, and screenshots
448
+ - [ ] PR description includes Compound Engineered badge
449
+
450
+ ## When to Use Reviewer Agents
451
+
452
+ **Don't use by default.** Use reviewer agents only when:
453
+
454
+ - Large refactor affecting many files (10+)
455
+ - Security-sensitive changes (authentication, permissions, data access)
456
+ - Performance-critical code paths
457
+ - Complex algorithms or business logic
458
+ - User explicitly requests thorough review
459
+
460
+ For most features: tests + linting + following patterns is sufficient.
461
+
462
+ ## Common Pitfalls to Avoid
463
+
464
+ - **Analysis paralysis** - Don't overthink, read the plan and execute
465
+ - **Skipping clarifying questions** - Ask now, not after building wrong thing
466
+ - **Ignoring plan references** - The plan has links for a reason
467
+ - **Testing at the end** - Test continuously or suffer later
468
+ - **Forgetting TodoWrite** - Track progress or lose track of what's done
469
+ - **80% done syndrome** - Finish the feature, don't move on early
470
+ - **Over-reviewing simple changes** - Save reviewer agents for complex work
@@ -2,7 +2,7 @@
2
2
  name: create-agent-skill
3
3
  description: Create or edit Claude Code skills with expert guidance on structure and best practices
4
4
  allowed-tools: Skill(create-agent-skills)
5
- argument-hint: [skill description or requirements]
5
+ argument-hint: "[skill description or requirements]"
6
6
  disable-model-invocation: true
7
7
  ---
8
8
 
@@ -10,7 +10,7 @@ argument-hint: "[path to plan file]"
10
10
 
11
11
  **Note: The current year is 2026.** Use this when searching for recent documentation and best practices.
12
12
 
13
- This command takes an existing plan (from `/workflows:plan`) and enhances each section with parallel research agents. Each major element gets its own dedicated research sub-agent to find:
13
+ This command takes an existing plan (from `/ce:plan`) and enhances each section with parallel research agents. Each major element gets its own dedicated research sub-agent to find:
14
14
  - Best practices and industry patterns
15
15
  - Performance optimizations
16
16
  - UI/UX improvements (if applicable)
@@ -145,13 +145,13 @@ Task general-purpose: "Use the security-patterns skill at ~/.claude/skills/secur
145
145
  ### 3. Discover and Apply Learnings/Solutions
146
146
 
147
147
  <thinking>
148
- Check for documented learnings from /workflows:compound. These are solved problems stored as markdown files. Spawn a sub-agent for each learning to check if it's relevant.
148
+ Check for documented learnings from /ce:compound. These are solved problems stored as markdown files. Spawn a sub-agent for each learning to check if it's relevant.
149
149
  </thinking>
150
150
 
151
151
  **LEARNINGS LOCATION - Check these exact folders:**
152
152
 
153
153
  ```
154
- docs/solutions/ <-- PRIMARY: Project-level learnings (created by /workflows:compound)
154
+ docs/solutions/ <-- PRIMARY: Project-level learnings (created by /ce:compound)
155
155
  ├── performance-issues/
156
156
  │ └── *.md
157
157
  ├── debugging-patterns/
@@ -370,7 +370,7 @@ Wait for ALL parallel agents to complete - skills, research agents, review agent
370
370
  **Collect outputs from ALL sources:**
371
371
 
372
372
  1. **Skill-based sub-agents** - Each skill's full output (code examples, patterns, recommendations)
373
- 2. **Learnings/Solutions sub-agents** - Relevant documented learnings from /workflows:compound
373
+ 2. **Learnings/Solutions sub-agents** - Relevant documented learnings from /ce:compound
374
374
  3. **Research agents** - Best practices, documentation, real-world examples
375
375
  4. **Review agents** - All feedback from every reviewer (architecture, security, performance, simplicity, etc.)
376
376
  5. **Context7 queries** - Framework documentation and patterns
@@ -481,14 +481,14 @@ After writing the enhanced plan, use the **AskUserQuestion tool** to present the
481
481
  **Options:**
482
482
  1. **View diff** - Show what was added/changed
483
483
  2. **Run `/technical_review`** - Get feedback from reviewers on enhanced plan
484
- 3. **Start `/workflows:work`** - Begin implementing this enhanced plan
484
+ 3. **Start `/ce:work`** - Begin implementing this enhanced plan
485
485
  4. **Deepen further** - Run another round of research on specific sections
486
486
  5. **Revert** - Restore original plan (if backup exists)
487
487
 
488
488
  Based on selection:
489
489
  - **View diff** → Run `git diff [plan_path]` or show before/after
490
490
  - **`/technical_review`** → Call the /technical_review command with the plan file path
491
- - **`/workflows:work`** → Call the /workflows:work command with the plan file path
491
+ - **`/ce:work`** → Call the /ce:work command with the plan file path
492
492
  - **Deepen further** → Ask which sections need more research, then re-run those agents
493
493
  - **Revert** → Restore from git or backup
494
494
 
@@ -109,5 +109,5 @@ Provide a summary:
109
109
  - [ ] Commit any pending changes
110
110
  - [ ] Push to main branch
111
111
  - [ ] Verify GitHub Pages workflow exists
112
- - [ ] Check deployment at https://everyinc.github.io/every-marketplace/
112
+ - [ ] Check deployment at https://everyinc.github.io/compound-engineering-plugin/
113
113
  ```
@@ -26,6 +26,7 @@ This command creates professional video walkthroughs of features for PR document
26
26
  - Git repository with a PR to document
27
27
  - `ffmpeg` installed (for video conversion)
28
28
  - `rclone` configured (optional, for cloud upload - see rclone skill)
29
+ - Public R2 base URL known (for example, `https://<public-domain>.r2.dev`)
29
30
  </requirements>
30
31
 
31
32
  ## Setup
@@ -212,6 +213,9 @@ ffmpeg -y -framerate 0.5 -pattern_type glob -i 'tmp/screenshots/*.png' \
212
213
  # Check rclone is configured
213
214
  rclone listremotes
214
215
 
216
+ # Set your public base URL (NO trailing slash)
217
+ PUBLIC_BASE_URL="https://<your-public-r2-domain>.r2.dev"
218
+
215
219
  # Upload video, preview GIF, and screenshots to cloud storage
216
220
  # Use --s3-no-check-bucket to avoid permission errors
217
221
  rclone copy tmp/videos/ r2:kieran-claude/pr-videos/pr-[number]/ --s3-no-check-bucket --progress
@@ -219,12 +223,17 @@ rclone copy tmp/screenshots/ r2:kieran-claude/pr-videos/pr-[number]/screenshots/
219
223
 
220
224
  # List uploaded files
221
225
  rclone ls r2:kieran-claude/pr-videos/pr-[number]/
222
- ```
223
226
 
224
- Public URLs (R2 with public access):
225
- ```
226
- Video: https://pub-4047722ebb1b4b09853f24d3b61467f1.r2.dev/pr-videos/pr-[number]/feature-demo.mp4
227
- Preview: https://pub-4047722ebb1b4b09853f24d3b61467f1.r2.dev/pr-videos/pr-[number]/feature-demo-preview.gif
227
+ # Build and validate public URLs BEFORE updating PR
228
+ VIDEO_URL="$PUBLIC_BASE_URL/pr-videos/pr-[number]/feature-demo.mp4"
229
+ PREVIEW_URL="$PUBLIC_BASE_URL/pr-videos/pr-[number]/feature-demo-preview.gif"
230
+
231
+ curl -I "$VIDEO_URL"
232
+ curl -I "$PREVIEW_URL"
233
+
234
+ # Require HTTP 200 for both URLs; stop if either fails
235
+ curl -I "$VIDEO_URL" | head -n 1 | grep -q ' 200 ' || exit 1
236
+ curl -I "$PREVIEW_URL" | head -n 1 | grep -q ' 200 ' || exit 1
228
237
  ```
229
238
 
230
239
  </upload_video>
@@ -254,7 +263,7 @@ If the PR already has a video section, replace it. Otherwise, append:
254
263
 
255
264
  Example:
256
265
  ```markdown
257
- [![Feature Demo](https://pub-4047722ebb1b4b09853f24d3b61467f1.r2.dev/pr-videos/pr-137/feature-demo-preview.gif)](https://pub-4047722ebb1b4b09853f24d3b61467f1.r2.dev/pr-videos/pr-137/feature-demo.mp4)
266
+ [![Feature Demo](https://<your-public-r2-domain>.r2.dev/pr-videos/pr-137/feature-demo-preview.gif)](https://<your-public-r2-domain>.r2.dev/pr-videos/pr-137/feature-demo.mp4)
258
267
  ```
259
268
 
260
269
  **Update the PR:**
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: heal-skill
3
3
  description: Fix incorrect SKILL.md files when a skill has wrong instructions or outdated API references
4
- argument-hint: [optional: specific issue to fix]
4
+ argument-hint: "[optional: specific issue to fix]"
5
5
  allowed-tools: [Read, Edit, Bash(ls:*), Bash(git:*)]
6
6
  disable-model-invocation: true
7
7
  ---
@@ -8,10 +8,10 @@ disable-model-invocation: true
8
8
  Run these slash commands in order. Do not do anything else. Do not stop between steps — complete every step through to the end.
9
9
 
10
10
  1. **Optional:** If the `ralph-wiggum` skill is available, run `/ralph-wiggum:ralph-loop "finish all slash commands" --completion-promise "DONE"`. If not available or it fails, skip and continue to step 2 immediately.
11
- 2. `/workflows:plan $ARGUMENTS`
11
+ 2. `/ce:plan $ARGUMENTS`
12
12
  3. `/compound-engineering:deepen-plan`
13
- 4. `/workflows:work`
14
- 5. `/workflows:review`
13
+ 4. `/ce:work`
14
+ 5. `/ce:review`
15
15
  6. `/compound-engineering:resolve_todo_parallel`
16
16
  7. `/compound-engineering:test-browser`
17
17
  8. `/compound-engineering:feature-video`
@@ -10,15 +10,15 @@ Swarm-enabled LFG. Run these steps in order, parallelizing where indicated. Do n
10
10
  ## Sequential Phase
11
11
 
12
12
  1. **Optional:** If the `ralph-wiggum` skill is available, run `/ralph-wiggum:ralph-loop "finish all slash commands" --completion-promise "DONE"`. If not available or it fails, skip and continue to step 2 immediately.
13
- 2. `/workflows:plan $ARGUMENTS`
13
+ 2. `/ce:plan $ARGUMENTS`
14
14
  3. `/compound-engineering:deepen-plan`
15
- 4. `/workflows:work` — **Use swarm mode**: Make a Task list and launch an army of agent swarm subagents to build the plan
15
+ 4. `/ce:work` — **Use swarm mode**: Make a Task list and launch an army of agent swarm subagents to build the plan
16
16
 
17
17
  ## Parallel Phase
18
18
 
19
19
  After work completes, launch steps 5 and 6 as **parallel swarm agents** (both only need code to be written):
20
20
 
21
- 5. `/workflows:review` — spawn as background Task agent
21
+ 5. `/ce:review` — spawn as background Task agent
22
22
  6. `/compound-engineering:test-browser` — spawn as background Task agent
23
23
 
24
24
  Wait for both to complete before continuing.
@@ -323,9 +323,9 @@ mcp__xcodebuildmcp__shutdown_simulator({ simulator_id: "[uuid]" })
323
323
  /xcode-test current
324
324
  ```
325
325
 
326
- ## Integration with /workflows:review
326
+ ## Integration with /ce:review
327
327
 
328
- When reviewing PRs that touch iOS code, the `/workflows:review` command can spawn this as a subagent:
328
+ When reviewing PRs that touch iOS code, the `/ce:review` command can spawn this as a subagent:
329
329
 
330
330
  ```
331
331
  Task general-purpose("Run /xcode-test for scheme [name]. Build, install on simulator, test key screens, check for crashes.")