docs: reposition, restyle, and document the governance suite#14
Merged
Conversation
…al + Shiki), add governance suite docs - Positioning: 'local quality authority for AI-written code' hero, why-ctx, comparison (3-plane), messaging.md source of truth, llms.txt - Visual: clean minimal theme, Shiki code blocks (swizzled CodeBlock), ctx logo/favicon - Governance pages: check/score/hotspots/duplicates/overview + sql-gates (preview), map/similar, reference json-output/exit-codes; Claude harness integration - 7 accuracy fixes to existing v0.2.1 docs
# Conflicts: # docs/website/docs/commands/map.md # docs/website/docs/commands/similar.md # docs/website/docs/integrations/claude.md # docs/website/docs/intro.md # docs/website/sidebars.ts
… add Indexing guide - Group main's merged command pages (check/score/hotspots/duplicates/sql/harness/ self-update/map/similar/quality-gates/json-output/sql-schema) into the site IA - Remove duplicate hand-ported governance pages; repoint links - New guides/indexing.md: 'index & embed first', flags (watch/parallel/force), background-watcher pattern; prominent callout in getting-started - llms.txt: real ctx sql (shipped), add indexing guide
- Rename all URLs saldestechnology -> agentis-tools (github, raw, editUrl, badges) - Custom domain: url=docs.agentis.tools, baseUrl=/ (was /ctx/), add static/CNAME - llms.txt raw links + footer llms.txt href updated to root
# Conflicts: # README.md # docs/website/docusaurus.config.ts # docs/website/src/pages/index.tsx
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Repositions and rebuilds the documentation site, restyles it, and documents the full governance suite. Verified locally against the v0.3.0 binary; build passes with `onBrokenLinks: 'throw'`.
Positioning
why-ctx+comparison+ README +messaging.md(source of truth) +llms.txtall lead with: "the local quality authority for AI-written code" — a queryable model that grounds the agent and gates its output.comparison.mduses the three-plane framing (packers / code-graph tools / quality platforms).Governance & commands (adopted from the merged authoritative pages)
check,score,hotspots,duplicates,sql(real--fail-on-rowsgates).map,similar,harness,self-update(+ existing), grouped into the site IA.json-output(the--jsonenvelope),exit-codes(0/1/2/3),sql-schema.--watch/--parallel/--forceflags, and the background-watcher pattern; prominent callout in getting-started.Visual
@theme/CodeBlock,min-light/min-dark) with a copy button; realctxlogo + favicon.Org + domain
agentis-tools; custom domaindocs.agentis.tools(baseUrl: /,static/CNAME);llms.txtserved at the domain root.Accuracy
ctx <cmd> --helpon the v0.3.0 binary; earlier v0.2.1 doc inaccuracies fixed (-j/--parallel,shellsemantics, Go edges, sqlite-vec, CI action name).