# frezanz/frezanz-r1 architecture

> Architecture diagram of the GitHub repository frezanz/frezanz-r1, 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/frezanz/frezanz-r1
- Repository: https://github.com/frezanz/frezanz-r1

## Overview

Frezanz is a research workspace for developing and connecting ideas, not a conventional application with a sampled runtime. Its documented core workflow moves from questions through investigation and evidence to learning and new questions. The graph preserves those stages and the workspace’s supporting source, artifact, architecture, and status areas. Relationships follow the README’s stated loop; source excerpts were unavailable, so implementation-level wiring is not inferred.

Main entry points: [`QUESTIONS/README.md`](https://github.com/frezanz/frezanz-r1/blob/main/QUESTIONS/README.md) (Questions), [`PROBLEMS/README.md`](https://github.com/frezanz/frezanz-r1/blob/main/PROBLEMS/README.md) (Problems), [`HYPOTHESES/README.md`](https://github.com/frezanz/frezanz-r1/blob/main/HYPOTHESES/README.md) (Hypotheses), [`CONCEPTS/README.md`](https://github.com/frezanz/frezanz-r1/blob/main/CONCEPTS/README.md) (Concepts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inquiry["Inquiry"]
  node_questions["Questions<br/>[README.md]"]
  node_problems["Problems<br/>[README.md]"]
end

subgraph group_framing["Idea framing"]
  node_hypotheses["Hypotheses<br/>[README.md]"]
  node_concepts["Concepts<br/>[README.md]"]
  node_thinking["Thinking processes<br/>[README.md]"]
  node_models["Models<br/>[README.md]"]
  node_architectures["Architectures<br/>[README.md]"]
end

subgraph group_investigation["Investigation"]
  node_experiments["Experiments<br/>[README.md]"]
end

subgraph group_synthesis["Evidence and synthesis"]
  node_evidence["Evidence"]
  node_comparisons["Comparisons<br/>[README.md]"]
  node_learning["Learning<br/>[README.md]"]
  node_sources["Sources<br/>[README.md]"]
  node_artifacts["Artifacts<br/>[README.md]"]
end

node_researcher(("Researcher"))
node_status["Current state<br/>[CURRENT.md]"]

node_researcher -->|"explores"| node_questions
node_questions -->|"frames"| node_problems
node_problems -->|"inspires"| node_hypotheses
node_hypotheses -->|"informs"| node_concepts
node_concepts -->|"guides"| node_thinking
node_thinking -->|"develops"| node_models
node_models -->|"develops"| node_architectures
node_architectures -->|"informs"| node_experiments
node_experiments -->|"produces"| node_evidence
node_evidence -->|"informs"| node_comparisons
node_comparisons -->|"supports"| node_learning
node_learning -->|"generates"| node_questions

click node_questions "https://github.com/frezanz/frezanz-r1/blob/main/QUESTIONS/README.md"
click node_problems "https://github.com/frezanz/frezanz-r1/blob/main/PROBLEMS/README.md"
click node_hypotheses "https://github.com/frezanz/frezanz-r1/blob/main/HYPOTHESES/README.md"
click node_concepts "https://github.com/frezanz/frezanz-r1/blob/main/CONCEPTS/README.md"
click node_thinking "https://github.com/frezanz/frezanz-r1/blob/main/THINKING_PROCESSES/README.md"
click node_models "https://github.com/frezanz/frezanz-r1/blob/main/MODELS/README.md"
click node_architectures "https://github.com/frezanz/frezanz-r1/blob/main/ARCHITECTURES/README.md"
click node_experiments "https://github.com/frezanz/frezanz-r1/blob/main/EXPERIMENTS/README.md"
click node_comparisons "https://github.com/frezanz/frezanz-r1/blob/main/COMPARISONS/README.md"
click node_learning "https://github.com/frezanz/frezanz-r1/blob/main/LEARNING/README.md"
click node_sources "https://github.com/frezanz/frezanz-r1/blob/main/SOURCES/README.md"
click node_artifacts "https://github.com/frezanz/frezanz-r1/blob/main/ARTIFACTS/README.md"
click node_status "https://github.com/frezanz/frezanz-r1/blob/main/STATUS/CURRENT.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_questions,node_problems toneBlue
class node_hypotheses,node_concepts,node_thinking,node_models,node_architectures toneAmber
class node_experiments toneMint
class node_evidence,node_comparisons,node_learning,node_sources,node_artifacts toneRose
class node_researcher toneIndigo
class node_status toneTeal
```

## Components

### Inquiry

- [Questions](https://github.com/frezanz/frezanz-r1/blob/main/QUESTIONS/README.md): `QUESTIONS/README.md`
- [Problems](https://github.com/frezanz/frezanz-r1/blob/main/PROBLEMS/README.md): `PROBLEMS/README.md`

### Idea framing

- [Hypotheses](https://github.com/frezanz/frezanz-r1/blob/main/HYPOTHESES/README.md): `HYPOTHESES/README.md`
- [Concepts](https://github.com/frezanz/frezanz-r1/blob/main/CONCEPTS/README.md): `CONCEPTS/README.md`
- [Thinking processes](https://github.com/frezanz/frezanz-r1/blob/main/THINKING_PROCESSES/README.md): `THINKING_PROCESSES/README.md`
- [Models](https://github.com/frezanz/frezanz-r1/blob/main/MODELS/README.md): `MODELS/README.md`
- [Architectures](https://github.com/frezanz/frezanz-r1/blob/main/ARCHITECTURES/README.md): `ARCHITECTURES/README.md`

### Investigation

- [Experiments](https://github.com/frezanz/frezanz-r1/blob/main/EXPERIMENTS/README.md): `EXPERIMENTS/README.md`

### Evidence and synthesis

- **Evidence**
- [Comparisons](https://github.com/frezanz/frezanz-r1/blob/main/COMPARISONS/README.md): `COMPARISONS/README.md`
- [Learning](https://github.com/frezanz/frezanz-r1/blob/main/LEARNING/README.md): `LEARNING/README.md`
- [Sources](https://github.com/frezanz/frezanz-r1/blob/main/SOURCES/README.md): `SOURCES/README.md`
- [Artifacts](https://github.com/frezanz/frezanz-r1/blob/main/ARTIFACTS/README.md): `ARTIFACTS/README.md`

### Other components

- **Researcher**
- [Current state](https://github.com/frezanz/frezanz-r1/blob/main/STATUS/CURRENT.md): `STATUS/CURRENT.md`

## Connections

- Researcher → Questions: explores
- Questions → Problems: frames
- Problems → Hypotheses: inspires
- Hypotheses → Concepts: informs
- Concepts → Thinking processes: guides
- Thinking processes → Models: develops
- Models → Architectures: develops
- Architectures → Experiments: informs
- Experiments → Evidence: produces
- Evidence → Comparisons: informs
- Comparisons → Learning: supports
- Learning → Questions: generates