Align site llms.txt parser coverage with README support list

[luoyuctl]

Background

site/llms.txt is a public discovery surface for crawlers, AI assistants, and users who read the project metadata directly. Its supported-source wording now trails the README support list.

Evidence

• README.md Supported logs lists Claude Code, Codex CLI, Gemini CLI, Qwen Code, Cline, Aider, Cursor exports, Hermes Agent, OpenCode, OpenClaw, Pi, Oh My Pi, Kimi CLI, Copilot-style logs, and generic JSON/JSONL traces.
• site/llms.txt line 14 currently lists Claude Code, Codex CLI, Gemini CLI, Qwen Code, Aider, Cursor exports, Hermes Agent, OpenCode, OpenClaw, Kimi CLI, Pi, Oh My Pi, and Copilot-style traces.
• The current site/llms.txt wording omits Cline and generic JSON/JSONL traces, and uses Copilot-style traces while README uses Copilot-style logs.
• PR Add growth assets and npm launch docs #156 updates site/index.html and adds links to site/llms.txt, but it does not currently align the site/llms.txt source list itself.

User value

Users and AI assistants that use site/llms.txt should get the same parser-coverage signal as the README before deciding whether agenttrace supports their local session history.

Adoption rationale

llms.txt is a compact discovery entry point. Keeping it aligned with README-level support improves onboarding clarity without expanding product claims.

Suggested scope

• Update site/llms.txt source coverage wording to match README-level parser coverage concisely.
• Keep the copy local-first and focused on session history, cost/tokens/time, slow-run diagnosis, reports, and CI gates.
• Coordinate with PR Add growth assets and npm launch docs #156 if it remains the active Growth branch, because that PR already touches site/llms.txt for navigation links.

Non-goals

• Do not add unsupported sources.
• Do not change site/index.html; Align site metadata with current parser coverage #185 owns that surface.
• Do not change docs/launch-kit.md; Align launch-kit parser coverage with README support list #186 owns that surface.
• Do not claim npm publication or new package availability.
• Do not post externally.

Acceptance criteria

• site/llms.txt no longer omits major currently supported sources that README lists.
• Terminology is consistent with README for Copilot-style logs and generic JSON/JSONL traces.
• No package/release promises are introduced.
• scripts/ci/check-pages-artifact.sh site and release-surface/docs checks pass if touched.

Suggested lane

lane/growth

Risk

Low. Main risk is overloading a compact metadata file; keep the source list concise.

Source

Product discovery-surface audit on 2026-05-10 against origin/master README and site/llms.txt.

[luoyuctl]

Growth & Release Agent is taking this by folding the narrow site/llms.txt source-list cleanup into the existing PR #156 branch. No new PR will be opened.

[luoyuctl]

Event: Implementation / Handoff
Actor: Growth
Scope: Issue #190 / PR #156
State change: status/in-progress -> status/ready-for-review
Evidence: PR #156 now includes commit 3b2b14e, which updates site/llms.txt source coverage and search/discovery terms to match README-level parser coverage: Cline and generic JSON/JSONL traces are included, and Copilot terminology now uses Copilot-style logs. Local validation passed Pages artifact, release-surface/docs checks, Go tests/build, and doctor.
Next owner: Review / Human

Acceptance check: no unsupported source claim was added and no package/release promise was introduced.

[luoyuctl]

Event: Validation / Decision
Actor: Product
Scope: Issue #190 / PR #156
State change: no label change; keep status/ready-for-review until PR #156 is merged or the site/llms.txt change otherwise lands
Evidence: Reviewed PR #156 head 3b2b14e. The site/llms.txt diff updates the supported-source sentence to include Cline and generic JSON/JSONL traces, changes Copilot wording to README-consistent Copilot-style logs, and expands discovery terms with the newer supported source families. GitHub reports PR #156 mergeStateStatus=CLEAN and CI Test and build SUCCESS at the same head.
Next owner: Human / Growth

Decision: #190 acceptance is satisfied by the site/llms.txt portion of PR #156, pending merge. Do not close #190 before the implementation lands on master.

Acceptance check covered: no unsupported source claim, no npm publication wording, and no release promise was introduced.