# loosemybrain/accessibility_knowledge_base architecture

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

- Interactive diagram: https://gitdiagram.com/loosemybrain/accessibility_knowledge_base
- Repository: https://github.com/loosemybrain/accessibility_knowledge_base

## Overview

The repository is an accessibility knowledge base and its supporting authoring workflow. Its principal product workflow develops handbook guidance, checks claims against external or internal evidence and reproducible practice tests, and maintains governance and project status. The README documents evidence profiles and technical validation; the CLI routes authoring and lifecycle commands to their implementations. Some content relationships are documented only at a policy level, so the graph does not infer links between individual chapters, tests, and sources. Tool internals not excerpted are represented by their exact paths without asserting unshown calls.

Main entry points: [`tools/commands/run-script.js`](https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/commands/run-script.js) (Script runner), [`tools/akb.js`](https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/akb.js) (AKB command router), [`01_Handbuecher`](https://github.com/loosemybrain/accessibility_knowledge_base/tree/main/01_Handbuecher) (Handbooks), [`tools/commands/topic.js`](https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/commands/topic.js) (Topic commands)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_knowledge["Knowledge content"]
  node_handbooks["Handbooks"]
  node_sap["SAP GUI guide"]
  node_erec["E-REC guide"]
  node_confluence["Confluence outputs"]
  node_assets["Documentation assets"]
end

subgraph group_evidence["Evidence and review"]
  node_sources["Source archive"]
  node_citations["Chapter sources"]
  node_practice["Practice tests"]
end

subgraph group_governance["Governance and planning"]
  node_evidence_policy["Evidence policy"]
  node_governance_docs["Editorial governance"]
  node_project_mgmt["Project management"]
end

subgraph group_tooling["Authoring tools"]
  node_cli["AKB command router<br/>[akb.js]"]
  node_topic_cmd["Topic commands<br/>[topic.js]"]
  node_topic_lifecycle["Topic lifecycle<br/>[topic-lifecycle.js]"]
  node_create_topic["Topic creation<br/>[create-topic.js]"]
  node_validate_cmd["Validation command<br/>[validate.js]"]
  node_validator["Markdown validator"]
  node_insert_cmd["Insert command<br/>[insert.js]"]
  node_insert_section["Section insertion<br/>[insert-section.js]"]
  node_phase_cmd["Phase command<br/>[phase.js]"]
  node_phase_report["Phase reporting"]
  node_summary_cmd["Sprint summary command<br/>[sprint-summary.js]"]
  node_summary["Sprint summary"]
  node_status_cmd["Status command<br/>[status.js]"]
  node_status_update["Project status update"]
  node_doctor["Project doctor<br/>[doctor.js]"]
  node_filesystem["Filesystem checks<br/>[filesystem.js]"]
  node_project_config["Project structure config<br/>[project.js]"]
  node_logger["Logging<br/>[logger.js]"]
  node_run_script["Script runner<br/>[run-script.js]"]
  node_sprint_finish["Sprint finish<br/>[sprint-finish.js]"]
end

node_author(("Knowledge authors"))

node_author -->|"authors guidance"| node_handbooks
node_sources -->|"supports claims"| node_handbooks
node_practice -->|"tests claims"| node_handbooks
node_evidence_policy -->|"sets evidence rules"| node_handbooks
node_handbooks -.->|"publishes knowledge"| node_confluence
node_handbooks -.->|"uses materials"| node_assets
node_cli -->|"dispatches"| node_topic_cmd
node_cli -->|"dispatches"| node_validate_cmd
node_cli -->|"dispatches"| node_insert_cmd
node_cli -->|"dispatches"| node_phase_cmd
node_cli -->|"dispatches"| node_summary_cmd
node_cli -->|"dispatches"| node_status_cmd
node_cli -->|"dispatches"| node_doctor
node_topic_cmd -->|"delegates"| node_topic_lifecycle
node_topic_cmd -->|"uses runner"| node_run_script
node_topic_cmd -->|"runs script"| node_create_topic
node_validate_cmd -->|"uses runner"| node_run_script
node_run_script -->|"runs script"| node_validator
node_insert_cmd -->|"uses runner"| node_run_script
node_run_script -->|"runs script"| node_insert_section
node_phase_cmd -->|"uses runner"| node_run_script
node_run_script -->|"runs script"| node_phase_report
node_summary_cmd -->|"uses runner"| node_run_script
node_run_script -->|"runs script"| node_summary
node_status_cmd -->|"uses runner"| node_run_script
node_run_script -->|"runs script"| node_status_update
node_doctor -->|"checks paths"| node_filesystem
node_doctor -->|"reads requirements"| node_project_config
node_doctor -->|"reports results"| node_logger

click node_handbooks "https://github.com/loosemybrain/accessibility_knowledge_base/tree/main/01_Handbuecher"
click node_sap "https://github.com/loosemybrain/accessibility_knowledge_base/tree/main/01_Handbuecher/SAP_GUI"
click node_erec "https://github.com/loosemybrain/accessibility_knowledge_base/tree/main/01_Handbuecher/E_REC"
click node_confluence "https://github.com/loosemybrain/accessibility_knowledge_base/tree/main/02_Confluence"
click node_assets "https://github.com/loosemybrain/accessibility_knowledge_base/tree/main/03_Assets"
click node_sources "https://github.com/loosemybrain/accessibility_knowledge_base/tree/main/04_Quellenarchiv"
click node_citations "https://github.com/loosemybrain/accessibility_knowledge_base/tree/main/01_Handbuecher/SAP_GUI/quellen"
click node_practice "https://github.com/loosemybrain/accessibility_knowledge_base/tree/main/01_Handbuecher/SAP_GUI/praxistests"
click node_evidence_policy "https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/00_Governance/AKB-003-Quellenrichtlinie.md"
click node_governance_docs "https://github.com/loosemybrain/accessibility_knowledge_base/tree/main/00_Governance"
click node_project_mgmt "https://github.com/loosemybrain/accessibility_knowledge_base/tree/main/90_Projektverwaltung"
click node_cli "https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/akb.js"
click node_topic_cmd "https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/commands/topic.js"
click node_topic_lifecycle "https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/lib/topic-lifecycle.js"
click node_create_topic "https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/create-topic.js"
click node_validate_cmd "https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/commands/validate.js"
click node_validator "https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/validate-markdown.js"
click node_insert_cmd "https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/commands/insert.js"
click node_insert_section "https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/insert-section.js"
click node_phase_cmd "https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/commands/phase.js"
click node_phase_report "https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/create-phase-report.js"
click node_summary_cmd "https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/commands/sprint-summary.js"
click node_summary "https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/create-sprint-summary.js"
click node_status_cmd "https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/commands/status.js"
click node_status_update "https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/update-project-status.js"
click node_doctor "https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/commands/doctor.js"
click node_filesystem "https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/lib/filesystem.js"
click node_project_config "https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/lib/project.js"
click node_logger "https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/lib/logger.js"
click node_run_script "https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/commands/run-script.js"
click node_sprint_finish "https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/sprint-finish.js"

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_handbooks,node_sap,node_erec,node_confluence,node_assets toneBlue
class node_sources,node_citations,node_practice toneAmber
class node_evidence_policy,node_governance_docs,node_project_mgmt toneMint
class node_cli,node_topic_cmd,node_topic_lifecycle,node_create_topic,node_validate_cmd,node_validator,node_insert_cmd,node_insert_section,node_phase_cmd,node_phase_report,node_summary_cmd,node_summary,node_status_cmd,node_status_update,node_doctor,node_filesystem,node_project_config,node_logger,node_run_script,node_sprint_finish toneRose
class node_author toneIndigo
```

## Components

### Knowledge content

- [Handbooks](https://github.com/loosemybrain/accessibility_knowledge_base/tree/main/01_Handbuecher): `01_Handbuecher`
- [SAP GUI guide](https://github.com/loosemybrain/accessibility_knowledge_base/tree/main/01_Handbuecher/SAP_GUI): `01_Handbuecher/SAP_GUI`
- [E-REC guide](https://github.com/loosemybrain/accessibility_knowledge_base/tree/main/01_Handbuecher/E_REC): `01_Handbuecher/E_REC`
- [Confluence outputs](https://github.com/loosemybrain/accessibility_knowledge_base/tree/main/02_Confluence): `02_Confluence`
- [Documentation assets](https://github.com/loosemybrain/accessibility_knowledge_base/tree/main/03_Assets): `03_Assets`

### Evidence and review

- [Source archive](https://github.com/loosemybrain/accessibility_knowledge_base/tree/main/04_Quellenarchiv): `04_Quellenarchiv`
- [Chapter sources](https://github.com/loosemybrain/accessibility_knowledge_base/tree/main/01_Handbuecher/SAP_GUI/quellen): `01_Handbuecher/SAP_GUI/quellen`
- [Practice tests](https://github.com/loosemybrain/accessibility_knowledge_base/tree/main/01_Handbuecher/SAP_GUI/praxistests): `01_Handbuecher/SAP_GUI/praxistests`

### Governance and planning

- [Evidence policy](https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/00_Governance/AKB-003-Quellenrichtlinie.md): `00_Governance/AKB-003-Quellenrichtlinie.md`
- [Editorial governance](https://github.com/loosemybrain/accessibility_knowledge_base/tree/main/00_Governance): `00_Governance`
- [Project management](https://github.com/loosemybrain/accessibility_knowledge_base/tree/main/90_Projektverwaltung): `90_Projektverwaltung`

### Authoring tools

- [AKB command router](https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/akb.js): `tools/akb.js`
- [Topic commands](https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/commands/topic.js): `tools/commands/topic.js`
- [Topic lifecycle](https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/lib/topic-lifecycle.js): `tools/lib/topic-lifecycle.js`
- [Topic creation](https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/create-topic.js): `tools/create-topic.js`
- [Validation command](https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/commands/validate.js): `tools/commands/validate.js`
- [Markdown validator](https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/validate-markdown.js): `tools/validate-markdown.js`
- [Insert command](https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/commands/insert.js): `tools/commands/insert.js`
- [Section insertion](https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/insert-section.js): `tools/insert-section.js`
- [Phase command](https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/commands/phase.js): `tools/commands/phase.js`
- [Phase reporting](https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/create-phase-report.js): `tools/create-phase-report.js`
- [Sprint summary command](https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/commands/sprint-summary.js): `tools/commands/sprint-summary.js`
- [Sprint summary](https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/create-sprint-summary.js): `tools/create-sprint-summary.js`
- [Status command](https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/commands/status.js): `tools/commands/status.js`
- [Project status update](https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/update-project-status.js): `tools/update-project-status.js`
- [Project doctor](https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/commands/doctor.js): `tools/commands/doctor.js`
- [Filesystem checks](https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/lib/filesystem.js): `tools/lib/filesystem.js`
- [Project structure config](https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/lib/project.js): `tools/lib/project.js`
- [Logging](https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/lib/logger.js): `tools/lib/logger.js`
- [Script runner](https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/commands/run-script.js): `tools/commands/run-script.js`
- [Sprint finish](https://github.com/loosemybrain/accessibility_knowledge_base/blob/main/tools/sprint-finish.js): `tools/sprint-finish.js`

### Other components

- **Knowledge authors**

## Connections

- Knowledge authors → Handbooks: authors guidance (evidence: `README.md`)
- Source archive → Handbooks: supports claims (evidence: `README.md`)
- Practice tests → Handbooks: tests claims (evidence: `README.md`)
- Evidence policy → Handbooks: sets evidence rules (evidence: `README.md`)
- Handbooks → Confluence outputs: publishes knowledge
- Handbooks → Documentation assets: uses materials
- AKB command router → Topic commands: dispatches (evidence: `tools/akb.js`)
- AKB command router → Validation command: dispatches (evidence: `tools/akb.js`)
- AKB command router → Insert command: dispatches (evidence: `tools/akb.js`)
- AKB command router → Phase command: dispatches (evidence: `tools/akb.js`)
- AKB command router → Sprint summary command: dispatches (evidence: `tools/akb.js`)
- AKB command router → Status command: dispatches (evidence: `tools/akb.js`)
- AKB command router → Project doctor: dispatches (evidence: `tools/akb.js`)
- Topic commands → Topic lifecycle: delegates (evidence: `tools/commands/topic.js`)
- Topic commands → Script runner: uses runner (evidence: `tools/commands/topic.js`)
- Topic commands → Topic creation: runs script
- Validation command → Script runner: uses runner (evidence: `tools/commands/validate.js`)
- Script runner → Markdown validator: runs script
- Insert command → Script runner: uses runner (evidence: `tools/commands/insert.js`)
- Script runner → Section insertion: runs script
- Phase command → Script runner: uses runner (evidence: `tools/commands/phase.js`)
- Script runner → Phase reporting: runs script
- Sprint summary command → Script runner: uses runner (evidence: `tools/commands/sprint-summary.js`)
- Script runner → Sprint summary: runs script
- Status command → Script runner: uses runner (evidence: `tools/commands/status.js`)
- Script runner → Project status update: runs script
- Project doctor → Filesystem checks: checks paths (evidence: `tools/commands/doctor.js`)
- Project doctor → Project structure config: reads requirements (evidence: `tools/commands/doctor.js`)
- Project doctor → Logging: reports results (evidence: `tools/commands/doctor.js`)
