# fg-tida/themes architecture

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

- Interactive diagram: https://gitdiagram.com/fg-tida/themes
- Repository: https://github.com/fg-tida/themes

## Overview

This repository supports an open process for proposing, discussing, and refining FG-TIDA themes, with optional progression to reviewed charter documents. Participants start proposals as GitHub Issues; discussion can mature a theme into a charter proposed by Pull Request. The README also identifies six candidate themes as starting material and documents automatic application of the proposal label. The graph reflects those documented relationships; the charter template’s specific use is not described, so its connection is marked unverified.

Main entry points: [`.github/ISSUE_TEMPLATE/theme-proposal.md`](https://github.com/fg-tida/themes/blob/main/.github/ISSUE_TEMPLATE/theme-proposal.md) (Proposal template), [`CHARTER-TEMPLATE.md`](https://github.com/fg-tida/themes/blob/main/CHARTER-TEMPLATE.md) (Charter template), [`candidate-themes-from-2026-07-29.md`](https://github.com/fg-tida/themes/blob/main/candidate-themes-from-2026-07-29.md) (Candidate themes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_proposal["Theme proposals"]
  node_issue["GitHub Issue"]
  node_issue_template["Proposal template<br/>[theme-proposal.md]"]
  node_discussion["Issue discussion"]
  node_proposal_label["Proposal label"]
end

subgraph group_formalization["Charter formalization"]
  node_charter_pr["Charter pull request"]
  node_charter_template["Charter template"]
end

subgraph group_starting["Starting material"]
  node_candidate_themes["Candidate themes"]
end

node_participants(("Participants"))

node_participants -->|"open proposal"| node_issue
node_issue_template -->|"structures proposal"| node_issue
node_issue -->|"hosts discussion"| node_discussion
node_issue_template -->|"applies automatically"| node_proposal_label
node_discussion -->|"may mature into"| node_charter_pr
node_participants -->|"propose charter"| node_charter_pr
node_charter_template -.->|"may support drafting"| node_charter_pr
node_candidate_themes -->|"offers starting points"| node_issue

click node_issue_template "https://github.com/fg-tida/themes/blob/main/.github/ISSUE_TEMPLATE/theme-proposal.md"
click node_charter_template "https://github.com/fg-tida/themes/blob/main/CHARTER-TEMPLATE.md"
click node_candidate_themes "https://github.com/fg-tida/themes/blob/main/candidate-themes-from-2026-07-29.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_issue,node_issue_template,node_discussion,node_proposal_label toneBlue
class node_charter_pr,node_charter_template toneAmber
class node_candidate_themes toneMint
class node_participants toneIndigo
```

## Components

### Theme proposals

- **GitHub Issue**
- [Proposal template](https://github.com/fg-tida/themes/blob/main/.github/ISSUE_TEMPLATE/theme-proposal.md): `.github/ISSUE_TEMPLATE/theme-proposal.md`
- **Issue discussion**
- **Proposal label**

### Charter formalization

- **Charter pull request**
- [Charter template](https://github.com/fg-tida/themes/blob/main/CHARTER-TEMPLATE.md): `CHARTER-TEMPLATE.md`

### Starting material

- [Candidate themes](https://github.com/fg-tida/themes/blob/main/candidate-themes-from-2026-07-29.md): `candidate-themes-from-2026-07-29.md`

### Other components

- **Participants**

## Connections

- Participants → GitHub Issue: open proposal (evidence: `README.md`)
- Proposal template → GitHub Issue: structures proposal (evidence: `README.md`)
- GitHub Issue → Issue discussion: hosts discussion (evidence: `README.md`)
- Proposal template → Proposal label: applies automatically (evidence: `README.md`)
- Issue discussion → Charter pull request: may mature into (evidence: `README.md`)
- Participants → Charter pull request: propose charter (evidence: `README.md`)
- Charter template → Charter pull request: may support drafting
- Candidate themes → GitHub Issue: offers starting points (evidence: `README.md`)