# Figma Annotations Strategy

This repository contains an AI agent skill for Cursor/Claude that documents flow, UX, and business rules as **native Figma annotations** via the `figma-console` MCP.

## What this skill guarantees

- Uses **only** the native Figma Annotation system (shortcut `Y`).
- Does not create cards, frames, sections, or comments to simulate annotations.
- Creates and applies native categories (colored pills) to each annotation.
- Validates context against 5 critical points before writing annotations.
- Updates annotations in-place with `figma_execute`.

## Requirements

- Cursor (or Claude with local skills support)
- Figma Desktop open
- `figma-console` MCP configured and connected
- Edit permission on the target Figma file

## Quick installation

See the full step-by-step guide in `INSTALL.md`.

## Usage

Example prompt:

> Generate strategic Figma annotations for this flow: [Figma URL]. Use native annotations only, native categories only.

Expected agent flow:

1. Validates the 5 critical points.
2. Maps/creates native categories.
3. Applies annotations to existing components.
4. Removes textual category prefixes (e.g. `[Business Rule]`) when applicable.

## Publishing and permissions on GitHub

This repository can be public for download/fork while keeping edit access restricted to the owner:

- Visibility: `public`
- Collaborators: no direct write access
- Changes via Pull Request
- Branch protection on `main` (recommended)

See the commands and checklist in `INSTALL.md`.