Instruction file imported from arrobabeto/sip-coffee (.cursor/rules/60-ui/02-research-before-building.mdc). Copyright stays with the author.

Research before building

Name: 02-research-before-building
Author: arrobabeto

Before a new section

Read an existing similar section (SectionHero, SectionProse, SectionCta)
Check src/lib/orbitype/schema.ts defaults for expected JSON shape
Confirm name matches registry convention (Section*.astro)
Review docs/adr/0004-filename-based-section-registry.md

Before layout or global style changes

Read src/styles/global.css — tokens and shared classes live there
Check src/layouts/Base.astro and src/components/layout/*
Verify SEO impact with src/lib/seo.ts and Seo.astro

Before new API or data behaviour

Read src/lib/orbitype/client.ts and the relevant domain module
Check docs/DEVIATIONS.md for verified API behaviour
Run pnpm run mcp:verify if touching MCP-related docs or scripts

Figma / design handoff

Map colours to @theme tokens — do not paste hex into components
Spacing uses Tailwind scale or --spacing-section token
Prefer extending existing sections over one-off page markup

Duplicating patterns incorrectly is worse than reusing them with new props.

{ "ocm": "1", "id": "arrobabeto-sip-coffee-02-research-before-building-rule", "kind": "skill", "name": "02-research-before-building", "description": "Research existing patterns before building new UI or sections", "publisher": "arrobabeto", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "github-cursor-rules" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Research existing patterns before building new UI or sections" ], "primary": false, "metadata": { "source": { "provider": "github-cursor-rules", "repository": "https://github.com/arrobabeto/sip-coffee", "path": ".cursor/rules/60-ui/02-research-before-building.mdc", "ref": "bdb2db920f11158577c79dcaa58a04f9684dd829", "url": "https://github.com/arrobabeto/sip-coffee/blob/bdb2db920f11158577c79dcaa58a04f9684dd829/.cursor/rules/60-ui/02-research-before-building.mdc", "key": "arrobabeto/sip-coffee/.cursor/rules/60-ui/02-research-before-building.mdc" }, "applies_to": "src/components/**,src/styles/**" }, "instructions": "# Research before building\n\n## Before a new section\n\n1. Read an existing similar section (`SectionHero`, `SectionProse`, `SectionCta`)\n2. Check `src/lib/orbitype/schema.ts` defaults for expected JSON shape\n3. Confirm name matches registry convention (`Section*.astro`)\n4. Review `docs/adr/0004-filename-based-section-registry.md`\n\n## Before layout or global style changes\n\n1. Read `src/styles/global.css` — tokens and shared classes live there\n2. Check `src/layouts/Base.astro` and `src/components/layout/*`\n3. Verify SEO impact with `src/lib/seo.ts` and `Seo.astro`\n\n## Before new API or data behavi", "cost": { "context_tokens": 273 } }

02-research-before-building

About

Research before building

Before a new section

Before layout or global style changes

Before new API or data behaviour

Figma / design handoff

Use it

Manifest

Reviews