flowstate-admin Package Skill

Package: @epicdm/flowstate-admin Repository: flowstate-platform Path: packages/admin Version: 0.1.0

Use this published Dojo skill as the package-level entrypoint. For detailed workflows, use the package-local skills listed below.

Primary Package Workflow

Admin Cross-Service Queries

Status: Active Purpose: Keep admin data access pointed at the correct service database and enum model. Scope: packages/admin/src/lib/db.ts, admin pages, and query tests. Trigger: Admin page data, filters, counts, search, joins, or status displays change. Input: Service domain, desired fields, pagination/filter needs. Output: Query behavior backed by the right DB helper and test evidence.

Source Map

Workflow

1. Pick the data domain before writing SQL or Drizzle calls.
2. Use the matching helper from src/lib/db.ts; do not reuse another helper because the page shape is similar.
3. Check the relevant query test for status values, pagination shape, and escaping expectations.
4. Use escapeLike from src/lib/escape-like.ts for LIKE search input.
5. Keep returned fields minimal and aligned with the page display.

Example

For a compliance controls list, start with getComplianceDb, inspect src/app/compliance/controls/page.tsx, and extend src/__tests__/compliance-queries.test.ts for any new status or TSC category filter.

Verification

• yarn workspace @epicdm/flowstate-admin test --runInBand
• yarn workspace @epicdm/flowstate-admin typecheck

Created: 2026-06-30

Package Skill Inventory

Skill Inventory: @epicdm/flowstate-admin

Review date: 2026-06-30

Skills

Composition Notes

• Use flowstate-admin-dashboard first to orient on package boundaries.
• Invoke flowstate-admin-cross-service-queries before editing data fetches or filters.
• Invoke flowstate-admin-session-audit before changing auth redirects, cookies, session invalidation, or audit rows.

Deferred Skills

• A separate teardown-operation skill is deferred until destructive admin operations grow beyond src/components/TeardownButton.tsx.

Review Gate

Package Skills Review: @epicdm/flowstate-admin

Review date: 2026-06-30 Status: Pass for local agent use

Checks

• Skills are source-backed by package routes, libs, tests, and package scripts.
• Skills avoid generated feature-list structure and group route metadata into real admin workflows.
• Skills include verification commands and cross-package cautions.
• Files were written only under packages/admin/.flowstate/skills.

Pressure Scenario

Scenario: "Add an admin page for a new compliance list and wire the query."

Expected agent behavior with skills: load flowstate-admin-dashboard, then flowstate-admin-cross-service-queries; reuse Layout, Pagination, status badges, getComplianceDb, and add query-shape coverage near src/__tests__/compliance-queries.test.ts.

Remaining Risk

The package has privileged operations but limited end-to-end route tests. Agents should run package-local tests and typecheck after auth, session, or DB query changes.

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/admin/package.json. Do not treat generated feature lists as lessons; use workflow evidence from CODE-REVIEW.md, SKILL-INVENTORY.md, and REVIEW.md.