Project Directory Map

This document maps every documentation page to its purpose, organized by functional layer.

Documentation Hierarchy

  1. Getting Startedgetting-started/installation.md, getting-started/quickstart.md
  2. The Big Pictureindex.md
  3. Architecture & Designarchitecture/overview.mdarchitecture/components.mdarchitecture/threading.mdarchitecture/data-flow.md
  4. Configurationconfiguration/variables.md
  5. Troubleshootingtroubleshooting/common-issues.md

Detailed File Index

FilePurposeDescription
index.mdLanding pageProject overview, problem statement, quick start, documentation map
DIRECTORY_STRUCTURE.mdSite mapThis file — navigation guide to all docs
getting-started/installation.mdSetup guideSystem dependencies, Python deps, virtual environment, permissions
getting-started/quickstart.mdQuick startMinimal steps to run the script
architecture/overview.mdSystem architectureHigh-level overview, block diagram, component summary, data flow
architecture/components.mdComponent deep-diveDetailed code walkthrough of every subsystem
architecture/threading.mdThreading modelThread architecture, shared state, race conditions fixed
architecture/data-flow.mdLifecycle walkthroughEnd-to-end sequence from key press to text injection
configuration/variables.mdSettings referenceAll config variables, defaults, and recommendations
troubleshooting/common-issues.mdProblem diagnosisSymptom-based troubleshooting for common issues