Practical patterns, starters & CLI tools for loop engineering with AI coding agents. Design systems that prompt and orchestrate agents (inspired by Addy Osmani and Boris Cherny). Includes loop-audit, loop-init, loop-cost.
TypeScript agentic-aiai-agentsai-codinganthropicautomationclaudeclaude-codecodexcoding-agentsdevops-automationdevtoolsgithub-actionsgrokllmloop-engineeringmcpprompt-engineering
docs: add Windsurf Dependency Sweeper example doc (#415)
Muhammad Zeshan Malikd6a9dc73638f
diff --git a/examples/README.md b/examples/README.mdindex c3b991c..8577999 100644--- a/examples/README.md+++ b/examples/README.md@@ -27,7 +27,7 @@ Start with [primitives-matrix.md](../docs/primitives-matrix.md) to map capabilit| PR Babysitter | [grok/pr-babysitter.md](./grok/pr-babysitter.md) | [claude-code/pr-babysitter.md](./claude-code/pr-babysitter.md) | [codex/pr-babysitter.md](./codex/pr-babysitter.md) | [openclaw/pr-babysitter.md](./openclaw/pr-babysitter.md) | [cursor/pr-babysitter.md](./cursor/pr-babysitter.md) | [windsurf/pr-babysitter.md](./windsurf/pr-babysitter.md) | [opencode/pr-babysitter.md](./opencode/pr-babysitter.md) | [hermes/pr-babysitter.md](./hermes/pr-babysitter.md) | [github-actions/pr-babysitter.yml](./github-actions/pr-babysitter.yml) || CI Sweeper | [grok/ci-sweeper.md](./grok/ci-sweeper.md) | [claude-code/ci-sweeper.md](./claude-code/ci-sweeper.md) | [codex/ci-sweeper.md](./codex/ci-sweeper.md) | [openclaw/ci-sweeper.md](./openclaw/ci-sweeper.md) | [cursor/ci-sweeper.md](./cursor/ci-sweeper.md) | [windsurf/ci-sweeper.md](./windsurf/ci-sweeper.md) | [opencode/ci-sweeper.md](./opencode/ci-sweeper.md) | — | [github-actions/ci-sweeper.yml](./github-actions/ci-sweeper.yml) || Post-Merge Cleanup | [grok/post-merge-cleanup.md](./grok/post-merge-cleanup.md) | [claude-code/post-merge-cleanup.md](./claude-code/post-merge-cleanup.md) | [codex/post-merge-cleanup.md](./codex/post-merge-cleanup.md) | [openclaw/post-merge-cleanup.md](./openclaw/post-merge-cleanup.md) | [cursor/post-merge-cleanup.md](./cursor/post-merge-cleanup.md) | — | [opencode/post-merge-cleanup.md](./opencode/post-merge-cleanup.md) | — | [github-actions/post-merge-cleanup.yml](./github-actions/post-merge-cleanup.yml) |-| Dependency Sweeper | [grok/dependency-sweeper.md](./grok/dependency-sweeper.md) | [claude-code/dependency-sweeper.md](./claude-code/dependency-sweeper.md) | [codex/dependency-sweeper.md](./codex/dependency-sweeper.md) | [openclaw/dependency-sweeper.md](./openclaw/dependency-sweeper.md) | [cursor/dependency-sweeper.md](./cursor/dependency-sweeper.md) | — | [opencode/dependency-sweeper.md](./opencode/dependency-sweeper.md) | — | [github-actions/dependency-sweeper.yml](./github-actions/dependency-sweeper.yml) |+| Dependency Sweeper | [grok/dependency-sweeper.md](./grok/dependency-sweeper.md) | [claude-code/dependency-sweeper.md](./claude-code/dependency-sweeper.md) | [codex/dependency-sweeper.md](./codex/dependency-sweeper.md) | [openclaw/dependency-sweeper.md](./openclaw/dependency-sweeper.md) | [cursor/dependency-sweeper.md](./cursor/dependency-sweeper.md) | [windsurf/dependency-sweeper.md](./windsurf/dependency-sweeper.md) | [opencode/dependency-sweeper.md](./opencode/dependency-sweeper.md) | — | [github-actions/dependency-sweeper.yml](./github-actions/dependency-sweeper.yml) || Changelog Drafter | [grok/changelog-drafter.md](./grok/changelog-drafter.md) | [claude-code/changelog-drafter.md](./claude-code/changelog-drafter.md) | [codex/changelog-drafter.md](./codex/changelog-drafter.md) | [openclaw/changelog-drafter.md](./openclaw/changelog-drafter.md) | [cursor/changelog-drafter.md](./cursor/changelog-drafter.md) | — | [opencode/changelog-drafter.md](./opencode/changelog-drafter.md) | — | [github-actions/changelog-drafter.yml](./github-actions/changelog-drafter.yml) || Issue Triage | [grok/issue-triage.md](./grok/issue-triage.md) | [claude-code/issue-triage.md](./claude-code/issue-triage.md) | [codex/issue-triage.md](./codex/issue-triage.md) | [openclaw/issue-triage.md](./openclaw/issue-triage.md) | [cursor/issue-triage.md](./cursor/issue-triage.md) | [windsurf/issue-triage.md](./windsurf/issue-triage.md) | [opencode/issue-triage.md](./opencode/issue-triage.md) | — | [github-actions/issue-triage.yml](./github-actions/issue-triage.yml) |diff --git a/examples/windsurf/README.md b/examples/windsurf/README.mdindex 547deab..dd42ec5 100644--- a/examples/windsurf/README.md+++ b/examples/windsurf/README.md@@ -8,6 +8,7 @@ Copy-pasteable loop patterns for Windsurf, using Cascade Workflows as the manual| PR Babysitter | 5m–15m (manual `/pr-babysitter`; external reminder optional) | Medium | [pr-babysitter.md](pr-babysitter.md) || CI Sweeper | 5m–15m (manual `/ci-sweeper`; external reminder optional) | Medium | [ci-sweeper.md](ci-sweeper.md) || Issue Triage | 2h–1d (manual `/issue-triage`; external reminder optional) | Low | [issue-triage.md](issue-triage.md) |+| Dependency Sweeper | 6h–1d (manual `/dependency-sweeper`; external reminder optional) | Medium | [dependency-sweeper.md](dependency-sweeper.md) |No `loop-init --tool windsurf` yet — copy `SKILL.md` + `STATE.md` from any starter (e.g. `starters/minimal-loop`), then follow the example to wire a Cascade Workflow.diff --git a/examples/windsurf/dependency-sweeper.md b/examples/windsurf/dependency-sweeper.mdnew file mode 100644index 0000000..6c64deb--- /dev/null+++ b/examples/windsurf/dependency-sweeper.md@@ -0,0 +1,93 @@+# Dependency Sweeper — Windsurf (Cascade Workflows)++This is a practical, copy-pasteable example of a Dependency Sweeper loop using Windsurf's Cascade.++Windsurf has no native `/loop` scheduler or built-in cron. Map the loop to a **Cascade Workflow** (`.windsurf/workflows/dependency-sweeper.md`) and invoke it manually with `/dependency-sweeper`; if you need an unattended cadence (e.g. 6h–1d), pair it with an external reminder or trigger (such as GitHub Actions cron, `launchd`, `cron`, or systemd) that prompts a human to run the workflow.++## Setup++Copy the shared skills and state into Windsurf's project-local paths:++```bash+mkdir -p .windsurf/rules/dependency-triage \+ .windsurf/rules/minimal-fix \+ .windsurf/rules/loop-verifier+cp starters/dependency-sweeper/.claude/skills/dependency-triage/SKILL.md \+ .windsurf/rules/dependency-triage/SKILL.md+cp templates/SKILL.md.minimal-fix \+ .windsurf/rules/minimal-fix/SKILL.md+cp templates/SKILL.md.verifier \+ .windsurf/rules/loop-verifier/SKILL.md+cp starters/dependency-sweeper/dependency-sweeper-state.md.example \+ dependency-sweeper-state.md+```++Put always-on path denylists, package denylists, and auto-bump restrictions in `.windsurf/rules/` as well as in the workflow prompt.++## Workflow (week one — report only)++Create `.windsurf/workflows/dependency-sweeper.md`:++```markdown+# Dependency Sweeper++**Description:** Audit package manifests/lockfiles for outdated dependencies and vulnerabilities. Report only, no auto-fix.++1. Read `dependency-sweeper-state.md` and `.windsurf/rules/dependency-triage/SKILL.md`.+2. Run the `dependency-triage` skill on package manifests and lockfiles.+3. Group findings by risk level (patch, minor, major, known CVEs).+4. Update `dependency-sweeper-state.md` with top findings and patch-only proposal notes.+5. Week one is report-only:+ - do not edit package manifests (`package.json`, etc.) or lockfiles;+ - do not open pull requests or push commits;+ - escalate major version bumps (no silent major bumps) and high-severity CVEs to a human.+```++Invoke in Cascade chat with `/dependency-sweeper`.++For an unattended cadence, keep Windsurf as the review/triage surface and use an external scheduler only to remind a human or trigger execution. Review the state file after every run. See [Safety and human gates](../../docs/safety.md) for permission boundaries.++## L2 progression (patch-only + circuit breaker)++After the report-only triage output is consistently accurate, allow patch-only fixes for safe updates:++1. Create a fresh worktree per attempt using `npx @cobusgreyling/loop-worktree create --run-id <run-id> --pattern dependency-sweeper`. Never edit the main working tree directly.+2. Apply minimal version updates (`minimal-fix`) only for allowlisted patch updates.+3. Run `loop-verifier` (`.windsurf/rules/loop-verifier/SKILL.md`) in a separate session/verifier step over tests and build.+4. **Circuit breaker & budget:** Before retrying any attempt on a package, run the circuit breaker:+ ```bash+ npx @cobusgreyling/loop-context --check --ledger loop-ledger.json \+ --budget-from-pattern dependency-sweeper --budget-level L2+ ```+ If the attempt cap is reached or circuit breaker triggers, stop retrying and escalate to a human. Respect the daily token cap defined in `loop-budget.md` (suggested: 500k tokens).+5. **Major bumps:** Major version bumps always require human approval before any merge proposal. Never silently apply major version upgrades.++## Example `dependency-sweeper-state.md`++```markdown+# Dependency Sweeper State+Last run: 2026-07-11 06:00 UTC+Mode: report-only++## Pending updates++### lodash 4.17.20 → 4.17.21 (patch)+- Severity: low+- Loop action: report-only (week one). Candidate for patch-auto next cycle.+- Attempts: 0 / 3++### react 18.2.0 → 19.0.0 (major)+- Severity: high (breaking changes in hooks API)+- Loop action: escalated to human. Do not auto-apply major bump.++## Denylist+- webpack (frozen at 5.x per team decision)+```++## References++- [Dependency Sweeper pattern](../../patterns/dependency-sweeper.md)+- [Dependency Sweeper starter](../../starters/dependency-sweeper/)+- [`loop-worktree`](../../tools/loop-worktree/)+- [Safety and human gates](../../docs/safety.md)+- [Primitives matrix](../../docs/primitives-matrix.md#appendix-editor-transfer-recipes-opencode-cursor--windsurf)diff --git a/patterns/registry.yaml b/patterns/registry.yamlindex c145571..3fc002d 100644--- a/patterns/registry.yaml+++ b/patterns/registry.yaml@@ -96,7 +96,7 @@ patterns:goal: Discover, safely apply, and verify dependency + vulnerability updates with human gates on risky changescadence: 6h-1drisk: medium- tools: [grok, claude-code, codex, openclaw, opencode, github-actions]+ tools: [grok, claude-code, codex, openclaw, opencode, github-actions, windsurf]skills: [dependency-triage, minimal-fix, loop-verifier]state: dependency-sweeper-state.mdphases: [scan, triage-risk, patch-safe, verify-worktree, escalate-risky]