# flatplanet/centeros architecture

> Architecture diagram of the GitHub repository flatplanet/centeros, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/flatplanet/centeros
- Repository: https://github.com/flatplanet/centeros

## Overview

CenterOS is a local, file-based AI operating environment: an AI assistant follows its setup and session instructions, then uses the repository’s workflows, memory, wikis, templates, and logs to produce persistent work. The dashboard provides a lightweight view and a script for adding workflow pages. The README documents the major capabilities; beyond the sampled dashboard-page generator, implementation details are largely unsampled, so those links reflect documented behavior rather than inspected calls.

Main entry points: [`dashboard/create-dashboard-page.py`](https://github.com/flatplanet/centeros/blob/main/dashboard/create-dashboard-page.py) (Page Creator), [`dashboard/index.html`](https://github.com/flatplanet/centeros/blob/main/dashboard/index.html) (Dashboard Shell), [`workflows`](https://github.com/flatplanet/centeros/tree/main/workflows) (Workflow Procedures), [`wikis`](https://github.com/flatplanet/centeros/tree/main/wikis) (Knowledge Bases)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orientation["AI Orientation"]
  node_startup["First Setup<br/>[STARTUP.md]"]
  node_bootstrap["Session Setup<br/>[BOOTSTRAP.md]"]
  node_rules["Harness Rules<br/>[AGENTS.md]"]
  node_identity["AI Identity<br/>[SOUL.md]"]
  node_profile["User Profile<br/>[PRINCIPAL.md]"]
  node_system_index["System Map<br/>[SYSTEM_INDEX.md]"]
end

subgraph group_work["Work Systems"]
  node_workflows["Workflow Procedures"]
  node_workflow_logs["Workflow Logs<br/>[LOG.md]"]
  node_workflow_template["Workflow Template"]
end

subgraph group_knowledge["Persistent Knowledge"]
  node_wikis["Knowledge Bases"]
  node_wiki_template["Wiki Template"]
  node_memory["Durable Memory<br/>[MEMORY.md]"]
  node_memory_log["System Change Log<br/>[LOG.md]"]
end

subgraph group_interface["Dashboard"]
  node_dashboard["Dashboard Shell<br/>[index.html]"]
  node_dashboard_pages["Workflow Pages"]
  node_dashboard_template["Page Template<br/>[page.html]"]
  node_page_creator["Page Creator"]
end

node_user(("User"))
node_assistant(("AI Assistant"))

node_user -->|"requests work"| node_assistant
node_assistant -->|"follows setup"| node_startup
node_assistant -->|"orients each session"| node_bootstrap
node_assistant -->|"follows rules"| node_rules
node_assistant -->|"uses principles"| node_identity
node_assistant -->|"uses preferences"| node_profile
node_assistant -->|"consults map"| node_system_index
node_assistant -->|"runs procedures"| node_workflows
node_assistant -->|"appends run entry"| node_workflow_logs
node_workflow_template -->|"scaffolds"| node_workflows
node_assistant -->|"builds knowledge"| node_wikis
node_wiki_template -->|"scaffolds"| node_wikis
node_assistant -->|"stores durable context"| node_memory
node_assistant -->|"records changes"| node_memory_log
node_assistant -->|"views dashboard"| node_dashboard
node_dashboard -->|"links pages"| node_dashboard_pages
node_page_creator -->|"reads template"| node_dashboard_template
node_page_creator -->|"writes page"| node_dashboard_pages
node_page_creator -->|"updates sidebar"| node_dashboard

click node_startup "https://github.com/flatplanet/centeros/blob/main/STARTUP.md"
click node_bootstrap "https://github.com/flatplanet/centeros/blob/main/BOOTSTRAP.md"
click node_rules "https://github.com/flatplanet/centeros/blob/main/AGENTS.md"
click node_identity "https://github.com/flatplanet/centeros/blob/main/SOUL.md"
click node_profile "https://github.com/flatplanet/centeros/blob/main/PRINCIPAL.md"
click node_system_index "https://github.com/flatplanet/centeros/blob/main/SYSTEM_INDEX.md"
click node_workflows "https://github.com/flatplanet/centeros/tree/main/workflows"
click node_workflow_logs "https://github.com/flatplanet/centeros/blob/main/workflows/LOG.md"
click node_workflow_template "https://github.com/flatplanet/centeros/tree/main/templates/workflow"
click node_wikis "https://github.com/flatplanet/centeros/tree/main/wikis"
click node_wiki_template "https://github.com/flatplanet/centeros/tree/main/templates/wiki"
click node_memory "https://github.com/flatplanet/centeros/blob/main/memory/MEMORY.md"
click node_memory_log "https://github.com/flatplanet/centeros/blob/main/memory/LOG.md"
click node_dashboard "https://github.com/flatplanet/centeros/blob/main/dashboard/index.html"
click node_dashboard_pages "https://github.com/flatplanet/centeros/tree/main/dashboard/workflows"
click node_dashboard_template "https://github.com/flatplanet/centeros/blob/main/templates/dashboard-page/page.html"
click node_page_creator "https://github.com/flatplanet/centeros/blob/main/dashboard/create-dashboard-page.py"

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_startup,node_bootstrap,node_rules,node_identity,node_profile,node_system_index,node_user toneBlue
class node_workflows,node_workflow_logs,node_workflow_template toneAmber
class node_wikis,node_wiki_template,node_memory,node_memory_log toneMint
class node_dashboard,node_dashboard_pages,node_dashboard_template,node_page_creator toneRose
class node_assistant toneIndigo
```

## Components

### AI Orientation

- [First Setup](https://github.com/flatplanet/centeros/blob/main/STARTUP.md): `STARTUP.md`
- [Session Setup](https://github.com/flatplanet/centeros/blob/main/BOOTSTRAP.md): `BOOTSTRAP.md`
- [Harness Rules](https://github.com/flatplanet/centeros/blob/main/AGENTS.md): `AGENTS.md`
- [AI Identity](https://github.com/flatplanet/centeros/blob/main/SOUL.md): `SOUL.md`
- [User Profile](https://github.com/flatplanet/centeros/blob/main/PRINCIPAL.md): `PRINCIPAL.md`
- [System Map](https://github.com/flatplanet/centeros/blob/main/SYSTEM_INDEX.md): `SYSTEM_INDEX.md`

### Work Systems

- [Workflow Procedures](https://github.com/flatplanet/centeros/tree/main/workflows): `workflows`
- [Workflow Logs](https://github.com/flatplanet/centeros/blob/main/workflows/LOG.md): `workflows/LOG.md`
- [Workflow Template](https://github.com/flatplanet/centeros/tree/main/templates/workflow): `templates/workflow`

### Persistent Knowledge

- [Knowledge Bases](https://github.com/flatplanet/centeros/tree/main/wikis): `wikis`
- [Wiki Template](https://github.com/flatplanet/centeros/tree/main/templates/wiki): `templates/wiki`
- [Durable Memory](https://github.com/flatplanet/centeros/blob/main/memory/MEMORY.md): `memory/MEMORY.md`
- [System Change Log](https://github.com/flatplanet/centeros/blob/main/memory/LOG.md): `memory/LOG.md`

### Dashboard

- [Dashboard Shell](https://github.com/flatplanet/centeros/blob/main/dashboard/index.html): `dashboard/index.html`
- [Workflow Pages](https://github.com/flatplanet/centeros/tree/main/dashboard/workflows): `dashboard/workflows`
- [Page Template](https://github.com/flatplanet/centeros/blob/main/templates/dashboard-page/page.html): `templates/dashboard-page/page.html`
- [Page Creator](https://github.com/flatplanet/centeros/blob/main/dashboard/create-dashboard-page.py): `dashboard/create-dashboard-page.py`

### Other components

- **User**
- **AI Assistant**

## Connections

- User → AI Assistant: requests work (evidence: `README.md`)
- AI Assistant → First Setup: follows setup (evidence: `README.md`)
- AI Assistant → Session Setup: orients each session (evidence: `README.md`)
- AI Assistant → Harness Rules: follows rules (evidence: `README.md`)
- AI Assistant → AI Identity: uses principles (evidence: `README.md`)
- AI Assistant → User Profile: uses preferences (evidence: `README.md`)
- AI Assistant → System Map: consults map (evidence: `README.md`)
- AI Assistant → Workflow Procedures: runs procedures (evidence: `README.md`)
- AI Assistant → Workflow Logs: appends run entry (evidence: `README.md`)
- Workflow Template → Workflow Procedures: scaffolds (evidence: `README.md`)
- AI Assistant → Knowledge Bases: builds knowledge (evidence: `README.md`)
- Wiki Template → Knowledge Bases: scaffolds (evidence: `README.md`)
- AI Assistant → Durable Memory: stores durable context (evidence: `README.md`)
- AI Assistant → System Change Log: records changes (evidence: `README.md`)
- AI Assistant → Dashboard Shell: views dashboard (evidence: `README.md`)
- Dashboard Shell → Workflow Pages: links pages (evidence: `README.md`)
- Page Creator → Page Template: reads template (evidence: `dashboard/create-dashboard-page.py`)
- Page Creator → Workflow Pages: writes page (evidence: `dashboard/create-dashboard-page.py`)
- Page Creator → Dashboard Shell: updates sidebar (evidence: `dashboard/create-dashboard-page.py`)
