Project Directory Map

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

Documentation Hierarchy

  1. Getting Started → getting-started/installation.md, getting-started/quickstart.md
  2. The Big Picture → index.md
  3. Architecture & Design → architecture/overview.md → architecture/components.md → architecture/threading.md → architecture/data-flow.md
  4. Configuration → configuration/variables.md
  5. Troubleshooting → troubleshooting/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