From 60f6ccc6f3f4fc6c58eef31913e8cea216c54ddb Mon Sep 17 00:00:00 2001
From: tupe12334 <ofek.gabay.he@gmail.com>
Date: Thu, 11 Jun 2026 19:17:53 +0300
Subject: [PATCH] docs: add installation and nav links to README

---
 README.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/README.md b/README.md
index cb1866e..99e13cf 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,8 @@
 
 steplock sits on top of the [polyhook](https://github.com/tupe12334/polyhook) SDK. It intercepts hook events and gates actions behind a sequential checklist — one question per invocation, acknowledged by the agent, persisted to disk.
 
+**[Installation →](Installation.md)** · **[Architecture →](Architecture.md)** · **[Contributing →](CONTRIBUTING.md)**
+
 ---
 
 ## The Problem
@@ -92,6 +94,10 @@ stateDiagram-v2
     skip_reason  : Describe why test coverage was skipped.
 ```
 
+See [`examples/git-push-quality-gate/`](examples/git-push-quality-gate/) for a complete working example.
+
+---
+
 ## Editor support
 
 **`config.toml`** — add the `#:schema` hint. [Taplo](https://taplo.tamasfe.dev) (via [Even Better TOML](https://marketplace.visualstudio.com/items?itemName=tamasfe.even-better-toml)) provides autocomplete and inline validation.