Skip to content

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.

chore: improve contributor visibility

Cobus Greyling648bd607f469
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
index 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.yml
about: "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.yml
index 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.md
index 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.
+
## Contributing
Share 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).