create-idia-app 0.2.0 → 0.2.2

package/template/.idia/brain/ai/agents/retrieval-cheatsheet.md

@@ -1,209 +0,0 @@
-# ds-brain — Retrieval Cheatsheet
-
-Output mode and task intent are **independent axes** (see `docs/RETRIEVAL-CONTRACT.md`). Classify both, then load mode docs plus intent docs, components, and foundations.
-
-## Retrieval recipe
-
-- Read `AGENTS.md` or `.idia/brain/ai/agents/AGENTS.generated.md`.
-- Classify **output mode** (form of work) and **task intent** (UI/domain task) separately.
-- Load output-mode docs from the table below.
-- Load task-intent docs, then component docs via `component-registry.generated.json` or intent component lists.
-- Load listed foundations when visual/token accuracy matters.
-- Inspect package source only when API or behaviour must be confirmed.
-- Prefer `.idia/brain/registry/ai-index.generated.json` for resolved paths; fall back to `.idia/brain/registry/ai-index.generated.json`.
-
-## Output modes (contract — 5 modes)
-
-### `component-implementation`
-
-- **Docs:** `ai/generation-principles.md`
-- **Keywords:** component, implementation, tsx, react, api
-- **Note:** Contract mode not in seed `outputModes`; combine with task-intent component lists and inspect source when API accuracy matters.
-
-### `docs-maintenance`
-
-- **Docs:** `ai/generation-principles.md`, `ai/review-loop.md`
-- **Keywords:** audit, docs, mapping, schema, update
-
-### `interactive-prototype`
-
-- **Docs:** `ai/generation-principles.md`, `ai/interactive-prototypes.md`
-- **Keywords:** code, implementation, interactive, prototype, react, tsx
-
-### `static-ui-idea`
-
-- **Docs:** `ai/generation-principles.md`, `ai/static-ui-ideas.md`, `docs/VISUAL-REFERENCES.md`
-- **Keywords:** calibration, exploration, idea, image, mockup, static, storybook, visual, visual-reference
-
-### `storybook-docs`
-
-- **Docs:** `ai/generation-principles.md`
-- **Keywords:** docs, example, story, storybook
-
-## Task intents (seed)
-
-### `button-action`
-
-- **Docs:** `decisions/action-hierarchy.md`, `decisions/button-vs-link.md`
-- **Components:** app-pressable, button, button-group, close-button, social-button
-- **Foundations:** `foundations/color.md`, `foundations/motion.md`, `foundations/radius.md`, `foundations/shadows.md`, `foundations/spacing.md`
-
-### `choice-input`
-
-- **Docs:** `decisions/radio-vs-select-vs-checkbox.md`, `patterns/forms.md`
-- **Components:** checkbox, custom-selection, input, radio, segmented-selector, select, … (+1 more)
-- **Foundations:** `foundations/spacing.md`, `foundations/typography.md`
-
-### `component-docs`
-
-- **Docs:** `ai/generation-principles.md`, `ai/review-loop.md`
-- **Components:** accordion, app-pressable, avatar, avatar-upload, back-link, badge, … (+70 more)
-- **Foundations:** `foundations/border-width.md`, `foundations/shadows.md`, `foundations/tokens.md`, `foundations/z-index.md`
-
-### `data-display`
-
-- **Docs:** `patterns/search-highlight.md`
-- **Components:** avatar, badge, calendar, card-list, carousel, catalog-browser, … (+7 more)
-- **Foundations:** `foundations/color.md`, `foundations/spacing.md`, `foundations/typography.md`
-
-### `data-table`
-
-- **Docs:** `patterns/search-highlight.md`, `patterns/table-filters.md`
-- **Components:** catalog-browser, date-input, empty-state, highlight-text, record-card, search-input, … (+2 more)
-- **Foundations:** `foundations/color.md`, `foundations/spacing.md`, `foundations/typography.md`
-
-### `feedback-loading`
-
-- **Docs:** `patterns/empty-status-flow.md`
-- **Components:** empty-records-mobile, empty-state, full-page-loader, notification-banner, notification-text, skeleton, … (+3 more)
-- **Foundations:** `foundations/color.md`, `foundations/motion.md`
-
-### `form`
-
-- **Docs:** `decisions/action-hierarchy.md`, `decisions/button-vs-link.md`, `decisions/radio-vs-select-vs-checkbox.md`, `patterns/address-capture.md`, `patterns/calendar-scheduling.md`, `patterns/form-composition.md`, `patterns/forms.md`, `patterns/media-upload.md`, `patterns/phone-and-currency.md`, `patterns/validation-forms.md`
-- **Components:** avatar-upload, button, checkbox, custom-selection, date-input, date-range-input, … (+20 more)
-- **Foundations:** `foundations/color.md`, `foundations/spacing.md`, `foundations/tokens.md`, `foundations/typography.md`
-
-### `layout`
-
-- **Docs:** `patterns/sticky-chrome.md`
-- **Components:** accordion, card-container, collapsible, floating-action-bar, layout, list-simple, … (+3 more)
-- **Foundations:** `foundations/spacing.md`, `foundations/typography.md`
-
-### `list-selection`
-
-- **Docs:** `patterns/list-selection.md`
-- **Components:** catalog-browser, checkbox, custom-selection, list-menu, list-menu-action, radio
-- **Foundations:** `foundations/spacing.md`, `foundations/typography.md`
-
-### `loading-states`
-
-- **Docs:** `patterns/loading-skeletons.md`
-- **Components:** button, card-list, full-page-loader, skeleton, spinner, table, … (+1 more)
-- **Foundations:** `foundations/color.md`, `foundations/motion.md`
-
-### `modal-navigation`
-
-- **Docs:** `decisions/action-hierarchy.md`, `decisions/button-vs-link.md`, `patterns/modal-routing.md`
-- **Components:** back-link, button, confirmation-modal, link, modal
-- **Foundations:** `foundations/motion.md`, `foundations/spacing.md`, `foundations/z-index.md`
-
-### `navigation`
-
-- **Docs:** `decisions/action-hierarchy.md`, `decisions/button-vs-link.md`, `patterns/navigation-pressable.md`
-- **Components:** back-link, link, list-menu, list-menu-action, tabs, tabs-simple, … (+1 more)
-- **Foundations:** `foundations/color.md`, `foundations/spacing.md`, `foundations/typography.md`
-
-### `overlay-stack`
-
-- **Docs:** `patterns/overlay-stack.md`
-- **Components:** confirmation-modal, full-page-loader, modal, overlay, picker-sheet, popover-wrapper, … (+2 more)
-- **Foundations:** `foundations/shadows.md`, `foundations/z-index.md`
-
-### `wizard`
-
-- **Docs:** `patterns/wizard-flows.md`
-- **Components:** button, confirmation-modal, form-section, wizard-stepper
-- **Foundations:** `foundations/spacing.md`, `foundations/typography.md`
-
-## Mode × intent matrix
-
-Each row is one classified pair. Load **mode docs ∪ intent docs** (dedupe), then intent components and foundations.
-
-| Output mode | Task intent | Mode docs | Intent docs | Components | Foundations |
-|---|---|---|---|---|---|
-| `component-implementation` | `button-action` | ai/generation-principles.md | decisions/action-hierarchy.md, decisions/button-vs-link.md | components/app-pressable.md, components/button.md, components/button-group.md, components/close-button.md, … | foundations/color.md, foundations/motion.md, foundations/radius.md, foundations/shadows.md, foundations/spacing.md |
-| `component-implementation` | `choice-input` | ai/generation-principles.md | decisions/radio-vs-select-vs-checkbox.md, patterns/forms.md | components/checkbox.md, components/custom-selection.md, components/input.md, components/radio.md, … | foundations/spacing.md, foundations/typography.md |
-| `component-implementation` | `component-docs` | ai/generation-principles.md | ai/generation-principles.md, ai/review-loop.md | components/accordion.md, components/app-pressable.md, components/avatar.md, components/avatar-upload.md, … | foundations/border-width.md, foundations/shadows.md, foundations/tokens.md, foundations/z-index.md |
-| `component-implementation` | `data-display` | ai/generation-principles.md | patterns/search-highlight.md | components/avatar.md, components/badge.md, components/calendar.md, components/card-list.md, … | foundations/color.md, foundations/spacing.md, foundations/typography.md |
-| `component-implementation` | `data-table` | ai/generation-principles.md | patterns/search-highlight.md, patterns/table-filters.md | components/catalog-browser.md, components/date-input.md, components/empty-state.md, components/highlight-text.md, … | foundations/color.md, foundations/spacing.md, foundations/typography.md |
-| `component-implementation` | `feedback-loading` | ai/generation-principles.md | patterns/empty-status-flow.md | components/empty-records-mobile.md, components/empty-state.md, components/full-page-loader.md, components/notification-banner.md, … | foundations/color.md, foundations/motion.md |
-| `component-implementation` | `form` | ai/generation-principles.md | decisions/action-hierarchy.md, decisions/button-vs-link.md, decisions/radio-vs-select-vs-checkbox.md, patterns/address-capture.md, patterns/calendar-scheduling.md, patterns/form-composition.md, patterns/forms.md, patterns/media-upload.md, patterns/phone-and-currency.md, patterns/validation-forms.md | components/avatar-upload.md, components/button.md, components/checkbox.md, components/custom-selection.md, … | foundations/color.md, foundations/spacing.md, foundations/tokens.md, foundations/typography.md |
-| `component-implementation` | `layout` | ai/generation-principles.md | patterns/sticky-chrome.md | components/accordion.md, components/card-container.md, components/collapsible.md, components/floating-action-bar.md, … | foundations/spacing.md, foundations/typography.md |
-| `component-implementation` | `list-selection` | ai/generation-principles.md | patterns/list-selection.md | components/catalog-browser.md, components/checkbox.md, components/custom-selection.md, components/list-menu.md, … | foundations/spacing.md, foundations/typography.md |
-| `component-implementation` | `loading-states` | ai/generation-principles.md | patterns/loading-skeletons.md | components/button.md, components/card-list.md, components/full-page-loader.md, components/skeleton.md, … | foundations/color.md, foundations/motion.md |
-| `component-implementation` | `modal-navigation` | ai/generation-principles.md | decisions/action-hierarchy.md, decisions/button-vs-link.md, patterns/modal-routing.md | components/back-link.md, components/button.md, components/confirmation-modal.md, components/link.md, … | foundations/motion.md, foundations/spacing.md, foundations/z-index.md |
-| `component-implementation` | `navigation` | ai/generation-principles.md | decisions/action-hierarchy.md, decisions/button-vs-link.md, patterns/navigation-pressable.md | components/back-link.md, components/link.md, components/list-menu.md, components/list-menu-action.md, … | foundations/color.md, foundations/spacing.md, foundations/typography.md |
-| `component-implementation` | `overlay-stack` | ai/generation-principles.md | patterns/overlay-stack.md | components/confirmation-modal.md, components/full-page-loader.md, components/modal.md, components/overlay.md, … | foundations/shadows.md, foundations/z-index.md |
-| `component-implementation` | `wizard` | ai/generation-principles.md | patterns/wizard-flows.md | components/button.md, components/confirmation-modal.md, components/form-section.md, components/wizard-stepper.md | foundations/spacing.md, foundations/typography.md |
-| `docs-maintenance` | `button-action` | ai/generation-principles.md, ai/review-loop.md | decisions/action-hierarchy.md, decisions/button-vs-link.md | components/app-pressable.md, components/button.md, components/button-group.md, components/close-button.md, … | foundations/color.md, foundations/motion.md, foundations/radius.md, foundations/shadows.md, foundations/spacing.md |
-| `docs-maintenance` | `choice-input` | ai/generation-principles.md, ai/review-loop.md | decisions/radio-vs-select-vs-checkbox.md, patterns/forms.md | components/checkbox.md, components/custom-selection.md, components/input.md, components/radio.md, … | foundations/spacing.md, foundations/typography.md |
-| `docs-maintenance` | `component-docs` | ai/generation-principles.md, ai/review-loop.md | ai/generation-principles.md, ai/review-loop.md | components/accordion.md, components/app-pressable.md, components/avatar.md, components/avatar-upload.md, … | foundations/border-width.md, foundations/shadows.md, foundations/tokens.md, foundations/z-index.md |
-| `docs-maintenance` | `data-display` | ai/generation-principles.md, ai/review-loop.md | patterns/search-highlight.md | components/avatar.md, components/badge.md, components/calendar.md, components/card-list.md, … | foundations/color.md, foundations/spacing.md, foundations/typography.md |
-| `docs-maintenance` | `data-table` | ai/generation-principles.md, ai/review-loop.md | patterns/search-highlight.md, patterns/table-filters.md | components/catalog-browser.md, components/date-input.md, components/empty-state.md, components/highlight-text.md, … | foundations/color.md, foundations/spacing.md, foundations/typography.md |
-| `docs-maintenance` | `feedback-loading` | ai/generation-principles.md, ai/review-loop.md | patterns/empty-status-flow.md | components/empty-records-mobile.md, components/empty-state.md, components/full-page-loader.md, components/notification-banner.md, … | foundations/color.md, foundations/motion.md |
-| `docs-maintenance` | `form` | ai/generation-principles.md, ai/review-loop.md | decisions/action-hierarchy.md, decisions/button-vs-link.md, decisions/radio-vs-select-vs-checkbox.md, patterns/address-capture.md, patterns/calendar-scheduling.md, patterns/form-composition.md, patterns/forms.md, patterns/media-upload.md, patterns/phone-and-currency.md, patterns/validation-forms.md | components/avatar-upload.md, components/button.md, components/checkbox.md, components/custom-selection.md, … | foundations/color.md, foundations/spacing.md, foundations/tokens.md, foundations/typography.md |
-| `docs-maintenance` | `layout` | ai/generation-principles.md, ai/review-loop.md | patterns/sticky-chrome.md | components/accordion.md, components/card-container.md, components/collapsible.md, components/floating-action-bar.md, … | foundations/spacing.md, foundations/typography.md |
-| `docs-maintenance` | `list-selection` | ai/generation-principles.md, ai/review-loop.md | patterns/list-selection.md | components/catalog-browser.md, components/checkbox.md, components/custom-selection.md, components/list-menu.md, … | foundations/spacing.md, foundations/typography.md |
-| `docs-maintenance` | `loading-states` | ai/generation-principles.md, ai/review-loop.md | patterns/loading-skeletons.md | components/button.md, components/card-list.md, components/full-page-loader.md, components/skeleton.md, … | foundations/color.md, foundations/motion.md |
-| `docs-maintenance` | `modal-navigation` | ai/generation-principles.md, ai/review-loop.md | decisions/action-hierarchy.md, decisions/button-vs-link.md, patterns/modal-routing.md | components/back-link.md, components/button.md, components/confirmation-modal.md, components/link.md, … | foundations/motion.md, foundations/spacing.md, foundations/z-index.md |
-| `docs-maintenance` | `navigation` | ai/generation-principles.md, ai/review-loop.md | decisions/action-hierarchy.md, decisions/button-vs-link.md, patterns/navigation-pressable.md | components/back-link.md, components/link.md, components/list-menu.md, components/list-menu-action.md, … | foundations/color.md, foundations/spacing.md, foundations/typography.md |
-| `docs-maintenance` | `overlay-stack` | ai/generation-principles.md, ai/review-loop.md | patterns/overlay-stack.md | components/confirmation-modal.md, components/full-page-loader.md, components/modal.md, components/overlay.md, … | foundations/shadows.md, foundations/z-index.md |
-| `docs-maintenance` | `wizard` | ai/generation-principles.md, ai/review-loop.md | patterns/wizard-flows.md | components/button.md, components/confirmation-modal.md, components/form-section.md, components/wizard-stepper.md | foundations/spacing.md, foundations/typography.md |
-| `interactive-prototype` | `button-action` | ai/generation-principles.md, ai/interactive-prototypes.md | decisions/action-hierarchy.md, decisions/button-vs-link.md | components/app-pressable.md, components/button.md, components/button-group.md, components/close-button.md, … | foundations/color.md, foundations/motion.md, foundations/radius.md, foundations/shadows.md, foundations/spacing.md |
-| `interactive-prototype` | `choice-input` | ai/generation-principles.md, ai/interactive-prototypes.md | decisions/radio-vs-select-vs-checkbox.md, patterns/forms.md | components/checkbox.md, components/custom-selection.md, components/input.md, components/radio.md, … | foundations/spacing.md, foundations/typography.md |
-| `interactive-prototype` | `component-docs` | ai/generation-principles.md, ai/interactive-prototypes.md | ai/generation-principles.md, ai/review-loop.md | components/accordion.md, components/app-pressable.md, components/avatar.md, components/avatar-upload.md, … | foundations/border-width.md, foundations/shadows.md, foundations/tokens.md, foundations/z-index.md |
-| `interactive-prototype` | `data-display` | ai/generation-principles.md, ai/interactive-prototypes.md | patterns/search-highlight.md | components/avatar.md, components/badge.md, components/calendar.md, components/card-list.md, … | foundations/color.md, foundations/spacing.md, foundations/typography.md |
-| `interactive-prototype` | `data-table` | ai/generation-principles.md, ai/interactive-prototypes.md | patterns/search-highlight.md, patterns/table-filters.md | components/catalog-browser.md, components/date-input.md, components/empty-state.md, components/highlight-text.md, … | foundations/color.md, foundations/spacing.md, foundations/typography.md |
-| `interactive-prototype` | `feedback-loading` | ai/generation-principles.md, ai/interactive-prototypes.md | patterns/empty-status-flow.md | components/empty-records-mobile.md, components/empty-state.md, components/full-page-loader.md, components/notification-banner.md, … | foundations/color.md, foundations/motion.md |
-| `interactive-prototype` | `form` | ai/generation-principles.md, ai/interactive-prototypes.md | decisions/action-hierarchy.md, decisions/button-vs-link.md, decisions/radio-vs-select-vs-checkbox.md, patterns/address-capture.md, patterns/calendar-scheduling.md, patterns/form-composition.md, patterns/forms.md, patterns/media-upload.md, patterns/phone-and-currency.md, patterns/validation-forms.md | components/avatar-upload.md, components/button.md, components/checkbox.md, components/custom-selection.md, … | foundations/color.md, foundations/spacing.md, foundations/tokens.md, foundations/typography.md |
-| `interactive-prototype` | `layout` | ai/generation-principles.md, ai/interactive-prototypes.md | patterns/sticky-chrome.md | components/accordion.md, components/card-container.md, components/collapsible.md, components/floating-action-bar.md, … | foundations/spacing.md, foundations/typography.md |
-| `interactive-prototype` | `list-selection` | ai/generation-principles.md, ai/interactive-prototypes.md | patterns/list-selection.md | components/catalog-browser.md, components/checkbox.md, components/custom-selection.md, components/list-menu.md, … | foundations/spacing.md, foundations/typography.md |
-| `interactive-prototype` | `loading-states` | ai/generation-principles.md, ai/interactive-prototypes.md | patterns/loading-skeletons.md | components/button.md, components/card-list.md, components/full-page-loader.md, components/skeleton.md, … | foundations/color.md, foundations/motion.md |
-| `interactive-prototype` | `modal-navigation` | ai/generation-principles.md, ai/interactive-prototypes.md | decisions/action-hierarchy.md, decisions/button-vs-link.md, patterns/modal-routing.md | components/back-link.md, components/button.md, components/confirmation-modal.md, components/link.md, … | foundations/motion.md, foundations/spacing.md, foundations/z-index.md |
-| `interactive-prototype` | `navigation` | ai/generation-principles.md, ai/interactive-prototypes.md | decisions/action-hierarchy.md, decisions/button-vs-link.md, patterns/navigation-pressable.md | components/back-link.md, components/link.md, components/list-menu.md, components/list-menu-action.md, … | foundations/color.md, foundations/spacing.md, foundations/typography.md |
-| `interactive-prototype` | `overlay-stack` | ai/generation-principles.md, ai/interactive-prototypes.md | patterns/overlay-stack.md | components/confirmation-modal.md, components/full-page-loader.md, components/modal.md, components/overlay.md, … | foundations/shadows.md, foundations/z-index.md |
-| `interactive-prototype` | `wizard` | ai/generation-principles.md, ai/interactive-prototypes.md | patterns/wizard-flows.md | components/button.md, components/confirmation-modal.md, components/form-section.md, components/wizard-stepper.md | foundations/spacing.md, foundations/typography.md |
-| `static-ui-idea` | `button-action` | ai/generation-principles.md, ai/static-ui-ideas.md, docs/VISUAL-REFERENCES.md | decisions/action-hierarchy.md, decisions/button-vs-link.md | components/app-pressable.md, components/button.md, components/button-group.md, components/close-button.md, … | foundations/color.md, foundations/motion.md, foundations/radius.md, foundations/shadows.md, foundations/spacing.md |
-| `static-ui-idea` | `choice-input` | ai/generation-principles.md, ai/static-ui-ideas.md, docs/VISUAL-REFERENCES.md | decisions/radio-vs-select-vs-checkbox.md, patterns/forms.md | components/checkbox.md, components/custom-selection.md, components/input.md, components/radio.md, … | foundations/spacing.md, foundations/typography.md |
-| `static-ui-idea` | `component-docs` | ai/generation-principles.md, ai/static-ui-ideas.md, docs/VISUAL-REFERENCES.md | ai/generation-principles.md, ai/review-loop.md | components/accordion.md, components/app-pressable.md, components/avatar.md, components/avatar-upload.md, … | foundations/border-width.md, foundations/shadows.md, foundations/tokens.md, foundations/z-index.md |
-| `static-ui-idea` | `data-display` | ai/generation-principles.md, ai/static-ui-ideas.md, docs/VISUAL-REFERENCES.md | patterns/search-highlight.md | components/avatar.md, components/badge.md, components/calendar.md, components/card-list.md, … | foundations/color.md, foundations/spacing.md, foundations/typography.md |
-| `static-ui-idea` | `data-table` | ai/generation-principles.md, ai/static-ui-ideas.md, docs/VISUAL-REFERENCES.md | patterns/search-highlight.md, patterns/table-filters.md | components/catalog-browser.md, components/date-input.md, components/empty-state.md, components/highlight-text.md, … | foundations/color.md, foundations/spacing.md, foundations/typography.md |
-| `static-ui-idea` | `feedback-loading` | ai/generation-principles.md, ai/static-ui-ideas.md, docs/VISUAL-REFERENCES.md | patterns/empty-status-flow.md | components/empty-records-mobile.md, components/empty-state.md, components/full-page-loader.md, components/notification-banner.md, … | foundations/color.md, foundations/motion.md |
-| `static-ui-idea` | `form` | ai/generation-principles.md, ai/static-ui-ideas.md, docs/VISUAL-REFERENCES.md | decisions/action-hierarchy.md, decisions/button-vs-link.md, decisions/radio-vs-select-vs-checkbox.md, patterns/address-capture.md, patterns/calendar-scheduling.md, patterns/form-composition.md, patterns/forms.md, patterns/media-upload.md, patterns/phone-and-currency.md, patterns/validation-forms.md | components/avatar-upload.md, components/button.md, components/checkbox.md, components/custom-selection.md, … | foundations/color.md, foundations/spacing.md, foundations/tokens.md, foundations/typography.md |
-| `static-ui-idea` | `layout` | ai/generation-principles.md, ai/static-ui-ideas.md, docs/VISUAL-REFERENCES.md | patterns/sticky-chrome.md | components/accordion.md, components/card-container.md, components/collapsible.md, components/floating-action-bar.md, … | foundations/spacing.md, foundations/typography.md |
-| `static-ui-idea` | `list-selection` | ai/generation-principles.md, ai/static-ui-ideas.md, docs/VISUAL-REFERENCES.md | patterns/list-selection.md | components/catalog-browser.md, components/checkbox.md, components/custom-selection.md, components/list-menu.md, … | foundations/spacing.md, foundations/typography.md |
-| `static-ui-idea` | `loading-states` | ai/generation-principles.md, ai/static-ui-ideas.md, docs/VISUAL-REFERENCES.md | patterns/loading-skeletons.md | components/button.md, components/card-list.md, components/full-page-loader.md, components/skeleton.md, … | foundations/color.md, foundations/motion.md |
-| `static-ui-idea` | `modal-navigation` | ai/generation-principles.md, ai/static-ui-ideas.md, docs/VISUAL-REFERENCES.md | decisions/action-hierarchy.md, decisions/button-vs-link.md, patterns/modal-routing.md | components/back-link.md, components/button.md, components/confirmation-modal.md, components/link.md, … | foundations/motion.md, foundations/spacing.md, foundations/z-index.md |
-| `static-ui-idea` | `navigation` | ai/generation-principles.md, ai/static-ui-ideas.md, docs/VISUAL-REFERENCES.md | decisions/action-hierarchy.md, decisions/button-vs-link.md, patterns/navigation-pressable.md | components/back-link.md, components/link.md, components/list-menu.md, components/list-menu-action.md, … | foundations/color.md, foundations/spacing.md, foundations/typography.md |
-| `static-ui-idea` | `overlay-stack` | ai/generation-principles.md, ai/static-ui-ideas.md, docs/VISUAL-REFERENCES.md | patterns/overlay-stack.md | components/confirmation-modal.md, components/full-page-loader.md, components/modal.md, components/overlay.md, … | foundations/shadows.md, foundations/z-index.md |
-| `static-ui-idea` | `wizard` | ai/generation-principles.md, ai/static-ui-ideas.md, docs/VISUAL-REFERENCES.md | patterns/wizard-flows.md | components/button.md, components/confirmation-modal.md, components/form-section.md, components/wizard-stepper.md | foundations/spacing.md, foundations/typography.md |
-| `storybook-docs` | `button-action` | ai/generation-principles.md | decisions/action-hierarchy.md, decisions/button-vs-link.md | components/app-pressable.md, components/button.md, components/button-group.md, components/close-button.md, … | foundations/color.md, foundations/motion.md, foundations/radius.md, foundations/shadows.md, foundations/spacing.md |
-| `storybook-docs` | `choice-input` | ai/generation-principles.md | decisions/radio-vs-select-vs-checkbox.md, patterns/forms.md | components/checkbox.md, components/custom-selection.md, components/input.md, components/radio.md, … | foundations/spacing.md, foundations/typography.md |
-| `storybook-docs` | `component-docs` | ai/generation-principles.md | ai/generation-principles.md, ai/review-loop.md | components/accordion.md, components/app-pressable.md, components/avatar.md, components/avatar-upload.md, … | foundations/border-width.md, foundations/shadows.md, foundations/tokens.md, foundations/z-index.md |
-| `storybook-docs` | `data-display` | ai/generation-principles.md | patterns/search-highlight.md | components/avatar.md, components/badge.md, components/calendar.md, components/card-list.md, … | foundations/color.md, foundations/spacing.md, foundations/typography.md |
-| `storybook-docs` | `data-table` | ai/generation-principles.md | patterns/search-highlight.md, patterns/table-filters.md | components/catalog-browser.md, components/date-input.md, components/empty-state.md, components/highlight-text.md, … | foundations/color.md, foundations/spacing.md, foundations/typography.md |
-| `storybook-docs` | `feedback-loading` | ai/generation-principles.md | patterns/empty-status-flow.md | components/empty-records-mobile.md, components/empty-state.md, components/full-page-loader.md, components/notification-banner.md, … | foundations/color.md, foundations/motion.md |
-| `storybook-docs` | `form` | ai/generation-principles.md | decisions/action-hierarchy.md, decisions/button-vs-link.md, decisions/radio-vs-select-vs-checkbox.md, patterns/address-capture.md, patterns/calendar-scheduling.md, patterns/form-composition.md, patterns/forms.md, patterns/media-upload.md, patterns/phone-and-currency.md, patterns/validation-forms.md | components/avatar-upload.md, components/button.md, components/checkbox.md, components/custom-selection.md, … | foundations/color.md, foundations/spacing.md, foundations/tokens.md, foundations/typography.md |
-| `storybook-docs` | `layout` | ai/generation-principles.md | patterns/sticky-chrome.md | components/accordion.md, components/card-container.md, components/collapsible.md, components/floating-action-bar.md, … | foundations/spacing.md, foundations/typography.md |
-| `storybook-docs` | `list-selection` | ai/generation-principles.md | patterns/list-selection.md | components/catalog-browser.md, components/checkbox.md, components/custom-selection.md, components/list-menu.md, … | foundations/spacing.md, foundations/typography.md |
-| `storybook-docs` | `loading-states` | ai/generation-principles.md | patterns/loading-skeletons.md | components/button.md, components/card-list.md, components/full-page-loader.md, components/skeleton.md, … | foundations/color.md, foundations/motion.md |
-| `storybook-docs` | `modal-navigation` | ai/generation-principles.md | decisions/action-hierarchy.md, decisions/button-vs-link.md, patterns/modal-routing.md | components/back-link.md, components/button.md, components/confirmation-modal.md, components/link.md, … | foundations/motion.md, foundations/spacing.md, foundations/z-index.md |
-| `storybook-docs` | `navigation` | ai/generation-principles.md | decisions/action-hierarchy.md, decisions/button-vs-link.md, patterns/navigation-pressable.md | components/back-link.md, components/link.md, components/list-menu.md, components/list-menu-action.md, … | foundations/color.md, foundations/spacing.md, foundations/typography.md |
-| `storybook-docs` | `overlay-stack` | ai/generation-principles.md | patterns/overlay-stack.md | components/confirmation-modal.md, components/full-page-loader.md, components/modal.md, components/overlay.md, … | foundations/shadows.md, foundations/z-index.md |
-| `storybook-docs` | `wizard` | ai/generation-principles.md | patterns/wizard-flows.md | components/button.md, components/confirmation-modal.md, components/form-section.md, components/wizard-stepper.md | foundations/spacing.md, foundations/typography.md |
-
-## Source docs
-
-- `.idia/brain/registry/ai-index.generated.json`
-- `docs/RETRIEVAL-CONTRACT.md`

