Files
manual_slop/conductor/tracks.md
T
ed e5a8a84381 docs(conductor): type_aliases count, tracks.md stale rows, index.md guide count
- product-guidelines.md: '10 aliases' -> core + extended per-aggregate
  dataclasses (Metadata, CommsLogEntry, ... PathInfo, FileItemsDiff,
  JsonPrimitive/JsonValue) reflecting the actual ~19 types in
  src/type_aliases.py.
- tracks.md: marked rows 2 (qwen_llama_grok), 3 (data_oriented_error
  handling), 17 (code_path_audit) as Completed per chronology.md
  (they were stale 'in progress' / 'ready to start'). Added cleanup
  note. data_structure_strengthening already dropped.
- index.md: '27 deep-dive guides' -> 41 (actual count in docs/);
  refreshed last doc-refresh date to 2026-07-02 with the drift-fix
  summary.
2026-07-02 19:02:35 -04:00

9.6 KiB

Project Tracks

This file tracks all major tracks for the project. Each track has its own detailed plan in its respective folder (or in ../archive/<track_name>/ for completed tracks).

Structure:

  • Active Tracks (Current Queue): In-flight and unblocked work the implementer can pick up today.
  • Standby / Pending Spec: Tracks with spec TBD or pending decision.
  • Full project history: see chronology.md (the canonical index of all tracks: active, shipped, superseded, abandoned, sorted newest-first with git-history-evidence-backed status).

Archive directories live at ../archive/<track_name>/ (from this file's location at conductor/tracks.md).


Active Tracks (Current Queue)

Tracks that are unblocked and ready to start. Ordered by dependency (blocked-by first) and priority (A foundational → D forward-looking).

# Priority Track Status Blocked By
36 A (sunset) MMA Quarantine + RAG Test Decoupling spec ✓, plan pending (none)
2 A Qwen, Llama & Grok Vendor Integration Completed (per chronology.md; Phase 6 follow-up shipped) — row retained for cross-ref; archive candidate test_infrastructure_hardening_20260609 (merged)
3 A Data-Oriented Error Handling (Fleury Pattern) Completed (per chronology.md) — archive candidate test_infrastructure_hardening_20260609 (merged), qwen_llama_grok
4 A MCP Architecture Refactor (Sub-MCP Extraction) spec ✓, plan pending test_infrastructure_hardening_20260609 (merged), data_oriented_error_handling, data_structure_strengthening
16 A Test Sandbox Hardening spec ✓, plan ✓, ready to start (none)
17 A Code Path Audit Completed (per chronology.md) — archive candidate test_infrastructure_hardening_20260609 (merged), any_type_componentization (shipped), phase2_4_5_call_site_completion (shipped)
22b A Meta-Tooling Workflow Review spec ✓, plan ✓, parked (none)
23 A Intent-Based Scripting Languages Survey spec ✓, plan pending (none)
25 B Fable System Prompt Review spec ✓, plan pending (none)
26 A Video Analysis Campaign (Pass 1 of 3) scaffolded; awaiting Phase 0 tooling (none)
29 A Video Analysis De-obfuscation Campaign (Pass 2 of 3) scaffolded; awaits USER action item (none)
29c A Pass 3 — C11/Python Projection spec DRAFT pending user review deob_apply (shipped), lexicon_v2 (shipped), c11_reference (shipped)
7 — UI Polish (Five Issues) spec ✓, plan ✓, ready to start (none)
7c B SQLite-Granularity Inline Docs for ai_client.py spec ✓, plan ✓, ready to start (none)
19 — Context First Message Fix spec TBD (none)

Stale-row cleanup (2026-07-02): rows 2, 3, 17 marked Completed per conductor/chronology.md (which is the canonical status source). They are retained here as archive candidates pending a git mv to conductor/archive/. data_structure_strengthening_20260606 (also Completed per chronology) was already dropped from this table.

Track detail anchors

  • MMA Quarantine + RAG Test Decoupling → conductor/tracks/mma_quarantine_rag_test_decoupling_20260701/
  • Qwen, Llama & Grok Vendor Integration → conductor/tracks/qwen_llama_grok_integration_20260606/ (Phase 6 in progress)
  • Data-Oriented Error Handling → conductor/tracks/data_oriented_error_handling_20260606/
  • MCP Architecture Refactor → conductor/tracks/mcp_architecture_refactor_20260606/
  • Test Sandbox Hardening → conductor/tracks/test_sandbox_hardening_20260619/
  • Code Path Audit → conductor/tracks/code_path_audit_20260607/
  • Meta-Tooling Workflow Review → conductor/tracks/meta_tooling_workflow_review_20260620/
  • Intent-Based Scripting Languages Survey → conductor/tracks/intent_dsl_survey_20260612/
  • Fable System Prompt Review → conductor/tracks/fable_review_20260617/
  • Video Analysis Campaign (Pass 1) → conductor/tracks/video_analysis_campaign_20260621/
  • Video Analysis De-obfuscation (Pass 2) → conductor/tracks/video_analysis_deob_20260621/
  • Pass 3 — C11/Python Projection → conductor/tracks/video_analysis_deob_pass3_20260623/
  • UI Polish (Five Issues) → conductor/tracks/ (see spec for details)
  • SQLite-Granularity Inline Docs for ai_client.py → conductor/tracks/sqlite_docs_gui_2_continued_20260613/ (7c is the ai_client continuation)
  • Context First Message Fix → conductor/tracks/context_first_message_fix_20260604/

Standby / Pending Spec

# Priority Track Status Blocked By
6 D Public API Result Migration placeholder; not yet specced data_oriented_error_handling (deprecated send())
8 — Bootstrap gencpp Python Bindings spec TBD (none)
9 — Tree-Sitter Lua MCP Tools spec TBD (none)
10 — GDScript Language Support Tools spec TBD (none)
11 — C# Language Support Tools spec TBD (none)
12 — OpenAI Provider Integration spec TBD (none)
13 — Zhipu AI (GLM) Provider Integration spec TBD (none)
14 — AI Provider Caching Optimization spec TBD (none)
15 — Manual UX Validation & Review spec TBD (none)
15a — Manual UX Validation — ASCII-Sketch Workflow spec ✓, plan ✓, ready to start (none)
15b — Chunkification Optimization (Contingency) spec ✓ (contingency), no plan hard constraint surface (deferred)
16 — GenCpp Dogfood Feedback Loop spec TBD (none)
18 — GUI Architecture Refinement no spec.md (TBD)

Standby track anchors

  • Public API Result Migration → placeholder (not yet specced)
  • Bootstrap gencpp Python Bindings → conductor/tracks/gencpp_python_bindings_20260308/
  • Tree-Sitter Lua MCP Tools → conductor/tracks/tree_sitter_lua_mcp_tools_20260310/
  • GDScript Language Support Tools → conductor/tracks/gdscript_godot_script_language_support_tools_20260310/
  • C# Language Support Tools → conductor/tracks/csharp_language_support_tools_20260310/
  • OpenAI Provider Integration → conductor/tracks/openai_integration_20260308/
  • Zhipu AI (GLM) Provider Integration → conductor/tracks/zhipu_integration_20260308/
  • AI Provider Caching Optimization → conductor/tracks/caching_optimization_20260308/
  • Manual UX Validation & Review → conductor/tracks/manual_ux_validation_20260302/
  • Manual UX Validation — ASCII-Sketch Workflow → conductor/tracks/manual_ux_validation_20260608_PLACEHOLDER/
  • Chunkification Optimization (Contingency) → conductor/tracks/chunkification_optimization_20260608_PLACEHOLDER/
  • GenCpp Dogfood Feedback Loop → conductor/tracks/gencpp_dogfood_feedback_20260510/
  • GUI Architecture Refinement → (no spec.md)

Full project history: see chronology.md — the canonical index of all 244 tracks (active, shipped, superseded, abandoned), sorted newest-first, with git-history-evidence-backed status per row. Generated by scripts/audit/generate_chronology.py; quality-gated by scripts/audit/chronology_quality_gate.py.


Notes

Archive link convention: ./archive/... paths resolve to conductor/archive/... (this file is at conductor/tracks.md).

Status legend:

  • [ ] not started
  • [~] in progress
  • [x] completed (track may still be in tracks/ or may have been moved to archive/)
  • ~~**...**~~ struck-through (renamed/replaced/superseded)

Naming convention: Each track's spec.md and plan.md (where present) follow the project's standard format: spec.md for design intent (the "why"), plan.md for executable tasks (the "how").

Editing this file: When you mark a track as [x] and move its folder to archive/, remove its row from the Active Tracks table (its history is in chronology.md). When you start a new track, create the folder under tracks/ first, then add the entry to the Active Tracks table.

Archiving a track (3 steps): When a track ships and its folder moves from conductor/tracks/<id>/ to conductor/archive/<id>/, complete all 3 steps in order:

  1. Move the folder: git mv conductor/tracks/<id> conductor/archive/<id> (preserves history as a rename).
  2. Remove the row from this file (conductor/tracks.md).
  3. Run uv run python scripts/audit/generate_chronology.py --draft > conductor/chronology.md to regenerate the chronology (the new row appears automatically). Commit with docs(chronology): regenerate after <track-id> shipped. Run uv run python -m scripts.audit.chronology_quality_gate --strict before committing to verify the quality gate passes.