@flowstack-ui/agent-tools 0.1.0-bootstrap.0

package/public/tasks/forms.txt

@@ -0,0 +1,65 @@
+# FLOWSTACK task: forms
+
+Select forms, fields, labels, validation, and input controls.
+
+Load only the routes required for the current job and preserve their exact package versions.
+
+## Default: finished interface
+
+Use Brick for an ordinary finished form. Do not import Atom directly.
+
+- [brick/guide/layer-selection](/packages/brick/0.1.11/guides/layer-selection.txt)
+- [brick/guide/interface-composition](/packages/brick/0.1.11/guides/interface-composition.txt)
+- [brick/component/button](/packages/brick/0.1.11/components/button.txt)
+- [brick/component/checkbox](/packages/brick/0.1.11/components/checkbox.txt)
+- [brick/component/checkbox-group](/packages/brick/0.1.11/components/checkbox-group.txt)
+- [brick/component/color-picker](/packages/brick/0.1.11/components/color-picker.txt)
+- [brick/component/combobox](/packages/brick/0.1.11/components/combobox.txt)
+- [brick/component/field](/packages/brick/0.1.11/components/field.txt)
+- [brick/component/fieldset](/packages/brick/0.1.11/components/fieldset.txt)
+- [brick/component/file-upload](/packages/brick/0.1.11/components/file-upload.txt)
+- [brick/component/form](/packages/brick/0.1.11/components/form.txt)
+- [brick/component/icon-button](/packages/brick/0.1.11/components/icon-button.txt)
+- [brick/component/input](/packages/brick/0.1.11/components/input.txt)
+- [brick/component/multi-select](/packages/brick/0.1.11/components/multi-select.txt)
+- [brick/component/number-input](/packages/brick/0.1.11/components/number-input.txt)
+- [brick/component/otp-field](/packages/brick/0.1.11/components/otp-field.txt)
+- [brick/component/password-toggle-field](/packages/brick/0.1.11/components/password-toggle-field.txt)
+- [brick/component/radio-group](/packages/brick/0.1.11/components/radio-group.txt)
+- [brick/component/rating](/packages/brick/0.1.11/components/rating.txt)
+- [brick/component/select](/packages/brick/0.1.11/components/select.txt)
+- [brick/component/slider](/packages/brick/0.1.11/components/slider.txt)
+- [brick/component/switch](/packages/brick/0.1.11/components/switch.txt)
+- [brick/component/textarea](/packages/brick/0.1.11/components/textarea.txt)
+- [brick/component/toggle](/packages/brick/0.1.11/components/toggle.txt)
+- [brick/component/toggle-group](/packages/brick/0.1.11/components/toggle-group.txt)
+
+## Explicit exception: headless behavior
+
+Use Atom only when the task explicitly requires reusable headless form behavior without Brick's finished visual contract.
+
+- [atom/guide/layer-selection](/packages/atom/0.24.0/guides/layer-selection.txt)
+- [atom/guide/behavior-composition](/packages/atom/0.24.0/guides/behavior-composition.txt)
+- [atom/component/button](/packages/atom/0.24.0/components/button.txt)
+- [atom/component/checkbox](/packages/atom/0.24.0/components/checkbox.txt)
+- [atom/component/checkbox-group](/packages/atom/0.24.0/components/checkbox-group.txt)
+- [atom/component/color-picker](/packages/atom/0.24.0/components/color-picker.txt)
+- [atom/component/combobox](/packages/atom/0.24.0/components/combobox.txt)
+- [atom/component/field](/packages/atom/0.24.0/components/field.txt)
+- [atom/component/fieldset](/packages/atom/0.24.0/components/fieldset.txt)
+- [atom/component/file-upload](/packages/atom/0.24.0/components/file-upload.txt)
+- [atom/component/form](/packages/atom/0.24.0/components/form.txt)
+- [atom/component/input](/packages/atom/0.24.0/components/input.txt)
+- [atom/component/label](/packages/atom/0.24.0/components/label.txt)
+- [atom/component/multi-select](/packages/atom/0.24.0/components/multi-select.txt)
+- [atom/component/number-input](/packages/atom/0.24.0/components/number-input.txt)
+- [atom/component/otp-field](/packages/atom/0.24.0/components/otp-field.txt)
+- [atom/component/password-toggle-field](/packages/atom/0.24.0/components/password-toggle-field.txt)
+- [atom/component/radio-group](/packages/atom/0.24.0/components/radio-group.txt)
+- [atom/component/rating](/packages/atom/0.24.0/components/rating.txt)
+- [atom/component/select](/packages/atom/0.24.0/components/select.txt)
+- [atom/component/slider](/packages/atom/0.24.0/components/slider.txt)
+- [atom/component/switch](/packages/atom/0.24.0/components/switch.txt)
+- [atom/component/textarea](/packages/atom/0.24.0/components/textarea.txt)
+- [atom/component/toggle](/packages/atom/0.24.0/components/toggle.txt)
+- [atom/component/toggle-group](/packages/atom/0.24.0/components/toggle-group.txt)

