AGENTS.md · diff

git:20260929.2011750 to git:20260930.b215b1e

4 added, 1 removed. Audit A to A.

+

+

# 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 a local `playwright-core`; set `PLAYWRIGHT_CORE` to point at it). 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.

+ - `node skills/netresearch-branding/scripts/contrast-audit.cjs <page>` — measure a rendered page against WCAG AA in headless Chromium (needs `playwright-core`: `npm install` installs the version pinned in `package.json` under `optionalDependencies`, `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

- [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) — architecture overview