@@ -15,23 +15,27 @@ Read these in order — they take about 10 minutes together and prevent the most
1515Browse [ problem-packs/] ( problem-packs/ ) and find a domain that matches your expertise or curiosity.
1616
1717** If you are an epidemiologist or public-health researcher:**
18+
1819- [ climate-health/malaria-early-warning-africa] ( problem-packs/climate-health/malaria-early-warning-africa/ ) — sub-national malaria-climate signals
1920- [ climate-health/dengue-heat-vietnam] ( problem-packs/climate-health/dengue-heat-vietnam/ ) — dengue risk in Viet Nam
2021- [ climate-health/heat-stress-urban-south-asia] ( problem-packs/climate-health/heat-stress-urban-south-asia/ ) — heat stress mortality risk
2122- [ public-health/stunting-sub-saharan-africa] ( problem-packs/public-health/stunting-sub-saharan-africa/ ) — child stunting hotspots
2223
2324** If you work in climate, remote sensing, or earth observation:**
25+
2426- [ biodiversity/coral-bleaching-great-barrier-reef] ( problem-packs/biodiversity/coral-bleaching-great-barrier-reef/ ) — satellite bleaching detection
2527- [ biodiversity/deforestation-amazon] ( problem-packs/biodiversity/deforestation-amazon/ ) — deforestation and species loss
2628- [ water-security/glacial-melt-hindu-kush] ( problem-packs/water-security/glacial-melt-hindu-kush/ ) — glacial melt and water security
2729- [ climate-adaptation/sea-level-rise-small-islands] ( problem-packs/climate-adaptation/sea-level-rise-small-islands/ ) — sea-level rise exposure
2830
2931** If you work in food security, agriculture, or logistics:**
32+
3033- [ food-security/locust-outbreak-east-africa] ( problem-packs/food-security/locust-outbreak-east-africa/ ) — locust early warning
3134- [ food-security/drought-early-warning-horn-of-africa] ( problem-packs/food-security/drought-early-warning-horn-of-africa/ ) — drought and food insecurity
3235- [ water-security/groundwater-depletion-india] ( problem-packs/water-security/groundwater-depletion-india/ ) — groundwater depletion
3336
3437** If you work in energy access or development economics:**
38+
3539- [ energy-access/mini-grid-rural-sub-saharan-africa] ( problem-packs/energy-access/mini-grid-rural-sub-saharan-africa/ ) — mini-grid viability
3640- [ energy-access/clean-cooking-sub-saharan-africa] ( problem-packs/energy-access/clean-cooking-sub-saharan-africa/ ) — clean cooking adoption
3741- [ education/learning-loss-post-pandemic] ( problem-packs/education/learning-loss-post-pandemic/ ) — post-pandemic learning loss
@@ -43,6 +47,7 @@ Any pack's `source-inventory` task is scoped and ready. Start with [climate-heal
4347## Step 2: Read the Pack
4448
4549In your chosen problem pack, read:
50+
4651- ` problem.md ` — the problem statement, known facts, uncertain areas, scope, done condition
4752- ` task-map.md ` — the work sequence and merge discipline
4853- ` tasks.json ` — the specific tasks with outcomes, inputs, and done conditions
@@ -66,13 +71,13 @@ If `pnpm validate` passes, your local environment is ready.
6671
6772Pick the agent role guide that matches your task:
6873
69- | If your task involves... | Use this role |
70- | --------------------------| ---------------|
71- | Finding and classifying sources | [ Literature Scout] ( agents/literature-scout.md ) |
72- | Cleaning datasets and documenting provenance | [ Data Cleaner] ( agents/data-cleaner.md ) |
73- | Breaking tasks into reproducible steps | [ Implementation Planner] ( agents/implementation-planner.md ) |
74- | Stress-testing claims against field context | [ Field-Reality Reviewer] ( agents/field-reality-reviewer.md ) |
75- | Finding failure modes and misuse risks | [ Red-Team Reviewer] ( agents/red-team-reviewer.md ) |
74+ | If your task involves... | Use this role |
75+ | -------------------------------------------- | ---------------------------------------------------------- |
76+ | Finding and classifying sources | [ Literature Scout] ( agents/literature-scout.md ) |
77+ | Cleaning datasets and documenting provenance | [ Data Cleaner] ( agents/data-cleaner.md ) |
78+ | Breaking tasks into reproducible steps | [ Implementation Planner] ( agents/implementation-planner.md ) |
79+ | Stress-testing claims against field context | [ Field-Reality Reviewer] ( agents/field-reality-reviewer.md ) |
80+ | Finding failure modes and misuse risks | [ Red-Team Reviewer] ( agents/red-team-reviewer.md ) |
7681
7782Read the role guide. It tells you exactly what to produce, what failure modes to avoid, and what your merge gate is.
7883
@@ -83,6 +88,7 @@ Use the [Agent Submission](.github/ISSUE_TEMPLATE/agent-submission.yml) or [Task
8388For your first contribution, use the ** Agent Submission** template even if you are a human — it has the right fields.
8489
8590Fill in:
91+
8692- ** Task ID** : the exact ` id ` field from ` tasks.json `
8793- ** Claim** : one specific, falsifiable statement
8894- ** Evidence** : source title, URL, date, access date
@@ -98,6 +104,7 @@ Do not try to write a comprehensive analysis. Write one narrow, verifiable claim
98104If your submission changes canonical files (` evidence.json ` , ` task-map.md ` , ` datasets.md ` , ` outputs.md ` ), open a pull request.
99105
100106Run before opening:
107+
101108``` bash
102109pnpm build && pnpm validate
103110```
0 commit comments