# austin-routt/walton-argumentation-schemes-for-carneades-4 architecture

> Architecture diagram of the GitHub repository austin-routt/walton-argumentation-schemes-for-carneades-4, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/austin-routt/walton-argumentation-schemes-for-carneades-4
- Repository: https://github.com/austin-routt/walton-argumentation-schemes-for-carneades-4

## Overview

This repository is primarily a YAML library of Walton argumentation schemes for Carneades 4, with a helper that assembles selected schemes into a standalone case graph. The user’s path is to choose schemes, generate a graph containing the needed language templates and schemes, add case-specific facts and questions, then evaluate it with Carneades. The README documents the master library, generated category files, and graph-generation flow; the master file is named there but absent from the supplied tree, so its path is not asserted. Other source details were not sampled.

Main entry points: [`categories.yml`](https://github.com/austin-routt/walton-argumentation-schemes-for-carneades-4/blob/master/categories.yml) (Category mapping), [`tools/graph_from_library.py`](https://github.com/austin-routt/walton-argumentation-schemes-for-carneades-4/blob/master/tools/graph_from_library.py) (Graph generator), [`A_reasoning`](https://github.com/austin-routt/walton-argumentation-schemes-for-carneades-4/tree/master/A_reasoning) (Reasoning schemes), [`B_source-based-arguments`](https://github.com/austin-routt/walton-argumentation-schemes-for-carneades-4/tree/master/B_source-based-arguments) (Source arguments)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_library["Scheme library"]
  node_master["Complete scheme list"]
  node_reasoning["Reasoning schemes"]
  node_sources["Source arguments"]
  node_rules["Rules and cases"]
  node_categories["Category mapping<br/>[categories.yml]"]
end

subgraph group_authoring["Case authoring"]
  node_generator["Graph generator"]
  node_casegraph["Case graph YAML"]
end

subgraph group_runtime["Evaluation"]
  node_engine["Carneades 4"]
end

node_user(("Case author"))

node_user -->|"selects schemes"| node_generator
node_master -->|"supplies schemes"| node_generator
node_categories -->|"assigns schemes"| node_reasoning
node_categories -->|"assigns schemes"| node_sources
node_categories -->|"assigns schemes"| node_rules
node_generator -->|"assembles graph"| node_casegraph
node_user -->|"adds case details"| node_casegraph
node_casegraph -->|"evaluates graph"| node_engine

click node_reasoning "https://github.com/austin-routt/walton-argumentation-schemes-for-carneades-4/tree/master/A_reasoning"
click node_sources "https://github.com/austin-routt/walton-argumentation-schemes-for-carneades-4/tree/master/B_source-based-arguments"
click node_rules "https://github.com/austin-routt/walton-argumentation-schemes-for-carneades-4/tree/master/C_applying-rules-to-cases"
click node_categories "https://github.com/austin-routt/walton-argumentation-schemes-for-carneades-4/blob/master/categories.yml"
click node_generator "https://github.com/austin-routt/walton-argumentation-schemes-for-carneades-4/blob/master/tools/graph_from_library.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_master,node_reasoning,node_sources,node_rules,node_categories toneBlue
class node_generator,node_casegraph toneAmber
class node_engine toneMint
class node_user toneIndigo
```

## Components

### Scheme library

- **Complete scheme list**
- [Reasoning schemes](https://github.com/austin-routt/walton-argumentation-schemes-for-carneades-4/tree/master/A_reasoning): `A_reasoning`
- [Source arguments](https://github.com/austin-routt/walton-argumentation-schemes-for-carneades-4/tree/master/B_source-based-arguments): `B_source-based-arguments`
- [Rules and cases](https://github.com/austin-routt/walton-argumentation-schemes-for-carneades-4/tree/master/C_applying-rules-to-cases): `C_applying-rules-to-cases`
- [Category mapping](https://github.com/austin-routt/walton-argumentation-schemes-for-carneades-4/blob/master/categories.yml): `categories.yml`

### Case authoring

- [Graph generator](https://github.com/austin-routt/walton-argumentation-schemes-for-carneades-4/blob/master/tools/graph_from_library.py): `tools/graph_from_library.py`
- **Case graph YAML**

### Evaluation

- **Carneades 4**

### Other components

- **Case author**

## Connections

- Case author → Graph generator: selects schemes (evidence: `README.md`)
- Complete scheme list → Graph generator: supplies schemes (evidence: `README.md`)
- Category mapping → Reasoning schemes: assigns schemes (evidence: `README.md`)
- Category mapping → Source arguments: assigns schemes (evidence: `README.md`)
- Category mapping → Rules and cases: assigns schemes (evidence: `README.md`)
- Graph generator → Case graph YAML: assembles graph (evidence: `README.md`)
- Case author → Case graph YAML: adds case details (evidence: `README.md`)
- Case graph YAML → Carneades 4: evaluates graph (evidence: `README.md`)
