debug and fix ToC breakage

Author: hesreallyhim

Makefile

@@ -7,13 +7,14 @@ else
 endif
 SCRIPTS_DIR := ./scripts
 
-.PHONY: help validate validate-single test coverage generate test-regenerate test-regenerate-no-cleanup test-regenerate-allow-diff test-regenerate-cycle docs-tree docs-tree-check download-resources add_resource add-category sort format format-check generate-resource-id mypy ci clean clean-all
+.PHONY: help validate validate-single validate-toc test coverage generate test-regenerate test-regenerate-no-cleanup test-regenerate-allow-diff test-regenerate-cycle docs-tree docs-tree-check download-resources add_resource add-category sort format format-check generate-resource-id mypy ci clean clean-all
 
 help:
 	@echo "Available commands:"
 	@echo "  make add-category      - Add a new category to the repository"
 	@echo "  make validate          - Validate all links in the resource CSV"
 	@echo "  make validate-single URL=<url> - Validate a single resource URL"
+	@echo "  make validate-toc      - Validate TOC anchors against GitHub HTML"
 	@echo "  make test              - Run validation tests on test CSV"
 	@echo "  make coverage          - Run pytest with coverage reports"
 	@echo "  make mypy              - Run mypy type checks"
@@ -69,6 +70,11 @@ validate-single:
 	fi
 	@$(PYTHON) -m scripts.validation.validate_single_resource "$(URL)" $(if $(SECONDARY),--secondary "$(SECONDARY)") $(if $(NAME),--name "$(NAME)")
 
+# Validate TOC anchors against GitHub HTML (requires .claude/root-readme-html-article-body.html)
+validate-toc:
+	@echo "Validating TOC anchors against GitHub HTML..."
+	@$(PYTHON) -m scripts.testing.validate_toc_anchors
+
 # Run all tests using pytest
 test:
 	@echo "Running all tests..."

README.md

