Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Jan 24, 2026

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

Create a pull request on bryan-rt/roll_tracker that fixes broken internal links in the docs/ site, normalizes layouts, and sets baseurl for GitHub Pages. Changes are minimal and preserve all existing content except front-matter and internal link markup. Target branch: main. Source branch: docs/fix-links-layouts (already created).

Summary of changes to apply (exact file contents provided):

  1. docs/_config.yml — replace 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"
  1. docs/index.md — replace 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.*
  1. docs/planning/index.md — replace 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 }})
  1. docs/planning/worker_threads/index.md — replace with:
---
layout: default
title: Worker Threads
---

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

Browse the worker thread writeups in this folder.
  1. docs/planning/README.md — modify only the front matter: change layout: page to layout: default. Preserve the rest of the file body exactly as currently in the repository.

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."

Do not modify any other files.

This pull request was created from Copilot chat.


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants