Skip to main content

​
Phase 3 Conversion Workbook

Created: 2025-01-17 Workspace: /Users/macbook/Projects/monolex/monolex-docs-draft Status: IN PROGRESS

​
🚀 Session Startup Instructions

Every new session, read these files first: 
# 1. This workbook (progress tracking)
/Users/macbook/Projects/monolex/monolex-docs-draft/CONVERSION-WORKBOOK.md

# 2. Conversion rules and quality standards
/Users/macbook/Projects/monolex/monolex/.claude/skills/monolex-docs-maker/SKILL.md

# 3. Technical term reference (when needed)
/Users/macbook/Projects/monolex/monolex/.claude/skills/monolex-docs-maker/GLOSSARY.md

​
📊 Project Overview

┌─────────────────────────────────────────────────────────────────┐
│  PHASE 3 CONVERSION PROJECT                                     │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  Phase 2 Source:         116 files (excluding niia-conscious)   │
│  Currently in Workspace:  56 files                              │
│  Estimated Remaining:    ~60 files                              │
│                                                                 │
│  Conversion Rule: Phase 2 → Phase 3                             │
│  ├── 30% text, 70% ASCII diagrams                              │
│  ├── Grandmother test (non-developer readable)                 │
│  ├── Remove: cache, buffer, hash, file:line refs               │
│  └── Keep: Rust, MPSC, Alacritty, VTE, WebGL, Tauri            │
│                                                                 │
│  EXCLUDED: niia-consciousness/ (42 files)                       │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

​
📋 Master Checklist

​
Legend

  • [ ] = Not started
  • [~] = In progress
  • [✓] = Completed
  • [S] = Skipped (duplicate/merged)
  • [E] = Existing (needs quality check)

​
1. monoterm-guide/ (13 files) → terminal/, philosophy/, guides/

#Source FileTargetStatusNotes
101-what-is-monoterm.mdintroduction.mdx[E]Check quality
202-atomic-loop.mdterminal/atomic-loop.mdx[E]Check quality
303-bsu-esu.mdterminal/bsu-esu-protocol.mdx[E]Check quality
404-data-reduction.mdterminal/data-reduction.mdx[E]Check quality
505-monokinetics.mdphilosophy/monokinetics.mdx[E]Check quality
606-monokinetic-hermeneutics.mdphilosophy/monokinetic-hermeneutics.mdx[E]Check quality
707-monokinetics-and-monolex.mdphilosophy/philosophy-to-app.mdx[ ]NEW
808-monokinetics-and-monoterm.mdarchitecture/philosophy-to-code.mdx[E]Check quality
909-cursor-pattern-pseudo-bsu.mdterminal/cursor-pattern.mdx[ ]NEW
1009-monokinetics-concurrency.mdphilosophy/concurrency-intro.mdx[ ]NEW
1110-ai-cli-framework-pairing.mdfeatures/ai-cli-pairing.mdx[ ]NEW
1211-monoterm-compatibility-matrix.mdfeatures/compatibility.mdx[ ]NEW
13README.md(index)[S]Skip - meta file
Progress: 6/13 existing, 4 new needed, 1 skipped

​
2. atomic-architecture/ (9 files) → architecture/deep-dive/

#Source FileTargetStatusNotes
1401-overview.mdarchitecture/overview.mdx[E]Check quality
1502-component-architecture.mdarchitecture/deep-dive/component-architecture.mdx[ ]NEW
1603-ack-gate-flow-control.mdarchitecture/deep-dive/ack-gate-flow.mdx[ ]NEW
1704-epoch-synchronization.mdarchitecture/deep-dive/epoch-sync.mdx[ ]NEW
1805-xterm-as-renderer.mdarchitecture/deep-dive/xterm-renderer.mdx[ ]NEW
1906-backend-rendering-patterns.mdarchitecture/deep-dive/backend-patterns.mdx[ ]NEW
2007-simulation-vs-presentation.mdarchitecture/deep-dive/simulation-vs-presentation.mdx[ ]NEW
2108-dirty-tracking-strategies.mdarchitecture/deep-dive/dirty-tracking.mdx[ ]NEW
22README.md(index)[S]Skip - meta file
Progress: 1/9 existing, 7 new needed, 1 skipped

​
3. atomic-state/ (9 files) → terminal/atomic-state/

