summaryrefslogtreecommitdiff
path: root/isa/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'isa/README.md')
-rw-r--r--isa/README.md12
1 files changed, 12 insertions, 0 deletions
diff --git a/isa/README.md b/isa/README.md
new file mode 100644
index 0000000..bf855eb
--- /dev/null
+++ b/isa/README.md
@@ -0,0 +1,12 @@
+# ISA Definition
+
+Formal, machine-readable specification of the instruction set.
+
+## Structure
+
+- `encoding/` — Instruction encoding bitfield definitions (JSON/YAML tables)
+- `opcodes/` — Opcode mnemonics, values, operand types
+- `extensions/` — Optional ISA extensions (e.g. float, vector, crypto)
+- `privileged/` — Privileged architecture: CSRs, traps, memory management
+
+This directory is the **source of truth** consumed by the generators in `gen/`.