---
phase: 08-mkdocs-infrastructure
plan: "01"
type: execute
wave: 1
depends_on: []
files_modified:
  - docs/backlog.md
  - docs/research-mapping.md
  - docs/roadmap.md
  - docs/index.md
autonomous: true
requirements:
  - INFR-02
must_haves:
  truths:
    - "docs/backlog.md does not exist"
    - "docs/research-mapping.md does not exist"
    - "docs/roadmap.md does not exist"
    - "docs/index.md links only to files that exist in docs/ after deletion"
  artifacts:
    - path: "docs/index.md"
      provides: "Landing page with no broken internal links"
      contains: "agentic-workflows.md"
  key_links:
    - from: "docs/index.md"
      to: "docs/"
      via: "markdown links"
      pattern: "\\[.*\\]\\(.*\\.md\\)"
---

<objective>
Delete three internal planning artifacts from docs/ that must not appear in the published site, and update docs/index.md to remove the now-broken links to those deleted files.

Purpose: The "For Developers and Agents" section of docs/index.md currently links to roadmap.md, research-mapping.md, and backlog.md. After deletion those become 404s. This plan removes the files and repairs the landing page in one atomic change.
Output: Three files deleted, docs/index.md updated with no dead links.
</objective>

<execution_context>
@/Users/shparki/.claude/get-shit-done/workflows/execute-plan.md
@/Users/shparki/.claude/get-shit-done/templates/summary.md
</execution_context>

<context>
@.planning/PROJECT.md
@.planning/ROADMAP.md
@.planning/phases/08-mkdocs-infrastructure/08-CONTEXT.md
@.planning/phases/08-mkdocs-infrastructure/08-RESEARCH.md
</context>

<tasks>

<task type="auto">
  <name>Task 1: Delete internal artifacts and repair index.md</name>
  <files>docs/backlog.md, docs/research-mapping.md, docs/roadmap.md, docs/index.md</files>

  <read_first>
    - docs/index.md — read FULL content before editing; understand every section and link
    - docs/backlog.md — confirm it exists (will be deleted)
    - docs/research-mapping.md — confirm it exists (will be deleted)
    - docs/roadmap.md — confirm it exists (will be deleted)
    - .planning/phases/08-mkdocs-infrastructure/08-RESEARCH.md — Pitfall 4 describes exactly which links must be removed
  </read_first>

  <action>
    1. Delete these three files using `git rm` (so the deletion is staged for commit):
       - `git rm docs/backlog.md`
       - `git rm docs/research-mapping.md`
       - `git rm docs/roadmap.md`

    2. Edit docs/index.md: replace the entire "For Developers and Agents" section with a version that removes the three dead links. The current section (lines ~33-40) contains:
       ```
       ## For Developers and Agents

       - [Product Roadmap](roadmap.md) — Forward-looking priorities from the post-backlog baseline
       - [Agentic Workflows](agentic-workflows.md) — Sessions, context assembly, batch operations, scripting
       - [Research to ztlctl Mapping](research-mapping.md) — Conceptual bridge from the original `research` workspace to the current product
       - [Hybrid Workspace Closure Record](backlog.md) — Historical record of the completed hybrid-workspace gap closure
       - [Development](development.md) — Contributing, architecture, and local setup
       - [Troubleshooting](troubleshooting.md) — Common issues and solutions
       ```
       Replace it with:
       ```
       ## For Developers and Agents

       - [Agentic Workflows](agentic-workflows.md) — Sessions, context assembly, batch operations, scripting
       - [Development](development.md) — Contributing, architecture, and local setup
       - [Troubleshooting](troubleshooting.md) — Common issues and solutions
       ```
       Do not alter any other section of docs/index.md.
  </action>

  <verify>
    <automated>test ! -f docs/backlog.md && test ! -f docs/research-mapping.md && test ! -f docs/roadmap.md && echo "DELETED OK" && grep -v "roadmap.md\|research-mapping.md\|backlog.md" docs/index.md | grep -c "agentic-workflows.md" && echo "INDEX OK"</automated>
  </verify>

  <acceptance_criteria>
    - `test ! -f docs/backlog.md` exits 0
    - `test ! -f docs/research-mapping.md` exits 0
    - `test ! -f docs/roadmap.md` exits 0
    - `grep -c "roadmap.md\|research-mapping.md\|backlog.md" docs/index.md` returns 0
    - `grep -c "agentic-workflows.md" docs/index.md` returns 1 (link still present)
    - `grep -c "development.md" docs/index.md` returns at least 1
    - `grep -c "troubleshooting.md" docs/index.md` returns at least 1
    - docs/index.md still has "## For Developers and Agents" section header
  </acceptance_criteria>

  <done>Three internal artifacts deleted from docs/ and docs/index.md contains no links to the deleted files</done>
</task>

</tasks>

<verification>
After task completion:
- `test ! -f docs/backlog.md && test ! -f docs/research-mapping.md && test ! -f docs/roadmap.md` — all three files gone
- `grep "roadmap.md\|research-mapping.md\|backlog.md" docs/index.md` — returns no matches
- `ls docs/*.md | wc -l` — should return 13 (16 original minus 3 deleted)
</verification>

<success_criteria>
All three internal artifact files are deleted from docs/. docs/index.md has no links pointing to the deleted files. The landing page still has a functional "For Developers and Agents" section linking to agentic-workflows.md, development.md, and troubleshooting.md.
</success_criteria>

<output>
After completion, create `.planning/phases/08-mkdocs-infrastructure/08-01-SUMMARY.md`
</output>
