# shadps4-compatibility/shadps4-game-compatibility architecture

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

- Interactive diagram: https://gitdiagram.com/shadps4-compatibility/shadps4-game-compatibility
- Repository: https://github.com/shadps4-compatibility/shadps4-game-compatibility

## Overview

This repository provides community guidance and GitHub issue-based compatibility reporting for shadPS4 games. The documented workflow is to submit a report with game, emulator, OS, and compatibility details, then update an existing report with a log after a major emulator release. GitHub issue labels expose compatibility stages from nothing to playable. The tree also contains a game-report issue template and an update workflow, but their implementation and wiring were not available to inspect, so those links remain unverified.

Main entry points: [`.github/ISSUE_TEMPLATE/game_compatibility.yml`](https://github.com/shadps4-compatibility/shadps4-game-compatibility/blob/main/.github/ISSUE_TEMPLATE/game_compatibility.yml) (Report form), [`.github/workflows/update_game_compatibility.yml`](https://github.com/shadps4-compatibility/shadps4-game-compatibility/blob/main/.github/workflows/update_game_compatibility.yml) (Release update automation), [`README.md`](https://github.com/shadps4-compatibility/shadps4-game-compatibility/blob/main/README.md) (Reporting rules)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guidance["Reporting guidance"]
  node_readme["Reporting rules<br/>[README.md]"]
end

subgraph group_github["GitHub reporting"]
  node_template["Report form"]
  node_tracker["Compatibility issues"]
  node_statuses["Status labels"]
  node_update["Release update automation"]
end

node_reporter(("Game reporter"))

node_reporter -->|"follows rules"| node_readme
node_reporter -->|"submits report"| node_tracker
node_reporter -->|"posts update"| node_tracker
node_tracker -->|"uses labels"| node_statuses
node_template -.->|"submits report"| node_tracker
node_update -.->|"updates reports"| node_tracker

click node_readme "https://github.com/shadps4-compatibility/shadps4-game-compatibility/blob/main/README.md"
click node_template "https://github.com/shadps4-compatibility/shadps4-game-compatibility/blob/main/.github/ISSUE_TEMPLATE/game_compatibility.yml"
click node_update "https://github.com/shadps4-compatibility/shadps4-game-compatibility/blob/main/.github/workflows/update_game_compatibility.yml"

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_readme toneBlue
class node_template,node_tracker,node_statuses,node_update toneAmber
class node_reporter toneIndigo
```

## Components

### Reporting guidance

- [Reporting rules](https://github.com/shadps4-compatibility/shadps4-game-compatibility/blob/main/README.md): `README.md`

### GitHub reporting

- [Report form](https://github.com/shadps4-compatibility/shadps4-game-compatibility/blob/main/.github/ISSUE_TEMPLATE/game_compatibility.yml): `.github/ISSUE_TEMPLATE/game_compatibility.yml`
- **Compatibility issues**
- **Status labels**
- [Release update automation](https://github.com/shadps4-compatibility/shadps4-game-compatibility/blob/main/.github/workflows/update_game_compatibility.yml): `.github/workflows/update_game_compatibility.yml`

### Other components

- **Game reporter**

## Connections

- Game reporter → Reporting rules: follows rules (evidence: `README.md`)
- Game reporter → Compatibility issues: submits report (evidence: `README.md`)
- Game reporter → Compatibility issues: posts update (evidence: `README.md`)
- Compatibility issues → Status labels: uses labels (evidence: `README.md`)
- Report form → Compatibility issues: submits report
- Release update automation → Compatibility issues: updates reports