Skip to content

feat: publish llms.txt and llms-full.txt for AI agents - #80

Merged
shenxianpeng merged 1 commit into
mainfrom
feature/llms-txt
Nov 9, 2026
Merged

shenxianpeng merged 1 commit into
mainfrom
feature/llms-txt

Conversation

@shenxianpeng

@shenxianpeng shenxianpeng commented Nov 9, 2026 •

Copy link
Copy Markdown
Member

Before / after

Before After
https://commit-check.com/llms.txt 404 Index of every page's Markdown copy, grouped by nav section (50 lines, 3 KB)
https://commit-check.com/llms-full.txt 404 All pages in one Markdown file (240 KB)
<head> of each page no llms link <link rel="alternate" type="text/plain" href="llms.txt"> (Sumi adds it once the file exists)
⌘K palette — "Open llms.txt" command (Sumi)

Start of the generated llms.txt:

# Commit Check

> Commit policy as code for teams and AI agents: commit message, branch naming, author and sign-off standards in one config file, enforced in hooks, CI and pull requests.

## Pages

- [Home](https://commit-check.com/index.md): Commit policy as code for teams and AI agents. …
- [Getting started](https://commit-check.com/getting-started.md)
- [Where to run it](https://commit-check.com/guides/integrations.md)

## Guides

- [Pre-commit hook](https://commit-check.com/guides/pre-commit.md)
- [GitHub Action](https://commit-check.com/guides/github-actions.md)
…

Why

Agents and their docs tools fetch llms.txt first. commitlint publishes both files; commit-check had neither.

How

One plugin line in mkdocs.yml: MkDocs NG's built-in llms_txt with full_output: true, before sumi as Sumi's README shows. No new dependency, and both files are rebuilt from the pages on every deploy, so nothing to maintain.

Checks

  • SOCIAL_CARDS=false mkdocs build --strict passes; every link in llms.txt points to a file the build wrote.
  • python -m pytest tests/ -q: 18 passed.

Note: the home page is mostly HTML, so its section of llms-full.txt is HTML too. The plugin has no per-page exclude; left as is.

Turns on MkDocs NG's built-in llms_txt plugin. It writes llms.txt at the
site root, linking the Markdown copy of every page by nav section, and
llms-full.txt with all pages in one file. Sumi already announces
llms.txt in each page's head once the file exists.
@netlify

netlify Bot commented Nov 9, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for commit-check ready!

Name Link
🔨 Latest commit 7b55006
🔍 Latest deploy log https://app.netlify.com/projects/commit-check/deploys/6af2168f5ee4ce3385d20a30
😎 Deploy Preview https://deploy-preview-80--commit-check.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@coderabbitai

coderabbitai Bot commented Nov 9, 2026

Copy link
Copy Markdown

Warning

Review limit reached

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Next included review available in 59 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

Learn how review limits work.

Review configuration:

Run configuration

  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: defaults
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 977cfd80-571c-4e97-872d-f2009ae82e6e
Commits

Reviewing files that changed from the base of the PR and between 971fe23 and 7b55006.

Files selected for processing: 1

  • mkdocs.yml
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

@shenxianpeng shenxianpeng self-assigned this Nov 9, 2026
@shenxianpeng
shenxianpeng merged commit 7a4b812 into main Nov 9, 2026
8 checks passed
@shenxianpeng
shenxianpeng deleted the feature/llms-txt branch November 9, 2026 18:56
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