From 44e1ad3181952dbe2271955ad188e422c4186e86 Mon Sep 17 00:00:00 2001 From: Gregg Cochran Date: Fri, 6 Nov 2026 23:15:39 -0800 Subject: [PATCH 1/2] docs: clarify Looper task completion introduction Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: c7361fd1-7d9c-4e50-bf97-875fd9a7cafd --- CHANGELOG.md | 1 + README.md | 4 +++- 2 files changed, 4 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index afcbfa6..a62b1d5 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,6 +8,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ## [Unreleased] ### Documentation +- Updated the README introduction to explain how Looper helps AI coding agents complete complex tasks, preserve progress, and verify results. - Added a profile-style animated SVG header with a reduced-motion fallback, simplified explanations throughout the README, and aligned the README, skill description, and repository About wording. - Rewrote the README introduction, skill description, and supporting overviews in plain language; explained the work cycle, saved progress (“durable state”), and the 20-attempt limit without changing behavior. - Corrected the README helper example to use the installed helper path, hash working-tree file contents, and keep repair instructions separate from the passing path. diff --git a/README.md b/README.md index 2443e5b..296a190 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,9 @@ Looper: small steps, checked results, saved progress. An animated illustration of the work cycle and the maximum of 20 attempts, including final verification. -**Break your request into small steps, check the results, and save progress so work can resume after an interruption. Stops when everything is verified, a blocker prevents progress, or 20 attempts are used. Built for GitHub Copilot and other AI agents that support Agent Skills.** +Looper helps AI coding agents complete complex tasks while keeping track of progress and checking results before declaring success. + +Built on the open Agent Skills standard, Looper breaks work into manageable steps, saves progress across interruptions, limits execution to 20 attempts, records test evidence, and requires final verification before reporting completion. [![Validate](https://github.com/DUBSOpenHub/looper/actions/workflows/validate.yml/badge.svg)](https://github.com/DUBSOpenHub/looper/actions/workflows/validate.yml) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE) From cbcd4b3f750b956ae26a8e3e08eaf200b2f302b1 Mon Sep 17 00:00:00 2001 From: Gregg Cochran Date: Fri, 6 Nov 2026 23:16:22 -0800 Subject: [PATCH 2/2] docs: align animated header with completion messaging Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: c7361fd1-7d9c-4e50-bf97-875fd9a7cafd --- CHANGELOG.md | 2 +- README.md | 2 +- assets/hero.svg | 10 +++++----- 3 files changed, 7 insertions(+), 7 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index a62b1d5..b76485c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,7 +8,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ## [Unreleased] ### Documentation -- Updated the README introduction to explain how Looper helps AI coding agents complete complex tasks, preserve progress, and verify results. +- Updated the README introduction and animated header to explain how Looper helps AI coding agents complete complex tasks, preserve progress, record test evidence, and verify results. - Added a profile-style animated SVG header with a reduced-motion fallback, simplified explanations throughout the README, and aligned the README, skill description, and repository About wording. - Rewrote the README introduction, skill description, and supporting overviews in plain language; explained the work cycle, saved progress (“durable state”), and the 20-attempt limit without changing behavior. - Corrected the README helper example to use the installed helper path, hash working-tree file contents, and keep repair instructions separate from the passing path. diff --git a/README.md b/README.md index 296a190..4fe1f39 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # 🔁 Looper -Looper: small steps, checked results, saved progress. An animated illustration of the work cycle and the maximum of 20 attempts, including final verification. +Looper helps AI coding agents finish what they start with saved progress, recorded test evidence, and final verification. An animated illustration of the work cycle and the maximum of 20 attempts. Looper helps AI coding agents complete complex tasks while keeping track of progress and checking results before declaring success. diff --git a/assets/hero.svg b/assets/hero.svg index c06752d..1e3725d 100644 --- a/assets/hero.svg +++ b/assets/hero.svg @@ -1,6 +1,6 @@ - Looper: small steps, checked results, saved progress - An illustrated work cycle: read saved progress, count an attempt, make a change, test, fix if needed, retest, and save progress. Up to 20 attempts, including final verification. Progress is saved in the project so work can resume after an interruption. This is an illustration, not a live status display. + Looper: help AI coding agents finish what they start + Looper helps AI coding agents complete complex tasks while keeping track of progress and checking results before declaring success. Built on the open Agent Skills standard, it breaks work into manageable steps, saves progress across interruptions, limits execution to 20 attempts, records test evidence, and requires final verification before reporting completion. The animated work cycle is an illustration, not a live status display. @@ -25,9 +25,9 @@ GITHUB COPILOT / AGENT SKILLS LOOPER - Small steps. Checked results. Saved progress. - Make a change. Check it. Fix it if needed. - Save progress so work can resume. + Help AI coding agents finish what they start. + Keep progress. Record test evidence. + Verify results before reporting completion. STOP: VERIFIED / BLOCKED / 20 ATTEMPTS USED