# aryalmilan-max/dharma-os-nepal architecture

> Architecture diagram of the GitHub repository aryalmilan-max/dharma-os-nepal, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aryalmilan-max/dharma-os-nepal
- Repository: https://github.com/aryalmilan-max/dharma-os-nepal

## Overview

Dharma OS Nepal is an offline research and assessment toolkit: users explore Nepal-focused domains and sources, develop a study or organization assessment, record evidence and findings, then review and export the result. It also provides portable task skills and sector playbooks. The README documents these workflows; sampled code confirms browser-side evidence checks and assessment review. Some data wiring and unsampled subsystems are represented only at the directory level, so uncertain runtime links are omitted.

Main entry points: [`web/app.js`](https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/web/app.js) (Offline Workspace), [`web/library.js`](https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/web/library.js) (Skills and Sources Browser), [`web/core.js`](https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/web/core.js) (Study Evidence Checks), [`skills/dharma-os/scripts/research.py`](https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/skills/dharma-os/scripts/research.py) (Research CLI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_explore["Explore Knowledge"]
  node_workspace["Offline Workspace<br/>[app.js]"]
  node_domain_tree["Domain Tree<br/>[domains.json]"]
  node_evidence_data[("Evidence Snapshot")]
  node_methods["Methods and Coverage"]
end

subgraph group_research["Study Research"]
  node_study_draft["Study Workspace<br/>[app.js]"]
  node_study_checks["Study Evidence Checks<br/>[core.js]"]
  node_research_cli["Research CLI<br/>[research.py]"]
  node_study_sources[("Source Registry")]
end

subgraph group_assess["Organization Assessment"]
  node_organization_builder["Organization Builder<br/>[organizations.py]"]
  node_assessment_review["Assessment Review<br/>[assessment.js]"]
  node_assessment_checks["Assessment Checks<br/>[assessment-core.js]"]
  node_assessment_cli["Assessment CLI<br/>[assessments.py]"]
end

subgraph group_library["Skills and Playbooks"]
  node_task_skills["Task Skills"]
  node_library_browser["Skills and Sources Browser<br/>[library.js]"]
  node_library_core["Library Search<br/>[library-core.js]"]
  node_sector_packs["Sector Playbooks<br/>[sector-packs.json]"]
  node_pack_cli["Pack CLI<br/>[packs.py]"]
end

node_user(("Researcher or Practitioner"))

node_user -->|"uses offline"| node_workspace
node_workspace -->|"explores domains"| node_domain_tree
node_workspace -->|"inspects evidence"| node_evidence_data
node_workspace -->|"browses methods"| node_methods
node_user -->|"creates study"| node_study_draft
node_study_draft -->|"validates structure"| node_study_checks
node_study_checks -.->|"checks citations"| node_study_sources
node_user -->|"runs research commands"| node_research_cli
node_research_cli -.->|"searches sources"| node_study_sources
node_user -->|"builds assessment"| node_organization_builder
node_organization_builder -->|"opens findings review"| node_assessment_review
node_assessment_review -->|"validates findings"| node_assessment_checks
node_user -->|"reviews assessment"| node_assessment_cli
node_user -->|"searches skills"| node_library_browser
node_library_browser -->|"filters and paginates"| node_library_core
node_library_browser -->|"opens task guidance"| node_task_skills
node_user -->|"exports playbooks"| node_pack_cli
node_pack_cli -->|"loads pack definitions"| node_sector_packs

click node_workspace "https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/web/app.js"
click node_domain_tree "https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/skills/dharma-os/references/nepal-tech-intelligence/domains.json"
click node_evidence_data "https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/catalog/source-records.json"
click node_methods "https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/skills/dharma-os/references/nepal-tech-intelligence/principles-and-methods.json"
click node_study_draft "https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/web/app.js"
click node_study_checks "https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/web/core.js"
click node_research_cli "https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/skills/dharma-os/scripts/research.py"
click node_study_sources "https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/skills/dharma-os/references/nepal-tech-intelligence/source-registry.json"
click node_organization_builder "https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/skills/dharma-os/scripts/organizations.py"
click node_assessment_review "https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/web/assessment.js"
click node_assessment_checks "https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/web/assessment-core.js"
click node_assessment_cli "https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/skills/dharma-os/scripts/assessments.py"
click node_task_skills "https://github.com/aryalmilan-max/dharma-os-nepal/tree/main/skills"
click node_library_browser "https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/web/library.js"
click node_library_core "https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/web/library-core.js"
click node_sector_packs "https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/skills/dharma-os/references/nepal-tech-intelligence/sector-packs.json"
click node_pack_cli "https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/skills/dharma-os/scripts/packs.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_workspace,node_domain_tree,node_evidence_data,node_methods toneBlue
class node_study_draft,node_study_checks,node_research_cli,node_study_sources toneAmber
class node_organization_builder,node_assessment_review,node_assessment_checks,node_assessment_cli toneMint
class node_task_skills,node_library_browser,node_library_core,node_sector_packs,node_pack_cli toneRose
class node_user toneIndigo
```

## Components

### Explore Knowledge

- [Offline Workspace](https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/web/app.js): `web/app.js`
- [Domain Tree](https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/skills/dharma-os/references/nepal-tech-intelligence/domains.json): `skills/dharma-os/references/nepal-tech-intelligence/domains.json`
- [Evidence Snapshot](https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/catalog/source-records.json): `catalog/source-records.json`
- [Methods and Coverage](https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/skills/dharma-os/references/nepal-tech-intelligence/principles-and-methods.json): `skills/dharma-os/references/nepal-tech-intelligence/principles-and-methods.json`

### Study Research

- [Study Workspace](https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/web/app.js): `web/app.js`
- [Study Evidence Checks](https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/web/core.js): `web/core.js`
- [Research CLI](https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/skills/dharma-os/scripts/research.py): `skills/dharma-os/scripts/research.py`
- [Source Registry](https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/skills/dharma-os/references/nepal-tech-intelligence/source-registry.json): `skills/dharma-os/references/nepal-tech-intelligence/source-registry.json`

### Organization Assessment

- [Organization Builder](https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/skills/dharma-os/scripts/organizations.py): `skills/dharma-os/scripts/organizations.py`
- [Assessment Review](https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/web/assessment.js): `web/assessment.js`
- [Assessment Checks](https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/web/assessment-core.js): `web/assessment-core.js`
- [Assessment CLI](https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/skills/dharma-os/scripts/assessments.py): `skills/dharma-os/scripts/assessments.py`

### Skills and Playbooks

- [Task Skills](https://github.com/aryalmilan-max/dharma-os-nepal/tree/main/skills): `skills`
- [Skills and Sources Browser](https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/web/library.js): `web/library.js`
- [Library Search](https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/web/library-core.js): `web/library-core.js`
- [Sector Playbooks](https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/skills/dharma-os/references/nepal-tech-intelligence/sector-packs.json): `skills/dharma-os/references/nepal-tech-intelligence/sector-packs.json`
- [Pack CLI](https://github.com/aryalmilan-max/dharma-os-nepal/blob/main/skills/dharma-os/scripts/packs.py): `skills/dharma-os/scripts/packs.py`

### Other components

- **Researcher or Practitioner**

## Connections

- Researcher or Practitioner → Offline Workspace: uses offline (evidence: `README.md`)
- Offline Workspace → Domain Tree: explores domains (evidence: `README.md`)
- Offline Workspace → Evidence Snapshot: inspects evidence (evidence: `README.md`)
- Offline Workspace → Methods and Coverage: browses methods (evidence: `README.md`)
- Researcher or Practitioner → Study Workspace: creates study (evidence: `README.md`)
- Study Workspace → Study Evidence Checks: validates structure (evidence: `web/app.js`)
- Study Evidence Checks → Source Registry: checks citations
- Researcher or Practitioner → Research CLI: runs research commands (evidence: `README.md`)
- Research CLI → Source Registry: searches sources
- Researcher or Practitioner → Organization Builder: builds assessment (evidence: `README.md`)
- Organization Builder → Assessment Review: opens findings review (evidence: `README.md`)
- Assessment Review → Assessment Checks: validates findings (evidence: `web/assessment.js`)
- Researcher or Practitioner → Assessment CLI: reviews assessment (evidence: `README.md`)
- Researcher or Practitioner → Skills and Sources Browser: searches skills (evidence: `README.md`)
- Skills and Sources Browser → Library Search: filters and paginates (evidence: `web/library.js`)
- Skills and Sources Browser → Task Skills: opens task guidance (evidence: `README.md`)
- Researcher or Practitioner → Pack CLI: exports playbooks (evidence: `README.md`)
- Pack CLI → Sector Playbooks: loads pack definitions (evidence: `skills/dharma-os/scripts/packs.py`)