Skip to content

Commit 6376c02

Browse files
Jonathan D.A. Jewellclaude
andcommitted
chore: sync template files and configuration
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 4080b22 commit 6376c02

3 files changed

Lines changed: 543 additions & 0 deletions

File tree

CHANGELOG.md

Lines changed: 221 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,221 @@
1+
# Changelog
2+
3+
All notable changes to the Wayfinder project will be documented in this file.
4+
5+
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6+
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html) where applicable.
7+
8+
## Philosophy
9+
10+
We maintain this changelog with the same values as the project:
11+
- **Transparency**: Document all significant changes
12+
- **Clarity**: Explain the "why" not just the "what"
13+
- **Honesty**: Include mistakes and lessons learned
14+
- **Attribution**: Credit contributors
15+
16+
## [Unreleased]
17+
18+
### Planned
19+
- Level 1 materials (evidence mapping templates, PROMPT worksheets)
20+
- First example investigation (to be determined based on beta tester feedback)
21+
- Simple website (GitLab Pages or similar)
22+
- Beta tester recruitment (5-10 journalists)
23+
24+
## [0.1.0-alpha] - 2025-11-23
25+
26+
### Added - Project Foundation
27+
28+
#### Documentation
29+
- **README.md**: Project overview, mission, learning pathway, quick start
30+
- **claude.md**: Comprehensive documentation for AI assistants and deep project context
31+
- **LICENSE.txt**: Dual MIT + Palimpsest v0.8 licensing
32+
- **CONTRIBUTING.md**: Contribution guidelines aligned with heutagogic principles
33+
- **CODE_OF_CONDUCT.md**: Community standards emphasizing epistemic virtues
34+
- **SECURITY.md**: Security policy covering source protection, data handling, platform security
35+
- **MAINTAINERS.md**: Governance model and maintainer responsibilities
36+
- **CHANGELOG.md**: This file
37+
38+
#### Core Frameworks
39+
- **PROMPT Framework**: Six-dimension claim evaluation
40+
- Provenance, Relevance, Objectivity, Methods, Perspective, Timeliness
41+
- **Boundary Objects Theory**: Integration as conceptual foundation
42+
- Enables coordination without consensus
43+
- Multiple entry points for different communities
44+
- **Data → Knowledge → Intelligence → Wisdom Pipeline**: Four-layer architecture
45+
- **Bio-Psycho-Social-Technical Systems Analysis**: Cognitive science integration
46+
47+
#### Learning Pathway (Heutagogic Design)
48+
- **Level 1**: Skeptical Journalist → Evidence Mapper (4-8 hours)
49+
- **Level 2A**: Methodological Journalist → Process Documentarian (8-12 hours)
50+
- **Level 2B**: Statistical Journalist → Uncertainty Communicator (6-10 hours)
51+
- **Level 3**: Interactive Journalist → Knowledge Architect (20-40 hours)
52+
- **Level 4**: Systems Journalist → Epistemic Infrastructure Builder (ongoing)
53+
54+
#### Cognitive Science Integration
55+
- Progressive disclosure architecture (avoid cognitive overload)
56+
- Meta-cognitive prompts (make thinking visible)
57+
- Empathy-first contradictory evidence (reduce defensiveness)
58+
- Transparent navigation analytics (show exploration patterns)
59+
- Trust calibration mechanisms
60+
61+
#### Design Principles
62+
- Face-saving architecture (never "you were wrong")
63+
- Identity-safe framings (Kahan's cultural cognition)
64+
- Multiple entry points (serve different communities)
65+
- Collaborative investigation features
66+
- Accessibility-first (WCAG 2.1 AA minimum)
67+
68+
### Context - Why This Project Exists
69+
70+
This project emerged from recognition that:
71+
1. **We're not in "post-truth"** but in transition from pre-truth to truth
72+
2. **Data is outpacing** knowledge, intelligence, and wisdom
73+
3. **Journalists are demoralized**, seeing "the end of journalism"
74+
4. **Current approaches fail**: Ground News's algorithmic both-sidesism isn't enough
75+
5. **Interactive documentaries** (i-docs) naturally address post-truth pathologies
76+
77+
### Influences and Inspiration
78+
79+
#### Theoretical Foundations
80+
- **Nico Carpentier**: Participatory communication theory, PhD supervision
81+
- **Susan Leigh Star**: Boundary objects theory
82+
- **Ludwig Wittgenstein**: Late work on language games (vs. early truth-value semantics)
83+
- **Dempster-Shafer Theory**: Uncertainty quantification
84+
- **Granger Causality**: Temporal influence without mechanistic causation
85+
86+
#### Media and Methodology
87+
- **i-Docs Research Network**: Interactive documentary frameworks
88+
- **Korsakow**: Non-linear documentary software (SNUs - smallest narrative units)
89+
- **Notable i-docs**: Out My Window, Hollow, Welcome to Pine Point, Prison Valley
90+
91+
#### Philosophy and Literature
92+
- **De Man and Derrida**: Irony and the map-territory gap
93+
- **David Foster Wallace**: New Sincerity movement
94+
- **Profilicity vs. Authenticity**: Contemporary debates
95+
- **Oxford OAR Group**: Inventive Methodologies (anecdotes as legitimate knowledge)
96+
97+
#### Cognitive Science
98+
- **Cowan (2001)**: Working memory limits (~4 chunks)
99+
- **Schwartz**: Choice paralysis
100+
- **Rozenblit & Keil**: Illusion of explanatory depth
101+
- **Kahan**: Cultural cognition and identity-protective reasoning
102+
- **Nickerson**: Understanding disagreement reduces polarization
103+
104+
#### Professional Practice
105+
- **National Union of Journalists (NUJ)**: Professional journalism standards
106+
- **ProPublica**: Transparent methodology journalism
107+
- **Knight Foundation, Omidyar Network**: Investigative journalism funding models
108+
109+
### Technical Decisions
110+
111+
#### Why Dual Licensing?
112+
- **MIT**: Maximum compatibility, enables wide adoption
113+
- **Palimpsest v0.8**: Values alignment, ensures transparency and epistemic justice
114+
- Both apply; users choose which governs their use
115+
116+
#### Why This Documentation Structure?
117+
- **README.md**: Quick orientation for humans
118+
- **claude.md**: Deep context for AI assistants
119+
- **Separate guides**: CONTRIBUTING, CODE_OF_CONDUCT, SECURITY, etc.
120+
- Allows targeted reading
121+
- Easier to maintain
122+
- Clearer separation of concerns
123+
124+
#### Why "Wayfinder"?
125+
- Captures both journalist role (guide) and reader experience (navigator)
126+
- Signals hope to demoralized journalists
127+
- Works as boundary object name (different communities hear what they need)
128+
- Gamification-friendly (Apprentice/Journeyman/Master Wayfinder)
129+
- Memorable, pronounceable, googleable
130+
131+
### Lessons Learned
132+
133+
#### What Worked
134+
- **Delaying specific advice**: Asking questions before prescribing solutions
135+
- **Cognitive science integration**: Design mitigations for known problems
136+
- **Heutagogic approach**: Self-determination + results (not points/badges)
137+
- **Boundary objects framing**: Solves "coordination without consensus" problem
138+
139+
#### What We're Watching
140+
- **Production cost**: 10x more work than traditional journalism initially
141+
- **Learning curve**: Both journalists and audiences need new capabilities
142+
- **Business model**: No obvious revenue source yet
143+
- **Measurement**: How to prove this works?
144+
145+
#### Open Questions
146+
- Which complex story for first prototype?
147+
- Obsidian vs. TiddlyWiki vs. Notion for Phase 1?
148+
- How to recruit first 5-10 beta testers?
149+
- What metrics actually matter for "success"?
150+
151+
### Status
152+
153+
**Current Phase**: Conceptual design complete, moving to proof-of-concept
154+
155+
**Next Milestones**:
156+
1. Week 1: Level 1 materials, evidence mapping template, one example investigation
157+
2. Week 2: Share with 3 journalist friends for feedback
158+
3. Week 3: Build simple website (GitLab Pages)
159+
4. Week 4: First 5-10 participants start Level 1
160+
161+
**4 weeks to proof-of-concept.**
162+
163+
### Contributors
164+
165+
- Project inception and design: [Name to be added]
166+
- [Additional contributors as they join]
167+
168+
### Thank You
169+
170+
To everyone who influenced this thinking:
171+
- The demoralized journalists who need hope
172+
- The academics who built the theoretical foundations
173+
- The i-docs practitioners who proved the concept
174+
- The open source community who model transparency
175+
- The cognitive scientists who reveal how we actually think
176+
177+
---
178+
179+
## Versioning Scheme
180+
181+
### For Pre-Release (0.x.x)
182+
- **0.x.0**: Major conceptual changes
183+
- **0.0.x**: Documentation updates, minor fixes
184+
185+
### For Release (1.x.x and beyond)
186+
- **Major (x.0.0)**: Breaking changes to methodology or platform
187+
- **Minor (0.x.0)**: New features, new levels, significant enhancements
188+
- **Patch (0.0.x)**: Bug fixes, documentation, minor improvements
189+
190+
### Special Versions
191+
- **alpha**: Conceptual design, not yet tested
192+
- **beta**: Testing with small group
193+
- **rc**: Release candidate, ready for wider use
194+
- **(no suffix)**: Stable release
195+
196+
---
197+
198+
## How to Use This Changelog
199+
200+
### For Contributors
201+
- Check Unreleased to see what's coming
202+
- Check your version to know what features are available
203+
- See Attribution to find who to thank or ask
204+
205+
### For Maintainers
206+
- Update Unreleased as you work
207+
- Move to versioned section when releasing
208+
- Always explain why, not just what
209+
- Credit contributors generously
210+
211+
### For Users
212+
- See what's new in each version
213+
- Understand why changes were made
214+
- Know what's planned next
215+
- Track project evolution
216+
217+
---
218+
219+
*This changelog embodies our commitment to transparency. Every significant change is documented with reasoning. Every contributor is credited. Every lesson is shared.*
220+
221+
*See also: [README.md](./README.md), [CONTRIBUTING.md](./CONTRIBUTING.md)*

0 commit comments

Comments
 (0)