docs: bring the document set into the standard shape

Assisted-by: GLM 5.3 Flash

CHANGELOG.md

@@ -3,7 +3,7 @@
 All notable changes to gasm-devkit are documented here.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this project adheres to [Conventional Commits](https://www.conventionalcommits.org/).
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [development]
 
@@ -13,20 +13,42 @@ and this project adheres to [Conventional Commits](https://www.conventionalcommi
   (build, fmt-check, vet, test, race).  `install` now builds and copies
   the binary into `~/.local/bin` (`BINDIR` overrides) instead of
   downloading module dependencies, and `install-bin` is gone.  The test
-  gate sweeps the whole suite and computes the coverage floor over the
-  product packages with `-coverpkg`, `disasm` now included, so the
-  number is identical locally and in CI.  `fuzz` requires its target
-  package.
+  gate sweeps the logic packages (arch through verify; the hardware-bound
+  `debug` and the thin `cmd/gasm` sit outside it), so the coverage floor
+  is computed over the product code and the number is identical locally
+  and in CI.  `fuzz` requires its target package.
 - **The reported version comes from the build.**  `gasm --version`
   prints the version the toolchain recorded: the tag on a tagged
   checkout, a pseudo-version naming the commit below one, `+dirty` on a
   dirty tree and `(devel)` outside version control.  Nothing is
   injected with `-ldflags -X` any more.
 - **CI realigned with the gate set.**  The push pipeline runs the gates
-  minus race in one job, with a cached Go setup and the module as the
-  version source; the race detector moved to a hand-dispatched workflow
-  and into the release gates; the release builds without injection and
+  minus race in one job, in the `gates` order, with a cached Go setup and
+  the module as the version source; a superseded run of the same branch
+  is cancelled instead of queueing; every `go test` runs under a
+  ten-minute bound that matches its job's; the race detector moved to a
+  hand-dispatched workflow and runs in the local gate before a tag is
+  cut, never on a push or a tag; the release builds without injection and
   its smoke test requires the recorded tag and rejects `+dirty`.
+- **The documents follow the standard set.**  `docs/ARCHITECTURE.md` is
+  organised as Overview, Packages, Data flow, State and lifetime and
+  Dependencies, and carries a sequence diagram of the assembly path;
+  `docs/DEVELOPMENT.md` lists every recipe in one table and documents the
+  coverage floor, the CI and the release flow; `docs/CLI.md` gives the
+  synopsis, the commands, every flag with its default, the exit codes and
+  worked examples; `CONTRIBUTING.md` carries the Contributor terms and
+  states the commit trailer form, the one-logical-change rule and the
+  licence header rule.  The repository's own assembly (the `verify`
+  trampolines and the test kernels) is in `gasm fmt` canonical form.
+
+### Fixed
+
+- **The dependency statement was wrong.**  `golang.org/x/arch` is not
+  test-only: `gasm dis` and the debugger's listings decode through it, so
+  it is linked into the binary.  `CONTRIBUTING.md` and
+  `docs/ARCHITECTURE.md` said otherwise.
+- **The CLI reference listed 17 of the 18 lint rules.**  The missing
+  `reserved-register-write` is documented with the rest.
 
 ## [0.33.0] - 2026-09-14