Skip to content

docs: recreate the harness without the CLI via the docsite llms.txt - #23

Merged
doidor merged 2 commits into
mainfrom
doidor/bootstrap-harness-skill
Jul 29, 2026
Merged

docs: recreate the harness without the CLI via the docsite llms.txt#23
doidor merged 2 commits into
mainfrom
doidor/bootstrap-harness-skill

Conversation

@doidor

@doidor doidor commented Jun 22, 2026

Copy link
Copy Markdown
Owner

What

Documents how to recreate the entire AgentRig harness without the CLI by pointing any coding agent
at the docsite's machine-readable llms.txt. This is the
concrete payoff of AgentRig's no-lock-in design — the package is never a runtime dependency.

Supersedes the earlier idea (first revision of this PR) of shipping a dedicated bootstrap-harness
skill. That skill was redundant with the docs: the docsite already contains the recreation
knowledge, and llms.txt already makes it agent-consumable. This revision reverts the skill
entirely and instead makes the docs the single, authoritative home for the recreate-by-hand path.

Changes (docs + README + site config)

  • docs/getting-started.md — new section "Recreate the harness without the CLI (no lock-in)":
    what llms.txt gives an agent (the 12 principles as a complete per-principle artifact inventory,
    the surface projection map, the install-completeness audit), an explicit pointer to
    knowledge/templates/ for exact
    copy-paste file contents, and a ready-to-use prompt.
  • docs/index.md — the "No lock-in" card now links to that walkthrough.
  • README.md — concise "No lock-in — recreate the harness without the CLI" section.
  • markbook.config.tssiteUrl set to the canonical custom domain https://tudorpopa.com/agentrig
    so generated canonical / og:url / sitemap (and every docsite link in the prose) agree with where
    the site is actually served.
  • .changeset/recreate-from-llms.md — patch (README ships in the package).

No behavior changes, no installed-artifact changes, no knowledgeVersion bump.

Did I verify the docs are actually sufficient to recreate the harness?

Yes — gap analysis:

  • Conceptual completeness: strong. principles.md is a full per-principle inventory (12/12, each
    naming its artifact + path); agent-surfaces.md is the exact projection map; evals.md documents
    the deterministic audit the agent can self-check against.
  • The one gap: the docs didn't point at the copyable canonical templates for exact file
    contents (inlining them verbatim would duplicate and drift from knowledge/templates/). Fixed by
    making knowledge/templates/ the explicit "exact bytes" source in the new section. llms.txt
    (architecture + inventory) + knowledge/templates/ (verbatim files) — both in the same public
    repo llms.txt indexes — together are sufficient.

Verification

  • node dist/cli.js eval --static . — Install Completeness 100% (33/33), Quality Probes 100% (6/6) (back to the main baseline; the skill's extra check is gone)
  • npm run build — clean · npm test66/66 pass
  • npm run docs:build — clean; the new section's anchor slug
    (recreate-the-harness-without-the-cli-no-lock-in) matches the cross-links, the content flows into
    the regenerated llms.txt, and generated canonical/og:url/llms all use tudorpopa.com (zero
    doidor.github.io left in site/)
  • Branch rebased to a single linear commit on origin/main

Also in this PR: bumps the docs toolchain @doidor/markbook + @doidor/markbook-core 0.2.0 → 0.6.0 (devDependencies). All changes are additive with safe defaults — no breaking config changes; markbook.config.ts is unchanged. 0.6.0 collapses the homepage canonical to the site root, so the generated docsite canonical is https://tudorpopa.com/agentrig/. docs:build + the full suite pass on the upgrade.

@doidor
doidor force-pushed the doidor/bootstrap-harness-skill branch from 1156484 to 19f28f2 Compare June 23, 2026 10:43
@doidor doidor changed the title feat(skills): add bootstrap-harness — the no-lock-in escape hatch docs: recreate the harness without the CLI via the docsite llms.txt Jun 23, 2026
@doidor
doidor force-pushed the doidor/bootstrap-harness-skill branch from 19f28f2 to d32e524 Compare June 24, 2026 15:02
doidor and others added 2 commits June 29, 2026 20:51
Replace the idea of a dedicated "bootstrap" skill (redundant with the
docs) with guidance to point any coding agent at the docsite's
machine-readable llms.txt and have it rebuild the harness by hand — the
concrete payoff of AgentRig's no-lock-in design.

- Getting started: add "Recreate the harness without the CLI (no
  lock-in)" — what llms.txt gives an agent (the 12 principles as a
  per-principle artifact inventory, the surface projection map, the
  install-completeness audit), a pointer to knowledge/templates/ for
  exact file contents, and a ready-to-use prompt.
- Home page: the "No lock-in" card now links to that walkthrough.
- README: add a concise "No lock-in — recreate the harness without the
  CLI" section.
- Use the canonical custom domain (https://tudorpopa.com/agentrig) for
  all docsite links and the markbook siteUrl, so generated canonical /
  og:url / sitemap and the prose links agree with where the site is
  actually served.

Docs/README/site-config only; no behavior or installed-artifact changes.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Bump the docs toolchain (@doidor/markbook + @doidor/markbook-core) to the
latest 0.6.0. All changes across 0.3–0.6 are additive with safe defaults
(optional `search`/`viewTransitions` config, nested-directive composition,
keyboard-nav search) — no breaking config changes; markbook.config.ts is
unchanged. 0.6.0 also collapses the homepage canonical to the site root,
so the generated docsite canonical is now https://tudorpopa.com/agentrig/.

docs:build, npm build, eval --static (33/33 + 6/6) and the test suite
(66/66) all pass on the upgrade.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@doidor
doidor force-pushed the doidor/bootstrap-harness-skill branch from 3d703b3 to 6f8240c Compare June 29, 2026 18:54
@doidor
doidor merged commit fae869b into main Jul 29, 2026
2 checks passed
@doidor
doidor deleted the doidor/bootstrap-harness-skill branch July 29, 2026 12:27
@github-actions github-actions Bot mentioned this pull request Jul 29, 2026
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