docs: add scale and HA sizing guide. index.md: extend. #349

	name: docs-check

	on:
	pull_request:
	branches:
	- 'main'
	paths:
	- 'docs/**'
	- '.github/workflows/docs-check.yaml'
	# Re-run the agent doc-link guard when the template/package it validates changes.
	# The normal Go jobs use a sparse `src` checkout where the guard skips (no docs tree).
	- 'src/internal/agentcontext/**'
	workflow_dispatch:

	permissions:
	contents: read

	concurrency:
	group: docs-check-${{ github.ref }}
	cancel-in-progress: true

	jobs:
	validate-docs:
	runs-on: ubuntu-latest
	steps:
	- name: Checkout kubara repo
	uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0

	- name: Setup Go
	uses: actions/setup-go@924ae3a1cded613372ab5595356fb5720e22ba16 # v6.5.0
	with:
	go-version-file: src/go.mod
	cache: true
	cache-dependency-path: src/go.sum

	- name: Install and setup uv
	uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
	with:
	version: '0.11.25'
	enable-cache: true
	cache-dependency-glob: 'docs/uv.lock'

	- name: Set up Python
	run: \|
	cd docs
	uv python install 3.14.3

	- name: Install dependencies
	run: \|
	cd docs
	uv sync --frozen

	- name: Validate docs build (strict)
	run: make docs-build

	- name: Check agent onboarding doc links resolve
	run: go -C src test ./internal/agentcontext/ -run '^TestRenderedDocLinksExist$'

	- name: Check command docs is up to date
	run: \|
	if ! git diff --exit-code -- docs; then
	echo "::error::Commands document isn't up to date:"
	echo "::error::Please run 'make docs-build' locally to fix it."
	exit 1
	fi

Navigation Menu