Brioso Docs

Brioso Docs

Internal documentation for the Brioso monorepo — runbooks, architecture,
policies, and product docs. Built from repo-root docs/ (this tree) and
.agents/docs/ (published under /internal/) on every push to
beta by deploy-docs.yml. The site and its machine feeds sit behind
Cloudflare Access — humans log in with their team email, agents use a
service token (below).

Quickstart

Humans

1. Open https://fitxers.usebrioso.com and log in with your team email
   (one-time PIN; 12h session).
2. Browse the sidebar or press ⌘K to search. Everything under Internal
   mirrors .agents/docs/ — start with
   Architecture, the PRD, or
   the roadmap. Ops material lives in the runbooks
   (GPU gateway, home worker, deploy, secrets…).

Agents

Fetch the docs corpus headlessly with the Access service token, pulled from
Infisical (prod, /infra — the same source of truth as the other infra
secrets):

infisical run --env=prod --path=/infra -- \
  curl -sS -o /tmp/llms-full.txt \
    -H "CF-Access-Client-Id: $CF_ACCESS_CLIENT_ID" \
    -H "CF-Access-Client-Secret: $CF_ACCESS_CLIENT_SECRET" \
    https://fitxers.usebrioso.com/llms-full.txt

Machine-readable feeds, generated at build time:

• /llms.txt — page index
• /llms-full.txt — full corpus in one request
• /llms.json — machine-readable manifest

Token rotation and troubleshooting: docs-site runbook.