Skip to content

feat: publish markdown twins for rankings, home, and changelog - #149

Merged
sonpiaz merged 1 commit into
mainfrom
fix/agent-markdown-pages
Oct 2, 2026
Merged

sonpiaz merged 1 commit into
mainfrom
fix/agent-markdown-pages

Conversation

@sonpiaz

@sonpiaz sonpiaz commented Oct 2, 2026

Copy link
Copy Markdown
Member

Why

Program detail pages already serve /programs/{slug}.md. Two listing pages did not:

  • /rankings.md was 404. The rankings HTML page also did not advertise a markdown twin.
  • /programs.md already existed, but /programs did not point at it.

/index.md was 404, which is the homepage check in the agent-readability audit. /changelog.md was 404 even though /changelog is live. This generates those three files at build time from the same registry and changelog entries the HTML uses, and adds rel="alternate" type="text/markdown" on /, /programs, /rankings, and /changelog.

/llms.txt stays at 10236 bytes after a full registry build (cap 10240).

Test

npx tsx scripts/build-registry.ts && npx tsx scripts/generate-md.ts wrote index.md, rankings.md, and changelog.md. Rankings are ordered by Affiliate Score, the same score as the podium on the rankings page.

Program detail pages already had a .md file. The rankings page, the homepage, and the changelog did not, and the programs index did not advertise its markdown twin.
@vercel

vercel Bot commented Oct 2, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
open-affiliate Ready Ready Preview Oct 2, 2026 3:05pm UTC

Request Review

@sonpiaz sonpiaz added the do-not-merge Emergency stop: never auto-merge this pull request label Oct 2, 2026
@github-actions github-actions Bot added the automerge:blocked Machine policy requires human review label Oct 2, 2026
@github-actions

github-actions Bot commented Oct 2, 2026

Copy link
Copy Markdown
Contributor

Auto-merge policy — LIVE

⛔ Blocked

  • blocking label: do-not-merge
  • changes more than 3 program files
  • sensitive or non-program path: .gitignore
  • sensitive or non-program path: scripts/generate-md.ts
  • sensitive or non-program path: scripts/verify-machine-surfaces.ts
  • sensitive or non-program path: src/app/changelog/page.tsx
  • sensitive or non-program path: src/app/page.tsx
  • sensitive or non-program path: src/app/programs/layout.tsx
  • sensitive or non-program path: src/app/rankings/layout.tsx
  • sensitive or non-program path: src/lib/changelog.ts

Human review is required; auto-merge was not requested.

The workflow never executes pull-request code with its write token
and never falls back to a direct merge.

@sonpiaz
sonpiaz merged commit a5cafe0 into main Oct 2, 2026
7 of 8 checks passed

This branch was successfully deployed

1 active deployment
Preview — 98a8ad10 Deployed Oct 2, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automerge:blocked Machine policy requires human review do-not-merge Emergency stop: never auto-merge this pull request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant