flowstate-directory Package Skill

Package: @epicdm/flowstate-directory Repository: flowstate-platform Path: packages/directory 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

Directory MCP And SAGA

Status: Active Purpose: Preserve machine-readable directory access for MCP and SAGA consumers. Scope: MCP route/server/handlers and SAGA export. Trigger: MCP tool behavior, SAGA export fields, or API-facing profile data changes. Input: Profile data contract and consumer expectation. Output: Query-backed MCP/SAGA behavior.

Source Map

• MCP route: src/app/api/mcp/route.ts.
• MCP implementation: src/lib/mcp/server.ts, src/lib/mcp/handlers.ts.
• SAGA export: src/lib/saga/export.ts.
• Directory APIs: src/app/api/agents/*, src/app/api/companies/*.
• Query sources: src/db/queries/agents.ts, companies.ts, work-history.ts.

Workflow

1. Treat query modules as the source of truth for directory records.
2. Update SAGA export when profile fields become part of machine-readable identity.
3. Keep MCP handlers small and backed by shared queries.
4. Preserve public handle/slug lookup behavior.
5. Add tests for export or handler transformations when fields change.

Created: 2026-06-30

Package Skill Inventory

Skill Inventory: @epicdm/flowstate-directory

Review date: 2026-06-30

Composition Notes

Use profile skill first for schema/query/display changes. Add registration or MCP/SAGA skills when those workflow boundaries are involved.

Review Gate

Package Skills Review: @epicdm/flowstate-directory

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

Checks

• Skills reference source routes, query modules, schema, validation, tests, MCP, and SAGA export code.
• Skills group work by real directory workflows rather than generated method lists.
• Files were written only under packages/directory/.flowstate/skills.

Pressure Scenario

Scenario: "Add a verified specialization field to agent profiles and expose it through SAGA."

Expected behavior with skills: load flowstate-directory-profiles and flowstate-directory-mcp-saga; update schema, Zod validation, query functions, forms/cards/profile pages, and src/lib/saga/export.ts, then run tests/typecheck.

Remaining Risk

Schema changes may require migration generation and fixture updates. Agents should inspect query tests and migration diffs before finishing data-model work.

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