package/template/.idia/brain/ai/skills/components/button/SKILL.md

@@ -1,32 +0,0 @@
----
-name: button
-description: Worked example per-component skill for Button. Operational API guidance extracted from the brain component doc.
-generated: true
-sources:
-  - ds-brain/components/button.md
----
-# Button — Component Skill
-
-Per-component worked example. Retrieve `components/button.md` for full mappings and behaviour; this skill summarizes AI-safe usage.
-
-## Operational guidance
-
-- Use `Button` for actions, not normal navigation.
-- Use one `primary` variant per local action group.
-- Use `primary` for the main submit/continue/save action.
-- Use `outline-grey` for cancel in form and modal footers; `secondary` for back on wizard steps.
-- Use `danger` or `danger-outline` for destructive delete/remove actions.
-- Document all eight variants and five sizes — do not invent variants or sizes.
-- For icon-only buttons, include `ariaLabel`.
-- Mention `aria-busy` and disabled semantics for loading states.
-- Reference semantic `colorTheme` tokens (for example `backgroundPrimaryBold200`, `borderNeutralBold100`, `borderDangerBold100`) instead of hardcoded colors.
-- If Figma mapping is needed, treat it as incomplete until explicitly mapped.
-
-## Related decisions
-
-- `decisions/action-hierarchy.md`
-- `decisions/button-vs-link.md`
-
-## Source docs
-
-- `components/button.md`

package/template/.idia/brain/ai/skills/ds-brain-action-hierarchy/SKILL.md

@@ -1,46 +0,0 @@
----
-name: ds-brain-action-hierarchy
-description: "Button, link, and action-tier guidance. One primary action per group; choose Button vs Link by outcome."
-generated: true
-sources:
-  - ds-brain/components/button.md
-  - ds-brain/decisions/action-hierarchy.md
-  - ds-brain/decisions/button-vs-link.md
----
-# ds-brain — Action Hierarchy
-
-Load for button-action or navigation tasks involving primary/secondary/destructive actions and Button vs Link choice.
-
-## Operational guidance
-
-- Each local action group should have **one primary action** — the control that completes the main task. Secondary actions support cancellation, back navigation, alternative flows, or lower-priority choices. Destructive actions must be visually distinct and must not read as casual alternatives to the primary action.
-- **Form footers** — submit, save, continue, cancel, back (`patterns/forms.md`)
-- **Dialog or sheet action rows** — confirm, dismiss, delete with confirmation (`patterns/modal-routing.md`, `components/confirmation-modal.md`)
-- **Modal `footer` slots** — save/cancel pairs on responsive `Modal` branches (`components/modal.md`)
-- **Wizard step footers** — next/continue vs back/submit on first, middle, and last steps (`patterns/wizard-flows.md`)
-- **Floating bottom chrome** — sticky continue/submit on long mobile steps (`components/floating-action-bar.md`)
-- **Empty and outcome CTAs** — create-first, clear-filters, or post-submit next steps (`patterns/empty-status-flow.md`, `components/empty-state.md`, `components/status-display.md`)
-- Use **`Button`** for actions that change state, submit data, confirm choices, open overlays without route change, or start tasks in the current context. Use **`Link`** (or the host navigation component) when the outcome is **navigation** — moving to another route, page, external URL, or in-document anchor.
-
-For **whole-surface navigation** (cards, list rows, icon hit targets) where the affordance is not text-link shaped, use **`AppPressable`** with programmatic routing in `onPress` — not `Button`. For **upstream back affordances** on detail screens, use **`BackLink`** (wraps `Link` with arrow + label). See `patterns/navigation-pressable.md` for the full pressable hierarchy.
-- Heuristic: state mutation or data submit → `Button`; URL or route change → `Link` (or `BackLink` / `AppPressable` per shape).
-- Use `Button` for actions, not normal navigation.
-- Use one `primary` variant per local action group.
-- Use `primary` for the main submit/continue/save action.
-- Use `outline-grey` for cancel in form and modal footers; `secondary` for back on wizard steps.
-- Use `danger` or `danger-outline` for destructive delete/remove actions.
-- Document all eight variants and five sizes — do not invent variants or sizes.
-- For icon-only buttons, include `ariaLabel`.
-- Mention `aria-busy` and disabled semantics for loading states.
-- Button-action task-intent components: app-pressable, button, button-group, close-button, social-button.
-
-## Related decisions
-
-- `decisions/action-hierarchy.md`
-- `decisions/button-vs-link.md`
-
-## Source docs
-
-- `components/button.md`
-- `decisions/action-hierarchy.md`
-- `decisions/button-vs-link.md`

