Skip to content

feat: make loop-engineering super useful (interactive tools, loop-audit v1.4, new Issue Triage pattern)#12

Closed
cobusgreyling wants to merge 1 commit into
mainfrom
feat/make-super-useful-20260609
Closed

feat: make loop-engineering super useful (interactive tools, loop-audit v1.4, new Issue Triage pattern)#12
cobusgreyling wants to merge 1 commit into
mainfrom
feat/make-super-useful-20260609

Conversation

@cobusgreyling

Copy link
Copy Markdown
Owner

Summary

This PR implements major improvements to make the loop-engineering repo significantly more useful and adoptable.

Highlights

loop-audit v1.4.0

  • New dynamic loopActivity signal that detects real usage: git history of STATE updates, "Last run" timestamps in state files, scheduled workflows, and run logs.
  • L3 readiness now requires proven usage, not just files on disk.
  • Stronger recommendations when you have structure but no actual runs yet.
  • Updated tests, README, and CLI help.

Interactive GitHub Pages Showcase

  • Prominent one-click "Copy" buttons for the key npx commands in the hero.
  • Pattern Picker widget: Click your current pain (CI red, PRs stalling, morning chaos, deps, merge debt, stale releases) → instantly get the exact npx @cobusgreyling/loop-init ... command + recommended first /loop prompt + links.
  • Live Readiness Simulator: Checkboxes for every signal the auditor looks for (including the new activity signal). Live-computed score + level + assessment + next action. Pure client-side, matches the real scoring logic.

New low-risk pattern: Issue Triage

  • 7th pattern, designed as the perfect companion to Daily Triage.
  • Focuses on discovering, deduping, prioritizing, and suggesting labels for GitHub issues + discussions.
  • Very low risk (report/propose mode by default).
  • Full docs, added to registry, pattern-picker decision tree, and loop-init support.

Distribution & Polish

  • loop-audit bumped to 1.4.0, loop-init to 1.2.0.
  • All READMEs, badges, and quickstart language updated to emphasize that npx works immediately with no clone required.
  • Everything dogfooded (the reference repo itself scores 100/L3 with activity detected).

Verification

  • All tests pass (loop-audit + loop-init)
  • Registry validation passes (7 patterns)
  • scripts/before-after-demo.sh works
  • Live loop-audit . --suggest on the repo shows 100 + activity signals

The feature branch was used for development. This PR follows the repository's branch protection rules.

How to review / test

  1. Check out the PR branch locally if desired.
  2. Try the interactive tools at https://cobusgreyling.github.io/loop-engineering/ (or the version in this PR).
  3. npx @cobusgreyling/loop-audit . --suggest (after the packages are published, or run from source).
  4. Run the before/after demo.

Once checks pass (the existing audit + validate workflows will run), this can be merged.

- loop-audit v1.4: dynamic 'loopActivity' signal (git history, 'Last run' timestamps in STATE, scheduled workflows, run logs). L3 now requires real usage evidence (not just files). Stronger --suggest output and recommendations. Updated tests + README.

- GitHub Pages showcase: Interactive Pattern Picker (click symptom pills → exact npx + first /loop command + links). Live Readiness Simulator (checkboxes for all signals → live score + level + next action, mirrors computeScore + new L3 rules). Hero now has prominent one-click copy npx CTAs for loop-init and loop-audit.

- New low-risk pattern: Issue Triage (perfect companion to Daily Triage for noisy GitHub/Linear issues). 7 patterns total. Updated registry.yaml (validated), patterns/README, pattern-picker.md decision flow + table.

- Polish: loop-init bumped to 1.2.0. Main + tool READMEs, badges, and quickstart language updated to emphasize 'npx works today' and the new interactive tools + activity proof requirement. Builds and validation green.

All changes dogfood the philosophy: structure + actual runs = high L3 score.
@github-actions

github-actions Bot commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

Loop Readiness Audit

Score: 100/100 (L3)

Strong loop readiness — good candidate for L3 with explicit gates.

No suggestions — looking good.

Posted by audit.yml · loop-audit docs

@cobusgreyling

Copy link
Copy Markdown
Owner Author

Superseded by #16 (rebased on main with loop-cost + combined L3 rules).

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.

1 participant