flowstate-epic-flowstate-apps-epicdm-flowstate-app-projects
Package-local agent skill for @epicdm/flowstate-app-projects.
Tags
Publisher
Versions
1 version published — latest: 1.0.0
- 1.0.0publishedInvalid Date
Skill
flowstate-app-projects Package Skill
Package: @epicdm/flowstate-app-projects
Repository: epic-flowstate-apps
Path: packages/flowstate-app-projects
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 Projects App
Status: Active
Purpose: Guide changes to the broad Projects app without turning feature lists into instructions.
Scope: packages/flowstate-app-projects.
Trigger: Use when changing Projects app integration, public exports, commands, routing, or multiple project-management workflows.
Input: src/index.ts, src/plugin.ts, flowstate.plugin.json, touched hooks/services/components/tests.
Output: A Projects package change with source-backed workflow and verification notes.
Workflow
1. Check Integration Boundaries
Compare projectsPlugin, flowstate.plugin.json, and src/index.ts. Note current drift: src/index.ts exports version = '0.1.0' while package/plugin metadata use 1.0.0.
2. Preserve Federation CSS Boundary
src/plugin.ts documents that CSS side-effect imports live in App.tsx to avoid Vite/module-federation HMR reload loops. Do not move CSS imports back into the top-level federated entry.
3. Route To Workflow Skills
Use projects-crud-workflows for collection CRUD. Use projects-calendar-templates for calendar, recurrence, generated tasks, and templates. Use projects-state-contribution for State app integration.
Verification
Run yarn workspace @epicdm/flowstate-app-projects typecheck and build for integration changes. Record that the package test script currently does not run the many tests under src.
Composition
Composes with @epicdm/flowstate-collections, app-framework database/org skills, and flowstate-app-state.
Pitfalls
- Do not edit
.flowstate/dojo. - Do not ignore version drift.
- Do not use feature matrix rows as skill content.
- Check
CommandRegistrar.tsxbefore claiming manifest command behavior.
Done When
Plugin metadata, exports, selected workflow, tests/checks, and drift notes are all updated.
Package Skill Inventory
Package Skill Inventory: @epicdm/flowstate-app-projects
Package Context
Projects is large, so skills must be composable and workflow-based. The inventory chooses four skills rather than mirroring 80+ feature rows.
Skill Map
| Skill | Type | Trigger | Teaches | Evidence | Depends On | Dojo |
|---|---|---|---|---|---|---|
flowstate-app-projects | orchestrator | Maintaining Projects app package | Plugin, exports, command/sidebar, verification, drift | src/index.ts, src/plugin.ts, flowstate.plugin.json | app framework, collections | ready-after-review |
projects-crud-workflows | workflow | Changing project, milestone, task, document, or approval CRUD | Hooks, collection names, org/workspace scoping, soft archive | src/hooks/*CRUD.ts, tests | collections | ready-after-review |
projects-calendar-templates | workflow | Changing calendar, recurrence, template, or generated task behavior | Services and calendar components | src/services/*, calendar/template components/tests | FullCalendar, date-fns | ready-after-review |
projects-state-contribution | workflow | Changing Projects data shown in State app | stateContribution contract and tests | src/state-contribution.ts, state contribution test | app-state | ready-after-review |
Anti-Sprawl Decision: Four skills cover the operational package workflows without generating one skill per component.
Feature Coverage
| Feature Group | Source Evidence | Covered By | Notes |
|---|---|---|---|
| Plugin/app/commands | source plugin, manifest, CommandRegistrar | flowstate-app-projects | Version drift noted. |
| Projects/milestones/tasks/docs/approvals | hooks and tests | projects-crud-workflows | Soft archive and scoping matter. |
| Calendar/templates/recurrence/time stats | services/components/tests | projects-calendar-templates | Service-first workflow. |
| State integration | state-contribution.ts, tests | projects-state-contribution | Cross-package contract. |
Composition Model
Start with orchestrator. Use CRUD skill for collection changes, calendar/templates skill for scheduling services, and state contribution skill for dashboard integration.
Deferred Skills
- Separate discussion/document skill deferred until a task specifically changes collaboration surfaces.
- Time tracking deep skill deferred; current guidance lives in CRUD and calendar/templates.
Review Questions
- Should root version export be
1.0.0? - Should test script run existing tests?
Review Gate
Package Skills Review: @epicdm/flowstate-app-projects
Verdict
Pass with fixes
Findings
| Severity | Skill | Issue | Evidence | Required Fix |
|---|---|---|---|---|
| Important | flowstate-app-projects | Version drift between package/plugin and root export. | package.json, src/index.ts, src/plugin.ts. | Reconcile before publication. |
| Important | All | Many tests exist but package test script says no tests. | package.json, src/**/__tests__. | Fix test script. |
| Minor | flowstate-app-projects | CSS federation boundary must stay in lazy chunk. | Comment in src/plugin.ts. | Preserve in future changes. |
Coverage
| Feature Group | Status | Skill | Notes |
|---|---|---|---|
| Plugin/app/commands | Covered | flowstate-app-projects | CommandRegistrar caveat. |
| CRUD records | Covered | projects-crud-workflows | Scoping/archive semantics. |
| Calendar/templates | Covered | projects-calendar-templates | Service-first. |
| State contribution | Covered | projects-state-contribution | Cross-package. |
Drift and Contract Risks
| Area | Risk | Evidence | Decision |
|---|---|---|---|
| Version | Exported version may mislead consumers. | src/index.ts. | Record. |
| Tests | Existing tests hidden. | package/test files. | Record. |
| Dojo | Generated prototype. | .flowstate/dojo/*. | Leave untouched. |
Dojo Publication Decision
Defer until version and test-script drift are resolved.
Follow-Up Work
- Fix version export or metadata.
- Wire tests into package script.
- Consider future document/discussion subskill if that surface gets focused work.
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-projects/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-projects --target <target> --out ./skillsReplace <target> with your agent target identifier. See the CLI docs for details.