# saizy767/dynamic-prompt-core architecture

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

- Interactive diagram: https://gitdiagram.com/saizy767/dynamic-prompt-core
- Repository: https://github.com/saizy767/dynamic-prompt-core

## Overview

prompt-loop is a research pipeline for iteratively improving a binary classifier’s system prompt through error analysis and candidate scoring. Its main workflow runs a baseline, measures results, analyzes and selects thesis clusters, composes a prompt version, evaluates it against the active version, and accepts or rolls back. The graph preserves the documented optional teacher-refinement and scoring backends. Some subsystem links rely on README or SOURCE INDEX references; unsampled implementation details are not inferred.

Main entry points: [`src/dynamic_prompt_core/application/use_cases/run_cycle/run_cycle.py`](https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/application/use_cases/run_cycle/run_cycle.py) (Cycle orchestrator), [`src/dynamic_prompt_core/application/use_cases/run_baseline/runner.py`](https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/application/use_cases/run_baseline/runner.py) (Baseline runner), [`src/dynamic_prompt_core/application/use_cases/compare_versions/comparator.py`](https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/application/use_cases/compare_versions/comparator.py) (Version comparator), [`src/dynamic_prompt_core/infrastructure/llm/scoring`](https://github.com/saizy767/dynamic-prompt-core/tree/main/src/dynamic_prompt_core/infrastructure/llm/scoring) (Scoring adapters)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Cycle workflow"]
  node_cycle["Cycle orchestrator<br/>[run_cycle.py]"]
  node_baseline["Baseline runner<br/>[runner.py]"]
  node_selector["Candidate selector<br/>[selector.py]"]
  node_composer["Prompt composer<br/>[composer.py]"]
  node_comparator["Version comparator<br/>[comparator.py]"]
end

subgraph group_analysis["Analysis and refinement"]
  node_metrics["Classification metrics<br/>[metrics.py]"]
  node_analyzer["Thesis analyzer<br/>[thesis_analyzer.py]"]
  node_refiner["Teacher refinement"]
end

subgraph group_inference["Inference and scoring"]
  node_candidate["Candidate model<br/>[candidate.py]"]
  node_scorer_port["Scorer port"]
  node_policy["Classification policy"]
  node_scorer_factory["Scorer factory<br/>[factory.py]"]
  node_scoring_adapters["Scoring adapters"]
  node_llm_client["Thesis extraction client<br/>[client.py]"]
end

subgraph group_state["Prompt and run state"]
  node_prompt_store[("Prompt version store<br/>[prompt_store.py]")]
  node_run_repository[("Run repository<br/>[run_repository.py]")]
end

subgraph group_interface["User interface"]
  node_cli["CLI composition root<br/>[main.py]"]
end

node_researcher(("Researcher"))
node_llm_server["Inference server"]

node_researcher -->|"runs commands"| node_cli
node_cli -->|"invokes cycle"| node_cycle
node_cycle -->|"runs versions"| node_baseline
node_cycle -->|"computes metrics"| node_metrics
node_cycle -->|"analyzes results"| node_analyzer
node_cycle -->|"selects candidates"| node_selector
node_cycle -->|"composes version"| node_composer
node_cycle -->|"compares versions"| node_comparator
node_cycle -.->|"may refine theses"| node_refiner
node_baseline -->|"scores candidates"| node_scorer_port
node_baseline -->|"classifies judgments"| node_policy
node_baseline -->|"extracts theses"| node_llm_client
node_scorer_factory -->|"builds backend"| node_scoring_adapters
node_scoring_adapters -->|"implements scoring"| node_scorer_port
node_baseline -->|"uses candidates"| node_candidate
node_comparator -->|"runs candidate version"| node_baseline
node_cycle -->|"activates accepted version"| node_prompt_store
node_cycle -.->|"persists run artifacts"| node_run_repository
node_llm_client -.->|"calls API"| node_llm_server

click node_cli "https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/interfaces/cli/main.py"
click node_cycle "https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/application/use_cases/run_cycle/run_cycle.py"
click node_baseline "https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/application/use_cases/run_baseline/runner.py"
click node_metrics "https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/application/services/metrics/metrics.py"
click node_analyzer "https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/application/use_cases/analyze_theses/thesis_analyzer.py"
click node_selector "https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/application/use_cases/select_candidates/selector.py"
click node_composer "https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/application/use_cases/compose_prompt/composer.py"
click node_comparator "https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/application/use_cases/compare_versions/comparator.py"
click node_refiner "https://github.com/saizy767/dynamic-prompt-core/tree/main/src/dynamic_prompt_core/application/use_cases/refine_theses"
click node_candidate "https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/domain/models/candidate.py"
click node_scorer_port "https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/application/ports/outbound/candidate_scorer.py"
click node_policy "https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/application/services/classification_policy.py"
click node_scorer_factory "https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/infrastructure/llm/scoring/factory.py"
click node_scoring_adapters "https://github.com/saizy767/dynamic-prompt-core/tree/main/src/dynamic_prompt_core/infrastructure/llm/scoring"
click node_llm_client "https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/infrastructure/llm/client.py"
click node_prompt_store "https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/infrastructure/storage/prompt_store.py"
click node_run_repository "https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/infrastructure/storage/run_repository.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_cycle,node_baseline,node_selector,node_composer,node_comparator toneBlue
class node_metrics,node_analyzer,node_refiner toneAmber
class node_candidate,node_scorer_port,node_policy,node_scorer_factory,node_scoring_adapters,node_llm_client,node_llm_server toneMint
class node_prompt_store,node_run_repository toneRose
class node_cli,node_researcher toneIndigo
```

## Components

### Cycle workflow

- [Cycle orchestrator](https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/application/use_cases/run_cycle/run_cycle.py): `src/dynamic_prompt_core/application/use_cases/run_cycle/run_cycle.py`
- [Baseline runner](https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/application/use_cases/run_baseline/runner.py): `src/dynamic_prompt_core/application/use_cases/run_baseline/runner.py`
- [Candidate selector](https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/application/use_cases/select_candidates/selector.py): `src/dynamic_prompt_core/application/use_cases/select_candidates/selector.py`
- [Prompt composer](https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/application/use_cases/compose_prompt/composer.py): `src/dynamic_prompt_core/application/use_cases/compose_prompt/composer.py`
- [Version comparator](https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/application/use_cases/compare_versions/comparator.py): `src/dynamic_prompt_core/application/use_cases/compare_versions/comparator.py`

### Analysis and refinement

- [Classification metrics](https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/application/services/metrics/metrics.py): `src/dynamic_prompt_core/application/services/metrics/metrics.py`
- [Thesis analyzer](https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/application/use_cases/analyze_theses/thesis_analyzer.py): `src/dynamic_prompt_core/application/use_cases/analyze_theses/thesis_analyzer.py`
- [Teacher refinement](https://github.com/saizy767/dynamic-prompt-core/tree/main/src/dynamic_prompt_core/application/use_cases/refine_theses): `src/dynamic_prompt_core/application/use_cases/refine_theses`

### Inference and scoring

- [Candidate model](https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/domain/models/candidate.py): `src/dynamic_prompt_core/domain/models/candidate.py`
- [Scorer port](https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/application/ports/outbound/candidate_scorer.py): `src/dynamic_prompt_core/application/ports/outbound/candidate_scorer.py`
- [Classification policy](https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/application/services/classification_policy.py): `src/dynamic_prompt_core/application/services/classification_policy.py`
- [Scorer factory](https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/infrastructure/llm/scoring/factory.py): `src/dynamic_prompt_core/infrastructure/llm/scoring/factory.py`
- [Scoring adapters](https://github.com/saizy767/dynamic-prompt-core/tree/main/src/dynamic_prompt_core/infrastructure/llm/scoring): `src/dynamic_prompt_core/infrastructure/llm/scoring`
- [Thesis extraction client](https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/infrastructure/llm/client.py): `src/dynamic_prompt_core/infrastructure/llm/client.py`

### Prompt and run state

- [Prompt version store](https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/infrastructure/storage/prompt_store.py): `src/dynamic_prompt_core/infrastructure/storage/prompt_store.py`
- [Run repository](https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/infrastructure/storage/run_repository.py): `src/dynamic_prompt_core/infrastructure/storage/run_repository.py`

### User interface

- [CLI composition root](https://github.com/saizy767/dynamic-prompt-core/blob/main/src/dynamic_prompt_core/interfaces/cli/main.py): `src/dynamic_prompt_core/interfaces/cli/main.py`

### Other components

- **Researcher**
- **Inference server**

## Connections

- Researcher → CLI composition root: runs commands (evidence: `README.md`)
- CLI composition root → Cycle orchestrator: invokes cycle (evidence: `src/dynamic_prompt_core/interfaces/cli/main.py`)
- Cycle orchestrator → Baseline runner: runs versions
- Cycle orchestrator → Classification metrics: computes metrics
- Cycle orchestrator → Thesis analyzer: analyzes results
- Cycle orchestrator → Candidate selector: selects candidates
- Cycle orchestrator → Prompt composer: composes version
- Cycle orchestrator → Version comparator: compares versions
- Cycle orchestrator → Teacher refinement: may refine theses
- Baseline runner → Scorer port: scores candidates (evidence: `src/dynamic_prompt_core/application/use_cases/run_baseline/runner.py`)
- Baseline runner → Classification policy: classifies judgments (evidence: `README.md`)
- Baseline runner → Thesis extraction client: extracts theses (evidence: `README.md`)
- Scorer factory → Scoring adapters: builds backend (evidence: `src/dynamic_prompt_core/infrastructure/llm/scoring/factory.py`)
- Scoring adapters → Scorer port: implements scoring (evidence: `src/dynamic_prompt_core/infrastructure/llm/scoring/factory.py`)
- Baseline runner → Candidate model: uses candidates (evidence: `src/dynamic_prompt_core/application/use_cases/run_baseline/runner.py`)
- Version comparator → Baseline runner: runs candidate version (evidence: `src/dynamic_prompt_core/application/use_cases/compare_versions/comparator.py`)
- Cycle orchestrator → Prompt version store: activates accepted version (evidence: `README.md`)
- Cycle orchestrator → Run repository: persists run artifacts
- Thesis extraction client → Inference server: calls API