package/template/.idia/brain/ai/skills/ds-brain-forms/SKILL.md

@@ -1,67 +0,0 @@
----
-name: ds-brain-forms
-description: "Form composition domain bundle. Retrieve patterns, decisions, and form components before generating sign-up, settings, or validation flows."
-generated: true
-sources:
-  - ds-brain/decisions/action-hierarchy.md
-  - ds-brain/decisions/button-vs-link.md
-  - ds-brain/decisions/radio-vs-select-vs-checkbox.md
-  - ds-brain/patterns/form-composition.md
-  - ds-brain/patterns/forms.md
-  - ds-brain/patterns/validation-forms.md
----
-# ds-brain — Forms
-
-Load for form UI generation after classifying output mode (`static-ui-idea` or `interactive-prototype`) and task intent `form`.
-
-## Operational guidance
-
-- Forms collect, validate, and submit structured user input — multiple related values the user enters or edits before a primary action completes the task.
-- Retrieve this pattern plus `patterns/forms.md` and `decisions/action-hierarchy.md`.
-- Retrieve `components/form-section.md` and `components/form-element.md` before generating hierarchy.
-- Retrieve component brain docs for every field you render.
-- Use `FormSection` when there are 2+ logical groups; use built-in `label` on `InputText`/`Select`/`TextArea`/`InputGroup` when possible.
-- Reserve `FormElement` for custom/headless controls or `Toggle` group labels.
-- Apply `FORM_V_GAP` / `FORM_H_GAP` from `foundations/spacing.md` — do not invent spacing tokens.
-- Do not nest `FormSection` inside `FormElement` or inside another `FormSection`.
-- Showcase `FormComposition.mdx` is visual calibration only — confirm props in brain component docs.
-- Retrieve this pattern, `patterns/forms.md`, and `patterns/form-composition.md` for layout context.
-- Retrieve `components/form-element.md` and every field component you render.
-- Import validators from `@idia-ui/validators` — do not duplicate regex in screens.
-- Map `formState.errors` to `hasError` + `errorText` on the matching field.
-- Use `mode: 'onSubmit'` as default for short forms; gate on-change revalidation with `isSubmitted`.
-- Set submit `Button` `loading` during async work.
-- Place form-level server errors above the primary action, not inside field stacks.
-- Inspect `packages/validators` or showcase `ValidationIntegration` for factory names — do not invent APIs.
-- Each local action group should have **one primary action** — the control that completes the main task. Secondary actions support cancellation, back navigation, alternative flows, or lower-priority choices. Destructive actions must be visually distinct and must not read as casual alternatives to the primary action.
-- Choose the control by **selection model**, **visibility needs**, and **visual density**. All Group A choice controls have brain docs — retrieve the cited component doc before generating props.
-- Retrieve form components from index task intent `form`: avatar-upload, button, checkbox, custom-selection, date-input, date-range-input, form-element, form-section, ….
-- Retrieve foundations: color, spacing, tokens, typography.
-
-## Related decisions
-
-- `decisions/action-hierarchy.md`
-- `decisions/radio-vs-select-vs-checkbox.md`
-- `decisions/button-vs-link.md`
-
-## Pattern docs
-
-- `decisions/action-hierarchy.md`
-- `decisions/button-vs-link.md`
-- `decisions/radio-vs-select-vs-checkbox.md`
-- `patterns/address-capture.md`
-- `patterns/calendar-scheduling.md`
-- `patterns/form-composition.md`
-- `patterns/forms.md`
-- `patterns/media-upload.md`
-- `patterns/phone-and-currency.md`
-- `patterns/validation-forms.md`
-
-## Source docs
-
-- `decisions/action-hierarchy.md`
-- `decisions/button-vs-link.md`
-- `decisions/radio-vs-select-vs-checkbox.md`
-- `patterns/form-composition.md`
-- `patterns/forms.md`
-- `patterns/validation-forms.md`

