| Adr |
Table of contents for architecture/setup-tnh/adr |
2026-05-26 |
docs/architecture/setup-tnh/adr/index.md |
| Adr |
Table of contents for architecture/video-processing/adr |
2026-05-26 |
docs/architecture/video-processing/adr/index.md |
| Adr |
Table of contents for architecture/jvb-viewer/adr |
2026-05-26 |
docs/architecture/jvb-viewer/adr/index.md |
| Adr |
Table of contents for architecture/configuration/adr |
2026-05-26 |
docs/architecture/configuration/adr/index.md |
| Adr |
Table of contents for architecture/metadata/adr |
2026-05-26 |
docs/architecture/metadata/adr/index.md |
| Adr |
Table of contents for architecture/knowledge-base/adr |
2026-05-26 |
docs/architecture/knowledge-base/adr/index.md |
| Adr |
Table of contents for architecture/object-service/adr |
2026-05-26 |
docs/architecture/object-service/adr/index.md |
| Adr |
Table of contents for architecture/ytt-fetch/adr |
2026-05-26 |
docs/architecture/ytt-fetch/adr/index.md |
| Adr |
Table of contents for architecture/provenance/adr |
2026-05-26 |
docs/architecture/provenance/adr/index.md |
| Adr |
Table of contents for architecture/tnh-gen/adr |
2026-05-26 |
docs/architecture/tnh-gen/adr/index.md |
| Adr |
Table of contents for architecture/docs-system/adr |
2026-05-26 |
docs/architecture/docs-system/adr/index.md |
| Adr |
Table of contents for architecture/ai-text-processing/adr |
2026-05-26 |
docs/architecture/ai-text-processing/adr/index.md |
| Adr |
Table of contents for architecture/project-policies/adr |
2026-05-26 |
docs/architecture/project-policies/adr/index.md |
| Adr |
Table of contents for architecture/prompt-system/adr |
2026-05-26 |
docs/architecture/prompt-system/adr/index.md |
| Adr |
Table of contents for architecture/agent-orchestration/adr |
2026-05-26 |
docs/architecture/agent-orchestration/adr/index.md |
| Adr |
Table of contents for architecture/transcription/adr |
2026-05-26 |
docs/architecture/transcription/adr/index.md |
| Adr |
Table of contents for architecture/gen-ai-service/adr |
2026-05-26 |
docs/architecture/gen-ai-service/adr/index.md |
| ADR-A01: Adopt Object-Service for GenAI Interactions |
Standardizes GenAI interactions with an Object-Service pattern that separates domain shapes from provider orchestration. |
2025-11-15 |
docs/architecture/gen-ai-service/adr/adr-a01-object-service-genai.md |
| ADR-A02: PatternCatalog Integration (V1) |
Describes the V1 contract for plugging the legacy PatternCatalog into GenAI Service via rendered system prompts. |
2025-11-15 |
docs/architecture/gen-ai-service/adr/adr-a02-patterncatalog-integration-v1.md |
| ADR-A08: Configuration / Parameters / Policy Taxonomy |
Establishes the Config/Params/Policy taxonomy for GenAI Service to prevent parameter soup and clarify ownership. |
2025-11-15 |
docs/architecture/gen-ai-service/adr/adr-a08-config-params-policy-taxonomy.md |
| ADR-A09: V1 Simplified Implementation Pathway |
Defines the minimum viable GenAI Service implementation that preserves architectural seams while shipping quickly. |
2025-11-15 |
docs/architecture/gen-ai-service/adr/adr-a09-v1-simplified.md |
| ADR-A11: Model Parameters and Strong Typing Fix |
Enforces typed parameter objects and removes literals from GenAI Service so provider flows stay consistent. |
2025-11-15 |
docs/architecture/gen-ai-service/adr/adr-a11-model-parameters-fix.md |
| ADR-A12: Prompt System & Fingerprinting Architecture (V1) |
Replaces the Pattern Catalog adapter with a Prompt-first design that yields domain objects plus fingerprints. |
2025-02-04 |
docs/architecture/gen-ai-service/adr/adr-a12-prompt-system-fingerprinting-v1.md |
| ADR-A13: Migrate All OpenAI Interactions to GenAIService |
Retires the legacy OpenAI client and standardizes every caller on the typed GenAI Service pipeline. |
2025-11-17 |
docs/architecture/gen-ai-service/adr/adr-a13-migrate-openai-to-genaiservice.md |
| ADR-A14.1: Registry Staleness Detection and User Warnings |
Implements staleness detection for OpenAI pricing data with configurable warnings and CLI tooling |
2026-01-01 |
docs/architecture/gen-ai-service/adr/adr-a14.1-registry-staleness-detection.md |
| ADR-A14: File-Based Registry System for Provider Metadata |
Establishes a JSONC-based registry system for model capabilities, pricing, and provider metadata with auto-update mechanisms, aligned with VS Code's native configuration format. |
2025-12-10 |
docs/architecture/gen-ai-service/adr/adr-a14-file-based-registry-system.md |
| ADR-A15: Thread Safety and Rate Limiting |
Implements thread-safe GenAIService operations and provider-aware rate limiting for concurrent and batch processing scenarios. |
2025-12-23 |
docs/architecture/gen-ai-service/adr/adr-a15-thread-safety-rate-limiting.md |
| ADR-AT01: AI Text Processing Pipeline Redesign |
Defines the modular TextObject pipeline, metadata handling, and configuration strategy for AI processing. |
2025-02-26 |
docs/architecture/ai-text-processing/adr/adr-at01-ai-text-processing.md |
| ADR-AT02: TextObject Architecture Decision Records |
Captures the historical TextObject design comparisons and links to the original/new design documents. |
2025-02-01 |
docs/architecture/ai-text-processing/adr/adr-at02-sectioning-textobject.md |
| ADR-AT03.1: AT03→AT04 Transition Plan |
Phased transition strategy: minimal refactor (AT03) for tnh-gen release, followed by comprehensive platform (AT04) |
2025-12-12 |
docs/architecture/ai-text-processing/adr/adr-at03.1-transition-plan.md |
| ADR-AT03.2: NumberedText Section Boundary Validation |
Adds robust validation, coverage reporting, and gap/overlap detection to NumberedText to support reliable sectioning in ai_text_processing |
2025-12-12 |
docs/architecture/ai-text-processing/adr/adr-at03.2-numberedtext-validation.md |
| ADR-AT03.3: TextObject Robustness and Metadata Management |
Fixes metadata propagation bugs, enhances section validation, and adds merge strategies to TextObject for reliable ai_text_processing workflows |
2025-12-12 |
docs/architecture/ai-text-processing/adr/adr-at03.3-textobject-robustness.md |
| ADR-AT03: Minimal AI Text Processing Refactor for tnh-gen |
Focused refactor of ai_text_processing module to support tnh-gen CLI release: TextObject robustness, GenAI Service integration, and basic prompt system adoption |
2025-12-07 |
docs/architecture/ai-text-processing/adr/adr-at03-object-service-refactor.md |
| ADR-AT04: AI Text Processing Platform Strategy |
Platform architecture for extensible, evaluation-driven text processing with strategy polymorphism and context fidelity |
2025-12-11 |
docs/architecture/ai-text-processing/adr/adr-at04-ai-text-processing-platform-strat.md |
| ADR-CF01: Runtime Context & Configuration Strategy |
Establishes unified project-wide strategy for configuration layers, data scoping, and runtime context resolution across all TNH Scholar subsystems |
2025-12-31 |
docs/architecture/configuration/adr/adr-cf01-runtime-context-strategy.md |
| ADR-CF02: Prompt Catalog Discovery Strategy |
Extends TNHContext three-layer model to prompt catalog path resolution, replacing hard-coded module constants. |
2026-02-05 |
docs/architecture/configuration/adr/adr-cf02-prompt-catalog-discovery.md |
| ADR-DD01: Documentation System Reorganization Strategy |
Rebuilds the documentation architecture with new directories, automation, and Prompt terminology. |
2024-11-09 |
docs/architecture/docs-system/adr/adr-dd01-docs-reorg-strategy.md |
| ADR-DD02: Documentation Main Content and Navigation Strategy |
Defines content architecture, sync mechanisms, and navigation patterns for README.md, docs/index.md, and filesystem-driven documentation. |
2025-11-23 |
docs/architecture/docs-system/adr/adr-dd02-main-content-nav.md |
| ADR-DD03: Pattern to Prompt Terminology Standardization |
Standardizes documentation terminology from 'Pattern' to 'Prompt' to align with industry conventions and gen-ai-service refactoring. |
2025-11-28 |
docs/architecture/docs-system/adr/adr-dd03-pattern-to-prompt.md |
| ADR-DD03: Phase 1 Execution Punch List |
Pre-merge checklist to complete Pattern→Prompt terminology updates and related navigation changes. |
2025-11-28 |
docs/architecture/docs-system/adr/adr-dd03-phase1-punchlist.md |
| ADR-JV03: Canonical XML AST for English Parsing |
Establishes canonical XML AST structure for JVB viewer English text parsing and rendering |
2025-09-07 |
docs/architecture/jvb-viewer/adr/adr-jv03-canonical-xml-ast.md |
| ADR-JVB01: JVB Parallel Viewer v1 As-Built |
As-built architecture documentation for JVB parallel viewer v1 bilingual journal interface |
2025-12-12 |
docs/architecture/jvb-viewer/adr/adr-jvb01_as-built_jvb_viewer_v1.md |
| ADR-K01: Preliminary Architectural Strategy for TNH Scholar Knowledge Base |
Proposes a phased managed-to-open-source knowledge base rollout to validate retrieval before scaling. |
2025-11-15 |
docs/architecture/knowledge-base/adr/adr-k01-kb-architecture-strategy.md |
| ADR-MD01: Adoption of JSON-LD for Metadata Management |
Chooses JSON-LD as the canonical metadata format to capture provenance, relationships, and future semantic queries. |
2025-02-01 |
docs/architecture/metadata/adr/adr-md01-json-ld-metadata.md |
| ADR-MD02: Metadata Infrastructure Object-Service Integration |
Defines metadata system's role as foundational infrastructure in the object-service architecture, establishing patterns for cross-layer usage and ensuring compliance with design principles. |
2025-12-07 |
docs/architecture/metadata/adr/adr-md02-metadata-object-service-integration.md |
| ADR-OA01.1: TNH-Conductor — Provenance-Driven AI Workflow Coordination (v2) |
Strategic architecture for coordinating external AI agents through bounded, auditable, human-supervised workflows with CLI opcode tooling |
2026-01-29 |
docs/architecture/agent-orchestration/adr/adr-oa01.1-conductor-strategy-v2.md |
| ADR-OA01.2: Conceptual Spike for Orientation-Based Supervisory Orchestration |
Strategy-level spike direction for testing orientation-based supervisory orchestration as an alternative to engine-first workflow control. |
2026-04-11 |
docs/architecture/agent-orchestration/adr/adr-oa01.2-conceptual-spike-orientation-based-supervisory-orchestration.md |
| ADR-OA01.3: Practical Approach for the Orientation-Based Conceptual Spike |
Practical approach for testing the OA01.2 orientation-based collaboration hypothesis with minimal new code and explicit prerequisite spike work. |
2026-04-11 |
docs/architecture/agent-orchestration/adr/adr-oa01.3-conceptual-spike-practical-approach.md |
| ADR-OA01.4: Headless Agent Communication Functional Spike |
Prerequisite functional spike for proving that structured headless communication between supervising and worker agents can happen simply and repeatably enough to support the OA01.2 conceptual spike. |
2026-04-11 |
docs/architecture/agent-orchestration/adr/adr-oa01.4-headless-agent-communication-functional-spike.md |
| ADR-OA01: TNH-Conductor — Provenance-Driven AI Workflow Coordination |
Strategic architecture for coordinating external AI agents (Claude Code, Codex) through bounded, auditable, human-supervised workflows |
2026-01-14 |
docs/architecture/agent-orchestration/adr/adr-oa01-agent-orchestration-strategy.md |
| ADR-OA02: Phase 0 Protocol Layer Spike — Headless Capture + Safety Controls |
De-risking spike to prove headless agent capture and safety controls for tnh-conductor |
2026-01-19 |
docs/architecture/agent-orchestration/adr/adr-oa02-phase-0-protocol-spike.md |
| ADR-OA03.1: Claude Code Runner |
Claude Code execution path — headless print mode only, no interactive/PTY automation |
2026-01-22 |
docs/architecture/agent-orchestration/adr/adr-oa03.1-claude-code-runner.md |
| ADR-OA03.2: Codex Runner |
Codex execution path — API-first, tool-driven runner for implementation tasks |
2026-01-22 |
docs/architecture/agent-orchestration/adr/adr-oa03.2-codex-runner.md |
| ADR-OA03.3: Codex CLI Runner |
Codex execution path via CLI — headless exec mode, superseding API-based approach |
2026-02-07 |
docs/architecture/agent-orchestration/adr/adr-oa03.3-codex-cli-runner.md |
| ADR-OA03: Agent Runner Architecture |
Phase 1 architecture for agent execution — kernel + adapter pattern based on OA02 spike learnings |
2026-01-21 |
docs/architecture/agent-orchestration/adr/adr-oa03-agent-runner-architecture.md |
| ADR-OA04.1: MVP Runtime Build-Out Sequence |
Implementation-guide addendum for OA04 defining the MVP runtime build order, role split, and handoff to OA07 bootstrap workspace work. |
2026-02-10 |
docs/architecture/agent-orchestration/adr/adr-oa04.1-implementation-notes-mvp-buildout.md |
| ADR-OA04.2: Runner Contract |
Defines the maintained RUN_AGENT request/result, artifact, and normalization contract for Claude CLI and Codex CLI adapters. |
2026-03-26 |
docs/architecture/agent-orchestration/adr/adr-oa04.2-runner-contract.md |
| ADR-OA04.3.1: Run Transparency and State Reporting |
Adds a maintained operator-facing status contract on top of the OA04.3 run-artifact model for live monitoring of headless workflow runs. |
2026-04-16 |
docs/architecture/agent-orchestration/adr/adr-oa04.3.1-run-transparency-and-state-reporting.md |
| ADR-OA04.3: Provenance and Run-Artifact Contract |
Defines the maintained run directory, artifact manifest, and event/provenance handoff contract for workflow execution. |
2026-03-27 |
docs/architecture/agent-orchestration/adr/adr-oa04.3-provenance-run-artifact-contract.md |
| ADR-OA04.4: Policy Enforcement Contract |
Defines the shared permissibility model, native-control mapping boundary, and violation handling contract for workflow execution. |
2026-03-27 |
docs/architecture/agent-orchestration/adr/adr-oa04.4-policy-enforcement-contract.md |
| ADR-OA04.5: Harness Backend Contract |
Defines the maintained backend contract for executing generated and predefined validation harnesses under RUN_VALIDATION. |
2026-03-27 |
docs/architecture/agent-orchestration/adr/adr-oa04.5-harness-backend-contract.md |
| ADR-OA04: Workflow Execution Contracts |
Defines the canonical workflow document format, opcode semantics, and execution-contract foundation for tnh-conductor runtime implementation. |
2026-02-09 |
docs/architecture/agent-orchestration/adr/adr-oa04-workflow-schema-opcode-semantics.md |
| ADR-OA05: Prompt Library Specification |
Defines prompt artifact schema, versioning, rendering, and catalog validation contracts for tnh-conductor prompt-program behavior. |
2026-02-09 |
docs/architecture/agent-orchestration/adr/adr-oa05-prompt-library-specification.md |
| ADR-OA06.1: Evaluator-Directed Revision Loop |
Defines a bounded maintained review-to-revision loop for conductor workflows so review and validation artifacts can drive one deterministic refinement pass. |
2026-04-16 |
docs/architecture/agent-orchestration/adr/adr-oa06.1-evaluator-directed-revision-loop.md |
| ADR-OA06: Planner Evaluator Contract |
Defines planner evaluator I/O schemas, status derivation, contradiction rules, and deterministic decision vectors for EVALUATE steps. |
2026-02-09 |
docs/architecture/agent-orchestration/adr/adr-oa06-planner-evaluator-contract.md |
| ADR-OA07.1: Worktree Lifecycle and Rollback |
Bootstrap implementation guide for managed worktree creation, run-directory separation, and branch-scoped rollback in maintained agent orchestration. |
2026-04-05 |
docs/architecture/agent-orchestration/adr/adr-oa07.1-worktree-lifecycle-and-rollback.md |
| ADR-OA07: Diff-Policy + Safety Rails |
Defines the bootstrap safety model for worktree isolation, branch-scoped rollback, and agent authority boundaries in maintained agent orchestration. |
2026-04-05 |
docs/architecture/agent-orchestration/adr/adr-oa07-diff-policy-safety-rails.md |
| ADR-OS01: Object-Service Design Architecture V3 |
Establishes layered architecture for complex objects and API-backed services across TNH Scholar, defining clear boundaries between domain, service, and transport layers. |
2025-10-24 |
docs/architecture/object-service/adr/adr-os01-object-service-architecture-v3.md |
| ADR-PP01: Rapid Prototype Versioning Policy |
Establishes versioning policy for TNH Scholar during 0.x releases, allowing breaking changes in any release to enable fast iteration and architectural improvements. |
2025-12-06 |
docs/architecture/project-policies/adr/adr-pp01-rapid-prototype-versioning.md |
| ADR-PT03: Prompt System Current Status & Roadmap |
Current as-built status of the TNH Scholar prompt system, documentation terminology standardization, and planned enhancements. |
2025-11-29 |
docs/architecture/prompt-system/adr/adr-pt03-prompt-system-status-roadmap.md |
| ADR-PT04: Prompt System Refactor Plan (Revised) |
Refactors the legacy pattern-based prompt system into a modular, object-service compliant PromptCatalog with validation, transport isolation, and clean dependency injection seams. |
2025-12-05 |
docs/architecture/prompt-system/adr/adr-pt04-prompt-system-refactor.md |
| ADR-PT05.1: Prototype Prompt Workspace Simplification |
Defines the active prototype prompt storage model around a tracked repo-local workspace and deprecates the external shared prompt-repo path for current TNH Scholar operations. |
2026-05-05 |
docs/architecture/prompt-system/adr/adr-pt05.1-prototype-prompt-workspace-simplification.md |
| ADR-PT05: Prompt Platform Strategy |
Establishes TNH Scholar's prompt platform architecture for multi-module prompt libraries, schema layering, and robust client integration. |
2026-02-15 |
docs/architecture/prompt-system/adr/adr-pt05-prompt-platform-strategy.md |
| ADR-PV01: Provenance & Tracing Infrastructure Strategy |
Establishes unified cross-cutting infrastructure for tracking data lineage, request tracing, and operation provenance across all TNH Scholar layers |
2025-12-19 |
docs/architecture/provenance/adr/adr-pv01-provenance-tracing-strat.md |
| ADR-ST01.1: tnh-setup UI Design |
Design proposal for a polished, stylized CLI experience for tnh-setup. |
2026-02-03 |
docs/architecture/setup-tnh/adr/adr-st01.1-tnh-setup-ui-design.md |
| ADR-ST01: tnh-setup Runtime Hardening |
Harden tnh-setup to ensure yt-dlp runtime readiness and clearer environment verification. |
2026-02-02 |
docs/architecture/setup-tnh/adr/adr-st01-tnh-setup-runtime-hardening.md |
| ADR-TG01.1: Human-Friendly CLI Defaults with --api Flag |
Default to human-readable output for CLI usage, with --api flag for machine-readable contract output |
2025-12-23 |
docs/architecture/tnh-gen/adr/adr-tg01.1-human-friendly-defaults.md |
| ADR-TG01: tnh-gen CLI Architecture |
Core command structure, error handling, and configuration for the unified TNH Scholar CLI tool |
2025-12-07 |
docs/architecture/tnh-gen/adr/adr-tg01-cli-architecture.md |
| ADR-TG02: TNH-Gen CLI Prompt System Integration |
Integration pattern for tnh-gen CLI with prompt system via PromptsAdapter |
2025-12-07 |
docs/architecture/tnh-gen/adr/adr-tg02-prompt-integration.md |
| ADR-TG03: Typed Completion Outcome and Adapter Diagnostics |
Normalize transport failure states into a typed domain outcome envelope and structured adapter diagnostics for observable, reliable generation results |
2026-04-16 |
docs/architecture/tnh-gen/adr/adr-tg03-completion-contract.md |
| ADR-TG04.1: JSON Contract Runtime Validation |
Define the runtime contract for resolving schema_ref, validating JSON prompt outputs, mapping failures, and serializing structured results in tnh-gen. |
2026-04-30 |
docs/architecture/tnh-gen/adr/adr-tg04.1-json-contract-runtime-validation.md |
| ADR-TG04.2: Structured JSON Provenance Sidecars |
Clarify how tnh-gen preserves first-class provenance for structured JSON outputs without violating JSON artifact purity. |
2026-05-01 |
docs/architecture/tnh-gen/adr/adr-tg04.2-structured-json-provenance-sidecars.md |
| ADR-TG04.3: Structured Output Trust Boundaries and Control Surfaces |
Define how tnh-gen and downstream consumers should treat model-produced structured data, distinguish artifact contracts from control contracts, and prefer deterministic control outside AI-generated payloads. |
2026-05-03 |
docs/architecture/tnh-gen/adr/adr-tg04.3-structured-output-trust-boundaries.md |
| ADR-TG04: Structured JSON Contract and Scope Boundaries |
Define tnh-gen as a prompt-agnostic execution substrate, separate it from higher-level semantic processing and orchestration, and establish the scope for structured JSON contracts. |
2026-04-30 |
docs/architecture/tnh-gen/adr/adr-tg04-structured-json-contract-and-scope.md |
| ADR-TR01: AssemblyAI Integration for Transcription Service |
Introduces a pluggable transcription interface with AssemblyAI and Whisper providers. |
2025-05-01 |
docs/architecture/transcription/adr/adr-tr01-assemblyai-integration.md |
| ADR-TR02: Optimized SRT Generation Design |
Uses provider-native SRT generation to simplify the transcription pipeline. |
2025-05-01 |
docs/architecture/transcription/adr/adr-tr02-optimized-srt-design.md |
| ADR-TR03: Standardizing Timestamps to Milliseconds |
Aligns all transcription providers on millisecond timestamps to avoid float drift. |
2025-05-01 |
docs/architecture/transcription/adr/adr-tr03-ms-timestamps.md |
| ADR-TR04: AssemblyAI Service Implementation Improvements |
Refactors the AssemblyAI adapter to use the official SDK, richer options, and better error handling. |
2025-05-01 |
docs/architecture/transcription/adr/adr-tr04-assemblyai-improvements.md |
| ADR-TR05.1: Speaker-Block Language Lock Default Strategy |
Defines the default multilingual segmentation strategy as contiguous-speaker language locking with selective translation. |
2026-03-01 |
docs/architecture/transcription/adr/adr-tr05.1-speaker-block-language-lock-default.md |
| ADR-TR05.2: MVP Service Scaffold for Multilingual Transcription |
Defines an in-place refactor of the existing audio_processing stack for the multilingual transcription MVP. |
2026-03-01 |
docs/architecture/transcription/adr/adr-tr05.2-mvp-service-scaffold.md |
| ADR-TR05: Language-Aware Multilingual Transcription Engine |
Adopts language-aware segmentation and merge-first orchestration for multilingual audio transcription and English subtitle generation. |
2026-03-01 |
docs/architecture/transcription/adr/adr-tr05-language-aware-multilingual-transcription-engine.md |
| ADR-VP01: Video Processing Return Types and Configuration |
Centralizes yt-dlp configuration and return types so video tooling emits consistent metadata. |
2025-02-01 |
docs/architecture/video-processing/adr/adr-vp01-video-processing.md |
| ADR-VP02: yt-dlp Operational Strategy |
Operational strategy for yt-dlp coupling, runtime injection, and continuous testing. |
2026-02-06 |
docs/architecture/video-processing/adr/adr-vp02-ytdlp-operational-strategy.md |
| ADR-VSC01: VS Code Integration Strategy (TNH-Scholar Extension v0.1.0) |
Strategy ADR defining a CLI-first VS Code integration built on the unified tnh-gen interface for extension v0.1.0. |
2025-01-28 |
docs/architecture/ui-ux/vs-code-integration/adr-vsc01-vscode-integration-strategy.md |
| ADR-VSC02: VS Code Extension Architecture |
VS Code extension architecture for consuming tnh-gen CLI - components, flow of control, and data contracts |
2025-01-28 |
docs/architecture/ui-ux/vs-code-integration/adr-vsc02-tnh-gen-cli-implementation.md |
| ADR-VSC03.2: Real-World Survey Addendum (VS Code as a UI/UX Platform) |
Online survey of existing systems and patterns that de-risk Python↔TypeScript boundaries for TNH-Scholar's VS Code UI/UX strategy |
2025-12-12 |
docs/architecture/ui-ux/vs-code-integration/adr-vsc03.2-real-world-survey-addendum.md |
| ADR-VSC03.3: Investigation Synthesis - Validation of Design Choices |
Synthesis of real-world survey findings validating TNH Scholar's VS Code integration strategy and design decisions |
2025-12-12 |
docs/architecture/ui-ux/vs-code-integration/adr-vsc03.3-investigation-synthesis.md |
| ADR-VSC03: Preliminary Investigation Findings |
Phase 1 research findings on Python-JavaScript impedance mitigation strategies |
2025-12-12 |
docs/architecture/ui-ux/vs-code-integration/adr-vsc03.1-findings.md |
| ADR-VSC03: Python-JavaScript Impedance Mismatch Investigation |
Decision to investigate architectural strategies for mitigating Python-JavaScript platform mismatch in VS Code integration |
2025-12-12 |
docs/architecture/ui-ux/vs-code-integration/adr-vsc03-python-javascript-impedance-investigation.md |
| ADR-YF00: Early yt-fetch Transcript Decisions (Historical) |
Consolidates the original transcript ADR notes for yt-fetch before they were split into discrete records. |
2025-01-17 |
docs/architecture/ytt-fetch/adr/adr-yf00-early-decisions.md |
| ADR-YF01: YouTube Transcript Source Handling |
Documents how yt-fetch prioritizes manual subtitles while accepting auto captions for maximum coverage. |
2025-01-21 |
docs/architecture/ytt-fetch/adr/adr-yf01-yt-transcript-source-handling.md |
| ADR-YF02: YouTube Transcript Format Selection |
Locks yt-fetch to a single transcript format (initially VTT) for predictable downstream processing. |
2025-01-21 |
docs/architecture/ytt-fetch/adr/adr-yf02-yt-transcript-format-selection.md |
| Agent Orchestration |
Table of contents for architecture/agent-orchestration |
2026-05-26 |
docs/architecture/agent-orchestration/index.md |
| Agent Orchestration Collaboration Paradigms |
Blue-sky research note framing the orchestration problem space for multi-agent coding and design collaboration across time, scope, and model families. |
2026-04-16 |
docs/architecture/agent-orchestration/notes/research/agent-orchestration-collaboration-paradigms.md |
| Agent Orchestration Recursive Bootstrap Proposal |
Working draft for release framing of tnh-conductor and the post-bootstrap build sequence toward long-horizon multi-agent engineering. |
2026-04-24 |
docs/architecture/agent-orchestration/notes/design/recursive-bootstrap-build-proposal.md |
| Agent Orchestration Spike Testing Sequence |
Concise, unambiguous steps to run the Codex CLI spike in a sandbox worktree. |
2026-02-08 |
docs/architecture/agent-orchestration/notes/experiments/spike-testing-sequence.md |
| Ai Text Processing |
Table of contents for architecture/ai-text-processing |
2026-05-26 |
docs/architecture/ai-text-processing/index.md |
| Architecture |
Table of contents for architecture |
2026-05-26 |
docs/architecture/index.md |
| Architecture Blueprint |
High-level blueprint of the agent orchestration system, its maintained core subsystems, and the current flow of control. |
2026-04-10 |
docs/architecture/agent-orchestration/notes/design/architecture-blueprint.md |
| Architecture Overview |
High-level conceptual view of TNH Scholar's layered, object-service oriented architecture with links to detailed design documents and ADRs. |
2025-12-02 |
docs/architecture/overview.md |
| Audio Chunking Algorithm Design Document |
Design for splitting diarization segments into five-minute audio chunks using greedy accumulation and speaker-aware boundaries. |
2025-05-01 |
docs/architecture/transcription/design/audio-chunking-design.md |
| Bootstrap Proof |
Table of contents for architecture/agent-orchestration/bootstrap-proof |
2026-05-26 |
docs/architecture/agent-orchestration/bootstrap-proof/index.md |
| Bootstrap Proof Run Result |
Concise record of the first maintained bootstrap proof execution, observed issues, and design implications. |
2026-04-10 |
docs/architecture/agent-orchestration/notes/experiments/bootstrap-proof-run-result.md |
| Cloud Run Artifacts |
Table of contents for architecture/agent-orchestration/notes/experiments/cloud-run-artifacts |
2026-05-26 |
docs/architecture/agent-orchestration/notes/experiments/cloud-run-artifacts/index.md |
| Codex Harness End-to-End Test Report |
Operational notes and blockers for the Codex harness test flow |
2026-01-23 |
docs/architecture/agent-orchestration/notes/experiments/codex-harness-e2e-report.md |
| Codex Harness Spike Findings |
Comprehensive findings from the Codex API harness spike - constraints, learnings, and recommendations |
2026-01-25 |
docs/architecture/agent-orchestration/notes/experiments/codex-harness-spike-findings.md |
| Codex Headless Communication Experiment Plan |
Practical next-step experiment plan for Codex headless communication, incorporating research findings while explicitly bracketing premature directions. |
2026-04-12 |
docs/architecture/agent-orchestration/notes/experiments/codex-headless-communication-experiment-plan.md |
| Codex Headless Communication Report |
Consolidated report on direct headless Codex communication experiments, observed errors, and the currently viable invocation pathway. |
2026-04-12 |
docs/architecture/agent-orchestration/notes/experiments/codex-headless-communication-report.md |
| Codex Headless Communication Research Directions |
Brief next-step research directions following the first successful headless Codex communication experiments. |
2026-04-12 |
docs/architecture/agent-orchestration/notes/research/codex-headless-communication-research-directions.md |
| Codex Headless Research Memo for Engineer Agents |
Official-surface findings and recommended work for Codex headless and multi-agent collaboration research. |
2026-04-12 |
docs/architecture/agent-orchestration/notes/research/codex-headless-research-memo-for-engineer-agents.md |
| Codex Official Docs Reference Summary |
Local reference summary of the most relevant current official Codex docs for headless communication, configuration, auth, and built-in collaboration surfaces. |
2026-04-12 |
docs/architecture/agent-orchestration/notes/research/codex-official-docs-reference-summary.md |
| Configuration |
Table of contents for architecture/configuration |
2026-05-26 |
docs/architecture/configuration/index.md |
| Current Bootstrap Proof Task Brief |
Task brief consumed by the generic bootstrap-proof workflow. |
2026-04-10 |
docs/architecture/agent-orchestration/bootstrap-proof/current-task-brief.md |
| Current Supervisory Task Brief |
Current task brief for the shell-launched supervisory team experiment. |
2026-04-13 |
docs/architecture/agent-orchestration/supervisory-shell-trial/current-supervisory-task-brief.md |
| Design |
Table of contents for architecture/setup-tnh/design |
2026-05-26 |
docs/architecture/setup-tnh/design/index.md |
| Design |
Table of contents for architecture/jvb-viewer/design |
2026-05-26 |
docs/architecture/jvb-viewer/design/index.md |
| Design |
Table of contents for architecture/ytt-fetch/design |
2026-05-26 |
docs/architecture/ytt-fetch/design/index.md |
| Design |
Table of contents for architecture/utilities/design |
2026-05-26 |
docs/architecture/utilities/design/index.md |
| Design |
Table of contents for architecture/docs-system/design |
2026-05-26 |
docs/architecture/docs-system/design/index.md |
| Design |
Table of contents for architecture/ai-text-processing/design |
2026-05-26 |
docs/architecture/ai-text-processing/design/index.md |
| Design |
Table of contents for architecture/agent-orchestration/notes/design |
2026-05-26 |
docs/architecture/agent-orchestration/notes/design/index.md |
| Design |
Table of contents for architecture/transcription/design |
2026-05-26 |
docs/architecture/transcription/design/index.md |
| Design |
Table of contents for architecture/gen-ai-service/design |
2026-05-26 |
docs/architecture/gen-ai-service/design/index.md |
| Design |
Table of contents for architecture/ui-ux/design |
2026-05-26 |
docs/architecture/ui-ux/design/index.md |
| Design Memo: Re-centering Agent Orchestration on Bootstrap and Long-Horizon Useful Work |
Directional memo for agent orchestration design after the bootstrap threshold. |
2026-04-09 |
docs/architecture/agent-orchestration/notes/design/bootstrap-direction-design-memo.md |
| Design Strategy: VS Code as UI/UX Platform for TNH Scholar |
--- |
2025-11-15 |
docs/architecture/ui-ux/design/vs-code-as-ui-platform.md |
| Diarization Algorithms |
This document details the key algorithms in the diarization system, focusing on high-level design without implementation details. Each algorithm is presented with its inputs, outputs, and process flow. |
2025-05-01 |
docs/architecture/transcription/design/diarization-algorithms.md |
| Diarization Chunker Module Design Strategy |
I've analyzed the current system and PoC code to propose a modular, extensible design for integrating the diarization chunking functionality into your tnh-scholar project. |
2025-05-05 |
docs/architecture/transcription/design/diarization-chunker-design.md |
| Diarization System Design |
Detailed architecture for the diarization pipeline, covering segmentation, track extraction, and transcript remapping. |
2025-05-01 |
docs/architecture/transcription/design/diarization-system-design.md |
| Docs System |
Table of contents for architecture/docs-system |
2026-05-26 |
docs/architecture/docs-system/index.md |
| Documentation Design |
Reference for the documentation stack, covering tooling choices, information architecture, and publishing workflow. |
2025-01-19 |
docs/architecture/docs-system/design/documentation-design.md |
| Example Agent Workflow |
Example multi-agent workflow preserved as a reference for agent-orchestration design and future automation. |
2025-12-28 |
docs/architecture/agent-orchestration/example-agent-workflow.md |
| Experiments |
Table of contents for architecture/agent-orchestration/notes/experiments |
2026-05-26 |
docs/architecture/agent-orchestration/notes/experiments/index.md |
| Gen Ai Service |
Table of contents for architecture/gen-ai-service |
2026-05-26 |
docs/architecture/gen-ai-service/index.md |
| GenAI Service — Design Strategy |
Strategy for unifying GenAI Service capabilities, personas, and phased releases. |
2025-11-15 |
docs/architecture/gen-ai-service/design/genai-service-design-strategy.md |
| Generate Markdown Translation JSON Pairs |
Instructions for producing paired Vietnamese-English Markdown JSON lines from scanned journal pages with strict formatting. |
2025-11-15 |
docs/architecture/jvb-viewer/design/generate-md-translation-json-pairs.md |
| Generate Markdown Vietnamese |
Guidelines for rewriting Vietnamese journal pages into structured Markdown with one sentence per line and preserved metadata. |
2025-11-15 |
docs/architecture/jvb-viewer/design/generate-md-vietnamese.md |
| Interval-to-Segment Mapping Algorithm |
Algorithm for mapping chunk-relative transcription intervals back to diarization segments using overlap and proximity. |
2025-05-08 |
docs/architecture/transcription/design/interval-to-segment-mapping.md |
| Jvb Viewer |
Table of contents for architecture/jvb-viewer |
2026-05-26 |
docs/architecture/jvb-viewer/index.md |
| JVB Viewer — Version 2 Strategy & High‑Level Design |
Strategy for a projection-first VS Code-based viewer/editor that reconciles OCR outputs into a canonical JSON artifact. |
2025-11-15 |
docs/architecture/jvb-viewer/design/jvb-viewer-v2-strategy.md |
| Knowledge Base |
Table of contents for architecture/knowledge-base |
2026-05-26 |
docs/architecture/knowledge-base/index.md |
| Language-Aware Chunking Orchestrator Notes |
Working notes for extending the DiarizationChunker orchestrator with language-aware strategies. |
2025-06-24 |
docs/architecture/transcription/design/language-aware-chunking-orchestrator-notes.md |
| LUÂN-HỒI |
Transcribed Markdown sample of the 'Luân-Hồi Một Thực-Thể' article used to validate viewer output. |
2025-11-15 |
docs/architecture/jvb-viewer/design/luan-hoi.md |
| Metadata |
Table of contents for architecture/metadata |
2026-05-26 |
docs/architecture/metadata/index.md |
| minimal but extensible setup tool for the prototyping phase |
Core Requirements: |
2025-01-21 |
docs/architecture/setup-tnh/design/setup-tnh-minimal-extensible-tool.md |
| Modular Pipeline Design: Best Practices for Audio Transcription and Diarization |
This document summarizes a detailed design and refactoring discussion on building a clean, modular, and production-ready audio transcription pipeline, with a focus on diarization chunking and robust system structure. It includes architectural patterns, file organization, and code hygiene practices. |
2025-06-10 |
docs/architecture/transcription/design/modular-pipeline-best-practices.md |
| Notes |
Table of contents for architecture/tnh-gen/notes |
2026-05-26 |
docs/architecture/tnh-gen/notes/index.md |
| Notes |
Table of contents for architecture/prompt-system/notes |
2026-05-26 |
docs/architecture/prompt-system/notes/index.md |
| Notes |
Table of contents for architecture/agent-orchestration/notes |
2026-05-26 |
docs/architecture/agent-orchestration/notes/index.md |
| OA01.x Cloud Direction Generation Comparison Result |
Independent result note for the three cloud-run OA01.x direction-generation attempts, focused on overlap, novelty, subagent evidence, and practical value. |
2026-04-14 |
docs/architecture/agent-orchestration/notes/experiments/oa01x-cloud-direction-generation-comparison-result.md |
| OA01.x Experimental Directions and Experiment Catalog |
Structured, evolving catalog of broad experimental directions and concrete experiments for long-running supervised multi-agent overnight runs. |
2026-04-14 |
docs/architecture/agent-orchestration/notes/experiments/cloud-run-artifacts/oa01x-experimental-directions-and-experiment-catalog.md |
| OA01.x Experimental Directions Atlas |
Broad and structured experimental direction set for validating multi-agent, headless overnight execution with supervised feedback loops across Codex, Claude Code, and additional model reviewers. |
2026-04-14 |
docs/architecture/agent-orchestration/notes/experiments/cloud-run-artifacts/oa01x-experimental-directions-atlas.md |
| OA01.x Spike Experiment Register |
Minimal maintained experiment register for the current OA01.x spike, limited to headless execution patterns, native subagent viability, and low-overhead operator-facing artifacts. |
2026-04-14 |
docs/architecture/agent-orchestration/notes/experiments/oa01x-spike-experiment-register.md |
| OA07 Bootstrap Proof Workflow Plan |
Plan for the first generic maintained bootstrap-proof workflow, aligned with the existing agent development workflow but constrained by the current headless runtime. |
2026-04-10 |
docs/architecture/agent-orchestration/notes/plans/oa07-bootstrap-proof-workflow-plan.md |
| OA07.1 PR-7 Worktree Runtime Boundary Plan |
Refined implementation plan for the first OA07.1 bootstrap slice: a real git-backed workspace service, worktree-root execution for mutable steps, and pre-run rollback. |
2026-04-06 |
docs/architecture/agent-orchestration/notes/plans/oa07.1-pr7-worktree-workspace-plan.md |
| OA07.1 PR-8 Bootstrap Headless Entry Plan |
Detailed implementation workplan for the maintained local/headless bootstrap entry that loads one workflow, creates a managed worktree context, and drives the maintained OA07.1 kernel end to end. |
2026-04-09 |
docs/architecture/agent-orchestration/notes/plans/oa07.1-pr8-bootstrap-headless-entry-plan.md |
| OA1.x Experimental Directions Matrix |
Comprehensive direction and experiment matrix for testing feasibility of large-scale headless overnight supervised multi-agent orchestration. |
2026-04-14 |
docs/architecture/agent-orchestration/notes/experiments/cloud-run-artifacts/oa1x-experimental-directions-matrix.md |
| Object Service |
Table of contents for architecture/object-service |
2026-05-26 |
docs/architecture/object-service/index.md |
| Object-Service Design Gaps |
Gaps, resolved items, and outstanding work needed to fully satisfy the Object-Service design blueprint. |
2025-10-24 |
docs/architecture/object-service/object-service-design-gaps.md |
| Object-Service Design Overview |
High-level overview of TNH Scholar's layered architecture for complex objects and API-backed services. |
2025-11-29 |
docs/architecture/object-service/object-service-design-overview.md |
| Object-Service Implementation Status |
Implementation status, resolved gaps, and outstanding work for the Object-Service design architecture. |
2025-10-24 |
docs/architecture/object-service/object-service-implementation-status.md |
| OpenAI Interface Migration Plan |
Step-by-step plan for migrating from the legacy openai_interface module to the typed GenAI Service. |
2025-11-17 |
docs/architecture/gen-ai-service/design/openai-interface-migration-plan.md |
| Package Version Checker Design Document |
Specification for a reusable package version checking utility with flexible strategies and clear reporting. |
2025-06-10 |
docs/architecture/utilities/design/package-version-checker-design.md |
| Plans |
Table of contents for architecture/agent-orchestration/notes/plans |
2026-05-26 |
docs/architecture/agent-orchestration/notes/plans/index.md |
| Practical Language-Aware Chunking Design |
Practical heuristics for detecting language changes during chunking when diarization output is noisy. |
2025-06-24 |
docs/architecture/transcription/design/practical-language-aware-chunking.md |
| Project Policies |
Cross-cutting architectural policies and decisions affecting the entire TNH Scholar codebase |
2025-12-06 |
docs/architecture/project-policies/index.md |
| Prompt Dir Task Brief |
Bounded implementation task brief for comparing direct Codex, supervisory Codex, and kernel-mediated agent orchestration on the tnh-gen --prompt-dir feature. |
2026-04-15 |
docs/architecture/agent-orchestration/supervisory-shell-trial/prompt-dir-task-brief.md |
| Prompt Platform Cleanup Follow-On |
Follow-on cleanup identified during tnh-gen prompt-home testing after PT05.1 default-path alignment. |
2026-05-05 |
docs/architecture/prompt-system/notes/prompt-platform-cleanup-follow-on-2026-05.md |
| Prompt System |
Table of contents for architecture/prompt-system |
2026-05-26 |
docs/architecture/prompt-system/index.md |
| Prompt System Architecture |
Current and planned architecture for the TNH Scholar prompt system, including VS Code integration and PromptCatalog service design. |
2025-11-29 |
docs/architecture/prompt-system/prompt-system-architecture.md |
| Provenance & Tracing Architecture |
Cross-cutting infrastructure for tracking data lineage, request tracing, and reproducibility across TNH Scholar |
2025-12-19 |
docs/architecture/provenance/index.md |
| Research |
Table of contents for architecture/agent-orchestration/notes/research |
2026-05-26 |
docs/architecture/agent-orchestration/notes/research/index.md |
| Run Bootstrap Proof |
Operator note for running the first maintained bootstrap-proof workflow. |
2026-04-10 |
docs/architecture/agent-orchestration/bootstrap-proof/run-bootstrap-proof.md |
| Run Prompt Dir Comparison |
Operator commands for the three-arm prompt-dir implementation comparison: direct Codex, supervisory Codex, and kernel-mediated orchestration. |
2026-04-15 |
docs/architecture/agent-orchestration/supervisory-shell-trial/run-prompt-dir-comparison.md |
| Run SPIKE-10 Agent Coordination Comparison |
Operator note for the five-arm SPIKE-10 comparison using direct Codex, native subagents, explicit Codex and Claude assistant CLIs, and the existing tnh-conductor path. |
2026-04-20 |
docs/architecture/agent-orchestration/notes/experiments/run-spike-10-agent-coordination-comparison.md |
| Run Supervisory Shell Trial |
Operator note for launching the first shell-based Codex supervisory team experiment. |
2026-04-13 |
docs/architecture/agent-orchestration/supervisory-shell-trial/run-supervisory-shell-trial.md |
| Setup Tnh |
Table of contents for architecture/setup-tnh |
2026-05-26 |
docs/architecture/setup-tnh/index.md |
| Simplified Language-Aware Chunking Design |
Language-aware chunking strategy that augments diarization splits with practical language detection heuristics. |
2025-06-24 |
docs/architecture/transcription/design/language-aware-chunking-design.md |
| Speaker Diarization Algorithm Design |
This document details the key algorithms referenced in the main diarization system design. Each algorithm is presented with a clear breakdown of its inputs, outputs, and processing steps. |
2025-05-01 |
docs/architecture/transcription/design/speaker-diarization-algorithm-design.md |
| Speaker Diarization and Time-Mapped Transcription System Design |
System design for mapping diarization outputs to speaker-specific transcriptions with accurate global timelines. |
2025-05-01 |
docs/architecture/transcription/design/speaker-diarization-time-mapped-design.md |
| SPIKE-02 Execution Context Comparison |
Lightweight result note comparing headless Codex execution contexts for noise, reliability, and practical usability. |
2026-04-15 |
docs/architecture/agent-orchestration/notes/experiments/spike-02-execution-context-comparison.md |
| SPIKE-03 Native Subagent Smoke Test |
Lightweight result note on whether native headless subagent behavior can be observed and captured clearly enough for the OA01.x spike. |
2026-04-15 |
docs/architecture/agent-orchestration/notes/experiments/spike-03-native-subagent-smoke-test.md |
| SPIKE-04 Narrow Supervisory Comparison |
Lightweight comparison note between a direct single-agent pass and the existing supervisory shell run on the same bounded OA01.x design-review task. |
2026-04-15 |
docs/architecture/agent-orchestration/notes/experiments/spike-04-narrow-supervisory-comparison.md |
| SPIKE-05 Minimum Review Artifact Set |
Lightweight result note defining the smallest artifact bundle that still made the OA01.x spike runs understandable and reviewable. |
2026-04-15 |
docs/architecture/agent-orchestration/notes/experiments/spike-05-minimum-review-artifact-set.md |
| SPIKE-06 Native Codex CLI Baseline |
Baseline validation of the standalone native Codex CLI before running the prompt-dir orchestration comparison. |
2026-04-15 |
docs/architecture/agent-orchestration/notes/experiments/spike-06-native-codex-cli-baseline.md |
| SPIKE-07 Codex Home State Dependency |
Differential experiment on which HOME-scoped Codex state is required for a successful headless invocation and which state only affects startup noise. |
2026-04-15 |
docs/architecture/agent-orchestration/notes/experiments/spike-07-codex-home-state-dependency.md |
| SPIKE-08 Launch Context Environment Contamination |
Differential experiment on whether Codex-on-Codex launch noise comes from PTY shape or from inherited execution environment contamination. |
2026-04-15 |
docs/architecture/agent-orchestration/notes/experiments/spike-08-launch-context-env-contamination.md |
| SPIKE-09 Prompt Dir Three-Arm Comparison |
Comparison of direct Codex, supervisory Codex, and kernel-mediated orchestration on the same bounded tnh-gen --prompt-dir implementation task. |
2026-04-16 |
docs/architecture/agent-orchestration/notes/experiments/spike-09-prompt-dir-three-arm-comparison.md |
| SPIKE-10 Agent Coordination Comparison Plan |
Next comparison plan covering native Codex delegation, explicit external workers, Claude worker invocation, and tnh-gen review/process roles. |
2026-04-20 |
docs/architecture/agent-orchestration/notes/experiments/spike-10-agent-coordination-comparison-plan.md |
| SPIKE-10 Agent Coordination Comparison Result |
Five-arm comparison of direct Codex, native subagents, explicit Codex and Claude assistant CLIs, and the existing tnh-conductor orchestration path on the same bounded implementation task. |
2026-04-20 |
docs/architecture/agent-orchestration/notes/experiments/spike-10-agent-coordination-comparison-result.md |
| SPIKE-10 Conductor Watch Task Brief |
Medium bounded implementation task for comparing agent-coordination arms on live operator visibility in tnh-conductor. |
2026-04-20 |
docs/architecture/agent-orchestration/notes/experiments/spike-10-conductor-watch-task-brief.md |
| Supervisory Shell Trial |
Table of contents for architecture/agent-orchestration/supervisory-shell-trial |
2026-05-26 |
docs/architecture/agent-orchestration/supervisory-shell-trial/index.md |
| Supervisory Team Workflow Contract |
Minimal workflow contract for a shell-launched Codex supervisor coordinating a team of native subagents. |
2026-04-13 |
docs/architecture/agent-orchestration/supervisory-shell-trial/supervisory-team-workflow-contract.md |
| Supervisory Team Workflow Contract V2 |
Minimal engineering-lead contract for coordinating subagents through ordinary software development steps. |
2026-04-15 |
docs/architecture/agent-orchestration/supervisory-shell-trial/supervisory-team-workflow-contract-v2.md |
| TextObject Original Design |
Legacy TextObject design notes capturing the original sectioning models, metadata strategy, and validation approach. |
2025-02-01 |
docs/architecture/ai-text-processing/design/textobject-original-design.md |
| TextObject System Design Document |
Detailed blueprint for the modern TextObject pipeline, outlining segmentation models, metadata, and API surfaces. |
2025-02-01 |
docs/architecture/ai-text-processing/design/textobject-system-design.md |
| TimelineMapper Design Document |
Design for the TimelineMapper component that reprojects chunk-level transcripts into the original audio timeline. |
2025-05-08 |
docs/architecture/transcription/design/timelinemapper-design.md |
| TNH Configuration Management |
Architecture decisions and a phased plan for consolidating TNH Scholar configuration across modules, CLIs, and environments. |
2025-02-01 |
docs/architecture/configuration/tnh-configuration-management.md |
| TNH-Gen CLI Architecture |
Unified command-line interface for TNH Scholar GenAI operations |
2025-12-07 |
docs/architecture/tnh-gen/index.md |
| tnh-gen Docs Consistency + OCR Pipeline Walkthrough Plan |
Work plan for v0.4.0 docs consistency pass on tnh-gen user-guide and CLI reference, and development of a golden OCR pipeline example with two-track clean→punctuate→section→translate walkthrough. |
2026-04-27 |
docs/architecture/tnh-gen/notes/tnh-gen-docs-pipeline-plan-2026-04.md |
| tnh-gen Golden Artifact Preservation Note — May 2026 |
Short operations note from the journal pipeline rerun on preserving structured artifacts, separating reviewed edits from raw outputs, and avoiding rerun clobber. |
2026-05-07 |
docs/architecture/tnh-gen/notes/tnh-gen-golden-artifact-preservation-2026-05.md |
| tnh-gen GPT-5 Structured Output Eval — May 2026 |
Concise findings from live golden evaluation of maintained tnh-gen prompts for walkthrough viability, human usability, artifact-backed real journal runs, and GPT-5-family prompt tuning. |
2026-05-03 |
docs/architecture/tnh-gen/notes/tnh-gen-gpt5-structured-output-eval-2026-05.md |
| tnh-gen Implementation Plan — April 2026 |
Brief phased implementation plan for the tnh-gen robustness and contract work identified in the April 2026 review. |
2026-04-16 |
docs/architecture/tnh-gen/notes/tnh-gen-implementation-plan-2026-04.md |
| tnh-gen Robustness Review — April 2026 |
Architectural analysis of issues #25, #47–#55 — identifying structural improvement opportunities beyond individual patches |
2026-04-16 |
docs/architecture/tnh-gen/notes/tnh-gen-robustness-review-2026-04.md |
| tnh-gen UX Directions and Issues — May 2026 |
Observed UX friction and improvement directions from the journal pipeline walkthrough, for a careful human operator running tnh-gen at the CLI. |
2026-05-04 |
docs/architecture/tnh-gen/notes/tnh-gen-ux-directions-2026-05.md |
| TNH-Scholar Agent Orchestration System |
Comprehensive design document for the agent orchestration system |
2026-01-13 |
docs/architecture/agent-orchestration/system-design.md |
| TNH‑Scholar Utilities Catalog |
This catalog lists core utility modules used across the TNH‑Scholar codebase. It provides a quick reference for shared abstractions, their purpose, API highlights, and stability. All modules are currently in Prototype phase, with most stable in active use. |
2025-11-15 |
docs/architecture/utilities/design/utilities-catalog.md |
| Transcription |
Table of contents for architecture/transcription |
2026-05-26 |
docs/architecture/transcription/index.md |
| Ui Ux |
Table of contents for architecture/ui-ux |
2026-05-26 |
docs/architecture/ui-ux/index.md |
| Utilities |
Table of contents for architecture/utilities |
2026-05-26 |
docs/architecture/utilities/index.md |
| Versioning Policy Documentation Additions |
Summary of documentation updates to clarify rapid prototype versioning policy |
2025-12-06 |
docs/architecture/project-policies/versioning-policy-implementation-summary.md |
| Video Processing |
Table of contents for architecture/video-processing |
2026-05-26 |
docs/architecture/video-processing/index.md |
| VS Code 1.110 Agent Features Research |
Research findings from VS Code February 2026 release — UI patterns and systems relevant to tnh-conductor |
2026-03-08 |
docs/architecture/agent-orchestration/notes/research/vscode-1110-agent-features-research.md |
| Vs Code Integration |
Table of contents for architecture/ui-ux/vs-code-integration |
2026-05-26 |
docs/architecture/ui-ux/vs-code-integration/index.md |
| YouTube API vs yt-dlp Evaluation |
Comparison of using the YouTube Data API versus yt-dlp for fetching Plum Village media assets. |
2025-01-21 |
docs/architecture/ytt-fetch/design/youtube-api-vs-yt-dlp-eval.md |
| Ytt Fetch |
Table of contents for architecture/ytt-fetch |
2026-05-26 |
docs/architecture/ytt-fetch/index.md |