Skip to content

Commit 3746fdc

Browse files
Jonathan D.A. Jewellclaude
andcommitted
feat: complete Level 1 Evidence Mapper materials (Week 1)
Week 1 deliverables for Wayfinder proof-of-concept: 1. Level 1 README (materials/level-1/README.adoc): - Complete learning pathway (5 steps, 4-8 hours) - PROMPT framework explanation with examples - Good vs. bad claim selection criteria - Common mistakes and how to avoid them - Completion checklist - Pathways to Level 2A/2B 2. PROMPT Worksheet (materials/level-1/PROMPT-Worksheet.adoc): - Structured template for evaluating evidence - 6 dimensions with detailed prompts - Space for multiple evidence pieces - Summary analysis section - Reflection prompts for meta-cognition - Epistemic honesty emphasis 3. Evidence Map Template (materials/level-1/Evidence-Map-Template.adoc): - Visual and textual mapping options - Convergence/divergence analysis - Evidence quality matrix - Gap identification - Multi-stakeholder navigation guide (boundary objects) - Synthesis sections (what we know/don't know/are uncertain about) Project Status Update: - Overall completion: 15% → 30% - Level 1 materials: COMPLETE ✅ - Test infrastructure: COMPLETE ✅ - Bot directives: COMPLETE ✅ Next: Create example investigation, begin beta testing Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
1 parent 8708e90 commit 3746fdc

4 files changed

Lines changed: 606 additions & 9 deletions

File tree

.machine_readable/STATE.scm

Lines changed: 19 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -19,17 +19,23 @@
1919

2020
(current-position
2121
(phase "proof-of-concept")
22-
(overall-completion 15)
22+
(overall-completion 30)
2323
(components
2424
("PROMPT framework" . "complete")
2525
("Level 1-4 pathway design" . "complete")
2626
("Cognitive science integration" . "complete")
2727
("SWOT analysis" . "complete")
28-
("Technical architecture planning" . "complete"))
28+
("Technical architecture planning" . "complete")
29+
("Test infrastructure" . "complete")
30+
("Bot directives" . "complete")
31+
("Level 1 materials" . "complete"))
2932
(working-features
3033
("Conceptual framework"
3134
"Boundary objects theory application"
32-
"Heutagogic design")))
35+
"Heutagogic design"
36+
"Evidence mapping templates"
37+
"PROMPT worksheets"
38+
"Validation testing")))
3339

3440
(route-to-mvp
3541
(milestones
@@ -48,13 +54,17 @@
4854

4955
(critical-next-actions
5056
(immediate
51-
("Develop Level 1 materials and evidence mapping templates"))
57+
("Create first example investigation using Level 1 materials"
58+
"Test Level 1 materials with 1-2 beta testers"))
5259
(this-week
53-
("Create first example investigation"
54-
"Document capability pathway"))
60+
("Complete Week 1 deliverables"
61+
"Share Level 1 materials with 3 journalist friends"))
5562
(this-month
56-
("Share with initial journalist beta testers"
57-
"Build GitLab Pages website")))
63+
("Recruit 5-10 beta testers"
64+
"Build GitLab Pages website"
65+
"Begin Week 2-4 plan execution")))
5866

