flowstate-epic-flowstate-apps-epicdm-flowstate-app-ux
Package-local agent skill for @epicdm/flowstate-app-ux.
Tags
Publisher
Versions
1 version published — latest: 1.0.0
- 1.0.0publishedInvalid Date
Skill
flowstate-app-ux Package Skill
Package: @epicdm/flowstate-app-ux
Repository: epic-flowstate-apps
Path: packages/flowstate-app-ux
Version: 1.0.0
Use this published Dojo skill as the package-level entrypoint. For detailed workflows, use the package-local skills listed below.
Primary Package Workflow
FlowState UX App
Status: Active
Purpose: Maintain the private UX/UI management app without confusing demo surfaces for production contracts.
Scope: packages/flowstate-app-ux.
Trigger: Use when changing UX plugin metadata, routes, sidebar links, pages, or demo entry points.
Input: src/plugin.ts, flowstate.plugin.json, package.json, src/App.tsx, src/pages/*.
Output: UX app changes with metadata and verification limits recorded.
Workflow
1. Check Three Metadata Sources
Compare package.json.flowstate, src/plugin.ts, and flowstate.plugin.json for app id ux, port 3229, route /apps/ux, plugin export uxPlugin, and base path /ux.
2. Keep Pages As UI Surfaces
Pages under src/pages are component browser, design system, themes, demos, and home surfaces. Do not introduce business data behavior here unless backed by a package API.
3. Route Demo Work
Use ux-demo-surfaces for src/pages/demos/* changes.
Verification
Run yarn workspace @epicdm/flowstate-app-ux build and yarn workspace @epicdm/flowstate-app-ux lint. There is no package typecheck or test script.
Composition
Composes with @epicdm/flowstate-ui and dashboard package skills when demoing shared UI patterns.
Pitfalls
- Do not treat
members-mock-data.tsas production schema. - Do not edit
.flowstate/dojo. - Keep private package publication assumptions local-only.
Done When
Metadata, pages, demo links, and verification notes are consistent.
Package Skill Inventory
Package Skill Inventory: @epicdm/flowstate-app-ux
Package Context
UX is a small private UI browser/demo app. It needs one orchestrator and one demo-surface workflow.
Skill Map
| Skill | Type | Trigger | Teaches | Evidence | Depends On | Dojo |
|---|---|---|---|---|---|---|
flowstate-app-ux | orchestrator | Maintaining UX app package | Plugin, metadata, pages, verification | src/plugin.ts, flowstate.plugin.json, package.json | app framework/UI | local-only |
ux-demo-surfaces | workflow | Adding or changing UX demos | Demo config/data/page boundaries | src/pages/demos/*, src/pages/DemosPage.tsx | dashboard/UI | local-only |
Anti-Sprawl Decision: Two skills are sufficient because pages are simple surfaces and there are no tests/services.
Feature Coverage
| Feature Group | Source Evidence | Covered By | Notes |
|---|---|---|---|
| Plugin/app/sidebar | source plugin, JSON manifest | flowstate-app-ux | Metadata in three places. |
| Static UI pages | src/pages/* | flowstate-app-ux | Page routing. |
| Demo data/config | src/pages/demos/* | ux-demo-surfaces | Sample-only. |
Composition Model
Use orchestrator for app metadata, demo workflow for mock/demo pages.
Deferred Skills
- Theme reference deferred until theme tokens/config become source-backed APIs.
Review Questions
- Should the package add
typecheckandtestscripts? - Which metadata source is authoritative?
Review Gate
Package Skills Review: @epicdm/flowstate-app-ux
Verdict
Pass with fixes
Findings
| Severity | Skill | Issue | Evidence | Required Fix |
|---|---|---|---|---|
| Minor | All | No package tests or typecheck script. | package.json. | Add verification scripts before publication. |
| Minor | flowstate-app-ux | Metadata appears in three places. | package.json, src/plugin.ts, flowstate.plugin.json. | Keep synchronized. |
Coverage
| Feature Group | Status | Skill | Notes |
|---|---|---|---|
| App/plugin/pages | Covered | flowstate-app-ux | Local-only. |
| Demos/mock data | Covered | ux-demo-surfaces | Sample-only. |
Drift and Contract Risks
| Area | Risk | Evidence | Decision |
|---|---|---|---|
| Metadata | Three metadata sources can drift. | package/source/json. | Record. |
| Dojo | Generated prototype. | .flowstate/dojo/*. | Leave untouched. |
Dojo Publication Decision
Local-only; package is private and lacks tests.
Follow-Up Work
- Add
typecheck. - Add visual smoke tests for demo pages.
Usage
Start with this skill to understand the package purpose, then use the package-local focused skills for specific workflows. Keep this Dojo version aligned with packages/flowstate-app-ux/package.json. Do not treat generated feature lists as lessons; use workflow evidence from CODE-REVIEW.md, SKILL-INVENTORY.md, and REVIEW.md.
Install
Run this in your project to install via CLI:
fscloud dojo skill install flowstate-epic-flowstate-apps-epicdm-flowstate-app-ux --target <target> --out ./skillsReplace <target> with your agent target identifier. See the CLI docs for details.