Skip to content

Validate generated Docs Agent links#144

Merged
chubes4 merged 1 commit into
mainfrom
clean-docs-bootstrap-wrapper
May 10, 2026
Merged

Validate generated Docs Agent links#144
chubes4 merged 1 commit into
mainfrom
clean-docs-bootstrap-wrapper

Conversation

@chubes4
Copy link
Copy Markdown
Contributor

@chubes4 chubes4 commented May 10, 2026

Summary

  • Add a bootstrap docs link validator that checks generated README.md and docs/** Markdown links against the generated branch tree.
  • Run that validator after Docs Agent opens a bootstrap PR, so incomplete scaffolds with missing linked pages fail mechanically.

Testing

  • php -l tests/playground-ci/scripts/validate-docs-links.php
  • bash -n tests/playground-ci/scripts/run-docs-agent.sh
  • php tests/playground-ci/scripts/validate-docs-links.php . HEAD
  • php tests/playground-ci/scripts/validate-docs-links.php . FETCH_HEAD against the bad generated docs branch, which correctly failed on missing links
  • git diff --check

AI assistance

  • AI assistance: Yes
  • Tool(s): OpenCode (GPT-5.5)
  • Used for: Diagnosed the bad generated docs PR, drafted the link validator and workflow integration, and ran targeted validation.

@chubes4 chubes4 merged commit 8a7e7a8 into main May 10, 2026
2 checks passed
@chubes4 chubes4 deleted the clean-docs-bootstrap-wrapper branch May 10, 2026 21:07
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.

1 participant