package/public/tasks/layout.txt

@@ -0,0 +1,37 @@
+# FLOWSTACK task: layout
+
+Select layout, surface, spacing, responsive visibility, and structural owners.
+
+Load only the routes required for the current job and preserve their exact package versions.
+
+## Default: finished interface
+
+Use Brick for an ordinary finished interface. Do not import Atom directly.
+
+- [brick/guide/layer-selection](/packages/brick/0.1.11/guides/layer-selection.txt)
+- [brick/guide/interface-composition](/packages/brick/0.1.11/guides/interface-composition.txt)
+- [brick/component/aspect-ratio](/packages/brick/0.1.11/components/aspect-ratio.txt)
+- [brick/component/bleed](/packages/brick/0.1.11/components/bleed.txt)
+- [brick/component/card](/packages/brick/0.1.11/components/card.txt)
+- [brick/component/container](/packages/brick/0.1.11/components/container.txt)
+- [brick/component/divider](/packages/brick/0.1.11/components/divider.txt)
+- [brick/component/frame](/packages/brick/0.1.11/components/frame.txt)
+- [brick/component/grid](/packages/brick/0.1.11/components/grid.txt)
+- [brick/component/group](/packages/brick/0.1.11/components/group.txt)
+- [brick/component/hide](/packages/brick/0.1.11/components/hide.txt)
+- [brick/component/section](/packages/brick/0.1.11/components/section.txt)
+- [brick/component/show](/packages/brick/0.1.11/components/show.txt)
+- [brick/component/stack](/packages/brick/0.1.11/components/stack.txt)
+- [brick/component/surface](/packages/brick/0.1.11/components/surface.txt)
+- [brick/component/z-stack](/packages/brick/0.1.11/components/z-stack.txt)
+
+## Explicit exception: headless behavior
+
+Use Atom only when the task explicitly requires reusable headless behavior without Brick's finished visual contract.
+
+- [atom/guide/layer-selection](/packages/atom/0.24.0/guides/layer-selection.txt)
+- [atom/guide/behavior-composition](/packages/atom/0.24.0/guides/behavior-composition.txt)
+- [atom/component/aspect-ratio](/packages/atom/0.24.0/components/aspect-ratio.txt)
+- [atom/component/direction](/packages/atom/0.24.0/components/direction.txt)
+- [atom/component/divider](/packages/atom/0.24.0/components/divider.txt)
+- [atom/component/visually-hidden](/packages/atom/0.24.0/components/visually-hidden.txt)

package/public/tasks/navigation.txt

