docs: add section index pages and Jekyll front matter for docs website

bniladridas · bniladridas · commit 8462f169ee6b · 2026-06-28T06:42:20.000+05:30
diff --git a/docs/architecture/implementation_audit.md b/docs/architecture/implementation_audit.md
@@ -1,3 +1,6 @@
+---
+---
+
 # Implementation Audit: Session Notes vs. Actual Code
 
 **Date:** 2026-06-25
diff --git a/docs/architecture/index.md b/docs/architecture/index.md
@@ -0,0 +1,10 @@
+---
+layout: default
+title: Architecture
+---
+
+# Architecture
+
+- [Implementation Audit](implementation_audit.md)
+- [Interactive Investigation Panels](interactive_investigation_panels.md)
+- [Principal Engineering Review](principal_engineering_review.md)
diff --git a/docs/architecture/interactive_investigation_panels.md b/docs/architecture/interactive_investigation_panels.md
@@ -1,3 +1,6 @@
+---
+---
+
 # Interactive Investigation Panels -- Feasibility Report
 
 ## 1. Feasibility
diff --git a/docs/engineering/acceptance_criteria.md b/docs/engineering/acceptance_criteria.md
@@ -1,3 +1,6 @@
+---
+---
+
 # Level 2 Exit Criteria
 
 - First-pass success ≥95%
diff --git a/docs/engineering/capacity_review.md b/docs/engineering/capacity_review.md
@@ -1,3 +1,6 @@
+---
+---
+
 # Capacity Review -- Level 2 Exit
 
 ## Overview
diff --git a/docs/engineering/confidence_calibration_phase1.md b/docs/engineering/confidence_calibration_phase1.md
@@ -1,3 +1,6 @@
+---
+---
+
 # Phase 1: Confidence Calibration Observation
 
 ## Calibration Error
diff --git a/docs/engineering/confidence_calibration_phase2_design.md b/docs/engineering/confidence_calibration_phase2_design.md
@@ -1,3 +1,6 @@
+---
+---
+
 # Phase 2: Confidence Model Design
 
 ## Current Model Problems (from Phase 1)
diff --git a/docs/engineering/evidence_quality_audit.md b/docs/engineering/evidence_quality_audit.md
@@ -1,3 +1,6 @@
+---
+---
+
 # Evidence Quality Audit
 
 ## Why This Exists
diff --git a/docs/engineering/human_evaluation_package.md b/docs/engineering/human_evaluation_package.md
@@ -1,3 +1,6 @@
+---
+---
+
 # Human Evaluation Package -- Planner Investigation Quality
 
 ## Purpose
diff --git a/docs/engineering/index.md b/docs/engineering/index.md
@@ -0,0 +1,15 @@
+---
+layout: default
+title: Engineering
+---
+
+# Engineering
+
+- [Acceptance Criteria](acceptance_criteria.md)
+- [Capacity Review](capacity_review.md)
+- [Confidence Calibration Phase 1](confidence_calibration_phase1.md)
+- [Confidence Calibration Phase 2 Design](confidence_calibration_phase2_design.md)
+- [Evidence Quality Audit](evidence_quality_audit.md)
+- [Human Evaluation Package](human_evaluation_package.md)
+- [Planner Recovery](planner_recovery.md)
+- [Roadmap](roadmap.md)
diff --git a/docs/engineering/planner_recovery.md b/docs/engineering/planner_recovery.md
@@ -1,3 +1,6 @@
+---
+---
+
 # Level 2 Sprint 2 -- Planner Recovery
 
 ## Mission
diff --git a/docs/engineering/roadmap.md b/docs/engineering/roadmap.md
@@ -1,3 +1,6 @@
+---
+---
+
 # Engineering Roadmap
 
 ## Current Sprint
diff --git a/docs/planner/goal_model.md b/docs/planner/goal_model.md
@@ -1,3 +1,6 @@
+---
+---
+
 # Goal Model for Level 2.4
 
 ## Purpose
