Good first issues
July 9, 2026 · View on GitHub
Starter tasks for contributors. Questions? Discussions → Contributor start here.
Pick an issue below, comment "I'd like to work on this", and follow CONTRIBUTING.md.
Documentation
| Task | Issue | Effort |
|---|---|---|
| Add a 30s terminal recording to README | #9 | Small |
| Document Windows/PowerShell equivalents for QUICKSTART | #11 | Small |
examples/cursor-only/ already exists — expand it via a new issue if you want a fuller walkthrough.
Integrations
| Task | Issue | Effort |
|---|---|---|
| Pre-commit hook template for evidence packaging | #13 | Small |
Aider adapter (--from custom-harness + post-run script) | #15 | Medium |
CLI & UX
| Task | Issue | Effort |
|---|---|---|
outerloop init --dry-run preview mode | #14 | Small |
| Shell completion scripts (bash/zsh/fish) | #12 | Medium |
outerloop audit --json output | #10 | Small |
Testing & quality
| Task | Issue | Effort |
|---|---|---|
| Expand CLI integration test coverage | #6 | Medium |
Increase packages/policy test coverage | #17 | Small |
| E2E: expand published-package smoke test | #18 | Medium |
| Fuzz test for policy DSL parser | #16 | Medium |
| Add ESLint across monorepo | #5 | Medium |
v3 / Future (experienced contributors)
Tracked in milestone: v3 / Future — not ideal first PRs.
| Task | Issue |
|---|---|
| Hosted dashboard with optional cloud sync | #1 |
| Graphite-style multi-repo coordination | #2 |
| Deeper loop-engineering state parsers | #3 |
| Cryptographic ledger signatures | #4 |
How to claim
- Find an issue (or pick from the tables above).
- Comment: I'd like to work on this.
- Fork, branch (
feat/ordocs/), implement with tests. - Add a changeset if you change published package behavior.
- Open a PR with rationale — we dogfood outer-loop answerability on our own merges.