@@ -0,0 +1,51 @@
+# FLOWSTACK task: navigation
+
+Select navigation landmarks, menus, tabs, pagination, and route affordances.
+
+Load only the routes required for the current job and preserve their exact package versions.
+
+## Default: finished interface
+
+Use Brick for ordinary finished navigation. Do not import Atom directly.
+
+- [brick/guide/layer-selection](/packages/brick/0.1.11/guides/layer-selection.txt)
+- [brick/guide/interface-composition](/packages/brick/0.1.11/guides/interface-composition.txt)
+- [brick/component/app-bar](/packages/brick/0.1.11/components/app-bar.txt)
+- [brick/component/bottom-navigation](/packages/brick/0.1.11/components/bottom-navigation.txt)
+- [brick/component/breadcrumb](/packages/brick/0.1.11/components/breadcrumb.txt)
+- [brick/component/context-menu](/packages/brick/0.1.11/components/context-menu.txt)
+- [brick/component/drawer](/packages/brick/0.1.11/components/drawer.txt)
+- [brick/component/dropdown-menu](/packages/brick/0.1.11/components/dropdown-menu.txt)
+- [brick/component/link](/packages/brick/0.1.11/components/link.txt)
+- [brick/component/link-box](/packages/brick/0.1.11/components/link-box.txt)
+- [brick/component/menubar](/packages/brick/0.1.11/components/menubar.txt)
+- [brick/component/nav-list](/packages/brick/0.1.11/components/nav-list.txt)
+- [brick/component/navigation-menu](/packages/brick/0.1.11/components/navigation-menu.txt)
+- [brick/component/pagination](/packages/brick/0.1.11/components/pagination.txt)
+- [brick/component/sidebar](/packages/brick/0.1.11/components/sidebar.txt)
+- [brick/component/skip-link](/packages/brick/0.1.11/components/skip-link.txt)
+- [brick/component/tabs](/packages/brick/0.1.11/components/tabs.txt)
+- [brick/component/toolbar](/packages/brick/0.1.11/components/toolbar.txt)
+
+## Explicit exception: headless behavior
+
+Use Atom only when the task explicitly requires reusable headless navigation behavior without Brick's finished visual contract.
+
+- [atom/guide/layer-selection](/packages/atom/0.24.0/guides/layer-selection.txt)
+- [atom/guide/behavior-composition](/packages/atom/0.24.0/guides/behavior-composition.txt)
+- [atom/component/app-bar](/packages/atom/0.24.0/components/app-bar.txt)
+- [atom/component/bottom-navigation](/packages/atom/0.24.0/components/bottom-navigation.txt)
+- [atom/component/breadcrumb](/packages/atom/0.24.0/components/breadcrumb.txt)
+- [atom/component/context-menu](/packages/atom/0.24.0/components/context-menu.txt)
+- [atom/component/drawer](/packages/atom/0.24.0/components/drawer.txt)
+- [atom/component/dropdown-menu](/packages/atom/0.24.0/components/dropdown-menu.txt)
+- [atom/component/link](/packages/atom/0.24.0/components/link.txt)
+- [atom/component/menu](/packages/atom/0.24.0/components/menu.txt)
+- [atom/component/menubar](/packages/atom/0.24.0/components/menubar.txt)
+- [atom/component/nav-list](/packages/atom/0.24.0/components/nav-list.txt)
+- [atom/component/navigation-menu](/packages/atom/0.24.0/components/navigation-menu.txt)
+- [atom/component/pagination](/packages/atom/0.24.0/components/pagination.txt)
+- [atom/component/sidebar](/packages/atom/0.24.0/components/sidebar.txt)
+- [atom/component/skip-link](/packages/atom/0.24.0/components/skip-link.txt)
+- [atom/component/tabs](/packages/atom/0.24.0/components/tabs.txt)
+- [atom/component/toolbar](/packages/atom/0.24.0/components/toolbar.txt)

package/public/tasks/overlays.txt

