Skip to content

gridaco/grida / .agents/skills/fixtures

fixtures

Verified

Guides authoring, organizing, and referencing test fixtures in this repo. Use when creating new fixtures, writing tests that depend on fixtures, or deciding what should be checked into git. Engine fixtures (rendering corpora) live in the engine repo.

FileKindSize
SKILL.mdskill md3.2 KB
---
name: fixtures
description: Guides authoring, organizing, and referencing test fixtures in this repo. Use when creating new fixtures, writing tests that depend on fixtures, or deciding what should be checked into git. Engine fixtures (rendering corpora) live in the engine repo.
---

# Fixtures

## What fixtures are

Fixtures are static input files — `.fig` archives, clipboard captures,
markdown samples, `.grida` documents — used as **deterministic inputs** to
parsing and I/O tests. They exist so that tests are reproducible,
self-contained, and don't depend on external services or generated data.

## Why we keep them

- **Regression detection** — parse the same input, compare the output.
- **Spec coverage** — each fixture maps to a specific feature or edge case
  being tested (one concept per file).
- **Onboarding** — new contributors can see exactly what the importers handle
  by browsing fixtures.

## Best practices

- **One concept per file.** Don't combine unrelated properties.
- **Self-contained.** No external resources, network fetches, or scripts.
- **Minimal.** Only enough structure to isolate the behavior under test.
- **Descriptive naming.** `<domain>-<property>[-<descriptor>].<ext>` — the
  filename alone should tell you what's being tested.
- **Don't duplicate.** Before adding a fixture, check if an existing one
  already covers the behavior. Extend or split rather than duplicate.

## The tree — who owns what

```
fixtures/
├── test-fig/         # Figma clipboard / .fig fixtures (LFS: *.fig, *.deck)
├── test-figma/       # Figma archive / REST fixtures
├── test-canvas/      # .canvas (dotcanvas) fixtures
├── test-markdown/    # Markdown fixtures
├── fonts/            # ← FROZEN SNAPSHOT (engine-owned)
├── images/           # ← FROZEN SNAPSHOT (engine-owned)
├── test-grida/       # ← FROZEN SNAPSHOT (engine-owned)
└── text-editor/      # ← FROZEN SNAPSHOT (engine-owned)
```

### Frozen snapshots

The engine repo owns the canonical, evolving copies of `fonts/`, `images/`,
`test-grida/` and `text-editor/` (its crates consume them at compile/test
time, with full git history carried over). The copies here exist only so
staying tests keep passing at their original paths — consumers:
`@grida/fonts`, `@grida/refig`, `@grida/io`, the editor reducer round-trip,
`@grida/text-editor`. **Do not edit them here**; re-snapshot deliberately
from the engine repo if the canon evolves. See
[`fixtures/README.md`](../../../fixtures/README.md).

**New engine fixtures** (rendering, SVG/HTML corpora, engine formats) go to
the engine repo: https://github.com/gridaco/nothing/tree/main/fixtures.
New fixtures for staying product code go in a grida-owned directory here.

## Local-only fixtures

Large, third-party, or license-restricted corpora are never committed —
the engine repo keeps its own gitignored `fixtures/local/` convention.
**Never reference a gitignored local path in committed code, tests, or
documentation** — it does not exist in CI or on other developers' machines.
If a doc must mention one (e.g. the refig corpus workflow in the io-figma
skill), clearly mark it **local-only** and note the download/build step.
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall