Merge pull request #432 from Data-Wise/dev

Merge dev: docs cleanup and broken link fixes

Author: Data-Wise

.STATUS

@@ -9,26 +9,20 @@
 ## Priority: 2
 ## Progress: 100
 
-## Current Session (2026-02-27)
+## Previous Session (2026-02-27, evening)
 
 **Session activity:**
-- docs: PR #427 (docs gap fix) — 7-phase documentation overhaul
-  - 4 new refcards: g, wt, dots, sec dispatchers
-  - help files updated to v7.6.0 (TROUBLESHOOTING, WORKFLOWS)
-  - stale version sweep: v5.x/v6.x → v7.6.0 across 7 guides
-  - teach dispatcher refcard: +4 Scholar commands, config subcommands
-  - tutorial renaming: 27→45 (lint-quickstart), 37→46 (em-v2-features)
-  - broken anchor fixes: 5 anchors across 5 files
-  - test suite: 53/53 passing (205 files, 1 expected timeout)
-- docs: Scholar wrappers refcard, integration guide expansion
-- docs: site update — index.md What's New, stale test counts, README Teaching section
-- merged: PR #425 (Scholar Config Sync), PR #424 (em --prompt), PR #427 (docs gap fix)
-- cleanup: worktree removed, stale branches deleted
-- release: v7.6.0 — full pipeline (PR #428, CI green, merge, retag, GitHub release)
-  - Homebrew tap updated, docs deployed, all downstream verified
-  - Stale remote branches deleted (atlas-integration, em-v2, homebrew-release-fix, swarm-em-v2-dispatcher)
-
-## Previous Session (2026-02-27, earlier)
+- docs: teaching docs refresh — 30 files updated (v5.x/v6.x → v7.6.0 version refs + dates)
+- docs: content gaps fixed — teach.md commands table + subsections (solution, sync, validate-r, style, config check/diff/show/scaffold), teaching hub features table (+5 entries), tutorial 14 branch naming (production → main)
+- docs: CHANGELOG sync — root v7.6.0 entry synced with docs/ (Scholar Config Sync, fixes, 53/53)
+- docs: lint fixes — MD031, MD029, MD040 across 7 teaching files
+- docs: consolidation — merged duplicate TEACHING-SYSTEM-ARCHITECTURE, archived 11 orphaned files to docs/.archive/, simplified mkdocs exclude list
+- docs: moved 2 BRAINSTORM-*.md from repo root to docs/specs/
+- fix: broken relative links in TEACHING-SYSTEM-ARCHITECTURE after file move
+- merged: PR #429 (docs update) to main, dev synced
+- deploy: docs site deployed (CI auto-deploy)
+
+## Previous Session (2026-02-27)
 
 **Session activity:**
 - feat: Scholar Config Sync (#423) — config injection, teach config/solution/sync/validate-r
@@ -149,6 +143,13 @@
 
 ## Recent Releases
 
+### v7.6.0 (2026-02-27) — em --prompt + Scholar Config Sync
+- em --prompt/--backend flags, em forward, smart TTY detection
+- Scholar Config Sync: teach config check/diff/show/scaffold, teach solution/sync/validate-r
+- Help guards on all 34 em subcommands, doctor config sync section
+- 53/53 tests passing, 205 test files, 1 expected timeout
+- PR #428, Release: https://github.com/Data-Wise/flow-cli/releases/tag/v7.6.0
+
 ### v7.5.0 (2026-02-26) — em v2.0 Safety Gate
 - em v2.0: two-phase safety gate for send/reply, ICS calendar, IMAP watch, folder CRUD
 - Enhanced attachments, `em send --confirm`, `em calendar`, `em watch`, `em create-folder`
@@ -220,13 +221,15 @@
 
 ## Next Action
 
+Taking a break — pick up tomorrow.
+
 1. API documentation push (50% → 80%)
 2. Code workspace manager — spec ready on dev
-3. Release v7.7.0 (Scholar Config Sync + em --prompt already on dev)
+3. Consider next feature work (all docs current, site clean)
 
 ---
 
-**Last Updated:** 2026-02-27
+**Last Updated:** 2026-02-27 (evening)
 **Status:** v7.6.0 | 53/53 tests passing (1 expected timeout) | 15 dispatchers + at bridge | 205 test files | 12000+ test functions | 0 lint errors | 0 broken anchors
 ## wins: Fixed the regression bug (2026-02-27), --category fix squashed the bug (2026-02-27), fixed the bug (2026-02-27), Fixed the regression bug (2026-02-27), --category fix squashed the bug (2026-02-27)
 ## streak: 1

docs/architecture/DOCTOR-TOKEN-ARCHITECTURE.md

@@ -676,7 +676,7 @@ Cache Performance:
 
 - [API Reference](../reference/MASTER-API-REFERENCE.md#doctor-cache)
 - [User Guide](../guides/DOCTOR-TOKEN-USER-GUIDE.md)
-- [Test Suites](../../tests/)
+- [Test Suites](https://github.com/Data-Wise/flow-cli/tree/main/tests)
 
 ---
 

docs/contributing/DOCUMENTATION-STYLE-GUIDE.md

@@ -75,7 +75,7 @@ docs/
 ├── reference/             # Technical reference
 │   ├── COMMAND-EXPLORER.md
 │   ├── ALIAS-REFERENCE-CARD.md
-│   └── WORKFLOW-QUICK-REFERENCE.md
+│   └── QUICK-REFERENCE.md
 │
 ├── testing/               # Testing guides
 │   └── TESTING.md

docs/demos/tutorials/TEACHING-V3-GIFS-README.md

@@ -36,7 +36,7 @@ This directory contains VHS tapes and generated GIF demos for Teaching Workflow
 - ✅ **Validation:** All tapes pass `scripts/validate-vhs-tapes.sh`
 - ✅ **Optimization:** All GIFs optimized with `gifsicle -O3`
 
-**Style Guide:** See [`docs/contributing/VHS-TAPE-STYLE-GUIDE.md`](../../contributing/VHS-TAPE-STYLE-GUIDE.md)
+**Style Guide:** See [`docs/internal/VHS-TAPE-STYLE-GUIDE.md`](../../internal/VHS-TAPE-STYLE-GUIDE.md)
 
 ---
 

docs/getting-started/choose-your-path.md

@@ -98,7 +98,7 @@ description: Find the right starting point for your goals
 **Perfect if you:** Want to know *why* Flow CLI works this way
 
 [→ Design Philosophy](../PHILOSOPHY.md){ .md-button }
-[→ ADHD-Optimized Design](../internal/conventions/adhd/){ .md-button }
+[→ ADHD-Optimized Design](../internal/conventions/adhd/README.md){ .md-button }
 
 ---
 

docs/guides/DOCTOR-TOKEN-USER-GUIDE.md

@@ -616,7 +616,7 @@ doctor --dot=github,npm,pypi  # Specific tokens
 ### Learn More
 
 - [API Reference](../reference/MASTER-API-REFERENCE.md#doctor-cache) - Complete API documentation
-- [Test Suites](../../tests/) - Usage examples in tests
+- [Test Suites](https://github.com/Data-Wise/flow-cli/tree/main/tests) - Usage examples in tests
 
 ### Related Commands
 

docs/guides/WORKFLOW-TUTORIAL.md

@@ -586,5 +586,4 @@ dash
 
 ---
 
-*For detailed docs, see: WORKFLOW-IMPLEMENTATION-SUMMARY.md*
-*For quick reference: WORKFLOW-QUICK-REFERENCE.md*
+*For detailed docs, see the [Quick Reference](../help/QUICK-REFERENCE.md)*

docs/index.md

@@ -8,7 +8,7 @@ tags:
 # Flow CLI
 
 [![Version](https://img.shields.io/github/v/release/Data-Wise/flow-cli?label=version&color=blue&cacheSeconds=300)](https://github.com/Data-Wise/flow-cli/releases/latest)
-[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![License](https://img.shields.io/badge/license-MIT-green)](https://github.com/Data-Wise/flow-cli/blob/main/LICENSE)
 [![Tests](https://img.shields.io/github/actions/workflow/status/Data-Wise/flow-cli/test.yml?label=tests&branch=main&cacheSeconds=300)](https://github.com/Data-Wise/flow-cli/actions/workflows/test.yml)
 [![Docs](https://img.shields.io/github/actions/workflow/status/Data-Wise/flow-cli/docs.yml?label=docs&branch=main&cacheSeconds=300)](https://github.com/Data-Wise/flow-cli/actions/workflows/docs.yml)
 [![Pure ZSH](https://img.shields.io/badge/pure-ZSH-1f425f)](https://www.zsh.org/)

docs/internal/conventions/adhd/HELP-PAGE-TEMPLATE.md

@@ -669,9 +669,7 @@ echo $FZF_DEFAULT_OPTS
 ## See Also
 
 - **Tutorial:** [Tutorial 2: Multiple Projects](../../tutorials/02-multiple-projects.md)
-- **Workflow:** [Project Navigation Workflow](../../workflows/project-navigation.md)
 - **Reference:** [Pick Command Reference](../../reference/MASTER-DISPATCHER-GUIDE.md)
-- **Guide:** [Project Detection Guide](../../guides/PROJECT-DETECTION-GUIDE.md)
 
 ---
 

docs/internal/conventions/adhd/README.md

@@ -362,7 +362,7 @@ worktree-workflow.md
 ```text
 COMMAND-QUICK-REFERENCE.md
 CC-DISPATCHER-REFERENCE.md
-WORKFLOW-QUICK-REFERENCE.md
+QUICK-REFERENCE.md
 ```
 
 ### GIFs