docs git:20260809.0a36076C

Immutable. This exact content is served forever at /api/v1/blob/2100145505b07222.

# Website Skill Router

Agent entry point for `projectbluefin/website`. Find the skill that matches your
task, load only that skill, then act.

**Agents edit content. Agents never edit design.**

## Read order

1. [`AGENTS.md`](../AGENTS.md) — repo contract, boundaries, build commands.
2. This file — task→skill mapping.
3. The one skill file named in the table below.
4. The source file that owns the requested content.

Do not load every skill. Load the smallest skill that answers the job.

## Know what you are editing

`/` is a website. `/wolves/` is a **presentation** performed to a live audience
seated in a theater, projected and synchronized to music, with no interaction
available to anyone. Web-page instincts — scroll it, shrink the type, add a
control, add more words — are defects there. Read `AGENTS.md` under
"`/wolves/` is a presentation" before touching that route.

## Skill index

| I need to... | Load |
|---|---|
| Edit text, links, translations, data, or approved assets | [`content-maintenance/SKILL.md`](skills/content-maintenance/SKILL.md) |
| Change layout, styling, a component, animation, or navigation | [`design-gate/SKILL.md`](skills/design-gate/SKILL.md) |
| Handle lore, fiction, quotes, or attribution | [`editorial-provenance/SKILL.md`](skills/editorial-provenance/SKILL.md) |
| Run tests, builds, staging, deployment, or claim live status | [`validation/SKILL.md`](skills/validation/SKILL.md) |
| Route a session, set remotes, commit, or hand off production | [`agent-workflow/SKILL.md`](skills/agent-workflow/SKILL.md) |
| Work on Cloudflare DNS, Workers, Pages, domains, or Wrangler | [`cloudflare/SKILL.md`](skills/cloudflare/SKILL.md) |
| Edit Wolves content or assets | [`wolves-content/SKILL.md`](skills/wolves-content/SKILL.md) |
| Edit Wolves guardian cards, share pages, or lobby gallery data | [`guardian-character-cards/SKILL.md`](skills/guardian-character-cards/SKILL.md) |
| Do explicitly approved Wolves runtime engineering | [`wolves-runtime-engineering/SKILL.md`](skills/wolves-runtime-engineering/SKILL.md) |
| Write back what I learned before finishing | [`skill-improvement/SKILL.md`](skills/skill-improvement/SKILL.md) |
| Create, restructure, or retire a skill | [`skill-authoring/SKILL.md`](skills/skill-authoring/SKILL.md) |

This table is the single hand-curated router for this repository.
[`skills/INDEX.md`](skills/INDEX.md) points here; do not maintain a second table.

## How to load a skill

Read the skill's YAML front matter first. If `description` matches your task,
read the body. If a fact belongs to another skill or reference, follow the link
rather than duplicating it.

## Factory context

This repository is part of the Project Bluefin factory. Local authority wins:
`AGENTS.md` and this router are authoritative for paths, boundaries, and
commands. `projectbluefin/common` attaches as a pinned shared-contract sidecar
that supplies factory-wide rules; it never overrides local authority.

- Factory model and cross-repo rules: `projectbluefin/common`
  `docs/factory/agentic-model.md`
- Onboarding contract this repo implements: `projectbluefin/common`
  `docs/skills/factory-onboarding.md`
- Cross-repo learning: open an issue in `projectbluefin/common` with the
  learning, affected component, and evidence. Never edit `ublue-os/*`.

A missing or unreachable sidecar is degraded mode, not permission to substitute
a stale sibling checkout.

## Every task loop

1. **Preflight** — verify repository, remote, branch, dirty paths, and the
   skill set you loaded.
2. **Act** — make the smallest scoped change inside the approved boundary.
3. **Validate** — run the smallest relevant check from
   [`skills/validation/SKILL.md`](skills/validation/SKILL.md).
4. **Write back** — update the skill that owns the area in the same commit.
   See [`skills/skill-improvement/SKILL.md`](skills/skill-improvement/SKILL.md).

## Supporting references

Skills define procedures. References state current production facts. Keep those
roles separate.

- [`reference/content-map.md`](reference/content-map.md)
- [`reference/production-entrypoints.md`](reference/production-entrypoints.md)
- [`reference/locale-schema.md`](reference/locale-schema.md)
- [`reference/wolves-runtime.md`](reference/wolves-runtime.md)
- [`reference/wolves-transport-and-clocks.md`](reference/wolves-transport-and-clocks.md)
- [`reference/wolves-intro-and-overlay.md`](reference/wolves-intro-and-overlay.md)
- [`reference/wolves-lore-timing.md`](reference/wolves-lore-timing.md)
- [`reference/wolves-slide-scheduling.md`](reference/wolves-slide-scheduling.md)
- [`reference/wolves-test-harnesses.md`](reference/wolves-test-harnesses.md)
- [`architecture/application-map.md`](architecture/application-map.md)
- [`architecture/runtime-data-flow.md`](architecture/runtime-data-flow.md)