Skip to content

Rollout: complete WorldVM agent guidance and docs checks - #41

Merged
bjacobso merged 1 commit into
mainfrom
conductor/rollout-triplex
Oct 8, 2026
Merged

bjacobso merged 1 commit into
mainfrom
conductor/rollout-triplex

Conversation

@bjacobso

@bjacobso bjacobso commented Oct 8, 2026 •

Copy link
Copy Markdown
Owner

Summary

Complete the WorldVM child-project rollout by linking the family hub in the README and adding root contributor guidance for coding agents. Keep the existing VitePress generation of agent docs, put pre-1.0 maturity and installation in its summary, and validate the built index and every local link.

Template IDs and verification

  • family: README now links to https://worldvm.com near the end. Verify the sentence above License.
  • agents-md: new root AGENTS.md describes setup, pnpm check, repository layout, conventions, and boundaries using existing commands. There is no CLAUDE.md to redirect.
  • llms-txt: the docs-generated summary now states pre-1.0 maturity and the published install command. pnpm docs:build produces dist/llms.txt; pnpm docs:preview serves it as HTTP 200 text/plain.
  • llms-tested, llms-links: scripts/check-llms.mjs runs after every docs build, including through pnpm check and CI. It requires the H1, summary, maturity, installation, sections, and annotated absolute HTTPS links; verifies local targets are real built files; and rejects HTML fallbacks. All 22 links pass in the built preview as HTTP 200 text/markdown, and all 22 current live links return HTTP 200.
  • check, ci, conductor (verified): the existing root check and PR workflow remain in place; .conductor/settings.toml already installs with the frozen lockfile and exposes pnpm check.
  • github-meta (verified): description is already “An Effect-native fact database for applications that have to explain themselves.” and homepage is already https://triplex.build. No metadata edit was needed.
  • ci-green (verified): the latest completed CI run on main at 2104cd3 succeeded: https://github.com/bjacobso/triplex/actions/runs/37727521967. No default-branch CI fix was needed.
  • readme, license, site (verified): existing README explains installation and maturity, root LICENSE is present, and the canonical HTTPS site is available.

Verification

  • pnpm install --frozen-lockfile — passed.
  • pnpm check — passed, including package and docs builds and the new llms validator.
  • pnpm exec playwright test e2e/docs-home.spec.ts --grep 'agent-readable' — passed, including the new text/plain assertion.
  • Built preview: /llms.txt is HTTP 200 text/plain and byte-identical to the built file; every indexed Markdown page is HTTP 200 text/markdown.
  • Manual validator failure checks: missing file, H1, summary, maturity, install, sections, nonexistent linked page, index HTML shell, and linked HTML shell all failed as intended; original output was restored and passes.

No repository blockers remain. The updated live summary and default-branch files await merge and the existing deployment workflow; no manual deployment, package publication, or merge was performed. This changes documentation and validation only, so no Changeset is needed.

Final status: repository changes complete and local checks passing; ready for review and normal CI/deployment after merge.


Open workspace in Conductor

@bjacobso
bjacobso merged commit 125e291 into main Oct 8, 2026
7 checks passed
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