TOC inside the docs

docs/GIT_FLOW.md

@@ -13,6 +13,39 @@ This document defines how we develop, integrate, release, and hotfix. **Cursor a
 
 ---
 
+---
+
+## Table of contents
+
+<!-- toc -->
+- [1. Goals](#1-goals)
+- [2. Branches](#2-branches)
+- [3. Branch diagram (steady state)](#3-branch-diagram-steady-state)
+- [4. Daily development](#4-daily-development)
+- [5. Release: next → master](#5-release-next-master)
+- [6. Hotfixes — chosen strategy](#6-hotfixes-chosen-strategy)
+  - [Default: hotfix from master (option 1) ✓](#default-hotfix-from-master-option-1)
+  - [Exception: fix only on next (option 2)](#exception-fix-only-on-next-option-2)
+- [7. Protection rules (CI + policy)](#7-protection-rules-ci-policy)
+  - [7.1 How to protect branches (not local hooks alone)](#71-how-to-protect-branches-not-local-hooks-alone)
+- [8. Sync cheat sheet](#8-sync-cheat-sheet)
+- [9. Agent / Cursor checklist](#9-agent-cursor-checklist)
+- [10. Comparison to classic Git Flow](#10-comparison-to-classic-git-flow)
+- [11. First-time setup (maintainer)](#11-first-time-setup-maintainer)
+- [12. Private primary + GitHub publish (dual remote)](#12-private-primary-github-publish-dual-remote)
+  - [12.1 Add GitHub without replacing origin](#121-add-github-without-replacing-origin)
+  - [12.2 What to push where](#122-what-to-push-where)
+  - [12.3 Daily habit](#123-daily-habit)
+  - [12.4 Where branch protection lives](#124-where-branch-protection-lives)
+  - [12.5 One-way mirror (optional automation)](#125-one-way-mirror-optional-automation)
+  - [12.6 Suggested order of operations (your situation)](#126-suggested-order-of-operations-your-situation)
+- [Related](#related)
+<!-- /toc -->
+
+**Documentation index:** [README.md](README.md)
+
+---
+
 ## 1. Goals
 
 | Goal | How |
@@ -388,6 +421,7 @@ Avoid `git push github --mirror` unless GitHub is a full duplicate of **private*
 
 ## Related
 
+- [README.md](README.md) — documentation index (all guides)
 - [ROADMAP.md](ROADMAP.md) — product tracks  
 - [.cursor/rules/git-flow.mdc](../.cursor/rules/git-flow.mdc) — agent enforcement  
 - `docs/_pdf_build/build_git_flow_pdf.py` — PDF generator