@@ -0,0 +1,39 @@
+# FLOWSTACK task: overlays
+
+Select dialogs, popovers, transient surfaces, and feedback owners.
+
+Load only the routes required for the current job and preserve their exact package versions.
+
+## Default: finished interface
+
+Use Brick for ordinary finished overlays. Do not import Atom directly.
+
+- [brick/guide/layer-selection](/packages/brick/0.1.11/guides/layer-selection.txt)
+- [brick/guide/interface-composition](/packages/brick/0.1.11/guides/interface-composition.txt)
+- [brick/component/alert-dialog](/packages/brick/0.1.11/components/alert-dialog.txt)
+- [brick/component/context-menu](/packages/brick/0.1.11/components/context-menu.txt)
+- [brick/component/dialog](/packages/brick/0.1.11/components/dialog.txt)
+- [brick/component/drawer](/packages/brick/0.1.11/components/drawer.txt)
+- [brick/component/dropdown-menu](/packages/brick/0.1.11/components/dropdown-menu.txt)
+- [brick/component/hover-card](/packages/brick/0.1.11/components/hover-card.txt)
+- [brick/component/popover](/packages/brick/0.1.11/components/popover.txt)
+- [brick/component/toast](/packages/brick/0.1.11/components/toast.txt)
+- [brick/component/tooltip](/packages/brick/0.1.11/components/tooltip.txt)
+
+## Explicit exception: headless behavior
+
+Use Atom only when the task explicitly requires reusable headless overlay behavior without Brick's finished visual contract.
+
+- [atom/guide/layer-selection](/packages/atom/0.24.0/guides/layer-selection.txt)
+- [atom/guide/behavior-composition](/packages/atom/0.24.0/guides/behavior-composition.txt)
+- [atom/component/alert-dialog](/packages/atom/0.24.0/components/alert-dialog.txt)
+- [atom/component/context-menu](/packages/atom/0.24.0/components/context-menu.txt)
+- [atom/component/dialog](/packages/atom/0.24.0/components/dialog.txt)
+- [atom/component/drawer](/packages/atom/0.24.0/components/drawer.txt)
+- [atom/component/dropdown-menu](/packages/atom/0.24.0/components/dropdown-menu.txt)
+- [atom/component/hover-card](/packages/atom/0.24.0/components/hover-card.txt)
+- [atom/component/menu](/packages/atom/0.24.0/components/menu.txt)
+- [atom/component/modal](/packages/atom/0.24.0/components/modal.txt)
+- [atom/component/popover](/packages/atom/0.24.0/components/popover.txt)
+- [atom/component/toast](/packages/atom/0.24.0/components/toast.txt)
+- [atom/component/tooltip](/packages/atom/0.24.0/components/tooltip.txt)

package/public/tasks/theming.txt

@@ -0,0 +1,37 @@
+# FLOWSTACK task: theming
+
+Route color operations through Colors and semantic compilation through Theme.
+
+Load only the routes required for the current job and preserve their exact package versions.
+
+## Finished color interaction
+
+Use Brick Color Picker and Color Swatch for finished interface selection and display; use Colors and Theme for authoring system values.
+
+- [brick/component/color-picker](/packages/brick/0.1.11/components/color-picker.txt)
+- [brick/component/color-swatch](/packages/brick/0.1.11/components/color-swatch.txt)
+
+## Step 1: Colors candidate
+
+Use Colors for deterministic raw color work and explicit candidate review before semantic mapping.
+
+- [colors/guide/colors-system](/packages/colors/0.1.1/guides/colors-system.txt)
+- [colors/operation/color-conversion](/packages/colors/0.1.1/operations/color-conversion.txt)
+- [colors/operation/color-inspection](/packages/colors/0.1.1/operations/color-inspection.txt)
+- [colors/operation/color-measurement](/packages/colors/0.1.1/operations/color-measurement.txt)
+- [colors/operation/color-provenance](/packages/colors/0.1.1/operations/color-provenance.txt)
+- [colors/operation/named-palette-reference](/packages/colors/0.1.1/operations/named-palette-reference.txt)
+- [colors/operation/palette-candidate](/packages/colors/0.1.1/operations/palette-candidate.txt)
+
+## Step 2: Theme semantics and Brick qualification
+
+Pass only reviewed Colors artifacts to Theme, then validate against the exact Brick contract.
+
+- [theme/guide/theme-system](/packages/theme/0.1.1/guides/theme-system.txt)
+- [theme/operation/brick-contract-compatibility](/packages/theme/0.1.1/operations/brick-contract-compatibility.txt)
+- [theme/operation/colors-interchange](/packages/theme/0.1.1/operations/colors-interchange.txt)
+- [theme/operation/theme-artifacts](/packages/theme/0.1.1/operations/theme-artifacts.txt)
+- [theme/operation/theme-cli](/packages/theme/0.1.1/operations/theme-cli.txt)
+- [theme/operation/theme-compilation](/packages/theme/0.1.1/operations/theme-compilation.txt)
+- [theme/operation/theme-definition](/packages/theme/0.1.1/operations/theme-definition.txt)
+- [theme/operation/theme-validation](/packages/theme/0.1.1/operations/theme-validation.txt)

