# gazperi.com — Docusaurus project

<scope>
Always-load companion when working anywhere under `SITE/site-com/`. Routes Claude to the right operational procedure in `documentation/` per task. Project history and rationale live in spec 0211.
</scope>

## Project shape

<conventions>
- Stack: Docusaurus v3 (TypeScript), Infima theming, custom React landing.
- Hosting: Cloudflare Pages (`gazperi-com` project) on `gazperi.com`. Registrar: Hostinger; nameservers point at Cloudflare.
- Analytics: PostHog EU (`https://eu.i.posthog.com`).
- Git: local-only; no remote.
- Public content lives under `docs/` (route `/educacao/*`). Internal operational procedures live under `documentation/` (this folder, not part of the site build).
</conventions>

## Routing — operational procedures

<instructions>
<step n="1">
**Adding a guide.** Read `documentation/add-guide.md`.
</step>

<step n="2">
**Adding an article.** Read `documentation/add-article.md`.
</step>

<step n="3">
**Adding a top-level section.** Read `documentation/add-section.md`.
</step>

<step n="4">
**Adjusting brand tokens (colors, fonts).** Read `documentation/brand-tokens.md`. Brand source of truth lives in `/Users/gazperi/Developer/ATIVOS/brand/CLAUDE.md` — do not invent tokens.
</step>

<step n="5">
**Running dev / build / deploy locally.** Read `documentation/dev-build-deploy.md`.
</step>

<step n="6">
**Working with PostHog (events, env vars, rotation).** Read `documentation/posthog-events.md`.
</step>

<step n="7">
**Updating SEO surfaces or LLM-discoverability artifacts.** Read `documentation/seo-and-llms.md`.
</step>

<step n="8">
**Deploying to Cloudflare or doing a DNS / domain change.** Read `documentation/cloudflare-deploy.md`.
</step>
</instructions>

## Boundaries

<rules>
- `documentation/` is internal — never published to the site. Public content lives in `docs/`.
- Voice: published copy in `docs/` and `src/pages/` follows `DOCS/brand-voice/` rules (PT-BR). `documentation/` (internal procedures) is English by default.
- Brand tokens come from `ATIVOS/brand/`. Do not duplicate values here.
- No direct edits to `build/` — regenerated on every build.
</rules>