# pavrus117/ai-os-maps-guide architecture

> Architecture diagram of the GitHub repository pavrus117/ai-os-maps-guide, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pavrus117/ai-os-maps-guide
- Repository: https://github.com/pavrus117/ai-os-maps-guide
- Video tour (about a minute): https://gitdiagram.com/pavrus117/ai-os-maps-guide/video

## Overview

This repository is a written setup guide, not an implementation: README.md provides interview and build prompts for a four-layer personal AI operating system, and ai-os-maps-guide.pdf is its companion copy. The principal workflow is to interview the user, establish a navigable memory map, share it across machines, run scheduled routines, then view or trigger work from a dashboard. The graph captures documented responsibilities and relationships, not verified software calls; the README excerpt ends during Card 3, so detailed Pulse and Screen wiring is limited to what it states.

Main entry points: [`README.md`](https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md) (Always-on workspace)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_memory["Memory"]
  node_interview["Interview session<br/>[README.md]"]
  node_interview_file["Interview record<br/>[README.md]"]
  node_master_map["Master signpost<br/>[README.md]"]
  node_area_signposts["Area signposts<br/>[README.md]"]
  node_work_files["Work documents<br/>[README.md]"]
  node_map_checker["Map checker<br/>[README.md]"]
end

subgraph group_agent["Agent"]
  node_laptop["Laptop workspace<br/>[README.md]"]
  node_server["Always-on workspace<br/>[README.md]"]
  node_git_sync["Git synchronization<br/>[README.md]"]
  node_private_network["Private network<br/>[README.md]"]
  node_restricted_profile["Restricted profile<br/>[README.md]"]
  node_telegram_bot["Telegram bot<br/>[README.md]"]
end

subgraph group_pulse["Pulse"]
  node_routine_list["Routine list<br/>[README.md]"]
  node_scheduler["Schedulers<br/>[README.md]"]
  node_routine["Scheduled routine<br/>[README.md]"]
  node_run_record["Run records<br/>[README.md]"]
end

subgraph group_screen["Screen"]
  node_dashboard["Dashboard<br/>[README.md]"]
  node_right_machine["Selected machine<br/>[README.md]"]
end

node_user(("User"))
node_claude_code["Claude Code"]
node_telegram["Telegram"]

node_user -->|"answers questions"| node_interview
node_interview -->|"guides interview"| node_claude_code
node_claude_code -->|"records answers"| node_interview_file
node_interview_file -->|"informs draft"| node_master_map
node_claude_code -->|"drafts map"| node_master_map
node_master_map -->|"points to"| node_area_signposts
node_area_signposts -->|"points to"| node_work_files
node_map_checker -->|"checks paths"| node_master_map
node_map_checker -->|"checks sections"| node_area_signposts
node_map_checker -->|"flags omissions"| node_work_files
node_laptop -->|"shares workspace"| node_git_sync
node_server -->|"shares workspace"| node_git_sync
node_git_sync -->|"syncs changes"| node_laptop
node_git_sync -->|"syncs changes"| node_server
node_private_network -.->|"protects access"| node_server
node_restricted_profile -->|"limits tools"| node_server
node_telegram -.->|"sends messages"| node_telegram_bot
node_telegram_bot -.->|"uses profile"| node_restricted_profile
node_telegram_bot -.->|"logs replies"| node_server
node_routine_list -->|"defines schedules"| node_scheduler
node_scheduler -->|"runs when due"| node_routine
node_routine -->|"records run"| node_run_record
node_dashboard -->|"reads records"| node_run_record
node_dashboard -->|"reads data"| node_work_files
node_dashboard -->|"dispatches work"| node_right_machine

click node_interview "https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md"
click node_interview_file "https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md"
click node_master_map "https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md"
click node_area_signposts "https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md"
click node_work_files "https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md"
click node_map_checker "https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md"
click node_laptop "https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md"
click node_server "https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md"
click node_git_sync "https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md"
click node_private_network "https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md"
click node_restricted_profile "https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md"
click node_telegram_bot "https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md"
click node_routine_list "https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md"
click node_scheduler "https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md"
click node_routine "https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md"
click node_run_record "https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md"
click node_dashboard "https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md"
click node_right_machine "https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_interview,node_interview_file,node_master_map,node_area_signposts,node_work_files,node_map_checker,node_user toneBlue
class node_laptop,node_server,node_git_sync,node_private_network,node_restricted_profile,node_telegram_bot toneAmber
class node_routine_list,node_scheduler,node_routine,node_run_record toneMint
class node_dashboard,node_right_machine toneRose
class node_claude_code,node_telegram toneIndigo
```

## Components

### Memory

- [Interview session](https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md): `README.md`
- [Interview record](https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md): `README.md`
- [Master signpost](https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md): `README.md`
- [Area signposts](https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md): `README.md`
- [Work documents](https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md): `README.md`
- [Map checker](https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md): `README.md`

### Agent

- [Laptop workspace](https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md): `README.md`
- [Always-on workspace](https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md): `README.md`
- [Git synchronization](https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md): `README.md`
- [Private network](https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md): `README.md`
- [Restricted profile](https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md): `README.md`
- [Telegram bot](https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md): `README.md`

### Pulse

- [Routine list](https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md): `README.md`
- [Schedulers](https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md): `README.md`
- [Scheduled routine](https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md): `README.md`
- [Run records](https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md): `README.md`

### Screen

- [Dashboard](https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md): `README.md`
- [Selected machine](https://github.com/pavrus117/ai-os-maps-guide/blob/main/README.md): `README.md`

### Other components

- **User**
- **Claude Code**
- **Telegram**

## Connections

- User → Interview session: answers questions
- Interview session → Claude Code: guides interview
- Claude Code → Interview record: records answers
- Interview record → Master signpost: informs draft
- Claude Code → Master signpost: drafts map
- Master signpost → Area signposts: points to
- Area signposts → Work documents: points to
- Map checker → Master signpost: checks paths
- Map checker → Area signposts: checks sections
- Map checker → Work documents: flags omissions
- Laptop workspace → Git synchronization: shares workspace
- Always-on workspace → Git synchronization: shares workspace
- Git synchronization → Laptop workspace: syncs changes
- Git synchronization → Always-on workspace: syncs changes
- Private network → Always-on workspace: protects access
- Restricted profile → Always-on workspace: limits tools
- Telegram → Telegram bot: sends messages
- Telegram bot → Restricted profile: uses profile
- Telegram bot → Always-on workspace: logs replies
- Routine list → Schedulers: defines schedules
- Schedulers → Scheduled routine: runs when due
- Scheduled routine → Run records: records run
- Dashboard → Run records: reads records
- Dashboard → Work documents: reads data
- Dashboard → Selected machine: dispatches work