# Fluent Mystique Builder

Reference guide for building Mystique manifests and selecting OOTB components quickly and consistently.

## Purpose

This skill package is organized so an AI agent (or developer) can:

1. Find the right component alias fast
2. Read exact prop and composition guidance
3. Generate valid manifest JSON with predictable patterns

## Directory Map

- `SKILL.md`: primary operating instructions for `/fluent-mystique-builder`
- `COMPONENT_TEMPLATE.md`: canonical template for component documentation files
- `components/index.md`: AI-friendly lookup table (`alias`, `category`, `module`)
- `components/*.md`: one file per component, with frontmatter and `## AI Parse Notes`

## Recommended Lookup Flow

For any frontend ask (for example: "build a list page with filters and actions"):

1. Open `components/index.md` and shortlist candidate aliases by category/module.
2. Open matching `components/<alias>.md` files for:
   - key props
   - data binding
   - composition patterns
   - gotchas
3. Use frontmatter + `## AI Parse Notes` for deterministic parsing and component selection.
4. Build the manifest using instructions in `SKILL.md`.

## Authoring and Maintenance Rules

- Keep one component per Markdown file under `components/`.
- Keep frontmatter keys present and accurate:
  - `alias`
  - `aliases`
  - `category`
  - `module`
- Always include `## AI Parse Notes`.
- When adding or editing a component doc, update `components/index.md`.
- Keep alias coverage aligned with the registry in:
  - `../fluent-mystique-validate/SKILL.md` (`Component Alias Registry`)

## Validation Checklist

Before considering docs updated:

- All component docs include frontmatter and `## AI Parse Notes`
- `components/index.md` row count matches component doc count
- No missing or extra aliases compared to `fluent-mystique-validate/SKILL.md`
- No control-character corruption in docs

## Typical End-User Ask Simulation

Input: "I need a frontend page with table/list data, filters, and action buttons."

Lookup pattern:
- Search aliases in `components/index.md` for `fc.list`, `fc.filterPanel`, `fc.button.*`, `fc.modal.button`, `fc.drawer.button`.
- Read selected component files for prop-level wiring and data-source usage.
- Assemble the final manifest page structure in `SKILL.md` patterns.

