> ## Documentation Index > Fetch the complete documentation index at: https://docs.monolex.ai/llms.txt > Use this file to discover all available pages before exploring further. # CONVERSION WORKBOOK # 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:** ```bash theme={null} # 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 File | Target | Status | Notes | | -- | ------------------------------------- | --------------------------------------- | ------ | ---------------- | | 1 | `01-what-is-monoterm.md` | introduction.mdx | \[E] | Check quality | | 2 | `02-atomic-loop.md` | terminal/atomic-loop.mdx | \[E] | Check quality | | 3 | `03-bsu-esu.md` | terminal/bsu-esu-protocol.mdx | \[E] | Check quality | | 4 | `04-data-reduction.md` | terminal/data-reduction.mdx | \[E] | Check quality | | 5 | `05-monokinetics.md` | philosophy/monokinetics.mdx | \[E] | Check quality | | 6 | `06-monokinetic-hermeneutics.md` | philosophy/monokinetic-hermeneutics.mdx | \[E] | Check quality | | 7 | `07-monokinetics-and-monolex.md` | philosophy/philosophy-to-app.mdx | \[ ] | NEW | | 8 | `08-monokinetics-and-monoterm.md` | architecture/philosophy-to-code.mdx | \[E] | Check quality | | 9 | `09-cursor-pattern-pseudo-bsu.md` | terminal/cursor-pattern.mdx | \[ ] | NEW | | 10 | `09-monokinetics-concurrency.md` | philosophy/concurrency-intro.mdx | \[ ] | NEW | | 11 | `10-ai-cli-framework-pairing.md` | features/ai-cli-pairing.mdx | \[ ] | NEW | | 12 | `11-monoterm-compatibility-matrix.md` | features/compatibility.mdx | \[ ] | NEW | | 13 | `README.md` | (index) | \[S] | Skip - meta file | **Progress: 6/13 existing, 4 new needed, 1 skipped** *** ### 2. atomic-architecture/ (9 files) → architecture/deep-dive/ | # | Source File | Target | Status | Notes | | -- | ---------------------------------- | ----------------------------------------------------- | ------ | ---------------- | | 14 | `01-overview.md` | architecture/overview\.mdx | \[E] | Check quality | | 15 | `02-component-architecture.md` | architecture/deep-dive/component-architecture.mdx | \[ ] | NEW | | 16 | `03-ack-gate-flow-control.md` | architecture/deep-dive/ack-gate-flow\.mdx | \[ ] | NEW | | 17 | `04-epoch-synchronization.md` | architecture/deep-dive/epoch-sync.mdx | \[ ] | NEW | | 18 | `05-xterm-as-renderer.md` | architecture/deep-dive/xterm-renderer.mdx | \[ ] | NEW | | 19 | `06-backend-rendering-patterns.md` | architecture/deep-dive/backend-patterns.mdx | \[ ] | NEW | | 20 | `07-simulation-vs-presentation.md` | architecture/deep-dive/simulation-vs-presentation.mdx | \[ ] | NEW | | 21 | `08-dirty-tracking-strategies.md` | architecture/deep-dive/dirty-tracking.mdx | \[ ] | NEW | | 22 | `README.md` | (index) | \[S] | Skip - meta file | **Progress: 1/9 existing, 7 new needed, 1 skipped** *** ### 3. atomic-state/ (9 files) → terminal/atomic-state/ | # | Source File | Target | Status | Notes | | -- | ---------------------------- | ----------------------------------------- | ------ | ---------------- | | 23 | `01-overview.md` | terminal/atomic-state.mdx | \[E] | Check quality | | 24 | `01-what-is-atomic-state.md` | terminal/atomic-state/what-is.mdx | \[ ] | NEW | | 25 | `02-data-flow.md` | terminal/atomic-state/data-flow\.mdx | \[ ] | NEW | | 26 | `02-how-it-works.md` | terminal/atomic-state/how-it-works.mdx | \[ ] | NEW | | 27 | `03-buffer-model.md` | terminal/atomic-state/buffer-model.mdx | \[ ] | NEW | | 28 | `03-performance-benefits.md` | terminal/atomic-state/performance.mdx | \[ ] | NEW | | 29 | `04-diff-rendering.md` | terminal/atomic-state/diff-rendering.mdx | \[ ] | NEW | | 30 | `04-troubleshooting.md` | terminal/atomic-state/troubleshooting.mdx | \[ ] | NEW | | 31 | `README.md` | (index) | \[S] | Skip - meta file | **Progress: 1/9 existing, 7 new needed, 1 skipped** *** ### 4. components/ (18 files) → components/, database/, features/, daemons/ | # | Source File | Target | Status | Notes | | -- | -------------------------------- | ----------------------------------- | ------ | ------------- | | 32 | `ch1-pty-daemon.md` | terminal/pty-daemon.mdx | \[E] | Check quality | | 33 | `ch3-pty-log.md` | components/pty-log.mdx | \[ ] | NEW | | 34 | `ch4-atomic-term-ime.md` | features/ime-cjk-support.mdx | \[E] | Check quality | | 35 | `ch5-niia-watcher.md` | daemons/niia-watcher.mdx | \[E] | Check quality | | 36 | `ch6-variable-md.md` | components/variable-md.mdx | \[ ] | NEW | | 37 | `ch7-database-architecture.md` | database/architecture.mdx | \[ ] | NEW | | 38 | `ch8-complex-relations.md` | database/complex-relations.mdx | \[ ] | NEW | | 39 | `ch9-file-db-mapping.md` | database/file-mapping.mdx | \[ ] | NEW | | 40 | `ch10-work-wiki-diff.md` | database/work-wiki-diff.mdx | \[ ] | NEW | | 41 | `ch11-module-db-graph.md` | database/module-graph.mdx | \[ ] | NEW | | 42 | `ch12-unified-connection-map.md` | database/unified-map.mdx | \[ ] | NEW | | 43 | `ch13-terminal-scrollbar.md` | components/terminal-scrollbar.mdx | \[ ] | NEW | | 44 | `ch19-design-patterns.md` | components/design-patterns.mdx | \[ ] | NEW | | 45 | `db-atomic-term.md` | database/schemas/atomic-term.mdx | \[ ] | NEW | | 46 | `db-niia-watcher.md` | database/schemas/niia-watcher.mdx | \[ ] | NEW | | 47 | `db-onit.md` | database/schemas/onit.mdx | \[ ] | NEW | | 48 | `db-session.md` | database/schemas/session.mdx | \[ ] | NEW | | 49 | `db-work-wiki-diff.md` | database/schemas/work-wiki-diff.mdx | \[ ] | NEW | **Progress: 3/18 existing, 15 new needed** *** ### 5. monokinetics-concurrency/ (5 files) → philosophy/concurrency/ | # | Source File | Target | Status | Notes | | -- | ---------------------------------------- | ---------------------------------------- | ------ | ------------- | | 50 | `monokinetics-concurrency-philosophy.md` | philosophy/concurrency/overview\.mdx | \[ ] | NEW | | 51 | `00-five-pattern-synergy.md` | philosophy/concurrency/five-patterns.mdx | \[ ] | NEW | | 52 | `01-actor-over-mutex.md` | philosophy/concurrency/actor-model.mdx | \[ ] | NEW | | 53 | `02-actor-ack-synergy.md` | philosophy/concurrency/ack-synergy.mdx | \[ ] | NEW | | 54 | `03-atomicstate-absorber.md` | architecture/concurrency-patterns.mdx | \[E] | Check quality | **Progress: 1/5 existing, 4 new needed** *** ### 6. monokinetics-transparency/ (48 files) → transparency/ | # | Source File | Target | Status | Notes | | --- | ----------------------------------------- | ------------------------------------------------- | ------ | --------------- | | 55 | `00-overview.md` | transparency/overview\.mdx | \[ ] | NEW or merge | | 56 | `01-work-wiki-core/chapter-01-*.md` | transparency/core/overview\.mdx | \[E] | Check quality | | 57 | `01-work-wiki-core/chapter-02-*.md` | transparency/core/visualization.mdx | \[E] | Check quality | | 58 | `01-work-wiki-core/chapter-03-*.md` | transparency/core/data-model.mdx | \[E] | Check quality | | 59 | `01-work-wiki-core/chapter-04-*.md` | transparency/core/integration.mdx | \[E] | Check quality | | 60 | `01-work-wiki-core/README.md` | (index) | \[S] | Skip | | 61 | `02-git-viewers/chapter-05-*.md` | transparency/git-viewers/base-viewer.mdx | \[E] | Check quality | | 62 | `02-git-viewers/chapter-06-*.md` | transparency/git-viewers/dashboard.mdx | \[E] | Check quality | | 63 | `02-git-viewers/chapter-07-*.md` | transparency/git-viewers/wiki-base.mdx | \[E] | Check quality | | 64 | `02-git-viewers/chapter-08-*.md` | transparency/git-viewers/blame-stash.mdx | \[E] | Merged 08+09 | | 65 | `02-git-viewers/chapter-09-*.md` | (merged with 08) | \[S] | Merged | | 66 | `02-git-viewers/chapter-10-*.md` | transparency/git-viewers/diff-commit.mdx | \[E] | Merged 10+11 | | 67 | `02-git-viewers/chapter-11-*.md` | (merged with 10) | \[S] | Merged | | 68 | `02-git-viewers/chapter-12-*.md` | transparency/git-viewers/parser-prove.mdx | \[E] | Merged 12+13 | | 69 | `02-git-viewers/chapter-13-*.md` | (merged with 12) | \[S] | Merged | | 70 | `02-git-viewers/chapter-14-*.md` | transparency/git-viewers/research-frontmatter.mdx | \[E] | Merged 14+15 | | 71 | `02-git-viewers/chapter-15-*.md` | (merged with 14) | \[S] | Merged | | 72 | `02-git-viewers/chapter-16-*.md` | transparency/git-viewers/integration-heatmap.mdx | \[E] | Merged 16+17+18 | | 73 | `02-git-viewers/chapter-17-*.md` | (merged with 16) | \[S] | Merged | | 74 | `02-git-viewers/chapter-18-*.md` | (merged with 16) | \[S] | Merged | | 75 | `02-git-viewers/README.md` | (index) | \[S] | Skip | | 76 | `03-extension/chapter-19-*.md` | transparency/extension/architecture.mdx | \[E] | Check quality | | 77 | `03-extension/chapter-20-*.md` | transparency/extension/implementation.mdx | \[E] | Check quality | | 78 | `03-extension/README.md` | (index) | \[S] | Skip | | 79 | `04-wiki-viewers/chapter-21-*.md` | transparency/wiki-viewers/onit-overview\.mdx | \[E] | Check quality | | 80 | `04-wiki-viewers/chapter-22-*.md` | (merged) | \[S] | Merged | | 81 | `04-wiki-viewers/chapter-23-*.md` | transparency/wiki-viewers/onit-render.mdx | \[E] | Check quality | | 82 | `04-wiki-viewers/chapter-24-*.md` | (merged) | \[S] | Merged | | 83 | `04-wiki-viewers/chapter-25-*.md` | transparency/wiki-viewers/onit-state.mdx | \[E] | Check quality | | 84 | `04-wiki-viewers/chapter-26-*.md` | transparency/wiki-viewers/prepare-viewer.mdx | \[E] | Check quality | | 85 | `04-wiki-viewers/chapter-27-*.md` | (merged) | \[S] | Merged | | 86 | `04-wiki-viewers/chapter-28-*.md` | (merged) | \[S] | Merged | | 87 | `04-wiki-viewers/chapter-29-*.md` | (merged) | \[S] | Merged | | 88 | `04-wiki-viewers/chapter-30-*.md` | transparency/wiki-viewers/onit-prepare.mdx | \[E] | Check quality | | 89 | `04-wiki-viewers/README.md` | (index) | \[S] | Skip | | 90 | `05-git-rs-backend/chapter-31-*.md` | transparency/git-backend/overview\.mdx | \[E] | Check quality | | 91 | `05-git-rs-backend/chapter-32-*.md` | transparency/git-backend/implementation.mdx | \[E] | Check quality | | 92 | `05-git-rs-backend/chapter-33-*.md` | transparency/git-backend/work-wiki.mdx | \[E] | Check quality | | 93 | `05-git-rs-backend/README.md` | (index) | \[S] | Skip | | 94 | `06-commit-graph-upgrade/chapter-34-*.md` | transparency/commit-graph/current-state.mdx | \[E] | Check quality | | 95 | `06-commit-graph-upgrade/chapter-35-*.md` | (merged) | \[S] | Merged | | 96 | `06-commit-graph-upgrade/chapter-36-*.md` | transparency/commit-graph/upgrade-plan.mdx | \[E] | Merged 36+37 | | 97 | `06-commit-graph-upgrade/chapter-37-*.md` | (merged with 36) | \[S] | Merged | | 98 | `06-commit-graph-upgrade/README.md` | (index) | \[S] | Skip | | 99 | `07-niia-watcher/chapter-38-*.md` | transparency/file-watcher/architecture.mdx | \[E] | Check quality | | 100 | `07-niia-watcher/chapter-39-*.md` | transparency/file-watcher/integration.mdx | \[E] | Check quality | | 101 | `07-niia-watcher/README.md` | (index) | \[S] | Skip | | 102 | `README.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 File | Target | Status | Notes | | --- | ------------------------------------------------------- | --------------------------------------- | ------ | ------------- | | 103 | `50-STEP-ANALYSIS-PLAN.md` | research/ai-native/analysis-plan.mdx | \[ ] | NEW | | 104 | `56-SOURCE-CODE-DEEP-ANALYSIS.md` | research/ai-native/source-analysis.mdx | \[ ] | NEW | | 105 | `59-NEW-PROBLEM-CATEGORY.md` | research/ai-native/problem-category.mdx | \[ ] | NEW | | 106 | `60-TWO-SCENARIOS-GAME-ANALOGY.md` | research/ai-native/game-analogy.mdx | \[ ] | NEW | | 107 | `61-AI-NATIVE-TERMINAL-DIAGRAMS.md` | research/ai-native/diagrams.mdx | \[ ] | NEW | | 108 | `62-AI-NATIVE-TERMINAL-GIANTS-QUOTE.md` | research/ai-native/giants-quote.mdx | \[ ] | NEW | | 109 | `63-AI-NATIVE-TERMINAL-ARCHITECTURE-SUCCESS-FACTORS.md` | research/ai-native/success-factors.mdx | \[ ] | NEW | | 110 | `64-AI-NATIVE-TERMINAL-PRIOR-ART.md` | research/ai-native/prior-art.mdx | \[ ] | NEW | | 111 | `README.md` | research/ai-native-terminal.mdx | \[E] | Check quality | **Progress: 1/9 existing, 8 new needed** *** ### 8. architecture-docs/ (2 files) → architecture/ | # | Source File | Target | Status | Notes | | --- | ------------------------- | --------------------------- | ------ | --------------- | | 112 | `02-data-flow.md` | architecture/data-flow\.mdx | \[ ] | NEW | | 113 | `ARCHITECTURE-VERSION.md` | (meta) | \[S] | Skip - internal | **Progress: 0/2 existing, 1 new needed, 1 skipped** *** ### 9. Root files (3 files) → (meta/navigation) | # | Source File | Target | Status | Notes | | --- | ------------------------ | ------ | ------ | --------------------- | | 114 | `README.md` | (meta) | \[S] | Skip - internal index | | 115 | `CLASSIFICATION-MAP.md` | (meta) | \[S] | Skip - internal | | 116 | `RESTRUCTURE-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) │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` *** ## 🎯 Work Order (Recommended) ### 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 [✓] ``` *** ## 📚 Reference Quick Links | Resource | Path | | -------------- | --------------------------------------------------------------------------------------- | | 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 | Date | Session | Work Done | Files Completed | | ---------- | ------- | -------------------------------- | --------------- | | 2025-01-17 | #1 | Created workbook, analyzed scope | 0 | | | | | | *** **Last Updated**: 2025-01-17