[WIP] Fix broken internal links and normalize page layouts

[Copilot]

Thanks for asking me to work on this. I will get started on it and keep this PR's description up to date as I form a plan and make progress.

Original prompt

Goal

Create a Pull Request that fixes broken internal links across the docs/ folder used by GitHub Pages, normalizes page layouts so the site renders correctly, and sets baseurl to "/roll_tracker" in docs/_config.yml as requested. The branch docs/fix-links-layouts already exists and should be used as the source branch. The PR should target the main branch.

Changes to make (files and exact contents)

1. Update docs/_config.yml
   Replace file with:

title: Roll Tracker
description: "Roll Tracker planning + docs"

# GitHub Pages Jekyll build
theme: jekyll-theme-cayman

# Keep URLs stable and readable
permalink: pretty

# Site baseurl for project pages
baseurl: "/roll_tracker"

2. Update docs/index.md
   Replace file with:

---
layout: default
title: Home
---

# Roll Tracker Documentation

Welcome to the **Roll Tracker** project documentation site. This site contains planning documents, architecture decisions, and worker thread specifications for the roll tracking system.

## 📚 Documentation Sections

### [Planning Documentation]({{ '/planning/' | relative_url }})
Core planning documents including:
- Pipeline architecture and hybrid execution model
- Stage contracts and artifact specifications
- Checkpoint discipline and validation requirements
- POC scope and success criteria

### [Worker Thread Index]({{ '/planning/WORKER_THREAD_INDEX.html' | relative_url }})
Complete index of all worker threads organized by stage, including responsibilities and deliverables.

### [Worker Thread Specifications]({{ '/planning/worker_threads/' | relative_url }})
Detailed specifications for individual worker threads, meant to be used as prompts for dedicated worker chats.

---

## 🔧 Quick Links

- **Repository**: https://github.com/bryan-rt/roll_tracker
- **Planning Pack**: [Planning README]({{ '/planning/README.html' | relative_url }})

---

*This site is automatically published from the repository's `docs/` folder using GitHub Pages.*

3. Update docs/planning/index.md
   Replace file with:

---
layout: default
title: Planning Documentation
---

# Roll Tracker Planning

This section contains the core planning documentation for the Roll Tracker project.

## 📋 Core Documents

### [Planning README]({{ '/planning/README.html' | relative_url }})
The main planning pack document covering:
- **Workflow**: How to use worker threads effectively
- **Pipeline Architecture**: Hybrid execution model (multiplex_AC)
- **Stage Contracts**: F0/F1/F2 artifact and configuration contracts
- **Current Locks**: Agreed-upon decisions and constraints
- **Checkpoint Discipline**: Requirements for keeping the pipeline runnable
- **Stage D POC Map**: Detailed specifications for the MCF stitcher

### [Worker Thread Index]({{ '/planning/WORKER_THREAD_INDEX.html' | relative_url }})
Comprehensive index of all worker threads organized by stage (A through X), including:
- Worker IDs and responsibilities
- Current status and deliverables
- Cross-references and dependencies

## 🧵 Worker Thread Specifications

### [Worker Threads Directory]({{ '/planning/worker_threads/' | relative_url }})
Individual worker thread specification files, each designed to be pasted as the first message in a dedicated worker chat.

**Usage**:
1. Create a new worker chat with the worker ID (e.g., `D2`)
2. Paste the entire worker markdown file
3. Ask the worker to deliver required outputs
4. Return summaries to the Manager thread

---

## ⚙️ Key Concepts

- **Min-Cost Flow (MCF)**: Mandatory stitching approach for Stage D
- **Multiplex Mode**: Single-pass execution (A+C together)
- **Artifact-Driven**: All stages communicate through versioned artifacts (F0 contract)
- **Checkpoint Discipline**: Pipeline must remain runnable end-to-end at every checkpoint

---

[← Back to Home]({{ '/' | relative_url }})

4. Update docs/planning/worker_threads/index.md
   Replace file with:

---
layout: default
title: Worker Threads
---

- [Back to Planning]({{ '/planning/' | relative_url }})

Browse the worker thread writeups in this folder.

5. Update docs/planning/README.md
   Change only the front matter from layout: page to layout: default. Preserve the entire body content exactly as-is.

Commit & PR details

• Branch (source): docs/fix-links-layouts
• Base (target): main
• Commit message: docs: fix internal links and normalize layouts; set baseurl
• PR title: Fix broken internal links and normalize docs layouts (set baseurl)
• PR body: This PR sets baseurl to /roll_tracker, normalizes layouts to layout: default for docs pages, and replaces internal links with Liquid {{ '/path/' | relative_url }} so the site correctly resolves links when published under the project path. All content preserved; changes are formatting and link fixes only. Local build verification notes will be included.

Testing

• After creating the PR, run a local Jekyll build in docs/ with baseurl set to /roll_tracker to verify links.

Preserve

• Do not modify any other fil...

This pull request was created from Copilot chat.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.