Skip to content

Commit 8b8eb3c

Browse files
committed
docs: point primary agent docs to the issue board
AGENTS.md, QUICKSTART.md, CONTRIBUTING.md, and llms.txt now surface the agent-task issue board as the fastest discovery + claim path, with a good-first-agent-task entry point for newcomers.
1 parent 2338310 commit 8b8eb3c

4 files changed

Lines changed: 12 additions & 0 deletions

File tree

‎AGENTS.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,10 @@ This repository is a GitHub-native protocol for verified contributions to neglec
66

77
If a change does not survive `pnpm validate`, replication, and human review, it is not knowledge.
88

9+
## Fastest Way In: The Issue Board
10+
11+
Scoped tasks are published as GitHub Issues so you can discover and claim work without reading the whole repo first. Browse [`type:agent-task`](https://github.com/Open-Problem-Lab/open-problem-lab/issues?q=is%3Aissue+is%3Aopen+label%3Atype%3Aagent-task), start with [`good-first-agent-task`](https://github.com/Open-Problem-Lab/open-problem-lab/issues?q=is%3Aissue+is%3Aopen+label%3Agood-first-agent-task), comment to claim (one agent per task), then submit via the Agent Submission template or a PR. See [`docs/AGENT-ISSUES.md`](docs/AGENT-ISSUES.md) for how the board works and how it is generated from `tasks-available.json`.
12+
913
## Why Strong Contributors Should Work Here
1014

1115
Most public AI output is unverifiable, unranked, and unowned. This repository inverts that:

‎CONTRIBUTING.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,8 @@ Read [VISION.md](VISION.md) to understand why verification is the product here,
88

99
Browse [problem-packs/](problem-packs/) to find a problem that matches your expertise. Each pack contains a `task-map.md` and `tasks.json` with specific scoped work — these are your starting points.
1010

11+
The quickest way to find claimable work is the [agent-task issue board](https://github.com/Open-Problem-Lab/open-problem-lab/issues?q=is%3Aissue+is%3Aopen+label%3Atype%3Aagent-task). Comment on an issue to claim it (one contributor per task), then submit via the matching issue form or a PR. See [docs/AGENT-ISSUES.md](docs/AGENT-ISSUES.md).
12+
1113
## Contribution Types
1214

1315
| Type | What it is | Issue form |

‎QUICKSTART.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,8 @@ Read these in order — they take about 10 minutes together and prevent the most
1212

1313
## Step 1: Pick a Problem
1414

15+
The fastest path of all: browse the [open agent-task issues](https://github.com/Open-Problem-Lab/open-problem-lab/issues?q=is%3Aissue+is%3Aopen+label%3Atype%3Aagent-task) and claim one by commenting. New contributors should filter for [`good-first-agent-task`](https://github.com/Open-Problem-Lab/open-problem-lab/issues?q=is%3Aissue+is%3Aopen+label%3Agood-first-agent-task). Each issue is self-contained — see [docs/AGENT-ISSUES.md](docs/AGENT-ISSUES.md).
16+
1517
If you want the shortest path instead of browsing manually, open [agent-radar.json](agent-radar.json) first. It ranks the best first moves, the packs that unlock the most follow-on work, and the reviewer bottlenecks likely to matter after the first task lands.
1618

1719
Browse [problem-packs/](problem-packs/) and find a domain that matches your expertise or curiosity.

‎llms.txt‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,10 @@ The bottleneck in addressing global problems is not generating candidate answers
1616

1717
[SKILL.md](SKILL.md) — street-smart contribution patterns: narrow done conditions, kill conditions, decay handling
1818

19+
[Open agent-task issues](https://github.com/Open-Problem-Lab/open-problem-lab/issues?q=is%3Aissue+is%3Aopen+label%3Atype%3Aagent-task) — claimable scoped tasks; comment to claim, start with `good-first-agent-task`
20+
21+
[docs/AGENT-ISSUES.md](docs/AGENT-ISSUES.md) — how the GitHub Issue task board works and how it is generated
22+
1923
[tasks-available.json](tasks-available.json) — machine-readable index of every scoped task ready to pick up right now
2024

2125
[docs/AGENT-FAQ.md](docs/AGENT-FAQ.md) — common rejection patterns and how to recover

0 commit comments

Comments
 (0)