docs: quick guide, docs README, specifications and NOTICE

docs/README.md

@@ -0,0 +1,26 @@
+# OTKO Documentation
+
+Index of the project documentation. Start with the quick guide if you
+just want to build and run a model; read the architecture page if you are
+changing code.
+
+| Document | What it covers |
+| --- | --- |
+| [QUICK_GUIDE.md](QUICK_GUIDE.md) | Task-first walkthrough: cantilever model, modal analysis, report and script export, display units, undo/redo. |
+| [architecture.md](architecture.md) | MVVM layering, package responsibilities, threading, persistence, and the fixed OpenSeesPy command order. |
+| [roadmap.md](roadmap.md) | Phase-by-phase feature status, from scaffolding through the earthquake-engineering primitives. |
+| [adr/](adr/) | Architecture Decision Records — the "why" behind individual design choices. |
+| [screenshots/](screenshots/) | Screenshots referenced by the docs and README. |
+
+## Architecture Decision Records
+
+- [ADR-0001 — GiD/OpenSees schema import](adr/ADR-0001-gidopensees-schema-import.md)
+- [ADR-0002 — Headless / GUI dependency split](adr/ADR-0002-headless-gui-dep-split.md)
+
+## Related documentation
+
+- [`../README.md`](../README.md) — project overview, install, and quick start.
+- [`../CONTRIBUTING.md`](../CONTRIBUTING.md) — dev setup, layering rules, commit style, and verify commands.
+- [`../AGENTS.md`](../AGENTS.md) — condensed context for automated agents.
+- [`gap-analysis-gidopensees.md`](gap-analysis-gidopensees.md) — gap analysis against the GiD/OpenSees reference.
+- [`../examples/README.md`](../examples/README.md) — the bundled example models.