#Source FileTargetStatusNotes
2301-overview.mdterminal/atomic-state.mdx[E]Check quality
2401-what-is-atomic-state.mdterminal/atomic-state/what-is.mdx[ ]NEW
2502-data-flow.mdterminal/atomic-state/data-flow.mdx[ ]NEW
2602-how-it-works.mdterminal/atomic-state/how-it-works.mdx[ ]NEW
2703-buffer-model.mdterminal/atomic-state/buffer-model.mdx[ ]NEW
2803-performance-benefits.mdterminal/atomic-state/performance.mdx[ ]NEW
2904-diff-rendering.mdterminal/atomic-state/diff-rendering.mdx[ ]NEW
3004-troubleshooting.mdterminal/atomic-state/troubleshooting.mdx[ ]NEW
31README.md(index)[S]Skip - meta file
Progress: 1/9 existing, 7 new needed, 1 skipped

​
4. components/ (18 files) → components/, database/, features/, daemons/

#Source FileTargetStatusNotes
32ch1-pty-daemon.mdterminal/pty-daemon.mdx[E]Check quality
33ch3-pty-log.mdcomponents/pty-log.mdx[ ]NEW
34ch4-atomic-term-ime.mdfeatures/ime-cjk-support.mdx[E]Check quality
35ch5-niia-watcher.mddaemons/niia-watcher.mdx[E]Check quality
36ch6-variable-md.mdcomponents/variable-md.mdx[ ]NEW
37ch7-database-architecture.mddatabase/architecture.mdx[ ]NEW
38ch8-complex-relations.mddatabase/complex-relations.mdx[ ]NEW
39ch9-file-db-mapping.mddatabase/file-mapping.mdx[ ]NEW
40ch10-work-wiki-diff.mddatabase/work-wiki-diff.mdx[ ]NEW
41ch11-module-db-graph.mddatabase/module-graph.mdx[ ]NEW
42ch12-unified-connection-map.mddatabase/unified-map.mdx[ ]NEW
43ch13-terminal-scrollbar.mdcomponents/terminal-scrollbar.mdx[ ]NEW
44ch19-design-patterns.mdcomponents/design-patterns.mdx[ ]NEW
45db-atomic-term.mddatabase/schemas/atomic-term.mdx[ ]NEW
46db-niia-watcher.mddatabase/schemas/niia-watcher.mdx[ ]NEW
47db-onit.mddatabase/schemas/onit.mdx[ ]NEW
48db-session.mddatabase/schemas/session.mdx[ ]NEW
49db-work-wiki-diff.mddatabase/schemas/work-wiki-diff.mdx[ ]NEW
Progress: 3/18 existing, 15 new needed

​
5. monokinetics-concurrency/ (5 files) → philosophy/concurrency/

#Source FileTargetStatusNotes
50monokinetics-concurrency-philosophy.mdphilosophy/concurrency/overview.mdx[ ]NEW
5100-five-pattern-synergy.mdphilosophy/concurrency/five-patterns.mdx[ ]NEW
5201-actor-over-mutex.mdphilosophy/concurrency/actor-model.mdx[ ]NEW
5302-actor-ack-synergy.mdphilosophy/concurrency/ack-synergy.mdx[ ]NEW
5403-atomicstate-absorber.mdarchitecture/concurrency-patterns.mdx[E]Check quality
Progress: 1/5 existing, 4 new needed

​
6. monokinetics-transparency/ (48 files) → transparency/

