docs(index): link guide_context_curation and guide_shaders_and_window; add legacy MMA section and 7 new-guide placeholders

docs/Readme.md

@@ -19,6 +19,34 @@ This documentation suite provides comprehensive technical reference for the Manu
 | [Tools & IPC](guide_tools.md) | MCP Bridge 3-layer security model (Allowlist Construction, Path Validation, Resolution Gate), all 26 native tool signatures with parameters and behavior (File I/O, AST-Based, Analysis, Network, Runtime), Hook API GET/POST endpoints with request/response formats, ApiHookClient method reference (Connection Methods, State Query Methods, GUI Manipulation Methods, Polling Methods, HITL Method), `/api/ask` synchronous HITL protocol (blocking request-response over HTTP), session logging (comms.log, toolcalls.log, apihooks.log, clicalls.log, scripts/generated/*.ps1), shell runner (mcp_env.toml configuration, run_powershell function with timeout handling and QA callback integration) |
 | [MMA Orchestration](guide_mma.md) | Ticket/Track/WorkerContext data structures (from `models.py`), DAG engine (TrackDAG class with cycle detection, topological sort, cascade_blocks; ExecutionEngine class with tick-based state machine), ConductorEngine execution loop (run method, _push_state for state broadcast, parse_json_tickets for ingestion), Tier 2 ticket generation (generate_tickets, topological_sort), Tier 3 worker lifecycle (run_worker_lifecycle with Context Amnesia, AST skeleton injection, HITL clutch integration via confirm_spawn and confirm_execution), Tier 4 QA integration (run_tier4_analysis, run_tier4_patch_callback), token firewalling (tier_usage tracking, model escalation), track state persistence (TrackState, save_track_state, load_track_state, get_all_tracks) |
 | [Simulations](guide_simulations.md) | Structural Testing Contract (Ban on Arbitrary Core Mocking, `live_gui` Standard, Artifact Isolation), `live_gui` pytest fixture lifecycle (spawning, readiness polling, failure path, teardown, session isolation via reset_ai_client), VerificationLogger for structured diagnostic logging, process cleanup (kill_process_tree for Windows/Unix), Puppeteer pattern (8-stage MMA simulation with mock provider setup, epic planning, track acceptance, ticket loading, status transitions, worker output verification), mock provider strategy (`tests/mock_gemini_cli.py` with JSON-L protocol, input mechanisms, response routing, output protocol), visual verification patterns (DAG integrity, stream telemetry, modal state, performance monitoring), supporting analysis modules (ASTParser with tree-sitter, summarize.py heuristic summaries, outline_tool.py hierarchical outlines) |
+| [Context Curation](guide_context_curation.md) | Granular AST control (per-symbol masking as Def, Sig, or Hide for C/C++ files via `ts_cpp_get_skeleton` and `ts_c_get_skeleton`), Fuzzy Anchor Slices (resilient line ranges that survive file modifications via `fuzzy_anchor.py`), Interactive AST Tree Masking (modal flow for inspecting and masking individual classes/functions), Batch Operations (multi-select and batch state modification for the Context Panel), Context Snapshotting (per-Take state restoration via `HistoryManager`), Aggregation Pipeline integration (mask application order, view mode merging) |
+| [Shaders & Window](guide_shaders_and_window.md) | Hybrid shader injection strategy (ImDrawList primitives combined with PyOpenGL FBO for advanced effects), pure ImGui borderless window implementation (cross-platform compatible, custom drag/minimize/maximize/close via pywin32 on Windows), event metrics integration for shader performance tracking |
+| [RAG](guide_rag.md) | *Placeholder — guide to be written in Task 10.* Vector store lifecycle, chunking strategies (character-based and AST-aware), multi-provider search (local ChromaDB and external MCP RAG bridge), parallelized indexing pipeline with mtime-based incremental updates, deep discussion integration with source buttons |
+| [Beads](guide_beads.md) | *Placeholder — guide to be written in Task 10.* Dolt-backed issue tracking (`.beads` repository), JSON-RPC client protocol, `bd` CLI integration, automated context compaction for completed beads, integration with the Visual DAG |
+| [Hot Reload](guide_hot_reload.md) | *Placeholder — guide to be written in Task 10.* State-preserving module reloading (`HotReloader` utility), UI delegation pattern enabling selective swap of rendering functions, keyboard trigger (Ctrl+Alt+R), visual error tint feedback on failure |
+| [Personas](guide_personas.md) | *Placeholder — guide to be written in Task 10.* Unified agent profile model consolidating model settings, prompts, and tool biases, persona editor modal, MMA tier assignment (which persona drives which tier), scope-based inheritance (global vs project) |
+| [NERV Theme](guide_nerv_theme.md) | *Placeholder — guide to be written in Task 10.* "Black Void" palette, zero-rounding geometry, CRT-style visual effects (scanlines, status flickering, alert animations), high-density NERV Technical Console aesthetic, integration with `theme_nerv.py` and `theme_nerv_fx.py` |
+| [Workspace Profiles](guide_workspace_profiles.md) | *Placeholder — guide to be written in Task 10.* Docking layouts and window visibility persistence, named profiles, scope inheritance (Global and Project), contextual auto-switch (experimental) binding profiles to MMA tier or task context |
+| [Command Palette](guide_command_palette.md) | *Placeholder — guide to be written in Task 10.* Fuzzy command resolution, async context preview to fix UI hangs, "Everything" mode for global actions, integration with the Conductor workflow |
+
+---
+
+## Legacy MMA Reference (Deprecated)
+
+*These documents are preserved for historical context. They describe a pre-Feb 2026 architecture and may not reflect current implementation. Prefer the guides above.*
+
+- [MMA_Support Overview](MMA_Support/Overview.md)
+- [MMA_Support Architecture Recommendation](MMA_Support/Architecture_Recommendation.md)
+- [MMA_Support Data Pipelines and Config](MMA_Support/Data_Pipelines_and_Config.md)
+- [MMA_Support Final Analysis Report](MMA_Support/Final_Analysis_Report.md)
+- [MMA_Support Implementation Tracks](MMA_Support/Implementation_Tracks.md)
+- [MMA_Support Orchestrator Engine](MMA_Support/Orchestrator_Engine.md)
+- [MMA_Support Tier 1 Orchestrator](MMA_Support/Tier1_Orchestrator.md)
+- [MMA_Support Tier 2 Tech Lead](MMA_Support/Tier2_TechLead.md)
+- [MMA_Support Tier 3 Workers](MMA_Support/Tier3_Workers.md)
+- [MMA_Support Tier 4 Utility](MMA_Support/Tier4_Utility.md)
+- [MMA_Support Original Discussion](MMA_Support/OriginalDiscussion.md)
+- [MMA_Support mma_tiered_orchestrator_skill](MMA_Support/mma_tiered_orchestrator_skill.md)
 
 ---