package/template/.idia/brain/ai/skills/ds-brain-index/SKILL.md

@@ -1,76 +0,0 @@
----
-name: ds-brain-index
-description: "Meta router for ds-brain. Read first on design-system tasks. Explains canonical vs generated layout, retrieval order, and registry index paths."
-generated: true
-sources:
-  - .idia/brain/AGENTS.md
-  - ds-brain/ai/generation-principles.md
-  - ds-brain/docs/RETRIEVAL-CONTRACT.md
----
-# ds-brain — Meta Router Skill
-
-**Read this skill first.** Orient to the design-system brain, classify the task, then load only the relevant domain skill and brain docs.
-
-## Operational guidance
-
-- Read this skill first before loading domain-specific ds-brain skills.
-- `foundations/`
-- `components/`
-- `patterns/`
-- `decisions/`
-- `ai/`
-- `config/`
-- `.idia/brain/`
-- If authored docs and generated files conflict, authored docs win.
-- Read `AGENTS.md` (repo root) — **session-start**; mandatory first Read for **any** task (see root `AGENTS.md`).
-- Read `.idia/brain/AGENTS.md` — **gate step 1**; brain entrypoint (this file).
-- Read `.idia/brain/registry/ai-index.generated.json` — **gate step 2**; **STOP** — required before any component or pattern doc.
-- Read `.idia/brain/ai/skills/ds-brain-index/SKILL.md` — **gate step 3**; **required** meta router; read before domain skills and component/pattern docs.
-- Classify **output mode** and **task intent** from the ai-index before opening authored component docs.
-- Read only the foundation, component, pattern, decision, and AI guidance docs resolved by the index.
-- Load domain skills as needed (e.g. `ds-brain-forms`, `ds-brain-action-hierarchy`) after classification.
-- Load `ds-brain-retrieval` only when output mode or task intent classification is ambiguous after reading the ai-index; otherwise skip it.
-- Inspect code only when API, implementation behaviour, or source paths must be confirmed.
-- **Identify output mode** from the user request (static image vs code vs docs work).
-- **Identify task intent** from the UI domain (form, action, choice control, etc.).
-- **Load the index** — `.idia/brain/registry/ai-index.generated.json` first; prefer generated index when available.
-- **Retrieve output-mode docs** listed under `outputModes.<mode>.docs`.
-- **Retrieve task-intent docs** listed under `taskIntents.<intent>.docs`, then component and foundation paths from the same intent entry.
-- **Inspect source** only when brain docs are `stub`, mappings are incomplete, or prop/API accuracy is required (especially for interactive prototypes).
-- `static-ui-idea`
-- `interactive-prototype`
-- `storybook-docs`
-- `component-implementation`
-- `docs-maintenance`
-- `form`
-- `button-action`
-- `choice-input`
-- `component-docs`
-- Read `AGENTS.md` — entry routing and output-mode read lists.
-- Read `.idia/brain/registry/ai-index.generated.json` — **required** gate before component/pattern docs.
-- Read `ds-brain-index` skill (`.idia/brain/ai/skills/ds-brain-index/SKILL.md`) — **required** meta router before domain skills and authored component docs.
-- Classify output mode from the ai-index.
-- Classify task intent from the ai-index.
-- Load domain skills as needed (e.g. `ds-brain-forms`, `ds-brain-action-hierarchy`).
-- Load output-mode and task-intent docs resolved by the index — components, foundations, patterns, and decisions only.
-- Load `ds-brain-retrieval` only when output mode or task intent remains ambiguous after index lookup; otherwise skip it.
-- Inspect code only when API or behaviour must be confirmed.
-- Prefer `.idia/brain/registry/ai-index.generated.json` when present.
-- Use `.idia/brain/registry/component-registry.generated.json` for component metadata summaries.
-- Do not edit `.idia/brain/` directly.
-- Do not invent components, props, variants, tokens, or Figma mappings.
-- Do not mark a doc `rich` unless required sections are substantive, especially accessibility for interactive components.
-- Do not claim catalog completeness beyond what the pack registries summarize.
-- If a gap is found, report it to the idia-ui maintainers rather than inventing API or docs.
-
-## Registry paths
-
-- `.idia/brain/registry/ai-index.generated.json` — enriched output-mode and task-intent doc resolution
-- `.idia/brain/registry/component-registry.generated.json` — per-component metadata and mapping summaries
-- `.idia/brain/registry/ai-index.generated.json` — authored index when generated registry is unavailable
-
-## Source docs
-
-- `AGENTS.md`
-- `ai/generation-principles.md`
-- `docs/RETRIEVAL-CONTRACT.md`