#Source FileTargetStatusNotes
5500-overview.mdtransparency/overview.mdx[ ]NEW or merge
5601-work-wiki-core/chapter-01-*.mdtransparency/core/overview.mdx[E]Check quality
5701-work-wiki-core/chapter-02-*.mdtransparency/core/visualization.mdx[E]Check quality
5801-work-wiki-core/chapter-03-*.mdtransparency/core/data-model.mdx[E]Check quality
5901-work-wiki-core/chapter-04-*.mdtransparency/core/integration.mdx[E]Check quality
6001-work-wiki-core/README.md(index)[S]Skip
6102-git-viewers/chapter-05-*.mdtransparency/git-viewers/base-viewer.mdx[E]Check quality
6202-git-viewers/chapter-06-*.mdtransparency/git-viewers/dashboard.mdx[E]Check quality
6302-git-viewers/chapter-07-*.mdtransparency/git-viewers/wiki-base.mdx[E]Check quality
6402-git-viewers/chapter-08-*.mdtransparency/git-viewers/blame-stash.mdx[E]Merged 08+09
6502-git-viewers/chapter-09-*.md(merged with 08)[S]Merged
6602-git-viewers/chapter-10-*.mdtransparency/git-viewers/diff-commit.mdx[E]Merged 10+11
6702-git-viewers/chapter-11-*.md(merged with 10)[S]Merged
6802-git-viewers/chapter-12-*.mdtransparency/git-viewers/parser-prove.mdx[E]Merged 12+13
6902-git-viewers/chapter-13-*.md(merged with 12)[S]Merged
7002-git-viewers/chapter-14-*.mdtransparency/git-viewers/research-frontmatter.mdx[E]Merged 14+15
7102-git-viewers/chapter-15-*.md(merged with 14)[S]Merged
7202-git-viewers/chapter-16-*.mdtransparency/git-viewers/integration-heatmap.mdx[E]Merged 16+17+18
7302-git-viewers/chapter-17-*.md(merged with 16)[S]Merged
7402-git-viewers/chapter-18-*.md(merged with 16)[S]Merged
7502-git-viewers/README.md(index)[S]Skip
7603-extension/chapter-19-*.mdtransparency/extension/architecture.mdx[E]Check quality
7703-extension/chapter-20-*.mdtransparency/extension/implementation.mdx[E]Check quality
7803-extension/README.md(index)[S]Skip
7904-wiki-viewers/chapter-21-*.mdtransparency/wiki-viewers/onit-overview.mdx[E]Check quality
8004-wiki-viewers/chapter-22-*.md(merged)[S]Merged
8104-wiki-viewers/chapter-23-*.mdtransparency/wiki-viewers/onit-render.mdx[E]Check quality
8204-wiki-viewers/chapter-24-*.md(merged)[S]Merged
8304-wiki-viewers/chapter-25-*.mdtransparency/wiki-viewers/onit-state.mdx[E]Check quality
8404-wiki-viewers/chapter-26-*.mdtransparency/wiki-viewers/prepare-viewer.mdx[E]Check quality
8504-wiki-viewers/chapter-27-*.md(merged)[S]Merged
8604-wiki-viewers/chapter-28-*.md(merged)[S]Merged
8704-wiki-viewers/chapter-29-*.md(merged)[S]Merged
8804-wiki-viewers/chapter-30-*.mdtransparency/wiki-viewers/onit-prepare.mdx[E]Check quality
8904-wiki-viewers/README.md(index)[S]Skip
9005-git-rs-backend/chapter-31-*.mdtransparency/git-backend/overview.mdx[E]Check quality
9105-git-rs-backend/chapter-32-*.mdtransparency/git-backend/implementation.mdx[E]Check quality
9205-git-rs-backend/chapter-33-*.mdtransparency/git-backend/work-wiki.mdx[E]Check quality
9305-git-rs-backend/README.md(index)[S]Skip
9406-commit-graph-upgrade/chapter-34-*.mdtransparency/commit-graph/current-state.mdx[E]Check quality
9506-commit-graph-upgrade/chapter-35-*.md(merged)[S]Merged
9606-commit-graph-upgrade/chapter-36-*.mdtransparency/commit-graph/upgrade-plan.mdx[E]Merged 36+37
9706-commit-graph-upgrade/chapter-37-*.md(merged with 36)[S]Merged
9806-commit-graph-upgrade/README.md(index)[S]Skip
9907-niia-watcher/chapter-38-*.mdtransparency/file-watcher/architecture.mdx[E]Check quality
10007-niia-watcher/chapter-39-*.mdtransparency/file-watcher/integration.mdx[E]Check quality
10107-niia-watcher/README.md(index)[S]Skip
102README.md(index)[S]Skip
Progress: 26/48 existing (many merged), ~1 new needed, 21 skipped/merged

​
7. ux-ai-native/ (9 files) → research/ai-native/

#Source FileTargetStatusNotes
10350-STEP-ANALYSIS-PLAN.mdresearch/ai-native/analysis-plan.mdx[ ]NEW
10456-SOURCE-CODE-DEEP-ANALYSIS.mdresearch/ai-native/source-analysis.mdx[ ]NEW
10559-NEW-PROBLEM-CATEGORY.mdresearch/ai-native/problem-category.mdx[ ]NEW
10660-TWO-SCENARIOS-GAME-ANALOGY.mdresearch/ai-native/game-analogy.mdx[ ]NEW
10761-AI-NATIVE-TERMINAL-DIAGRAMS.mdresearch/ai-native/diagrams.mdx[ ]NEW
10862-AI-NATIVE-TERMINAL-GIANTS-QUOTE.mdresearch/ai-native/giants-quote.mdx[ ]NEW
10963-AI-NATIVE-TERMINAL-ARCHITECTURE-SUCCESS-FACTORS.mdresearch/ai-native/success-factors.mdx[ ]NEW
11064-AI-NATIVE-TERMINAL-PRIOR-ART.mdresearch/ai-native/prior-art.mdx[ ]NEW
111README.mdresearch/ai-native-terminal.mdx[E]Check quality
Progress: 1/9 existing, 8 new needed

