Skip to content

docs: add Cursor CI Sweeper example (#220)#356

Merged
cobusgreyling merged 2 commits into
cobusgreyling:mainfrom
shixi-li:docs/cursor-ci-sweeper
Jul 23, 2026
Merged

docs: add Cursor CI Sweeper example (#220)#356
cobusgreyling merged 2 commits into
cobusgreyling:mainfrom
shixi-li:docs/cursor-ci-sweeper

Conversation

@shixi-li

@shixi-li shixi-li commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

Summary

Add a Cursor-specific CI Sweeper example that starts report-only and maps safe fix attempts to Automations, project skills/rules, isolated worktrees, and an independent verifier.

Changes

  • New pattern or starter (followed templates/pattern-template.md + updated registry.yaml)
  • Doc / example improvement
  • Tool change (loop-audit)
  • Story (includes real failure or surprise + lesson)

The example:

  • adds a week-one report-only Automation prompt with evidence-based failure classification;
  • maps ci-triage, minimal-fix, loop-verifier, and ci-sweeper-state.md into Cursor project paths;
  • distinguishes Cursor's managed Automations and local /loop skill from repository-owned scheduling;
  • treats prompts and .cursor/rules as advisory, with tool and credential scopes as the enforceable boundary;
  • requires loop-worktree isolation and a separate verifier for later fix attempts; and
  • forbids CI retries, comments, auto-merge, and unattended fixes in week one.

The Cursor index and pattern-coverage matrix now link the example.

Checklist (from CONTRIBUTING)

  • Links work from README, patterns/README, starters/README, docs/index
  • No secrets, tokens, internal company URLs
  • Safety-sensitive guidance references docs/safety.md and includes explicit human gates
  • Ran node tools/loop-audit/dist/cli.js . and addressed findings

Testing / Dogfood

  • bash scripts/ci-validate-gates.sh
  • bash scripts/ci-audit-gates.sh
  • bash scripts/before-after-demo.sh
  • node tools/loop-audit/dist/cli.js . --json — 100/100, L3
  • git diff --check
  • Manually checked local links and current official Cursor Automations documentation

Screenshots / Examples

Not applicable; this is a Markdown-only documentation change. The new page contains the copy-paste report-only prompt and an example state entry.

Closes #220

@shixi-li
shixi-li requested a review from cobusgreyling as a code owner July 23, 2026 06:48
@github-actions

Copy link
Copy Markdown
Contributor

Thanks @shixi-li for contributing a tool example — visible, reviewable PRs like this grow the reference for everyone.

What happens next

  • Maintainer aims for same-day review on story, adopter, and scoped docs/example PRs (CONTRIBUTING.md).
  • good first issue PRs: comment on the linked issue so we can assign and close on merge.

More ways to help

— loop-engineering maintainers

@shixi-li
shixi-li force-pushed the docs/cursor-ci-sweeper branch from 860a63a to bffe391 Compare July 23, 2026 06:56
@cobusgreyling
cobusgreyling merged commit 7bef5ca into cobusgreyling:main Jul 23, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add Cursor CI Sweeper example doc

2 participants