Skip to content

Commit 78a4542

Browse files
committed
Strengthen birth registration problem pack
1 parent c6be561 commit 78a4542

18 files changed

Lines changed: 501 additions & 139 deletions

‎AGENTS.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ Correct, narrow, and falsifiable beats prolific.
1919

2020
## Key Components
2121

22-
- `problem-packs/`: canonical problem-pack directories with task maps across multiple domains. Read generated indexes for live counts.
22+
- `problem-packs/`: canonical problem-pack directories with task maps across multiple domains. Read generated indexes for live counts. When calibrating pack quality, use strong exemplars such as `climate-health/dengue-heat-vietnam` for operational humility and `public-health/birth-registration-access-global` for measure-family discipline across survey, CRVS, and health-touchpoint evidence.
2323
- `schemas/`: JSON schemas for machine-checkable protocol objects.
2424
- `.github/ISSUE_TEMPLATE/`: structured issue forms.
2525
- `.github/workflows/`: validation, source verification, reproducibility, and Wiki publishing.

‎SKILL.md‎

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -77,9 +77,12 @@ If your task map declares an expected artifact, include the exact command, input
7777

7878
Strong rejections are worth more than mediocre approvals. A precise rejection that names the failure mode prevents a class of future bad merges. If you are reviewing, your output should read like a `review.json` record, not a comment.
7979

80-
### 7. Read the dengue-heat-vietnam pack as the reference
80+
### 7. Read reference packs before inventing your own standard
8181

82-
`problem-packs/climate-health/dengue-heat-vietnam/` is the calibration sample. New packs should match its level of grain, sourcing, and explicit limits — not exceed scope, not fall short on evidence.
82+
- `problem-packs/climate-health/dengue-heat-vietnam/` is the calibration sample for operational humility, bounded claims, and analytic-use warnings.
83+
- `problem-packs/public-health/birth-registration-access-global/` is the calibration sample for packs where one "indicator" hides multiple incompatible measures and where service-linkage claims need explicit workflow language.
84+
85+
New packs should match that level of grain, sourcing, and explicit limits — not exceed scope, not fall short on evidence.
8386

8487
### 8. Report the friction you hit
8588

‎agent-radar.json‎

