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
chore: improve contributor visibility
Cobus Greyling648bd607f469
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.ymlindex 6d22ef8..511a3ed 100644--- a/.github/ISSUE_TEMPLATE/config.yml+++ b/.github/ISSUE_TEMPLATE/config.yml@@ -9,6 +9,9 @@ contact_links:- name: "\ud83c\udf10 Add my project to Adopters"url: https://github.com/cobusgreyling/loop-engineering/issues/new?template=add-adopter.ymlabout: "List your loop on the showcase adopters wall and docs/adopters.md."+ - name: "\ud83c\udf31 Good first issues (contributor quickstart)"+ url: https://github.com/cobusgreyling/loop-engineering/discussions/123+ about: "Scoped ~10 min–1 hr tasks. Comment I'll take this on an issue to get assigned."labels:- name: "pattern-request"diff --git a/.github/workflows/welcome-contributors.yml b/.github/workflows/welcome-contributors.ymlindex 3f2d2ee..076d768 100644--- a/.github/workflows/welcome-contributors.yml+++ b/.github/workflows/welcome-contributors.yml@@ -6,6 +6,8 @@ on:paths:- 'stories/**'- 'docs/adopters.md'+ - 'examples/**'+ - 'docs/**'permissions:pull-requests: write@@ -18,18 +20,35 @@ jobs:with:script: |const pr = context.payload.pull_request;- const isStory = pr.title.toLowerCase().includes('story') ||- pr.body?.toLowerCase().includes('stories/');const opener = pr.user.login;+ const files = await github.paginate(+ github.rest.pulls.listFiles,+ { owner: context.repo.owner, repo: context.repo.repo, pull_number: pr.number, per_page: 100 }+ );+ const paths = files.map((f) => f.filename);+ const isStory = pr.title.toLowerCase().includes('story') ||+ pr.body?.toLowerCase().includes('stories/') ||+ paths.some((p) => p.startsWith('stories/'));+ const isAdopter = paths.some((p) => p === 'docs/adopters.md');+ const isExample = paths.some((p) => p.startsWith('examples/'));+ const isDocs = paths.some((p) => p.startsWith('docs/'));++ let kind = 'a contribution';+ if (isStory) kind = 'a production story';+ else if (isAdopter) kind = 'an adopter listing';+ else if (isExample) kind = 'a tool example';+ else if (isDocs) kind = 'a docs improvement';const body = [- `Thanks @${opener} for contributing${isStory ? ' a production story' : ''} — failures and honest wins are first-class here.`,+ `Thanks @${opener} for contributing ${kind} — visible, reviewable PRs like this grow the reference for everyone.`,'','**What happens next**',- '- Maintainer aims for **same-day review** on story and adopter PRs (see [CONTRIBUTING.md — Maintainer response](https://github.com/cobusgreyling/loop-engineering/blob/main/CONTRIBUTING.md#maintainer-response-adopters--stories)).',- '- Small fixes may be merged quickly; larger asks get one focused review round.',+ '- Maintainer aims for **same-day review** on story, adopter, and scoped docs/example PRs ([CONTRIBUTING.md](https://github.com/cobusgreyling/loop-engineering/blob/main/CONTRIBUTING.md#maintainer-response-adopters--stories)).',+ '- `good first issue` PRs: comment on the linked issue so we can assign and close on merge.','',- '**Want a follow-up?** Comment if you would like help turning this into a tool example or a `good first issue` for someone else.',+ '**More ways to help**',+ '- [Contributor quickstart + open issues](https://github.com/cobusgreyling/loop-engineering/discussions/123)',+ '- [Good first issue backlog](https://github.com/cobusgreyling/loop-engineering/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)','','— loop-engineering maintainers'].join('\n');diff --git a/README.md b/README.mdindex aa0bdbb..7d4bf39 100644--- a/README.md+++ b/README.md@@ -14,6 +14,7 @@<a href="https://www.npmjs.com/package/@cobusgreyling/loop-init"><img src="https://img.shields.io/npm/v/@cobusgreyling/loop-init?label=loop-init" alt="loop-init npm"></a><a href="https://www.npmjs.com/package/@cobusgreyling/loop-cost"><img src="https://img.shields.io/npm/v/@cobusgreyling/loop-cost?label=loop-cost" alt="loop-cost npm"></a><a href="https://www.npmjs.com/package/@cobusgreyling/loop-sync"><img src="https://img.shields.io/npm/v/@cobusgreyling/loop-sync?label=loop-sync" alt="loop-sync npm"></a>+ <a href="https://www.npmjs.com/package/@cobusgreyling/loop-context"><img src="https://img.shields.io/npm/v/@cobusgreyling/loop-context?label=loop-context" alt="loop-context npm"></a><a href="https://github.com/cobusgreyling/loop-engineering/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT"></a><a href="https://cobusgreyling.github.io/loop-engineering/"><img src="https://img.shields.io/badge/GitHub_Pages-live%20%7C%20interactive-3ee8c5" alt="Pages"></a></p>@@ -92,6 +93,7 @@ For developers using Grok, Claude Code, Codex, Cursor, and other AI coding agent| [loop-mcp-server](tools/mcp-server/) | MCP runtime lookup for patterns, skills, state — `node tools/mcp-server/dist/index.js` (repo v1; npm pending) || [Goal Engineering](https://github.com/cobusgreyling/goal-engineering) | **Companion:** loops discover, goals finish — `/goal` + [stack cookbook](https://github.com/cobusgreyling/goal-engineering/blob/main/docs/stack-cookbook.md) (`npx @cobusgreyling/goal doctor .`) || [Stories](stories/) | Real wins and honest failures |+| [Contributor quickstart](https://github.com/cobusgreyling/loop-engineering/discussions/123) | **Help wanted:** 9 scoped `good first issues` — comment *I'll take this* to get assigned || [Community update](https://github.com/cobusgreyling/loop-engineering/discussions/89) | v1.5.0 release — loop-sync, constraints, MCP server || [Add your project](https://github.com/cobusgreyling/loop-engineering/discussions/92) | **Pinned:** Loop Ready badge + adopters list |@@ -242,6 +244,18 @@ Loop engineering amplifies judgment — both good and bad.Addy Osmani:> “Build the loop. But build it like someone who intends to stay the engineer, not just the person who presses go.”+## Help wanted++**First PR?** Start with the [contributor quickstart](https://github.com/cobusgreyling/loop-engineering/discussions/123) — ~10 min to ~1 hr tasks with same-day review on stories and adopters.++| Pick one | Issue |+|----------|-------|+| ~10 min | [#120 — Add your project to adopters](https://github.com/cobusgreyling/loop-engineering/issues/120) |+| ~20 min | [#121 — QUICKSTART `loop-init --tool` values](https://github.com/cobusgreyling/loop-engineering/issues/121) |+| ~1 hr | [#118](https://github.com/cobusgreyling/loop-engineering/issues/118) / [#119](https://github.com/cobusgreyling/loop-engineering/issues/119) — **failure stories welcome** |++Comment **"I'll take this"** on any [`good first issue`](https://github.com/cobusgreyling/loop-engineering/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) for assignment.+## ContributingShare production patterns, tool mappings, and failure stories. See [CONTRIBUTING.md](CONTRIBUTING.md) (contribution ladder + [`good first issue` backlog](https://github.com/cobusgreyling/loop-engineering/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)), [adopters](docs/adopters.md), and [GitHub Discussions](https://github.com/cobusgreyling/loop-engineering/discussions).