mirror of
https://github.com/max-sixty/worktrunk.git
synced 2026-09-14 20:00:38 +08:00
Maximilian Roos
89dceed12e
## Summary Implements the [llms.txt spec](https://llmstxt.org/) for the docs site: - **`worktrunk.dev/llms.txt`** — curated index listing every doc page, grouped by sidebar section (Commands, Reference) and ordered by weight. Generated from `docs/content/*.md` front-matter. - **`worktrunk.dev/<page>.md`** — clean-markdown versions of each doc page, served as symlinks from `docs/static/*.md` into `skills/worktrunk/reference/*.md`. Zola follows the symlinks at build time, so there's no content duplication — just 13 symlink entries in git, alongside the existing `docs/static/.well-known/agent-skills/worktrunk` symlink. ## What changed - 13 symlinks at `docs/static/*.md` → `../../skills/worktrunk/reference/*.md` - `docs/static/llms.txt` — generated output (checked in, same as `skills/worktrunk/reference/` and `.well-known/agent-skills/index.json`) - `sync_llms_txt()` + `extract_intro_prose()` + `docs_content_page_names()` helpers in `tests/integration_tests/readme_sync.rs` - Step 4 added to `test_command_pages_and_skill_files_are_in_sync` — CI catches drift if front-matter changes and `llms.txt` isn't regenerated The new directory-walk helper (`docs_content_page_names`) is shared with `sync_skill_files`, which had the same walk inlined. ## Test plan - [x] `cargo test --test integration readme_sync` — 13/13 pass, idempotent on re-run - [x] `cargo fmt` + `cargo clippy --all-targets --all-features -- -D warnings` — clean - [x] `pre-commit run --files tests/integration_tests/readme_sync.rs` — pass - [x] `zola build` produces `public/merge.md` etc. as real 4814-byte files (not symlinks) and `public/llms.txt` - [ ] CI green > _This was written by Claude Code on behalf of @max-sixty_ --------- Co-authored-by: Claude <noreply@anthropic.com> Co-authored-by: worktrunk-bot <254187624+worktrunk-bot@users.noreply.github.com>
Symbolic link
39 B
Generated
Symbolic link
39 B
Generated
../../skills/worktrunk/reference/faq.md