diff --git a/docs/planner/index.md b/docs/planner/index.md
@@ -0,0 +1,10 @@
+---
+layout: default
+title: Planner
+---
+
+# Planner
+
+- [Goal Model](goal_model.md)
+- [Intent Taxonomy](intent_taxonomy.md)
+- [Planner Mapping](planner_mapping.md)
diff --git a/docs/planner/intent_taxonomy.md b/docs/planner/intent_taxonomy.md
@@ -1,3 +1,6 @@
+---
+---
+
 # Intent Taxonomy
 
 Derived from 114 prompts in the corpus (see `prompt_corpus.csv`).
diff --git a/docs/planner/planner_mapping.md b/docs/planner/planner_mapping.md
@@ -1,3 +1,6 @@
+---
+---
+
 # Planner Mapping: Goal → Strategy → Tools
 
 ## Current Flow (broken)
diff --git a/docs/proposals/controlled_edit_design.md b/docs/proposals/controlled_edit_design.md
@@ -1,3 +1,6 @@
+---
+---
+
 # [PROPOSAL: DESIGN ONLY - NOT YET IMPLEMENTED]
 
 # Controlled Edit Mode v1: Design Document
diff --git a/docs/proposals/controlled_edit_feasibility_report.md b/docs/proposals/controlled_edit_feasibility_report.md
@@ -1,3 +1,6 @@
+---
+---
+
 # [PROPOSAL: DESIGN ONLY - NOT YET IMPLEMENTED]
 
 # Controlled Edit Mode: Feasibility & Verification Report
diff --git a/docs/proposals/index.md b/docs/proposals/index.md
@@ -0,0 +1,9 @@
+---
+layout: default
+title: Proposals
+---
+
+# Proposals
+
+- [Controlled Edit Design](controlled_edit_design.md)
+- [Controlled Edit Feasibility Report](controlled_edit_feasibility_report.md)
diff --git a/docs/release/index.md b/docs/release/index.md
@@ -0,0 +1,10 @@
+---
+layout: default
+title: Release
+---
+
+# Release
+
+- [Planner Acceptance](planner_acceptance.md)
+- [Release Checklist](release_checklist.md)
+- [Release Readiness Report](release_readiness_report.md)
diff --git a/docs/release/planner_acceptance.md b/docs/release/planner_acceptance.md
@@ -1,3 +1,6 @@
+---
+---
+
 # Planner Acceptance Report
 
 > Release gate for the V2 planner architecture.
diff --git a/docs/release/release_checklist.md b/docs/release/release_checklist.md
@@ -1,3 +1,6 @@
+---
+---
+
 # Release Checklist
 
 This checklist gates every release of `cursor-agent`.
diff --git a/docs/release/release_readiness_report.md b/docs/release/release_readiness_report.md
@@ -1,3 +1,6 @@
+---
+---
+
 # Release Readiness Report
 
 **Date:** 2026-06-26  
diff --git a/docs/telemetry/architecture_query_failure_report.md b/docs/telemetry/architecture_query_failure_report.md
@@ -1,3 +1,6 @@
+---
+---
+
 # Architecture Query Failure Report
 
 **Date:** 2026-06-26  
diff --git a/docs/telemetry/ci_known_failures.md b/docs/telemetry/ci_known_failures.md
@@ -1,3 +1,6 @@
+---
+---
+
 # Known CI Test Failures
 
 These 8 `cursor-tester` scenarios fail consistently in CI.
diff --git a/docs/telemetry/commit_plan.md b/docs/telemetry/commit_plan.md
@@ -1,3 +1,6 @@
+---
+---
+
 # Commit Plan: Directory-Aware Find Engineering Cycle
 
 ## Files to Commit
diff --git a/docs/telemetry/directory_aware_find_report.md b/docs/telemetry/directory_aware_find_report.md
@@ -1,3 +1,6 @@
+---
+---
+
 # Directory-Aware Find: Implementation Report
 
 **Date:** 2026-06-26