5967
(session-history
60-
(("2026-02-07" . "RSR compliance: added .machine_readable structure, fixed workflows, removed duplicates"))))
68+
(("2026-02-07" . "RSR compliance: added .machine_readable structure, fixed workflows, removed duplicates")
69+
("2026-02-07" . "Infrastructure: test suite, bot directives, Hypatia/gitbot-fleet integration verified")
70+
("2026-02-07" . "Week 1 started: Level 1 materials complete (README, PROMPT worksheet, evidence map template)"))))
Lines changed: 203 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,203 @@
1+
// SPDX-License-Identifier: PMPL-1.0-or-later
2+
= Evidence Map Template
3+
:toc:
4+
5+
**Claim:** _[Your specific claim]_
6+
7+
**Mapper:** _[Your name]_
8+
9+
**Date:** _[Today's date]_
10+
11+
---
12+
13+
== Visual Map
14+
15+
_[You can draw this by hand, use tools like Obsidian, TiddlyWiki, or just describe it textually below]_
16+
17+
=== Textual Representation
18+
19+
[source,text]
20+
----
21+
CLAIM: [Your claim here]
22+
├── Evidence 1 (Score: 0.X) [Supports/Contradicts]
23+
│ └── Connected to: Evidence 3
24+
├── Evidence 2 (Score: 0.X) [Supports/Contradicts]
25+
│ └── Contradicts: Evidence 4
26+
├── Evidence 3 (Score: 0.X) [Supports/Contradicts]
27+
│ ├── Connected to: Evidence 1
28+
│ └── Connected to: Evidence 5
29+
├── Evidence 4 (Score: 0.X) [Supports/Contradicts]
30+
│ └── Contradicts: Evidence 2
31+
└── Evidence 5 (Score: 0.X) [Supports/Contradicts]
32+
└── Connected to: Evidence 3
33+
----
34+
35+
---
36+
37+
== Evidence Relationships
38+
39+
=== Convergence (Agreement)
40+
41+
**Cluster 1: _[Theme/Aspect]_**
42+
- Evidence: _[List evidence pieces that agree]_
43+
- What they say: _[Common finding]_
44+
- Combined PROMPT score: _[Average or range]_
45+
- Confidence: _[How confident can we be in this convergence?]_
46+
47+
**Cluster 2: _[Theme/Aspect]_**
48+
- Evidence: _[List evidence pieces]_
49+
- What they say: _[Common finding]_
50+
- Combined PROMPT score: _[Average or range]_
51+
- Confidence: _[Assessment]_
52+
53+
=== Divergence (Disagreement)
54+
55+
**Contradiction 1: _[Specific point of disagreement]_**
56+
- Evidence A says: _[Position A]_
57+
- Evidence B says: _[Position B]_
58+
- Possible reasons for divergence:
59+
* _[Different methodologies?]_
60+
* _[Different time periods?]_
61+
* _[Different populations studied?]_
62+
* _[Conflicting interests?]_
63+
- Which is more reliable? _[Based on PROMPT scores]_
64+
65+
**Contradiction 2: _[Specific point of disagreement]_**
66+
- Evidence C says: _[Position C]_
67+
- Evidence D says: _[Position D]_
68+
- Possible reasons: _[Analysis]_
69+
70+
=== Gaps in Evidence
71+
72+
**Missing Perspective 1:** _[What viewpoint is absent?]_
73+
- Why it matters: _[Importance]_
74+
- How to fill: _[Potential sources]_
75+
76+
**Missing Perspective 2:** _[What aspect is unexplored?]_
77+
- Why it matters: _[Importance]_
78+
- How to fill: _[Potential sources]_
79+
80+
**Methodological Gaps:**
81+
- What kind of research hasn't been done yet?
82+
- What would be needed to strengthen confidence?
83+
84+
---
85+
86+
== Evidence Quality Matrix
87+
88+
[cols="2,1,1,1,1"]
89+
|===
90+
|Evidence |PROMPT Avg |Supports Claim |Contradicts Claim |Notes
91+
92+
|Evidence 1
93+
|_[0.0-1.0]_
94+
|_[Yes/No/Partial]_
95+
|_[Yes/No/Partial]_
96+
|_[Key point]_
97+
98+
|Evidence 2
99+
|_[0.0-1.0]_
100+
|_[Yes/No/Partial]_
101+
|_[Yes/No/Partial]_
102+
|_[Key point]_
103+
104+
|Evidence 3
105+
|_[0.0-1.0]_
106+
|_[Yes/No/Partial]_
107+
|_[Yes/No/Partial]_
108+
|_[Key point]_
109+
110+
|Evidence 4
111+
|_[0.0-1.0]_
112+
|_[Yes/No/Partial]_
113+
|_[Yes/No/Partial]_
114+
|_[Key point]_
115+
116+
|Evidence 5
117+
|_[0.0-1.0]_
118+
|_[Yes/No/Partial]_
119+
|_[Yes/No/Partial]_
120+
|_[Key point]_
121+
|===
122+
123+
---
124+
125+
== Synthesis
126+
127+
=== What We Know (High Confidence)
128+
129+
_[Evidence with high PROMPT scores that converges]_
130+
131+
**Claims we can make confidently:**
132+
1. _[Specific finding]_
133+
2. _[Specific finding]_
134+
3. _[Specific finding]_
135+
136+
=== What's Uncertain (Low-Medium Confidence)
137+
138+
_[Areas where evidence is weak, contradictory, or missing]_
139+
140+
**Claims that need caveats:**
141+
1. _[Tentative finding with caveat]_
142+
2. _[Tentative finding with caveat]_
143+
144+
=== What We Don't Know (Gaps)
145+
146+
**Unanswered questions:**
147+
1. _[Question]_
148+
2. _[Question]_
149+
3. _[Question]_
150+
151+
**What would help answer them:**
152+
- _[Type of research/evidence needed]_
153+
154+
---
155+
156+
== Epistemic Navigation Guide
157+
158+
If you're reading this as a journalist, policymaker, activist, or citizen, here's how to navigate this evidence ecosystem:
159+
160+
=== For Activists
161+
**Action-relevant findings:**
162+
- _[What does the evidence support for action?]_
163+
- _[What caveats matter for strategy?]_
164+
165+
=== For Policymakers
166+
**Decision-relevant findings:**
167+
- _[What trade-offs does evidence reveal?]_
168+
- _[What unknowns affect policy choices?]_
169+
170+
=== For Skeptics
171+
**Challenge points:**
172+
- _[Where is evidence weakest?]_
173+
- _[What would falsify the claim?]_
174+
175+
=== For Academics
176+
**Research gaps:**
177+
- _[What studies are needed?]_
178+
- _[What methodological improvements would help?]_
179+
180+
=== For Affected Communities
181+
**Relevance to lived experience:**
182+
- _[Does evidence reflect your reality?]_
183+
- _[What perspectives are missing?]_
184+
185+
---
186+
187+
== Meta-Reflection
188+
189+
**How did mapping change your understanding?**
190+
191+
_[Before mapping, you thought... After mapping, you realize...]_
192+
193+
**What did you learn about evidence ecosystems?**
194+
195+
_[Insights about how evidence works in the real world]_
196+
197+
**What would you do differently next time?**
198+
199+
_[Learning from this experience]_
200+
201+
---
202+
203+
*This map is a boundary object - different communities can use it for their needs while working with the same evidence. That's coordination without consensus.*

0 commit comments

Comments
 (0)