# concentriccirclesmrtt/neube-structural-rebuild architecture

> Architecture diagram of the GitHub repository concentriccirclesmrtt/neube-structural-rebuild, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/concentriccirclesmrtt/neube-structural-rebuild
- Repository: https://github.com/concentriccirclesmrtt/neube-structural-rebuild

## Overview

NeuBE is a forkable AI-agent skill and domain-pack template, not an automatic reconstruction engine. Its documented workflow turns registered evidence into observations, hypotheses, a domain semantic model and constraints, then human review and versioned outputs. The graph combines that documented workflow with sampled initialization, validation, and publishing behavior; unsampled workflow stages are represented at their documented directory or file paths.

Main entry points: [`scripts/init_project.py`](https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/scripts/init_project.py) (Project initializer), [`projects/_template/workspace/ir.json`](https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/projects/_template/workspace/ir.json) (Semantic model), [`scripts/publish_result.py`](https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/scripts/publish_result.py) (Result publisher), [`domains/_template/references`](https://github.com/concentriccirclesmrtt/neube-structural-rebuild/tree/main/domains/_template/references) (Ontology and rules)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Reconstruction workflow"]
  node_skill["Agent workflow<br/>[SKILL.md]"]
  node_evidence["Evidence sources<br/>[index.json]"]
  node_observations["Observations<br/>[ir.json]"]
  node_hypotheses["Hypotheses<br/>[ir.json]"]
  node_semantic["Semantic model<br/>[ir.json]"]
  node_constraints["Constraints<br/>[ir.json]"]
  node_review["Expert review<br/>[decisions.json]"]
end

subgraph group_domains["Domain packs"]
  node_domain_pack["Domain pack<br/>[domain.json]"]
  node_domain_skill["Domain skill<br/>[SKILL.md]"]
  node_domain_rules["Ontology and rules"]
  node_domain_validator["Domain validator<br/>[validate_domain.py]"]
  node_domain_setup["Domain initializer<br/>[init_domain.py]"]
end

subgraph group_projects["Project lifecycle"]
  node_outputs["Project outputs"]
  node_project_setup["Project initializer<br/>[init_project.py]"]
  node_release["Release manifest"]
end

subgraph group_quality["Validation and release"]
  node_workspace_validator["Workspace validator"]
  node_ir_validator["Public IR validator"]
  node_publisher["Result publisher<br/>[publish_result.py]"]
end

node_agent(("AI agent"))

node_agent -->|"follows"| node_skill
node_skill -->|"registers"| node_evidence
node_evidence -->|"informs"| node_observations
node_observations -->|"supports"| node_hypotheses
node_hypotheses -->|"informs"| node_semantic
node_domain_pack -->|"defines"| node_domain_skill
node_domain_pack -->|"provides"| node_domain_rules
node_domain_rules -->|"guides"| node_semantic
node_domain_rules -->|"defines"| node_constraints
node_semantic -->|"checked by"| node_constraints
node_constraints -->|"gates"| node_review
node_review -->|"approves"| node_outputs
node_agent -->|"creates pack"| node_domain_setup
node_agent -->|"creates project"| node_project_setup
node_project_setup -->|"requires"| node_domain_pack
node_project_setup -->|"copies template"| node_evidence
node_project_setup -->|"initializes IR"| node_semantic
node_workspace_validator -->|"validates IR"| node_ir_validator
node_publisher -->|"validates IR"| node_ir_validator
node_publisher -->|"copies artifacts"| node_outputs
node_publisher -->|"writes manifest"| node_release

click node_skill "https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/SKILL.md"
click node_evidence "https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/projects/_template/sources/index.json"
click node_observations "https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/projects/_template/workspace/ir.json"
click node_hypotheses "https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/projects/_template/workspace/ir.json"
click node_semantic "https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/projects/_template/workspace/ir.json"
click node_constraints "https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/projects/_template/workspace/ir.json"
click node_review "https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/projects/_template/reviews/decisions.json"
click node_outputs "https://github.com/concentriccirclesmrtt/neube-structural-rebuild/tree/main/projects/_template/outputs"
click node_domain_pack "https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/domains/_template/domain.json"
click node_domain_skill "https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/domains/_template/SKILL.md"
click node_domain_rules "https://github.com/concentriccirclesmrtt/neube-structural-rebuild/tree/main/domains/_template/references"
click node_domain_validator "https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/domains/_template/scripts/validate_domain.py"
click node_project_setup "https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/scripts/init_project.py"
click node_domain_setup "https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/scripts/init_domain.py"
click node_workspace_validator "https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/scripts/validate_workspace.py"
click node_ir_validator "https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/scripts/validate_public_ir.py"
click node_publisher "https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/scripts/publish_result.py"
click node_release "https://github.com/concentriccirclesmrtt/neube-structural-rebuild/tree/main/releases"

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_skill,node_evidence,node_observations,node_hypotheses,node_semantic,node_constraints,node_review toneBlue
class node_domain_pack,node_domain_skill,node_domain_rules,node_domain_validator,node_domain_setup toneAmber
class node_outputs,node_project_setup,node_release toneMint
class node_workspace_validator,node_ir_validator,node_publisher toneRose
class node_agent toneIndigo
```

## Components

### Reconstruction workflow

- [Agent workflow](https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/SKILL.md): `SKILL.md`
- [Evidence sources](https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/projects/_template/sources/index.json): `projects/_template/sources/index.json`
- [Observations](https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/projects/_template/workspace/ir.json): `projects/_template/workspace/ir.json`
- [Hypotheses](https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/projects/_template/workspace/ir.json): `projects/_template/workspace/ir.json`
- [Semantic model](https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/projects/_template/workspace/ir.json): `projects/_template/workspace/ir.json`
- [Constraints](https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/projects/_template/workspace/ir.json): `projects/_template/workspace/ir.json`
- [Expert review](https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/projects/_template/reviews/decisions.json): `projects/_template/reviews/decisions.json`

### Domain packs

- [Domain pack](https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/domains/_template/domain.json): `domains/_template/domain.json`
- [Domain skill](https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/domains/_template/SKILL.md): `domains/_template/SKILL.md`
- [Ontology and rules](https://github.com/concentriccirclesmrtt/neube-structural-rebuild/tree/main/domains/_template/references): `domains/_template/references`
- [Domain validator](https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/domains/_template/scripts/validate_domain.py): `domains/_template/scripts/validate_domain.py`
- [Domain initializer](https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/scripts/init_domain.py): `scripts/init_domain.py`

### Project lifecycle

- [Project outputs](https://github.com/concentriccirclesmrtt/neube-structural-rebuild/tree/main/projects/_template/outputs): `projects/_template/outputs`
- [Project initializer](https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/scripts/init_project.py): `scripts/init_project.py`
- [Release manifest](https://github.com/concentriccirclesmrtt/neube-structural-rebuild/tree/main/releases): `releases`

### Validation and release

- [Workspace validator](https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/scripts/validate_workspace.py): `scripts/validate_workspace.py`
- [Public IR validator](https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/scripts/validate_public_ir.py): `scripts/validate_public_ir.py`
- [Result publisher](https://github.com/concentriccirclesmrtt/neube-structural-rebuild/blob/main/scripts/publish_result.py): `scripts/publish_result.py`

### Other components

- **AI agent**

## Connections

- AI agent → Agent workflow: follows (evidence: `README.md`)
- Agent workflow → Evidence sources: registers (evidence: `README.md`)
- Evidence sources → Observations: informs (evidence: `README.md`)
- Observations → Hypotheses: supports (evidence: `README.md`)
- Hypotheses → Semantic model: informs (evidence: `README.md`)
- Domain pack → Domain skill: defines (evidence: `README.md`)
- Domain pack → Ontology and rules: provides (evidence: `README.md`)
- Ontology and rules → Semantic model: guides (evidence: `README.md`)
- Ontology and rules → Constraints: defines (evidence: `README.md`)
- Semantic model → Constraints: checked by (evidence: `README.md`)
- Constraints → Expert review: gates (evidence: `README.md`)
- Expert review → Project outputs: approves (evidence: `README.md`)
- AI agent → Domain initializer: creates pack (evidence: `README.md`)
- AI agent → Project initializer: creates project (evidence: `README.md`)
- Project initializer → Domain pack: requires (evidence: `scripts/init_project.py`)
- Project initializer → Evidence sources: copies template (evidence: `scripts/init_project.py`)
- Project initializer → Semantic model: initializes IR (evidence: `scripts/init_project.py`)
- Workspace validator → Public IR validator: validates IR (evidence: `scripts/validate_workspace.py`)
- Result publisher → Public IR validator: validates IR (evidence: `scripts/publish_result.py`)
- Result publisher → Project outputs: copies artifacts (evidence: `scripts/publish_result.py`)
- Result publisher → Release manifest: writes manifest (evidence: `scripts/publish_result.py`)