package/template/.idia/brain/ai/skills/ds-brain-overlays/SKILL.md

@@ -1,30 +0,0 @@
----
-name: ds-brain-overlays
-description: Overlay and modal domain bundle. Choose the lightest blocking surface and layer overlays using z-index contracts.
-generated: true
-sources:
-  - ds-brain/foundations/z-index.md
-  - ds-brain/patterns/overlay-stack.md
----
-# ds-brain — Overlays
-
-Load for overlay-stack task intent: tooltips, popovers, sheets, dialogs, toasts, and z-index layering.
-
-## Operational guidance
-
-- Overlay stack is the recipe for **choosing the lightest blocking or floating surface** for a task and **layering overlays predictably** — tooltip hints, popover menus, sheets, dialogs, toasts — without z-index collisions or focus-trap conflicts.
-- Escalation ladder: Tooltip → PopoverWrapper → BottomSheet / SideSheet → Dialog (Modal).
-- Start with the least disruptive surface that fits the task; escalate to modal only for blocking work.
-- Z-index tokens define semantic stacking layers for controls, dropdowns, sticky chrome, modals, toasts, and full-screen overlays. Two sources exist by design: token `zIndex` feeds Tamagui substrate props; theme `Z_INDEX` is the **canonical layering contract for components and AI guidance**.
-- Component layering policy uses `Z_INDEX` from `@idia-ui/theme` — canonical for components and AI guidance.
-- Overlay task-intent components: confirmation-modal, full-page-loader, modal, overlay, picker-sheet, popover-wrapper, toast, tooltip.
-- Overlay foundations: shadows, z-index.
-
-## Related decisions
-
-- `decisions/action-hierarchy.md` — confirm/dismiss action rows in modals
-
-## Source docs
-
-- `foundations/z-index.md`
-- `patterns/overlay-stack.md`

