Phase 3 Documentation Conversion Master Tracker
Date: 2026-01-18 Status: In Progress Total Phase 2 Source Files: 118 (excluding niia-consciousness) Target Workspace:/Users/macbook/Projects/monolex/monolex-docs-draft/
Session Continuity Instructions
Phase 3 Core Rules Reference
Term Priority Reference (from GLOSSARY.md)
| Priority | Terms | Usage |
|---|---|---|
| Always Use | Rust, TypeScript, Tauri, GPU Acceleration, WebGL | Every page |
| Frequently | Alacritty, VTE, MPSC, Actor Model, PTY, Tokio | Architecture |
| When Relevant | BSU/ESU, ACK, ANSI, xterm.js, Unix Socket | Technical |
| For Depth | SessionActor, DiffHint, GridWorker, AtomicState | Deep dive |
| Brand | Monokinetics, SMPC, OFAC, Atomic UX | Philosophy |
Directory Mapping
| Phase 2 Source | Phase 3 Target | Files |
|---|---|---|
monoterm-guide/ | terminal/ + philosophy/ | 13 |
atomic-architecture/ | architecture/ | 9 |
atomic-state/ | terminal/ | 9 |
components/ | daemons/ + database/ + features/ | 18 |
monokinetics-concurrency/ | architecture/ | 7 |
monokinetics-transparency/ | transparency/ | 48 |
ux-ai-native/ | research/ | 9 |
architecture-docs/ | architecture/ | 2 |
| Root files (README, etc.) | Root | 3 |
Conversion Progress Summary
| Category | Total | Converted | Remaining | Progress |
|---|---|---|---|---|
| monoterm-guide | 13 | 8 | 5 | 62% |
| atomic-architecture | 9 | 6 | 3 | 67% |
| atomic-state | 9 | 4 | 5 | 44% |
| components | 18 | 4 | 14 | 22% |
| monokinetics-concurrency | 7 | 7 | 0 | 100% |
| monokinetics-transparency | 48 | 26 | 22 | 54% |
| ux-ai-native | 9 | 3 | 6 | 33% |
| architecture-docs | 2 | 0 | 2 | 0% |
| Root | 3 | 2 | 1 | 67% |
| TOTAL | 118 | 60 | 58 | 51% |
Full Checklist
1. monoterm-guide/ (13 files)
| # | Source | Target | Status |
|---|---|---|---|
| 1 | 01-what-is-monoterm.md | terminal/overview.mdx | [ ] PENDING |
| 2 | 02-atomic-loop.md | terminal/atomic-loop.mdx | [x] EXISTS |
| 3 | 03-bsu-esu.md | terminal/bsu-esu-protocol.mdx | [x] EXISTS |
| 4 | 04-data-reduction.md | terminal/data-reduction.mdx | [x] EXISTS |
| 5 | 05-monokinetics.md | philosophy/monokinetics.mdx | [x] EXISTS |
| 6 | 06-monokinetic-hermeneutics.md | philosophy/monokinetic-hermeneutics.mdx | [x] EXISTS |
| 7 | 07-monokinetics-and-monolex.md | philosophy/monolex-vision.mdx | [ ] PENDING |
| 8 | 08-monokinetics-and-monoterm.md | architecture/philosophy-to-code.mdx | [x] EXISTS |
| 9 | 09-cursor-pattern-pseudo-bsu.md | terminal/cursor-pattern.mdx | [ ] PENDING |
| 10 | 09-monokinetics-concurrency.md | architecture/concurrency-patterns.mdx | [x] EXISTS |
| 11 | 10-ai-cli-framework-pairing.md | research/ai-cli-pairing.mdx | [ ] PENDING |
| 12 | 11-monoterm-compatibility-matrix.md | terminal/compatibility.mdx | [ ] PENDING |
| 13 | README.md | (index only) | [x] SKIP |
2. atomic-architecture/ (9 files)
| # | Source | Target | Status |
|---|---|---|---|
| 14 | 01-overview.md | architecture/overview.mdx | [x] EXISTS |
| 15 | 02-component-architecture.md | architecture/components.mdx | [ ] PENDING |
| 16 | 03-ack-gate-flow-control.md | architecture/ack-flow-control.mdx | [ ] PENDING |
| 17 | 04-epoch-synchronization.md | architecture/epoch-sync.mdx | [ ] PENDING |
| 18 | 05-xterm-as-renderer.md | architecture/xterm-renderer.mdx | [ ] PENDING |
| 19 | 06-backend-rendering-patterns.md | architecture/rendering-patterns.mdx | [ ] PENDING |
| 20 | 07-simulation-vs-presentation.md | architecture/simulation-presentation.mdx | [ ] PENDING |
| 21 | 08-dirty-tracking-strategies.md | architecture/dirty-tracking.mdx | [ ] PENDING |
| 22 | README.md | (index only) | [x] SKIP |
3. atomic-state/ (9 files)
| # | Source | Target | Status |
|---|---|---|---|
| 23 | 01-overview.md | terminal/atomic-state.mdx | [x] EXISTS |
| 24 | 01-what-is-atomic-state.md | terminal/atomic-state-intro.mdx | [ ] PENDING |
| 25 | 02-data-flow.md | terminal/data-flow.mdx | [ ] PENDING |
| 26 | 02-how-it-works.md | terminal/atomic-state-mechanics.mdx | [ ] PENDING |
| 27 | 03-buffer-model.md | terminal/buffer-model.mdx | [ ] PENDING |
| 28 | 03-performance-benefits.md | terminal/performance.mdx | [ ] PENDING |
| 29 | 04-diff-rendering.md | terminal/diff-rendering.mdx | [ ] PENDING |
| 30 | 04-troubleshooting.md | guides/troubleshooting.mdx | [x] EXISTS |
| 31 | README.md | (index only) | [x] SKIP |
4. components/ (18 files)
| # | Source | Target | Status |
|---|---|---|---|
| 32 | ch1-pty-daemon.md | terminal/pty-daemon.mdx | [x] EXISTS |
| 33 | ch3-pty-log.md | daemons/pty-log.mdx | [ ] PENDING |
| 34 | ch4-atomic-term-ime.md | features/ime-cjk-support.mdx | [x] EXISTS |
| 35 | ch5-niia-watcher.md | daemons/niia-watcher.mdx | [x] EXISTS |
| 36 | ch6-variable-md.md | features/variable-md.mdx | [ ] PENDING |
| 37 | ch7-database-architecture.md | database/overview.mdx | [x] EXISTS |
| 38 | ch8-complex-relations.md | database/relations.mdx | [ ] PENDING |
| 39 | ch9-file-db-mapping.md | database/file-mapping.mdx | [ ] PENDING |
| 40 | ch10-work-wiki-diff.md | database/work-wiki-diff.mdx | [ ] PENDING |
| 41 | ch11-module-db-graph.md | database/module-graph.mdx | [ ] PENDING |
| 42 | ch12-unified-connection-map.md | database/connection-map.mdx | [ ] PENDING |
| 43 | ch13-terminal-scrollbar.md | features/scrollbar.mdx | [ ] PENDING |
| 44 | ch19-design-patterns.md | architecture/design-patterns.mdx | [ ] PENDING |
| 45 | db-atomic-term.md | database/atomic-term.mdx | [ ] PENDING |
| 46 | db-niia-watcher.md | database/niia-watcher.mdx | [ ] PENDING |
| 47 | db-onit.md | database/onit.mdx | [ ] PENDING |
| 48 | db-session.md | database/session.mdx | [ ] PENDING |
| 49 | db-work-wiki-diff.md | database/work-wiki-diff-schema.mdx | [ ] PENDING |
5. monokinetics-concurrency/ (7 files)
| # | Source | Target | Status |
|---|---|---|---|
| 50 | monokinetics-concurrency-philosophy.md | philosophy/concurrency-philosophy.mdx | [x] EXISTS |
| 51 | monokinetics-concurrency-00-five-pattern-synergy.md | architecture/five-patterns.mdx | [x] EXISTS |
| 52 | monokinetics-concurrency-01-actor-over-mutex.md | architecture/actor-pattern.mdx | [x] EXISTS |
| 53 | monokinetics-concurrency-02-actor-ack-synergy.md | architecture/actor-ack.mdx | [x] EXISTS |
| 54 | monokinetics-concurrency-03-atomicstate-absorber.md | architecture/state-absorber.mdx | [x] EXISTS |
| 55a | monokinetics-concurrency-04-passthrough-survival.md | architecture/passthrough-survival.mdx | [x] EXISTS |
| 55b | monokinetics-concurrency-05-oneshot-timeout.md | architecture/response-timeout.mdx | [x] EXISTS |
6. monokinetics-transparency/ (48 files)
6.1 Core & Overview (3 files)
| # | Source | Target | Status |
|---|---|---|---|
| 55 | 00-overview.md | transparency/overview.mdx | [ ] PENDING |
| 56 | README.md | (index only) | [x] SKIP |
| 57 | 01-work-wiki-core/README.md | (index only) | [x] SKIP |
6.2 Work Wiki Core (4 files)
| # | Source | Target | Status |
|---|---|---|---|
| 58 | 01-work-wiki-core/chapter-01-work-wiki-system-overview.md | transparency/core/overview.mdx | [x] EXISTS |
| 59 | 01-work-wiki-core/chapter-02-visualization-components.md | transparency/core/visualization.mdx | [x] EXISTS |
| 60 | 01-work-wiki-core/chapter-03-backend-data-model.md | transparency/core/data-model.mdx | [x] EXISTS |
| 61 | 01-work-wiki-core/chapter-04-transparency-loop-integration.md | transparency/core/integration.mdx | [x] EXISTS |
6.3 Git Viewers (15 files)
| # | Source | Target | Status |
|---|---|---|---|
| 62 | 02-git-viewers/README.md | (index only) | [x] SKIP |
| 63 | 02-git-viewers/chapter-05-git-base-viewer-qed.md | transparency/git-viewers/base-viewer.mdx | [x] EXISTS |
| 64 | 02-git-viewers/chapter-06-dashboard-viewers-qed.md | transparency/git-viewers/dashboard.mdx | [x] EXISTS |
| 65 | 02-git-viewers/chapter-07-wiki-base-infrastructure-qed.md | transparency/git-viewers/wiki-base.mdx | [x] EXISTS |
| 66 | 02-git-viewers/chapter-08-blame-viewer-qed.md | transparency/git-viewers/blame-stash.mdx | [x] EXISTS |
| 67 | 02-git-viewers/chapter-09-stash-reflog-qed.md | transparency/git-viewers/stash-reflog.mdx | [ ] PENDING |
| 68 | 02-git-viewers/chapter-10-diff-viewer-qed.md | transparency/git-viewers/diff-commit.mdx | [x] EXISTS |
| 69 | 02-git-viewers/chapter-11-commit-graph-architecture-qed.md | transparency/git-viewers/commit-graph.mdx | [ ] PENDING |
| 70 | 02-git-viewers/chapter-12-filename-parser-ipc-qed.md | transparency/git-viewers/parser-prove.mdx | [x] EXISTS |
| 71 | 02-git-viewers/chapter-13-prove-viewer-status-qed.md | transparency/git-viewers/prove-status.mdx | [ ] PENDING |
| 72 | 02-git-viewers/chapter-14-research-viewer-gittab-qed.md | transparency/git-viewers/research-gittab.mdx | [ ] PENDING |
| 73 | 02-git-viewers/chapter-15-frontmatter-parsing-qed.md | transparency/git-viewers/research-frontmatter.mdx | [x] EXISTS |
| 74 | 02-git-viewers/chapter-16-cross-viewer-integration-qed.md | transparency/git-viewers/integration-heatmap.mdx | [x] EXISTS |
| 75 | 02-git-viewers/chapter-17-heatmap-color-qed.md | transparency/git-viewers/heatmap-color.mdx | [ ] PENDING |
| 76 | 02-git-viewers/chapter-18-final-integration-synthesis-qed.md | transparency/git-viewers/synthesis.mdx | [ ] PENDING |
6.4 Extension (3 files)
| # | Source | Target | Status |
|---|---|---|---|
| 77 | 03-extension/README.md | (index only) | [x] SKIP |
| 78 | 03-extension/chapter-19-extension-architecture.md | transparency/extension/architecture.mdx | [x] EXISTS |
| 79 | 03-extension/chapter-20-extension-implementation.md | transparency/extension/implementation.mdx | [x] EXISTS |
6.5 Wiki Viewers (11 files)
| # | Source | Target | Status |
|---|---|---|---|
| 80 | 04-wiki-viewers/README.md | (index only) | [x] SKIP |
| 81 | 04-wiki-viewers/chapter-21-wiki-onit-viewer-overview.md | transparency/wiki-viewers/onit-overview.mdx | [x] EXISTS |
| 82 | 04-wiki-viewers/chapter-22-wiki-onit-viewer-data-model.md | transparency/wiki-viewers/onit-data.mdx | [ ] PENDING |
| 83 | 04-wiki-viewers/chapter-23-wiki-onit-viewer-render.md | transparency/wiki-viewers/onit-render.mdx | [x] EXISTS |
| 84 | 04-wiki-viewers/chapter-24-wiki-onit-viewer-interaction.md | transparency/wiki-viewers/onit-interaction.mdx | [ ] PENDING |
| 85 | 04-wiki-viewers/chapter-25-wiki-onit-viewer-state.md | transparency/wiki-viewers/onit-state.mdx | [x] EXISTS |
| 86 | 04-wiki-viewers/chapter-26-wiki-prepare-viewer-overview.md | transparency/wiki-viewers/prepare-viewer.mdx | [x] EXISTS |
| 87 | 04-wiki-viewers/chapter-27-wiki-prepare-viewer-data.md | transparency/wiki-viewers/prepare-data.mdx | [ ] PENDING |
| 88 | 04-wiki-viewers/chapter-28-wiki-prepare-viewer-render.md | transparency/wiki-viewers/prepare-render.mdx | [ ] PENDING |
| 89 | 04-wiki-viewers/chapter-29-wiki-prepare-viewer-navigation.md | transparency/wiki-viewers/prepare-nav.mdx | [ ] PENDING |
| 90 | 04-wiki-viewers/chapter-30-onit-prepare-integration.md | transparency/wiki-viewers/onit-prepare.mdx | [x] EXISTS |
6.6 Git Backend (4 files)
| # | Source | Target | Status |
|---|---|---|---|
| 91 | 05-git-rs-backend/README.md | (index only) | [x] SKIP |
| 92 | 05-git-rs-backend/chapter-31-git-rs-overview.md | transparency/git-backend/overview.mdx | [x] EXISTS |
| 93 | 05-git-rs-backend/chapter-32-git-rs-implementation.md | transparency/git-backend/implementation.mdx | [x] EXISTS |
| 94 | 05-git-rs-backend/chapter-33-git-rs-work-wiki.md | transparency/git-backend/work-wiki.mdx | [x] EXISTS |
6.7 Commit Graph Upgrade (5 files)
| # | Source | Target | Status |
|---|---|---|---|
| 95 | 06-commit-graph-upgrade/README.md | (index only) | [x] SKIP |
| 96 | 06-commit-graph-upgrade/chapter-34-commit-graph-current.md | transparency/commit-graph/current-state.mdx | [x] EXISTS |
| 97 | 06-commit-graph-upgrade/chapter-35-upgrade-requirements.md | transparency/commit-graph/upgrade-plan.mdx | [x] EXISTS |
| 98 | 06-commit-graph-upgrade/chapter-36-upgrade-plans.md | transparency/commit-graph/implementation.mdx | [ ] PENDING |
| 99 | 06-commit-graph-upgrade/chapter-37-upgrade-impact.md | transparency/commit-graph/impact.mdx | [ ] PENDING |
6.8 NIIA Watcher (3 files)
| # | Source | Target | Status |
|---|---|---|---|
| 100 | 07-niia-watcher/README.md | (index only) | [x] SKIP |
| 101 | 07-niia-watcher/chapter-38-niia-watcher-architecture.md | transparency/file-watcher/architecture.mdx | [x] EXISTS |
| 102 | 07-niia-watcher/chapter-39-niia-watcher-integration.md | transparency/file-watcher/integration.mdx | [x] EXISTS |
7. ux-ai-native/ (9 files)
| # | Source | Target | Status |
|---|---|---|---|
| 103 | 50-STEP-ANALYSIS-PLAN.md | research/analysis-methodology.mdx | [ ] PENDING |
| 104 | 56-SOURCE-CODE-DEEP-ANALYSIS.md | research/source-analysis.mdx | [ ] PENDING |
| 105 | 59-NEW-PROBLEM-CATEGORY.md | research/ai-native-terminal.mdx | [x] EXISTS |
| 106 | 60-TWO-SCENARIOS-GAME-ANALOGY.md | research/game-analogy.mdx | [ ] PENDING |
| 107 | 61-AI-NATIVE-TERMINAL-DIAGRAMS.md | research/architecture-diagrams.mdx | [ ] PENDING |
| 108 | 62-AI-NATIVE-TERMINAL-GIANTS-QUOTE.md | research/giants-quote.mdx | [ ] PENDING |
| 109 | 63-AI-NATIVE-TERMINAL-ARCHITECTURE-SUCCESS-FACTORS.md | research/success-factors.mdx | [ ] PENDING |
| 110 | 64-AI-NATIVE-TERMINAL-PRIOR-ART.md | research/prior-art.mdx | [ ] PENDING |
| 111 | README.md | (index only) | [x] SKIP |
8. architecture-docs/ (2 files)
| # | Source | Target | Status |
|---|---|---|---|
| 112 | 02-data-flow.md | architecture/data-flow.mdx | [ ] PENDING |
| 113 | ARCHITECTURE-VERSION.md | architecture/version-history.mdx | [ ] PENDING |
9. Root Files (3 files)
| # | Source | Target | Status |
|---|---|---|---|
| 114 | README.md | introduction.mdx | [x] EXISTS |
| 115 | CLASSIFICATION-MAP.md | (internal only) | [x] SKIP |
| 116 | RESTRUCTURE-MAPPING.md | (internal only) | [x] SKIP |
Batch Assignment for Parallel Conversion
Batch A: Architecture Deep-Dive (7 files)
Files: #15, #16, #17, #18, #19, #20, #21Batch B: AtomicState Deep-Dive (5 files)
Files: #24, #25, #26, #27, #28, #29Batch C: Concurrency Philosophy (7 files) ✅ COMPLETE
Files: #50, #51, #52, #53, #54, #55a, #55bBatch D: Components & Features (5 files)
Files: #33, #36, #43, #44, #1Batch E: Database Documentation (8 files)
Files: #38, #39, #40, #41, #42, #45, #46, #47, #48, #49Batch F: AI-Native Research (8 files)
Files: #103, #104, #106, #107, #108, #109, #110, #11Batch G: Transparency Remaining (11 files)
Files: #55, #67, #69, #71, #72, #75, #76, #82, #84, #87, #88, #89, #98, #99Batch H: Miscellaneous Remaining (5 files)
Files: #7, #9, #12, #112, #113Quality Verification Checklist
After each file conversion, verify:Reference Paths
- SKILL.md:
/Users/macbook/Projects/monolex/monolex/.claude/skills/monolex-docs-maker/SKILL.md - GLOSSARY.md:
/Users/macbook/Projects/monolex/monolex/.claude/skills/monolex-docs-maker/GLOSSARY.md - Phase 2 Source:
/Users/macbook/Projects/monolex/monolex/.claude/skills/monolex-architect/docs/ - Phase 3 Target:
/Users/macbook/Projects/monolex/monolex-docs-draft/
Update History
| Date | Session | Progress |
|---|---|---|
| 2026-01-18 | Initial | Created master tracker, 49% complete (57/116) |
| 2026-01-20 | Concurrency Complete | Added & converted Parts 4&5, Batch C 100% complete (7/7 files) |
Last Updated: 2026-01-20