diff --git a/docs/telemetry/failure_topology.md b/docs/telemetry/failure_topology.md
@@ -1,3 +1,6 @@
+---
+---
+
 # Failure Topology
 
 Telemetry analysis and engineering observations.
diff --git a/docs/telemetry/final_verification.md b/docs/telemetry/final_verification.md
@@ -1,3 +1,6 @@
+---
+---
+
 # Final Verification: Directory-Aware Find Shared Engine
 
 **Date:** 2026-06-26
diff --git a/docs/telemetry/find_implementation_audit.md b/docs/telemetry/find_implementation_audit.md
@@ -1,3 +1,6 @@
+---
+---
+
 # Find Implementation Audit
 
 ## 1. Locations
diff --git a/docs/telemetry/gist_sync_audit.md b/docs/telemetry/gist_sync_audit.md
@@ -1,3 +1,6 @@
+---
+---
+
 # Gist Synchronization Audit Report
 
 **Date:** 2026-06-26  
diff --git a/docs/telemetry/index.md b/docs/telemetry/index.md
@@ -0,0 +1,19 @@
+---
+layout: default
+title: Telemetry
+---
+
+# Telemetry
+
+- [Architecture Query Failure Report](architecture_query_failure_report.md)
+- [CI Known Failures](ci_known_failures.md)
+- [Commit Plan](commit_plan.md)
+- [Directory Aware Find Report](directory_aware_find_report.md)
+- [Failure Topology](failure_topology.md)
+- [Final Verification](final_verification.md)
+- [Find Implementation Audit](find_implementation_audit.md)
+- [Gist Sync Audit](gist_sync_audit.md)
+- [Next Capability Report](next_capability_report.md)
+- [Reference Search Report](reference_search_report.md)
+- [Search Correctness Report](search_correctness_report.md)
+- [UI Audit](ui_audit.md)
diff --git a/docs/telemetry/next_capability_report.md b/docs/telemetry/next_capability_report.md
@@ -1,3 +1,6 @@
+---
+---
+
 # Telemetry & Capability-Gap Report: Reference & Symbol Search
 
 **Date:** 2026-06-26  
diff --git a/docs/telemetry/reference_search_report.md b/docs/telemetry/reference_search_report.md
@@ -1,3 +1,6 @@
+---
+---
+
 # Reference Search: Implementation Report
 
 **Date:** 2026-06-26  
diff --git a/docs/telemetry/search_correctness_report.md b/docs/telemetry/search_correctness_report.md
@@ -1,3 +1,6 @@
+---
+---
+
 # Search Correctness Report
 
 **Generated:** 2026-06-26  
diff --git a/docs/telemetry/ui_audit.md b/docs/telemetry/ui_audit.md
@@ -1,3 +1,6 @@
+---
+---
+
 # UI Audit: Backend Capability → User Visibility
 
 **Date:** 2026-06-25
diff --git a/docs/ux/index.md b/docs/ux/index.md
@@ -0,0 +1,9 @@
+---
+layout: default
+title: UX
+---
+
+# UX
+
+- [Query Journey Audit](query_journey_audit.md)
+- [Review Terminal UX](review_terminal_ux.md)
diff --git a/docs/ux/query_journey_audit.md b/docs/ux/query_journey_audit.md
@@ -1,3 +1,6 @@
+---
+---
+
 # Query Journey Audit: 50 Developer Tasks
 
 **Date:** 2026-06-28  
diff --git a/docs/ux/review_terminal_ux.md b/docs/ux/review_terminal_ux.md
@@ -1,3 +1,6 @@
+---
+---
+
 # Level 2 UX Review: Terminal Experience
 
 **Date:** 2026-06-28  

-Original file line number
+Diff line change
@@ @@ -1,3 +1,6 @@ @@
 +---
 +---
++
 # Implementation Audit: Session Notes vs. Actual Code
 **Date:** 2026-06-25