AGENTS.md git:20261010.2d09752A

Immutable. This exact content never changes and is served at /api/v1/blob/93b302eb56e17d73.

<!-- SPDX-License-Identifier: CC-BY-SA-4.0 -->
<!-- SPDX-FileCopyrightText: Netresearch DTT GmbH -->

# Agent Guide — netresearch-branding-skill

## Repo Structure

```
.
├── skills/netresearch-branding/
│   ├── SKILL.md                    # Main skill definition (brand guidelines)
│   ├── checkpoints.yaml            # Skill evaluation checkpoints
│   ├── references/                 # Brand reference docs
│   │   ├── colors.md               # Color palette (Hex, RGB, CMYK, Pantone)
│   │   ├── typography.md           # Font specs and scale
│   │   ├── web-design.md           # Component styles and layouts
│   │   └── typo3-extension-branding.md
│   └── templates/                  # Ready-to-use HTML/CSS
│       ├── landing-page.html
│       └── styles.css
├── skills/netresearch-branding/assets/logos/   # Logo files (SVG)
├── examples/components.html        # Interactive component showcase
├── outputStyles/                   # Output style templates
├── evals/evals.json                # Skill evaluation suite
├── Build/Scripts/                  # Build scripts
├── Build/hooks/                    # Git hooks
├── .claude-plugin/plugin.json      # Claude Code plugin manifest
├── composer.json                   # Composer package definition
├── docs/                           # Architecture and planning docs
│   └── ARCHITECTURE.md
└── .github/workflows/              # CI workflows
```

## Commands

No Makefile or npm scripts. Available commands:

- `composer install` — install dependencies (requires [composer-agent-skill-plugin](https://github.com/netresearch/composer-agent-skill-plugin))
- `node skills/netresearch-branding/scripts/contrast-audit.cjs <page>` — measure a rendered page against WCAG AA in headless Chromium (needs `playwright-core`: `npm ci --ignore-scripts` installs the version `package-lock.json` pins (declared in `package.json` under `optionalDependencies`; `--ignore-scripts` keeps the peer dependency's postinstall from rewriting this file), `npx playwright-core install chromium` its browser; or set `PLAYWRIGHT_CORE` to another install). Exits non-zero on a text-contrast failure or a stylesheet/script that did not load. `.github/workflows/contrast-audit.yml` runs it against `skills/netresearch-branding/templates/landing-page.html`, `examples/components.html` and `site/index.html` on every change to those paths, so a colour regression fails CI rather than shipping.
- `uv run Build/Scripts/check-brand-colours.py` — fails when a tracked CSS, SCSS, SVG, HTML, Markdown, JSON or YAML file uses a near miss of a brand colour: not equal to `#2F99A4`, `#585961` or `#FF4D00`, but every RGB channel within 8 of one, or CIEDE2000 below 2. The script header lists what it reads, what it does not, and the deliberate quotes. Tests: `uv run --no-project --with-requirements Build/Scripts/check-brand-colours.py python -B Build/Scripts/tests/test_check_brand_colours.py`. `.github/workflows/brand-colours.yml` runs both.

## Rules

1. **Colors**: Primary `#2F99A4` (turquoise), accent `#FF4D00` (orange — accent only), text `#585961`
2. **Typography**: Raleway for headlines, Open Sans for body, Calibri for documents
3. **Logo**: Use `skills/netresearch-branding/assets/logos/netresearch-symbol-only.svg`, min 32x32px icon / 120px digital
4. **Footer**: Must link to https://www.netresearch.de/ with "Netresearch DTT GmbH"
5. **Accessibility**: WCAG AA compliance mandatory
6. **White space**: High white space design principle throughout
7. **TYPO3 extensions**: Icon at `Resources/Public/Icons/Extension.svg`, vendor `netresearch/`

## References

- [SKILL.md](skills/netresearch-branding/SKILL.md) — full brand guidelines and auto-trigger rules
- [colors.md](skills/netresearch-branding/references/colors.md) — complete color specs with CSS variables
- [typography.md](skills/netresearch-branding/references/typography.md) — font weights, sizes, responsive scale
- [web-design.md](skills/netresearch-branding/references/web-design.md) — component library and layout patterns
- [typo3-extension-branding.md](skills/netresearch-branding/references/typo3-extension-branding.md) — TYPO3 extension branding requirements
- [co-branding.md](skills/netresearch-branding/references/co-branding.md) — optional endorsement lines, only on an explicit co-branding request
- [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) — architecture overview