@@ -32,36 +32,36 @@ Claude Code is a CLI-based coding assistant from [Anthropic](https://www.anthrop
 
 ## Contents
 
-- [Agent Skills 🤖](#agent-skills--)
-  - [General](#general-)
-- [Workflows & Knowledge Guides 🧠](#workflows--knowledge-guides--)
-  - [General](#general--1)
-- [Tooling 🧰](#tooling--)
-  - [General](#general--2)
-  - [IDE Integrations](#ide-integrations-)
-  - [Usage Monitors](#usage-monitors-)
-  - [Orchestrators](#orchestrators-)
-- [Status Lines 📊](#status-lines--)
-  - [General](#general--3)
-- [Hooks 🪝](#hooks--)
-  - [General](#general--4)
-- [Slash-Commands 🔪](#slash-commands--)
-  - [General](#general--5)
-  - [Version Control & Git](#version-control--git-)
-  - [Code Analysis & Testing](#code-analysis--testing-)
-  - [Context Loading & Priming](#context-loading--priming-)
-  - [Documentation & Changelogs](#documentation--changelogs-)
-  - [CI / Deployment](#ci--deployment-)
-  - [Project & Task Management](#project--task-management-)
-  - [Miscellaneous](#miscellaneous-)
-- [CLAUDE.md Files 📂](#claudemd-files--)
-  - [Language-Specific](#language-specific-)
-  - [Domain-Specific](#domain-specific-)
-  - [Project Scaffolding & MCP](#project-scaffolding--mcp-)
-- [Alternative Clients 📱](#alternative-clients--)
-  - [General](#general--6)
-- [Official Documentation 🏛️](#official-documentation--%EF%B8%8F)
-  - [General](#general--7)
+- [Agent Skills 🤖](#agent-skills-)
+  - [General](#general)
+- [Workflows & Knowledge Guides 🧠](#workflows--knowledge-guides-)
+  - [General](#general-1)
+- [Tooling 🧰](#tooling-)
+  - [General](#general-2)
+  - [IDE Integrations](#ide-integrations)
+  - [Usage Monitors](#usage-monitors)
+  - [Orchestrators](#orchestrators)
+- [Status Lines 📊](#status-lines-)
+  - [General](#general-3)
+- [Hooks 🪝](#hooks-)
+  - [General](#general-4)
+- [Slash-Commands 🔪](#slash-commands-)
+  - [General](#general-5)
+  - [Version Control & Git](#version-control--git)
+  - [Code Analysis & Testing](#code-analysis--testing)
+  - [Context Loading & Priming](#context-loading--priming)
+  - [Documentation & Changelogs](#documentation--changelogs)
+  - [CI / Deployment](#ci--deployment)
+  - [Project & Task Management](#project--task-management)
+  - [Miscellaneous](#miscellaneous)
+- [CLAUDE.md Files 📂](#claudemd-files-)
+  - [Language-Specific](#language-specific)
+  - [Domain-Specific](#domain-specific)
+  - [Project Scaffolding & MCP](#project-scaffolding--mcp)
+- [Alternative Clients 📱](#alternative-clients-)
+  - [General](#general-6)
+- [Official Documentation 🏛️](#official-documentation-%EF%B8%8F)
+  - [General](#general-7)
 
 ## Agent Skills 🤖
 
@@ -358,3 +358,5 @@ This project is released with a Code of Conduct. By participating, you agree to
 
 This list is licensed under [Creative Commons CC BY-NC-ND 4.0](https://creativecommons.org/licenses/by-nc-nd/4.0/) - this means you are welcome to fork, clone, copy and redistribute the list, provided you include appropriate attribution; however you are not permitted to distribute any modified versions or to use it for any commercial purposes. This is to prevent disregard for the licenses of the authors whose resources are listed here. Please note that all resources included in this list have their own license terms.
 
+
+<!-- OBLIGATORY GUARD AGAINST SILLY END-OF-FILE PROBLEM -->

README_ALTERNATIVES/README_AWESOME.md

@@ -32,36 +32,36 @@ Claude Code is a CLI-based coding assistant from [Anthropic](https://www.anthrop
 
 ## Contents
 
-- [Agent Skills 🤖](#agent-skills--)
-  - [General](#general-)
-- [Workflows & Knowledge Guides 🧠](#workflows--knowledge-guides--)
-  - [General](#general--1)
-- [Tooling 🧰](#tooling--)
-  - [General](#general--2)
-  - [IDE Integrations](#ide-integrations-)
-  - [Usage Monitors](#usage-monitors-)
-  - [Orchestrators](#orchestrators-)
-- [Status Lines 📊](#status-lines--)
-  - [General](#general--3)
-- [Hooks 🪝](#hooks--)
-  - [General](#general--4)
-- [Slash-Commands 🔪](#slash-commands--)
-  - [General](#general--5)
-  - [Version Control & Git](#version-control--git-)
-  - [Code Analysis & Testing](#code-analysis--testing-)
-  - [Context Loading & Priming](#context-loading--priming-)
-  - [Documentation & Changelogs](#documentation--changelogs-)
-  - [CI / Deployment](#ci--deployment-)
-  - [Project & Task Management](#project--task-management-)
-  - [Miscellaneous](#miscellaneous-)
-- [CLAUDE.md Files 📂](#claudemd-files--)
-  - [Language-Specific](#language-specific-)
-  - [Domain-Specific](#domain-specific-)
-  - [Project Scaffolding & MCP](#project-scaffolding--mcp-)
-- [Alternative Clients 📱](#alternative-clients--)
-  - [General](#general--6)
-- [Official Documentation 🏛️](#official-documentation--%EF%B8%8F)
-  - [General](#general--7)
+- [Agent Skills 🤖](#agent-skills-)
+  - [General](#general)
+- [Workflows & Knowledge Guides 🧠](#workflows--knowledge-guides-)
+  - [General](#general-1)
+- [Tooling 🧰](#tooling-)
+  - [General](#general-2)
+  - [IDE Integrations](#ide-integrations)
+  - [Usage Monitors](#usage-monitors)
+  - [Orchestrators](#orchestrators)
+- [Status Lines 📊](#status-lines-)
+  - [General](#general-3)
+- [Hooks 🪝](#hooks-)
+  - [General](#general-4)
+- [Slash-Commands 🔪](#slash-commands-)
+  - [General](#general-5)
+  - [Version Control & Git](#version-control--git)
+  - [Code Analysis & Testing](#code-analysis--testing)
+  - [Context Loading & Priming](#context-loading--priming)
+  - [Documentation & Changelogs](#documentation--changelogs)
+  - [CI / Deployment](#ci--deployment)
+  - [Project & Task Management](#project--task-management)
+  - [Miscellaneous](#miscellaneous)
+- [CLAUDE.md Files 📂](#claudemd-files-)
+  - [Language-Specific](#language-specific)
+  - [Domain-Specific](#domain-specific)
+  - [Project Scaffolding & MCP](#project-scaffolding--mcp)
+- [Alternative Clients 📱](#alternative-clients-)
+  - [General](#general-6)
+- [Official Documentation 🏛️](#official-documentation-%EF%B8%8F)
+  - [General](#general-7)
 
 ## Agent Skills 🤖
 
@@ -358,3 +358,5 @@ This project is released with a Code of Conduct. By participating, you agree to
 
 This list is licensed under [Creative Commons CC BY-NC-ND 4.0](https://creativecommons.org/licenses/by-nc-nd/4.0/) - this means you are welcome to fork, clone, copy and redistribute the list, provided you include appropriate attribution; however you are not permitted to distribute any modified versions or to use it for any commercial purposes. This is to prevent disregard for the licenses of the authors whose resources are listed here. Please note that all resources included in this list have their own license terms.
 
+
+<!-- OBLIGATORY GUARD AGAINST SILLY END-OF-FILE PROBLEM -->

README_ALTERNATIVES/README_CLASSIC.md

@@ -154,7 +154,7 @@ A strong bundle of core competencies for software engineering, with good coverag
   </details>
 
 - <details open>
-  <summary><a href="#official-documentation--%EF%B8%8F">Official Documentation</a></summary>
+  <summary><a href="#official-documentation-%EF%B8%8F-">Official Documentation</a></summary>
 
   - [General](#general--7)