# riscv/riscv-attached-matrix-extension architecture

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

- Interactive diagram: https://gitdiagram.com/riscv/riscv-attached-matrix-extension
- Repository: https://github.com/riscv/riscv-attached-matrix-extension

## Overview

This repository is the source for the RISC-V Instruction Set Manual. The reader’s main workflow is to consult the unprivileged, privileged, or profiles volume for architecture requirements; the README identifies these as the manual’s three volumes and distinguishes ratified standards from drafts. The source tree also contains normative-rule definitions and instruction-encoding material. The excerpts do not show how those sources are assembled or linked, so the graph avoids inferring internal publication flows.

Main entry points: [`src/unpriv/unpriv.adoc`](https://github.com/riscv/riscv-attached-matrix-extension/blob/main/src/unpriv/unpriv.adoc) (Unprivileged volume), [`src/priv/priv.adoc`](https://github.com/riscv/riscv-attached-matrix-extension/blob/main/src/priv/priv.adoc) (Privileged volume), [`src/profiles/profiles.adoc`](https://github.com/riscv/riscv-attached-matrix-extension/blob/main/src/profiles/profiles.adoc) (Profiles volume), [`marchid.md`](https://github.com/riscv/riscv-attached-matrix-extension/blob/main/marchid.md) (Marchid registry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_volumes["Specification volumes"]
  node_manual["ISA manual source<br/>[riscv-spec.adoc]"]
  node_unpriv["Unprivileged volume<br/>[unpriv.adoc]"]
  node_priv["Privileged volume<br/>[priv.adoc]"]
  node_profiles["Profiles volume<br/>[profiles.adoc]"]
end

subgraph group_support["Specification support"]
  node_rule_defs["Normative rules"]
  node_encoding_alloc["Encoding allocations"]
  node_instruction_pages["Instruction definitions<br/>[instructions.adoc]"]
end

subgraph group_references["Reference material"]
  node_bibliography["Bibliography<br/>[bibliography.adoc]"]
  node_marchid["Marchid registry<br/>[marchid.md]"]
end

node_reader(("Specification reader"))

node_reader -->|"consults"| node_unpriv
node_reader -->|"consults"| node_priv
node_reader -->|"consults"| node_profiles
node_reader -->|"consults"| node_marchid

click node_manual "https://github.com/riscv/riscv-attached-matrix-extension/blob/main/src/riscv-spec.adoc"
click node_unpriv "https://github.com/riscv/riscv-attached-matrix-extension/blob/main/src/unpriv/unpriv.adoc"
click node_priv "https://github.com/riscv/riscv-attached-matrix-extension/blob/main/src/priv/priv.adoc"
click node_profiles "https://github.com/riscv/riscv-attached-matrix-extension/blob/main/src/profiles/profiles.adoc"
click node_rule_defs "https://github.com/riscv/riscv-attached-matrix-extension/tree/main/normative_rule_defs"
click node_encoding_alloc "https://github.com/riscv/riscv-attached-matrix-extension/blob/main/src/instruction-encoding-allocations.adoc"
click node_instruction_pages "https://github.com/riscv/riscv-attached-matrix-extension/blob/main/src/instructions.adoc"
click node_bibliography "https://github.com/riscv/riscv-attached-matrix-extension/blob/main/src/bibliography.adoc"
click node_marchid "https://github.com/riscv/riscv-attached-matrix-extension/blob/main/marchid.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_manual,node_unpriv,node_priv,node_profiles toneBlue
class node_rule_defs,node_encoding_alloc,node_instruction_pages toneAmber
class node_bibliography,node_marchid toneMint
class node_reader toneIndigo
```

## Components

### Specification volumes

- [ISA manual source](https://github.com/riscv/riscv-attached-matrix-extension/blob/main/src/riscv-spec.adoc): `src/riscv-spec.adoc`
- [Unprivileged volume](https://github.com/riscv/riscv-attached-matrix-extension/blob/main/src/unpriv/unpriv.adoc): `src/unpriv/unpriv.adoc`
- [Privileged volume](https://github.com/riscv/riscv-attached-matrix-extension/blob/main/src/priv/priv.adoc): `src/priv/priv.adoc`
- [Profiles volume](https://github.com/riscv/riscv-attached-matrix-extension/blob/main/src/profiles/profiles.adoc): `src/profiles/profiles.adoc`

### Specification support

- [Normative rules](https://github.com/riscv/riscv-attached-matrix-extension/tree/main/normative_rule_defs): `normative_rule_defs`
- [Encoding allocations](https://github.com/riscv/riscv-attached-matrix-extension/blob/main/src/instruction-encoding-allocations.adoc): `src/instruction-encoding-allocations.adoc`
- [Instruction definitions](https://github.com/riscv/riscv-attached-matrix-extension/blob/main/src/instructions.adoc): `src/instructions.adoc`

### Reference material

- [Bibliography](https://github.com/riscv/riscv-attached-matrix-extension/blob/main/src/bibliography.adoc): `src/bibliography.adoc`
- [Marchid registry](https://github.com/riscv/riscv-attached-matrix-extension/blob/main/marchid.md): `marchid.md`

### Other components

- **Specification reader**

## Connections

- Specification reader → Unprivileged volume: consults (evidence: `README.md`)
- Specification reader → Privileged volume: consults (evidence: `README.md`)
- Specification reader → Profiles volume: consults (evidence: `README.md`)
- Specification reader → Marchid registry: consults (evidence: `README.md`)
