Contributor quickstart — good first issues (refreshed)

[cobusgreyling]

We keep a scoped good first issue backlog so new contributors have reviewable work — not a blank README.

Start here (pick one)

Time	Issue	What you will do
~10 min	#120 — Adopters	One row in docs/adopters.md or the Add Adopter template
~15–20 min	#118 · #173 · #119 · #392	Production story under stories/
~25–30 min	#389 · #390 · #391	QUICKSTART subsections for loop-action / sandbox / gate
~40 min	#384–#386	Windsurf pattern examples (coverage gaps)
~40–45 min	#387 · #388	Hermes pattern examples
~45–60 min	#393	Harden loop-action command quoting

Live filter: open good first issues · full table: README § Help wanted

How to claim

1. Comment I'll take this on the issue
2. Open a PR that links the issue (Closes #N)
3. Stories / adopters: aim for same-day review (see CONTRIBUTING.md)

Maintainers

Re-seed with bash scripts/create-good-first-issues.sh (idempotent). Prefer the live GitHub filter over hardcoded counts.

Last refreshed: 2026-07-25 — 14 open good first issues after wave-4 seed.

[cobusgreyling]

Update (July 2): First community merge landed — @roian6's Aider appendix (#127). Also shipped Cursor/Windsurf examples (#128) and loop-context (#129).

Still open from the table below: #117–#122, plus story issues #118/#119. Comment "I'll take this" on any issue for assignment.

@harshjainnn is on #114 — we're waiting on his preference before closing (see #126).

[cobusgreyling]

Backlog refreshed — 8 new good first issues

Comment I'll take this on any issue for assignment.

Time	Issue	Task
~10 min	#152 — Aider link	Link Aider appendix from examples/README
~15 min	#149 — Hermes table	Add Hermes to examples/README coverage
~15 min	#151 — Dep Sweeper story	Share a Dependency Sweeper failure story
~20 min	#150 — MCP Quickstart	loop-mcp-server install snippet
~20 min	#153 — loop-context	Document circuit breaker in QUICKSTART
~30 min	#147 — Cline / #148 — Zed	Primitives matrix appendices
~45 min	#154 — Cursor PR Babysitter	Example doc for L2 pattern gap

Still open from before: #117 Continue.dev · #118/#119 stories · #120 adopters.

[cobusgreyling]

Backlog refresh — July 5, 2026

Shipped since the July 4 batch: Hermes + Aider in examples/README, QUICKSTART circuit breaker + MCP snippets (#158), Cursor PR Babysitter (#156).

12 good first issues open — comment I'll take this on any issue for assignment.

Time	Issue	Task
~10 min	#120 — Adopters	One row in docs/adopters.md
~10 min	#161 — Hermes index	examples/hermes/README.md
~15 min	#159 — Hermes starters table	Copy-paste starters row
~15 min	#160 — Hermes Quickstart	docs/QUICKSTART.md subsection
~30 min	#117 — Continue.dev · #147 — Cline · #148 — Zed	Primitives matrix appendices
~30 min	#162 — Windsurf PR Babysitter	Example doc (Cursor pattern in #156)
~45 min	#118 · #119 · #151 · #163	Production / failure stories

Full backlog: https://github.com/cobusgreyling/loop-engineering/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22

Same-day review on stories, adopters, and scoped docs/example PRs. Failures welcome.

[cobusgreyling]

Backlog refresh — July 6, 2026

Shipped since the July 5 batch:

• Contributor growth (#176) — CLI CTAs in loop-init + loop-audit, CONTRIBUTORS.md, generator script
• npm — @cobusgreyling/loop-audit@1.5.3 and @cobusgreyling/loop-init@1.3.3 live; npx runs now end with the contributor quickstart link

7 new good first issues (wave 2) — comment I'll take this on any issue for assignment.

Time	Issue	Task
~10 min	#171 — Aider link	Link Aider appendix from examples/README.md
~15 min	#172 — Hermes directory	Hermes row in examples tool table
~15 min	#173 — Issue Triage story	Week-one label-only automation story
~20 min	#169 — loop-context	Circuit breaker subsection in QUICKSTART
~20 min	#170 — loop-mcp-server	MCP install snippet in QUICKSTART
~30 min	#174 — Opencode constraints	CLI-first constraints example doc
~20 min	#175 — Multi-loop story	Running two loops without overlap

19 good first issues open total. Fastest wins still:

Time	Issue	Task
~10 min	#120 — Adopters	One row in docs/adopters.md
~15 min	#159–#161	Hermes docs follow-ups from #141
~30 min	#117 · #147 · #148	Primitives matrix appendices
~45 min	#118 · #119 · #151 · #163	Production / failure stories

Full backlog: https://github.com/cobusgreyling/loop-engineering/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22

See who has shipped: CONTRIBUTORS.md. Same-day review on stories, adopters, and scoped docs/example PRs. Failures welcome.