​
8. architecture-docs/ (2 files) → architecture/

#Source FileTargetStatusNotes
11202-data-flow.mdarchitecture/data-flow.mdx[ ]NEW
113ARCHITECTURE-VERSION.md(meta)[S]Skip - internal
Progress: 0/2 existing, 1 new needed, 1 skipped

​
9. Root files (3 files) → (meta/navigation)

#Source FileTargetStatusNotes
114README.md(meta)[S]Skip - internal index
115CLASSIFICATION-MAP.md(meta)[S]Skip - internal
116RESTRUCTURE-MAPPING.md(meta)[S]Skip - internal
Progress: 0/3 - all skipped (internal meta files)

​
📈 Progress Summary

┌─────────────────────────────────────────────────────────────────┐
│  CONVERSION PROGRESS                                            │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  Category                  Total  Exist  New   Skip   Done%     │
│  ─────────────────────────────────────────────────────────────  │
│  monoterm-guide/             13     6      4     1      --%     │
│  atomic-architecture/         9     1      7     1      --%     │
│  atomic-state/                9     1      7     1      --%     │
│  components/                 18     3     15     0      --%     │
│  monokinetics-concurrency/    5     1      4     0      --%     │
│  monokinetics-transparency/  48    26      1    21      --%     │
│  ux-ai-native/                9     1      8     0      --%     │
│  architecture-docs/           2     0      1     1      --%     │
│  Root files                   3     0      0     3      --%     │
│  ─────────────────────────────────────────────────────────────  │
│  TOTAL                      116    39     47    28              │
│                                                                 │
│  Existing files to verify:  39                                  │
│  New files to create:       47                                  │
│  Skipped (meta/merged):     28                                  │
│                                                                 │
│  ACTUAL WORK:               86 files (39 verify + 47 new)       │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

​
Phase A: Verify Existing Files (39 files)

  1. Check existing 39 files for Phase 3 quality
  2. Mark [✓] if good, or note issues for fixing

​
Phase B: Create New Files by Priority

Priority 1: Core Terminal (11 files)
  • terminal/atomic-state/*.mdx (7 files)
  • terminal/cursor-pattern.mdx
  • features/ai-cli-pairing.mdx
  • features/compatibility.mdx
  • philosophy/philosophy-to-app.mdx
Priority 2: Architecture Deep Dive (8 files)
  • architecture/deep-dive/*.mdx (7 files)
  • architecture/data-flow.mdx
Priority 3: Database (10 files)
  • database/architecture.mdx
  • database/schemas/*.mdx (5 files)
  • database/complex-relations.mdx
  • database/file-mapping.mdx
  • database/work-wiki-diff.mdx
  • database/module-graph.mdx
Priority 4: Components (4 files)
  • components/pty-log.mdx
  • components/variable-md.mdx
  • components/terminal-scrollbar.mdx
  • components/design-patterns.mdx
Priority 5: Philosophy Concurrency (4 files)
  • philosophy/concurrency/overview.mdx
  • philosophy/concurrency/five-patterns.mdx
  • philosophy/concurrency/actor-model.mdx
  • philosophy/concurrency/ack-synergy.mdx
Priority 6: Research AI-Native (8 files)
  • research/ai-native/*.mdx (8 files)
Priority 7: Transparency (1 file)
  • transparency/overview.mdx

​
📝 Conversion Template

When converting each file, follow this template: 
1. READ Phase 2 source file completely
2. IDENTIFY content to remove (per SKILL.md):
   - cache, buffer, CachedLine, hash
   - File paths (file.rs:142)
   - Code snippets
   - Internal variable names

3. IDENTIFY content to keep:
   - Rust, MPSC, Alacritty, Tauri
   - Unix Socket, WebGL, VTE Parser
   - Component names (SessionActor, DiffHint)
   - Performance numbers

4. TRANSFORM to Phase 3:
   - Replace removed content with ASCII diagrams
   - Target: 30% text, 70% diagrams
   - Apply grandmother test

5. WRITE to target .mdx file

6. VERIFY with quality checklist:
   □ No implementation details
   □ No file paths or line numbers
   □ No code snippets (except user commands)
   □ Tech terms present
   □ ASCII art ratio ~70%
   □ Diagrams self-explanatory
   □ Grandmother test passed

7. UPDATE this workbook - mark [✓]
ResourcePath
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/

​
📅 Session Log

DateSessionWork DoneFiles Completed
2025-01-17#1Created workbook, analyzed scope0
Last Updated: 2025-01-17