# go2sun/centeros architecture

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

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

## Overview

CenterOS is a local, file-based workspace that gives an AI assistant persistent instructions, memory, knowledge, and repeatable workflows. The main user journey is to start a session in an AI harness, orient it with the repository’s startup or bootstrap instructions, then create or run a workflow and retain its outputs and log. Separate branches support wiki synthesis and dashboard pages. The README documents these capabilities; sampled implementation evidence is limited to the dashboard-page generator, so other internal links are shown only where documented.

Main entry points: [`dashboard/create-dashboard-page.py`](https://github.com/go2sun/centeros/blob/main/dashboard/create-dashboard-page.py) (Page Generator), [`dashboard/index.html`](https://github.com/go2sun/centeros/blob/main/dashboard/index.html) (Dashboard Shell), [`dashboard/workflows`](https://github.com/go2sun/centeros/tree/main/dashboard/workflows) (Dashboard Pages), [`STARTUP.md`](https://github.com/go2sun/centeros/blob/main/STARTUP.md) (First-Time Setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

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

subgraph group_workflows["Workflow System"]
  node_workflows["Workflow Folders"]
  node_workflow_context["Workflow Instructions<br/>[CONTEXT.md]"]
  node_workflow_logs["Workflow Logs<br/>[LOG.md]"]
end

subgraph group_knowledge["Knowledge Base"]
  node_wiki_sources["Wiki Source Material"]
  node_wiki_pages["Wiki Knowledge"]
  node_memory["Durable Memory<br/>[MEMORY.md]"]
  node_memory_log["Memory Log<br/>[LOG.md]"]
end

subgraph group_interface["Dashboard Interface"]
  node_dashboard_shell["Dashboard Shell<br/>[index.html]"]
  node_dashboard_pages["Dashboard Pages"]
  node_page_generator["Page Generator"]
end

subgraph group_scaffolding["Reusable Scaffolding"]
  node_page_template["Dashboard Page Template<br/>[page.html]"]
  node_workflow_template["Workflow Template<br/>[README.md]"]
  node_wiki_template["Wiki Template<br/>[README.md]"]
end

node_user(("User"))
node_harness(("AI Harness"))

node_user -->|"opens workspace"| node_harness
node_harness -->|"follows on setup"| node_startup
node_harness -->|"follows each session"| node_bootstrap
node_harness -->|"reads rules"| node_rules
node_harness -->|"reads identity"| node_identity
node_harness -->|"reads preferences"| node_principal
node_harness -->|"reads map"| node_system_index
node_harness -->|"creates or runs"| node_workflows
node_harness -->|"follows instructions"| node_workflow_context
node_harness -->|"appends run"| node_workflow_logs
node_harness -->|"reads sources"| node_wiki_sources
node_harness -->|"synthesizes pages"| node_wiki_pages
node_harness -->|"maintains memory"| node_memory
node_harness -->|"records changes"| node_memory_log
node_user -->|"views dashboard"| node_dashboard_shell
node_dashboard_shell -->|"links pages"| node_dashboard_pages
node_page_generator -->|"renders template"| node_page_template
node_page_generator -->|"writes page"| node_dashboard_pages
node_page_generator -->|"updates sidebar"| node_dashboard_shell
node_harness -->|"uses to scaffold"| node_workflow_template
node_harness -->|"uses to scaffold"| node_wiki_template

click node_startup "https://github.com/go2sun/centeros/blob/main/STARTUP.md"
click node_bootstrap "https://github.com/go2sun/centeros/blob/main/BOOTSTRAP.md"
click node_rules "https://github.com/go2sun/centeros/blob/main/AGENTS.md"
click node_identity "https://github.com/go2sun/centeros/blob/main/SOUL.md"
click node_principal "https://github.com/go2sun/centeros/blob/main/PRINCIPAL.md"
click node_system_index "https://github.com/go2sun/centeros/blob/main/SYSTEM_INDEX.md"
click node_workflows "https://github.com/go2sun/centeros/tree/main/workflows"
click node_workflow_context "https://github.com/go2sun/centeros/blob/main/workflows/CONTEXT.md"
click node_workflow_logs "https://github.com/go2sun/centeros/blob/main/workflows/LOG.md"
click node_wiki_sources "https://github.com/go2sun/centeros/tree/main/wikis"
click node_wiki_pages "https://github.com/go2sun/centeros/tree/main/wikis"
click node_memory "https://github.com/go2sun/centeros/blob/main/memory/MEMORY.md"
click node_memory_log "https://github.com/go2sun/centeros/blob/main/memory/LOG.md"
click node_dashboard_shell "https://github.com/go2sun/centeros/blob/main/dashboard/index.html"
click node_dashboard_pages "https://github.com/go2sun/centeros/tree/main/dashboard/workflows"
click node_page_generator "https://github.com/go2sun/centeros/blob/main/dashboard/create-dashboard-page.py"
click node_page_template "https://github.com/go2sun/centeros/blob/main/templates/dashboard-page/page.html"
click node_workflow_template "https://github.com/go2sun/centeros/blob/main/templates/workflow/README.md"
click node_wiki_template "https://github.com/go2sun/centeros/blob/main/templates/wiki/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_startup,node_bootstrap,node_rules,node_identity,node_principal,node_system_index,node_user toneBlue
class node_workflows,node_workflow_context,node_workflow_logs toneAmber
class node_wiki_sources,node_wiki_pages,node_memory,node_memory_log toneMint
class node_dashboard_shell,node_dashboard_pages,node_page_generator toneRose
class node_page_template,node_workflow_template,node_wiki_template,node_harness toneIndigo
```

## Components

### Session Orientation

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

### Workflow System

- [Workflow Folders](https://github.com/go2sun/centeros/tree/main/workflows): `workflows`
- [Workflow Instructions](https://github.com/go2sun/centeros/blob/main/workflows/CONTEXT.md): `workflows/CONTEXT.md`
- [Workflow Logs](https://github.com/go2sun/centeros/blob/main/workflows/LOG.md): `workflows/LOG.md`

### Knowledge Base

- [Wiki Source Material](https://github.com/go2sun/centeros/tree/main/wikis): `wikis`
- [Wiki Knowledge](https://github.com/go2sun/centeros/tree/main/wikis): `wikis`
- [Durable Memory](https://github.com/go2sun/centeros/blob/main/memory/MEMORY.md): `memory/MEMORY.md`
- [Memory Log](https://github.com/go2sun/centeros/blob/main/memory/LOG.md): `memory/LOG.md`

### Dashboard Interface

- [Dashboard Shell](https://github.com/go2sun/centeros/blob/main/dashboard/index.html): `dashboard/index.html`
- [Dashboard Pages](https://github.com/go2sun/centeros/tree/main/dashboard/workflows): `dashboard/workflows`
- [Page Generator](https://github.com/go2sun/centeros/blob/main/dashboard/create-dashboard-page.py): `dashboard/create-dashboard-page.py`

### Reusable Scaffolding

- [Dashboard Page Template](https://github.com/go2sun/centeros/blob/main/templates/dashboard-page/page.html): `templates/dashboard-page/page.html`
- [Workflow Template](https://github.com/go2sun/centeros/blob/main/templates/workflow/README.md): `templates/workflow/README.md`
- [Wiki Template](https://github.com/go2sun/centeros/blob/main/templates/wiki/README.md): `templates/wiki/README.md`

### Other components

- **User**
- **AI Harness**

## Connections

- User → AI Harness: opens workspace
- AI Harness → First-Time Setup: follows on setup
- AI Harness → Session Orientation: follows each session
- AI Harness → Harness Rules: reads rules
- AI Harness → Identity and Profile: reads identity
- AI Harness → User Preferences: reads preferences
- AI Harness → System Map: reads map
- AI Harness → Workflow Folders: creates or runs
- AI Harness → Workflow Instructions: follows instructions
- AI Harness → Workflow Logs: appends run
- AI Harness → Wiki Source Material: reads sources
- AI Harness → Wiki Knowledge: synthesizes pages
- AI Harness → Durable Memory: maintains memory
- AI Harness → Memory Log: records changes
- User → Dashboard Shell: views dashboard
- Dashboard Shell → Dashboard Pages: links pages
- Page Generator → Dashboard Page Template: renders template
- Page Generator → Dashboard Pages: writes page
- Page Generator → Dashboard Shell: updates sidebar
- AI Harness → Workflow Template: uses to scaffold
- AI Harness → Wiki Template: uses to scaffold