Lines changed: 27 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -3,39 +3,55 @@
33
"generated_by": "scripts/generate-agent-radar.mjs",
44
"schema_version": 1,
55
"total_packs": 100,
6-
"total_tasks": 515,
6+
"total_tasks": 516,
77
"scoped_tasks": 100,
8-
"latent_tasks": 415,
8+
"latent_tasks": 416,
99
"status_counts": {
1010
"scoped": 100,
11-
"needs-triage": 415
11+
"needs-triage": 416
1212
},
1313
"owner_role_counts": {
1414
"literature-scout": 100,
1515
"data-cleaner": 96,
16-
"implementation-planner": 118,
16+
"implementation-planner": 119,
1717
"red-team-reviewer": 100,
1818
"field-reality-reviewer": 101
1919
},
2020
"scoped_role_counts": {
2121
"literature-scout": 100
2222
},
2323
"reviewer_needed_counts": {
24-
"domain-reviewer": 211,
24+
"domain-reviewer": 212,
2525
"replicator": 102,
2626
"red-team-reviewer": 100,
2727
"field-reality-reviewer": 102
2828
},
2929
"safety_risk_counts": {
30-
"medium": 233,
30+
"medium": 236,
3131
"high": 268,
32-
"low": 14
32+
"low": 12
3333
},
3434
"protocol_alert_count": 0
3535
},
3636
"protocol_alerts": [],
3737
"contributor_lanes": {
3838
"first_moves": [
39+
{
40+
"pack_id": "public-health/birth-registration-access-global",
41+
"pack_title": "Birth Registration Coverage Gaps And Health-Service Linkage In Low-Income Countries",
42+
"task_id": "source-inventory",
43+
"title": "Inventory survey, CRVS, and health-touchpoint data sources for birth registration analysis",
44+
"owner_role": "literature-scout",
45+
"reviewer_needed": "domain-reviewer",
46+
"safety_risk": "low",
47+
"done_condition": "At least six candidate sources are classified as usable, limited, or rejected with explicit reasons covering measure family, timing, geographic grain, and health-linkage relevance.",
48+
"evidence_count": 7,
49+
"downstream_tasks_unlocked": 5,
50+
"downstream_high_risk_tasks": 2,
51+
"problem_file": "problem-packs/public-health/birth-registration-access-global/problem.md",
52+
"tasks_file": "problem-packs/public-health/birth-registration-access-global/tasks.json",
53+
"why_pick_now": "Completing this scoped task opens 5 follow-on tasks across 4 additional roles."
54+
},
3955
{
4056
"pack_id": "education/digital-divide-school-access-global",
4157
"pack_title": "Digital Divide Measurement And School Internet Connectivity In Low-Income Countries",
@@ -68,22 +84,6 @@
6884
"tasks_file": "problem-packs/education/skills-training-youth-employment-global/tasks.json",
6985
"why_pick_now": "Completing this scoped task opens 4 follow-on tasks across 4 additional roles."
7086
},
71-
{
72-
"pack_id": "public-health/birth-registration-access-global",
73-
"pack_title": "Birth Registration Coverage Gaps And Health-Service Linkage In Low-Income Countries",
74-
"task_id": "source-inventory",
75-
"title": "Inventory data sources for public-health/birth-registration-access-global",
76-
"owner_role": "literature-scout",
77-
"reviewer_needed": "domain-reviewer",
78-
"safety_risk": "low",
79-
"done_condition": "At least four sources classified as usable, limited, or rejected with explicit reasons.",
80-
"evidence_count": 1,
81-
"downstream_tasks_unlocked": 4,
82-
"downstream_high_risk_tasks": 2,
83-
"problem_file": "problem-packs/public-health/birth-registration-access-global/problem.md",
84-
"tasks_file": "problem-packs/public-health/birth-registration-access-global/tasks.json",
85-
"why_pick_now": "Completing this scoped task opens 4 follow-on tasks across 4 additional roles."
86-
},
8787
{
8888
"pack_id": "public-health/ncd-risk-factor-surveillance-global",
8989
"pack_title": "Non-Communicable Disease Risk Factor Surveillance Gaps In Low-Income Countries",
@@ -654,9 +654,9 @@
654654
{
655655
"owner_role": "implementation-planner",
656656
"scoped_tasks": 0,
657-
"latent_tasks": 118,
658-
"share_of_all_tasks": 0.229,
659-
"share_of_latent_tasks": 0.284
657+
"latent_tasks": 119,
658+
"share_of_all_tasks": 0.231,
659+
"share_of_latent_tasks": 0.286
660660
},
661661
{
662662
"owner_role": "field-reality-reviewer",
@@ -670,7 +670,7 @@
670670
"scoped_tasks": 0,
671671
"latent_tasks": 100,
672672
"share_of_all_tasks": 0.194,
673-
"share_of_latent_tasks": 0.241
673+
"share_of_latent_tasks": 0.24
674674
},
675675
{
676676
"owner_role": "data-cleaner",

‎docs/wiki/Agent-Radar.md‎

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -14,18 +14,30 @@ Without routing, a new agent sees a flat task list and misses the actual shape o
1414
## Current Shape
1515

1616
- **100 problem packs**
17-
- **515 total tasks**
17+
- **516 total tasks**
1818
- **100 scoped now**
19-
- **415 follow-on tasks still latent**
20-
- **Owner roles:** `data-cleaner`: 96, `field-reality-reviewer`: 101, `implementation-planner`: 118, `literature-scout`: 100, `red-team-reviewer`: 100
21-
- **Reviewer demand:** `domain-reviewer`: 211, `field-reality-reviewer`: 102, `red-team-reviewer`: 100, `replicator`: 102
22-
- **Safety mix:** `high`: 268, `low`: 14, `medium`: 233
19+
- **416 follow-on tasks still latent**
20+
- **Owner roles:** `data-cleaner`: 96, `field-reality-reviewer`: 101, `implementation-planner`: 119, `literature-scout`: 100, `red-team-reviewer`: 100
21+
- **Reviewer demand:** `domain-reviewer`: 212, `field-reality-reviewer`: 102, `red-team-reviewer`: 100, `replicator`: 102
22+
- **Safety mix:** `high`: 268, `low`: 12, `medium`: 236
2323

2424
## First Moves
2525

2626
These are the best entry tasks for a fresh contributor. Ranking favors lower-risk scoped work first, then packs where a successful first move unlocks the most downstream tasks.
2727

28-
### 1. Digital Divide Measurement And School Internet Connectivity In Low-Income Countries
28+
### 1. Birth Registration Coverage Gaps And Health-Service Linkage In Low-Income Countries
29+
30+
- Pack: [`public-health/birth-registration-access-global`](../../problem-packs/public-health/birth-registration-access-global/problem.md)
31+
- Task: `source-inventory` — Inventory survey, CRVS, and health-touchpoint data sources for birth registration analysis
32+
- Risk: `low`
33+
- Reviewer needed: `domain-reviewer`
34+
- Existing evidence records: 7
35+
- Downstream tasks unlocked: 5
36+
- Downstream high-risk tasks: 2
37+
- Why pick now: Completing this scoped task opens 5 follow-on tasks across 4 additional roles.
38+
- Done condition: At least six candidate sources are classified as usable, limited, or rejected with explicit reasons covering measure family, timing, geographic grain, and health-linkage relevance.
39+
40+
### 2. Digital Divide Measurement And School Internet Connectivity In Low-Income Countries
2941

3042
- Pack: [`education/digital-divide-school-access-global`](../../problem-packs/education/digital-divide-school-access-global/problem.md)
3143
- Task: `source-inventory` — Inventory school connectivity, mobile-network, and digital-learning data sources for low-income countries
@@ -37,7 +49,7 @@ These are the best entry tasks for a fresh contributor. Ranking favors lower-ris
3749
- Why pick now: Completing this scoped task opens 4 follow-on tasks across 4 additional roles.
3850
- Done condition: At least five candidate data sources are classified as usable, limited, or rejected with explicit reasons covering connectivity-classification methodology, data currency, and cross-validation status.
3951

40-
### 2. Youth Skills Training And Employment Outcome Gaps In Low-Income Countries
52+
### 3. Youth Skills Training And Employment Outcome Gaps In Low-Income Countries
4153

4254
- Pack: [`education/skills-training-youth-employment-global`](../../problem-packs/education/skills-training-youth-employment-global/problem.md)
4355
- Task: `source-inventory` — Inventory training-provider, employment-outcome, labor-market, and skills-mismatch data sources for LMICs
@@ -49,18 +61,6 @@ These are the best entry tasks for a fresh contributor. Ranking favors lower-ris
4961
- Why pick now: Completing this scoped task opens 4 follow-on tasks across 4 additional roles.
5062
- Done condition: At least five candidate data sources are classified as usable, limited, or rejected with explicit reasons covering provider-data fragmentation, outcome-tracking rates, and informal-sector measurement gaps.
5163

52-
### 3. Birth Registration Coverage Gaps And Health-Service Linkage In Low-Income Countries
53-
54-
- Pack: [`public-health/birth-registration-access-global`](../../problem-packs/public-health/birth-registration-access-global/problem.md)
55-
- Task: `source-inventory` — Inventory data sources for public-health/birth-registration-access-global
56-
- Risk: `low`
57-
- Reviewer needed: `domain-reviewer`
58-
- Existing evidence records: 1
59-
- Downstream tasks unlocked: 4
60-
- Downstream high-risk tasks: 2
61-
- Why pick now: Completing this scoped task opens 4 follow-on tasks across 4 additional roles.
62-
- Done condition: At least four sources classified as usable, limited, or rejected with explicit reasons.
63-
6464
### 4. Non-Communicable Disease Risk Factor Surveillance Gaps In Low-Income Countries
6565

6666
- Pack: [`public-health/ncd-risk-factor-surveillance-global`](../../problem-packs/public-health/ncd-risk-factor-surveillance-global/problem.md)
@@ -387,9 +387,9 @@ This is the actual pipeline shape. The flat scoped list hides it.
387387

388388
| Role | Scoped now | Latent backlog | Share of all tasks | Share of latent tasks |
389389
| ------------------------ | ---------- | -------------- | ------------------ | --------------------- |
390-
| `implementation-planner` | 0 | 118 | 0.229 | 0.284 |
390+
| `implementation-planner` | 0 | 119 | 0.231 | 0.286 |
391391
| `field-reality-reviewer` | 0 | 101 | 0.196 | 0.243 |
392-
| `red-team-reviewer` | 0 | 100 | 0.194 | 0.241 |
392+
| `red-team-reviewer` | 0 | 100 | 0.194 | 0.24 |
393393
| `data-cleaner` | 0 | 96 | 0.186 | 0.231 |
394394
| `literature-scout` | 100 | 0 | 0.194 | 0 |
395395

‎docs/wiki/Problem-Packs.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -518,7 +518,7 @@ Build a verified workflow for measuring antimicrobial resistance surveillance ga
518518
- Region: `global`
519519
- Source: [problem-packs/public-health/birth-registration-access-global](../../problem-packs/public-health/birth-registration-access-global/problem.md)
520520

521-
Build a verified workflow for measuring birth registration coverage gaps and linking registration data to health-service access.
521+
Build a verified workflow for separating survey-based birth-registration coverage, administrative completeness, and certificate possession before using any sub-national gap or health-service linkage claim.
522522

523523
## Avoidable Blindness And Cataract Surgical Coverage Gaps In Low- And Middle-Income Countries
524524

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
# Birth Registration Pack
2+
3+
## Overview
4+
5+
This pack exists to stop a common analytical error: treating survey-based under-5 birth-registration status, certificate possession, and administrative CRVS completeness as if they were one number.
6+
7+
Health-service linkage is allowed here only when the workflow is named. "Use the health system" is too vague to merge.
8+
9+
## Key Components
10+
11+
- `problem.md` and `problem.json`: pack scope, contrarian framing, and merge gates.
12+
- `tasks.json`: sequencing from source inventory to measure reconciliation, country selection, and red-team review.
13+
- `datasets.md` and `evidence.json`: canonical source inventory and evidence records.
14+
- `outputs.md`, `playbooks.md`, `validation.md`, `analytic-use-note.md`: what can be published, how to attack it, and what must be blocked.
15+
16+
## Diagrams (Mermaid)
17+
18+
### Flowchart
19+
20+
```mermaid
21+
flowchart TD
22+
A["Source inventory"] --> B["Measure-family note"]
23+
B --> C["Country selection"]
24+
C --> D["Missed-opportunity analysis"]
25+
D --> E["Red-team review"]
26+
D --> F["Field-reality review"]
27+
E --> G["Reviewed output"]
28+
F --> G
29+
```
30+
31+
### Component Diagram
32+
33+
```mermaid
34+
flowchart LR
35+
Problem["problem.*"] --> Tasks["tasks.json"]
36+
Tasks --> Evidence["evidence.json / datasets.md"]
37+
Tasks --> Rules["validation.md / analytic-use-note.md"]
38+
Tasks --> Outputs["outputs.md / playbooks.md"]
39+
```
40+
41+
### Sequence Diagram
42+
43+
```mermaid
44+
sequenceDiagram
45+
participant Contributor
46+
participant Evidence as evidence.json
47+
participant Reviewer
48+
Contributor->>Evidence: classify measure family and source limits
49+
Contributor->>Reviewer: propose country or touchpoint comparison
50+
Reviewer-->>Contributor: allow, narrow, or block based on comparability and misuse risk
51+
```
Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
# Analytic Use Note
2+
3+
This pack is for evidence review, measurement reconciliation, and bounded sub-national analysis.
4+
5+
A birth-registration artifact is not field-ready unless the PR states:
6+
7+
- which measure family is being used
8+
- which user is supposed to act on it
9+
- which health-service touchpoint is being discussed, if any
10+
- what the comparison cannot prove
11+
- what misuse the reviewers are explicitly blocking
Lines changed: 20 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,28 @@
11
# Dataset Inventory
22

3-
| Source | Grain | Status | Use |
4-
| ---------------------------- | ------------ | ------ | ------------- |
5-
| Primary survey data | Sub-national | Usable | Core analysis |
6-
| Satellite/environmental data | Variable | Usable | Risk context |
7-
| Population data | 100m | Usable | Denominator |
3+
## Candidate Sources
4+
5+
| Source | Grain | Current status | Use |
6+
| ---------------------------------------------- | -------------------------------- | -------------------------------------- | -------------------------------------------------------------- |
7+
| UNICEF birth registration database | Country, some sub-national notes | Usable for global and country framing | Official cross-country baseline and downloadable indicator set |
8+
| DHS birth-registration indicators or microdata | Household, cluster, sub-national | Usable where country access is granted | Survey-based under-5 registration and certificate possession |
9+
| MICS birth-registration module and datasets | Household, cluster, sub-national | Usable where country survey exists | Survey-based registration, proof, and knowledge-of-process |
10+
| World Bank WDI `SP.REG.BRTH.ZS` | Country | Usable with metadata caveat | Comparable SDG 16.9.1 series and official definition |
11+
| National CRVS administrative tabulations | Country to district, variable | Limited and country-specific | Administrative completeness and timeliness checks |
12+
| Health facility birth-notification systems | Facility to district, variable | Limited and access-constrained | Registration opportunities at delivery and postnatal contact |
13+
| Immunization or child-health registries | Child, facility, district | Limited and access-constrained | Missed-opportunity analysis for registration touchpoints |
14+
| Population denominators and admin boundaries | District, gridded, national | Usable but version-sensitive | Rate construction, district comparisons, and mapping context |
815

916
## Required Properties
1017

11-
Source methodology, data year, geographic grain, license.
18+
- Measure family: under-5 survey registration, certificate possession, or administrative live-birth completeness.
19+
- Data year and time reference.
20+
- Geographic grain and whether sub-national identifiers are preserved.
21+
- Numerator and denominator definition.
22+
- License, access conditions, and whether microdata require approval.
23+
- Known mismatch against other measure families.
24+
- Health-touchpoint relevance, if the source is being used to support service-linkage claims.
1225

1326
## Rejection Rule
1427

15-
Rejected if methodology, grain, date, or license unverifiable.
28+
A source is rejected for canonical comparison if the measure family, date, grain, or access conditions cannot be verified. Sources that are valid only for framing or only for one country should be listed as limited rather than silently generalized. Administrative and service data without clear denominator or catchment definitions may be used as context but not as proof of sub-national registration performance.

0 commit comments

Comments
 (0)