Skip to content

Commit 00aa776

Browse files
author
Jonathan D.A. Jewell
committed
Auto-commit: Sync changes [2026-02-21]
1 parent ee3c928 commit 00aa776

2 files changed

Lines changed: 101 additions & 0 deletions

File tree

README.adoc

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -170,3 +170,8 @@ See [LICENSE.txt](./LICENSE.txt) for full details.
170170
*Status*: Pre-release conceptual design
171171

172172
*For AI assistants: See [claude.md](./claude.md) for full context and implementation details.*
173+
174+
175+
== Architecture
176+
177+
See link:TOPOLOGY.md[TOPOLOGY.md] for a visual architecture map and completion dashboard.

TOPOLOGY.md

Lines changed: 96 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,96 @@
1+
<!-- SPDX-License-Identifier: PMPL-1.0-or-later -->
2+
<!-- TOPOLOGY.md — Project architecture map and completion dashboard -->
3+
<!-- Last updated: 2026-02-19 -->
4+
5+
# Wayfinder (im-docs) — Project Topology
6+
7+
## System Architecture
8+
9+
```
10+
┌─────────────────────────────────────────┐
11+
│ COMMUNITIES │
12+
│ (Activists, Academics, Journalists) │
13+
└───────────────────┬─────────────────────┘
14+
│ Interpretation
15+
16+
┌─────────────────────────────────────────┐
17+
│ BOUNDARY OBJECT LAYER │
18+
│ (Interactive Investigation HUD) │
19+
└──────────┬───────────────────┬──────────┘
20+
│ │
21+
▼ ▼
22+
┌───────────────────────┐ ┌────────────────────────────────┐
23+
│ PROMPT FRAMEWORK │ │ EPISTEMIC PIPELINE │
24+
│ - Provenance / Relevance│ - Data Layer (Evidence) │
25+
│ - Objectivity / Methods │ - Knowledge Layer (Claims) │
26+
│ - Perspective / Time │ │ - Intelligence Layer (Patterns)│
27+
└──────────┬────────────┘ └──────────┬─────────────────────┘
28+
│ │
29+
└────────────┬─────────────┘
30+
31+
┌─────────────────────────────────────────┐
32+
│ TECHNICAL SUBSTRATE │
33+
│ ┌───────────┐ ┌───────────────────┐ │
34+
│ │ SvelteKit │ │ PostgreSQL / │ │
35+
│ │ (Phase 2) │ │ Graph DB │ │
36+
│ └─────┬─────┘ └────────┬──────────┘ │
37+
└────────│─────────────────│──────────────┘
38+
│ │
39+
▼ ▼
40+
┌─────────────────────────────────────────┐
41+
│ LEARNING PATHWAY │
42+
│ (Level 1-4 Capability HUD) │
43+
└─────────────────────────────────────────┘
44+
45+
┌─────────────────────────────────────────┐
46+
│ REPO INFRASTRUCTURE │
47+
│ Justfile Automation .machine_readable/ │
48+
│ Documentation Hub 0-AI-MANIFEST.a2ml │
49+
└─────────────────────────────────────────┘
50+
```
51+
52+
## Completion Dashboard
53+
54+
```
55+
COMPONENT STATUS NOTES
56+
───────────────────────────────── ────────────────── ─────────────────────────────────
57+
CONCEPTUAL FRAMEWORK
58+
PROMPT Scoring Model ██████████ 100% Foundational 6-dims stable
59+
Boundary Object Design ██████████ 100% Community roles defined
60+
Learning Pathway (Lv 1-4) ██████████ 100% Pathway logic verified
61+
Heutagogic Design ██████████ 100% Self-directed model stable
62+
63+
IMPLEMENTATION (PHASE 1)
64+
Obsidian/Wiki Prototypes ████████░░ 80% Initial evidence maps active
65+
Example Investigation ██████░░░░ 60% First use case in progress
66+
Evidence Mapping Templates ████████░░ 80% Markdown schemas stable
67+
68+
REPO INFRASTRUCTURE
69+
Justfile Automation ██████████ 100% Standard build tasks
70+
.machine_readable/ ██████████ 100% STATE tracking active
71+
Documentation (README.adoc) ██████████ 100% Comprehensive strategy guide
72+
73+
─────────────────────────────────────────────────────────────────────────────
74+
OVERALL: ██████░░░░ ~60% Conceptual foundation 100% stable
75+
```
76+
77+
## Key Dependencies
78+
79+
```
80+
Cognitive Science ───► PROMPT Model ───► Boundary Object ──► Wisdom
81+
│ │ │ │
82+
▼ ▼ ▼ ▼
83+
Attention Limits ──► Progression ──────► Investigation ──► Decision
84+
```
85+
86+
## Update Protocol
87+
88+
This file is maintained by both humans and AI agents. When updating:
89+
90+
1. **After completing a component**: Change its bar and percentage
91+
2. **After adding a component**: Add a new row in the appropriate section
92+
3. **After architectural changes**: Update the ASCII diagram
93+
4. **Date**: Update the `Last updated` comment at the top of this file
94+
95+
Progress bars use: `` (filled) and `` (empty), 10 characters wide.
96+
Percentages: 0%, 10%, 20%, ... 100% (in 10% increments).

0 commit comments

Comments
 (0)