diff --git a/.agents/SOUL.md b/.agents/SOUL.md
new file mode 100644
index 0000000..c5146d9
--- /dev/null
+++ b/.agents/SOUL.md
@@ -0,0 +1,6 @@
+# SOUL — tinqs/builds
+
+Inherits the shared Tinqs identity, values, and confidentiality rules from the hub:
+`tinqs-ltd/docs/.agents/SOUL.md`. Read that first.
+
+Nothing repo-specific to add — this is a build artifact store, not a product with its own voice.
diff --git a/.agents/plans/.gitkeep b/.agents/plans/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/.agents/skills/.gitkeep b/.agents/skills/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/.agents/wiki/ARCHITECTURE.md b/.agents/wiki/ARCHITECTURE.md
new file mode 100644
index 0000000..b4ee56d
--- /dev/null
+++ b/.agents/wiki/ARCHITECTURE.md
@@ -0,0 +1,17 @@
+# ARCHITECTURE — tinqs/builds
+
+Build artifact repo, not a codebase. There's no runtime architecture to document — the "system"
+is a flat, LFS-backed artifact store plus a manifest.
+
+## Layout
+
+- `engine/<platform>/` — engine editor binaries + their matched `GodotSharp/` C# bindings
+- `manifest.json` — exact versions/commits for each shipped artifact
+- `.gitattributes` — Git LFS rules for binaries and GodotSharp
+
+## Law
+
+Binary and `GodotSharp/` for a given engine build are a **matched pair** — always install/replace
+together. See root `README.md` for the full rule and current per-platform status table.
+
+See `architecture/` for any future per-system breakdowns (none yet — repo is single-purpose).
diff --git a/.agents/wiki/architecture/README.md b/.agents/wiki/architecture/README.md
new file mode 100644
index 0000000..edf166b
--- /dev/null
+++ b/.agents/wiki/architecture/README.md
@@ -0,0 +1,4 @@
+# Architecture docs
+
+Per-system architecture notes go here as this repo grows beyond a flat artifact store.
+Currently empty — see `../ARCHITECTURE.md` for the current-state summary.
diff --git a/.agents/wiki/master-plan.md b/.agents/wiki/master-plan.md
new file mode 100644
index 0000000..fca22d8
--- /dev/null
+++ b/.agents/wiki/master-plan.md
@@ -0,0 +1,22 @@
+# Master plan — tinqs/builds
+
+## Current state
+
+Build artifact repo: stores engine editor binaries + matched `GodotSharp/` C# bindings for the
+Tinqs/Ariki stack, plus `manifest.json` tracking exact shipped versions. Source lives in
+`tinqs/engine`, `tinqs/ariki-game`, `tinqs/ariki-sim` — this repo only holds built output.
+
+- macOS arm64: engine 4.7, native Terrain3D module, GodotSharp shipped.
+- Windows x64: engine 4.6.5 (pre-4.7), GDExtension Terrain3D, 4.7 upgrade pending Forge —
+  see `.agents/handoffs/forge-windows-4.7.md`.
+
+## In flight
+
+- Windows 4.7 engine build + matching GodotSharp (blocked on Forge machine — see handoff).
+- Longer-term: CI (Gitea Actions) building on push and publishing here / to S3 — tracked in
+  `docs/ai/plans/build-pipeline-architecture-2026-06-07.md` (hub repo, not here).
+
+## Recently shipped
+
+- macOS arm64 rebuilt on 4.7 with native Terrain3D + agent_skinned modules, Tinqs branding restored,
+  GodotSharp regenerated to match.
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..a5d31b3
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,32 @@
+# AGENTS.md — tinqs/builds
+
+## Identity
+
+Build artifact repo for the Tinqs/Ariki engine stack — engine editor binaries + matched
+`GodotSharp/` C# bindings, tracked in `manifest.json`. Not a codebase; source lives in
+`tinqs/engine`, `tinqs/ariki-game`, `tinqs/ariki-sim`.
+
+**Read the docs hub at session start:** `tinqs-ltd/docs/AGENTS.md` — shared identity, team roster,
+cross-repo rules. This file is the thin, repo-specific entry point; per-repo detail lives in
+`.agents/`.
+
+## Knowledge map (`.agents/`)
+
+| Path | Role | When |
+|---|---|---|
+| `.agents/SOUL.md` | Identity (inherits hub) | always-on |
+| `.agents/wiki/master-plan.md` | Current state + in-flight work | always-on |
+| `.agents/wiki/ARCHITECTURE.md` | Architecture law (entry point) | consult-when |
+| `.agents/wiki/architecture/` | Per-system architecture docs | consult-when |
+| `.agents/plans/` | Open/executing work (temporary — graduates to wiki) | consult-when |
+| `.agents/skills/` | Agent playbooks | consult-when |
+| `.agents/handoffs/` | Cross-machine task queue (e.g. `forge-windows-4.7.md`) | consult-when |
+
+Root `README.md` and `manifest.json` are the human-facing/data source of truth for what's actually
+shipped — read those for exact current contents.
+
+## Git
+
+- Branch: **main** only.
+- Sync with `tinqs push` / `tinqs pull` (LFS-heavy repo — never raw `git push`/`git pull`).
+- Commit with plain `git commit`.