package/skills/flowstack-ui-builder/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: flowstack-ui-builder
+description: Build or change FLOWSTACK interfaces by selecting the correct public layer and loading exact-version package Agent Knowledge. Use for implementation work with FLOWSTACK components, themes, or colors; use the review skill for audit-only requests.
+---
+
+# FLOWSTACK UI Builder
+
+Build from package-owned guidance, not remembered component rules.
+
+## Resolve authority
+
+1. Inspect the target project's dependencies and lockfile. Run `scripts/resolve-agent-knowledge.mjs` from this skill for every FLOWSTACK package and owner you use. Pass `--project`, `--package`, and, when selecting an owner, `--kind` plus `--id`. If that exact package is not installed, also pass its exact `--version`; ranges and implicit locked-version selection are rejected.
+2. Read the resolved manifest, zero-failure coverage, package guides, and selected owner artifacts. Prefer the installed package. The resolver may use Agent Tools only when its locked route has the exact requested or installed version.
+3. Stop with an unavailable-version report if exact guidance cannot be resolved. Never substitute current, latest, sibling-repository, or remembered guidance.
+
+## Select the layer
+
+- Route an ordinary finished interface to Brick. Search Brick before native replacements or application CSS, and do not import Atom directly.
+- Route explicitly requested headless UI or primitive authoring to Atom. Do not add Brick appearance rules there.
+- For custom design-system color work, take reviewed Colors output into Theme, compile compatible Theme artifacts, then load those artifacts with Brick.
+- Treat paid Blocks as a separate authenticated product boundary. Agent Tools does not carry their registry, source, or item guidance; after an authorized CLI installation, resolve the copied code's public Brick owners here.
+- Implement a supplied Blueprint or application plan only after its jobs and policy are explicit. Public skills do not invent product strategy, content, routes, business rules, persistence, analytics, art direction, or private Blueprint policy.
+
+Read the selected package's layer-selection and composition/system guide before individual owners. Follow related exact Atom guidance only when a Brick guide routes there for behavioral understanding; keep finished implementation imports at Brick.
+
+## Implement and verify
+
+- Use documented composition, public APIs, semantic Theme tokens, supported recipes, parts, and responsive contracts from the resolved artifacts.
+- Load Brick's documented CSS entry exactly once and apply Theme artifacts in the documented order. Confirm package and contract compatibility rather than assuming it.
+- Keep application-owned semantic HTML where the package guide permits it. Do not recreate behavior, accessibility, responsiveness, or styling already owned by FLOWSTACK.
+- Run the target repository's focused type, unit, browser/accessibility, build, and package checks in proportion to the change. Check keyboard/focus behavior, responsive containment, appearance modes, CSS presence, and Theme loading where relevant.
+
+## Report gaps
+
+Do not conceal a fallback. Record the exact package/version, intended job, guides and owners searched, missing capability, temporary native/application/CSS fallback, proposed owner (`Brick`, `Atom`, `Colors`, `Theme`, `Block`, `Blueprint`, or `application`), and verification evidence. Repeated compositions are Block or Blueprint candidates, not new component rules in this skill.

package/skills/flowstack-ui-builder/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "FLOWSTACK UI Builder"
+  short_description: "Build interfaces with exact FLOWSTACK guidance"
+  default_prompt: "Use $flowstack-ui-builder to implement this interface with matching installed FLOWSTACK guidance."