package/template/.idia/brain/ai/skills/ds-brain-retrieval/SKILL.md

@@ -1,54 +0,0 @@
----
-name: ds-brain-retrieval
-description: Route ds-brain retrieval by output mode and task intent using the ai-index. Load only high-signal docs for the classified axes.
-generated: true
-sources:
-  - .idia/brain/registry/ai-index.generated.json
-  - ds-brain/docs/RETRIEVAL-CONTRACT.md
----
-# ds-brain — Retrieval Routing
-
-Use after `ds-brain-index` when you need the doc lists for a classified output mode and task intent.
-
-## Operational guidance
-
-- Classify output mode and task intent independently before retrieving docs.
-- `static-ui-idea`
-- `interactive-prototype`
-- `storybook-docs`
-- `component-implementation`
-- `docs-maintenance`
-- `form`
-- `button-action`
-- `choice-input`
-- `component-docs`
-- Seed output modes: docs-maintenance, interactive-prototype, static-ui-idea, storybook-docs.
-- Seed task intents: button-action, choice-input, component-docs, data-display, data-table, feedback-loading, form, layout, list-selection, loading-states, modal-navigation, navigation, overlay-stack, wizard.
-- Load `outputModes.<mode>.docs` then `taskIntents.<intent>.docs`, components, and foundations from the index.
-- Read `AGENTS.md` — entry routing and output-mode read lists.
-- Read `.idia/brain/registry/ai-index.generated.json` — **required** gate before component/pattern docs.
-- Read `ds-brain-index` skill (`.idia/brain/ai/skills/ds-brain-index/SKILL.md`) — **required** meta router before domain skills and authored component docs.
-- Classify output mode from the ai-index.
-- Classify task intent from the ai-index.
-- Load domain skills as needed (e.g. `ds-brain-forms`, `ds-brain-action-hierarchy`).
-- Load output-mode and task-intent docs resolved by the index — components, foundations, patterns, and decisions only.
-- Load `ds-brain-retrieval` only when output mode or task intent remains ambiguous after index lookup; otherwise skip it.
-- Inspect code only when API or behaviour must be confirmed.
-- 1 output-mode doc
-- 1 generation-principles doc
-- 1 pattern doc
-- 1 to 3 component docs
-- 1 to 3 decision docs
-- 1 to 3 foundation docs
-- Prefer generated index at `.idia/brain/registry/ai-index.generated.json` when present.
-
-## Index files
-
-- `.idia/brain/registry/ai-index.generated.json` — authored routing config
-- `.idia/brain/registry/ai-index.generated.json` — generated enrichment with `resolvedDocs` and `inventory`
-
-## Source docs
-
-- `ai/generation-principles.md`
-- `.idia/brain/registry/ai-index.generated.json`
-- `docs/RETRIEVAL-CONTRACT.md`