om-help — Open Mercato Navigator
Two modes: pick the one that matches the question.
Mode 1: Navigation — "What do I do now?"
Triggers: "what now?", "next steps?", "where do I start?", "which skill?", "I'm lost"
Step 1 — Read current context
Run these commands to understand where the developer is:
git branch --show-current
git status --short
ls .ai/specs/ 2>/dev/null | sort | tail -10
gh pr list --author "@me" --state open --json number,title,labels 2>/dev/null || true
Step 2 — Map to a workflow sequence
Read references/workflow-sequences.md. Match the context:
| Signal |
Likely sequence |
| No spec, no open PR, task described |
New Feature or New Module |
Spec exists in .ai/specs/, not implemented |
pre-implement-spec → implement-spec |
| Spec exists, implementation in progress |
implement-spec (continue from last phase) |
| Code changed, no PR |
code-review → check-and-commit → auto-create-pr |
| PR open, no review |
auto-review-pr |
| Bug report / error logs |
root-cause → fix |
| UI files touched |
ds-guardian → code-review |
| MikroORM errors |
migrate-mikro-orm |
Step 3 — Recommend
Output a recommendation in this format:
**Where you are:** <one sentence: branch, active spec or PR if any>
**Recommended next step:** `/om-<skill-name>`
**Why:** <one sentence explaining the match>
**After that:** `/om-<next-skill>` → `/om-<skill-after>`
If multiple paths are valid, present at most two options.
Mode 2: Knowledge — "How do I do X in Open Mercato?"
Triggers: "how do I add X?", "how do I build Y?", "where does Z go?", "what import for W?"
Step 1 — Map question to Task Router
Read the Task Router table in the root AGENTS.md. Find the row whose description best matches the question.
Common mappings (quick reference):
| Question topic |
Task Router row / Guide |
| New module, scaffolding, auto-discovery |
packages/core/AGENTS.md |
CRUD routes, OpenAPI, makeCrudRoute |
packages/core/AGENTS.md → API Routes |
Events, subscribers, createModuleEvents |
packages/core/AGENTS.md → Events |
RBAC, ACL features, acl.ts |
packages/core/AGENTS.md → Access Control |
Custom fields, cf.*, defineLink |
packages/core/AGENTS.md → Custom Fields |
Search, search.ts, reindexing |
packages/search/AGENTS.md |
UI components, forms, CrudForm, DataTable |
packages/ui/AGENTS.md |
Backend pages, apiCall, RowActions |
packages/ui/src/backend/AGENTS.md |
i18n, useT, resolveTranslations |
packages/shared/AGENTS.md |
| Cache, tag invalidation |
packages/cache/AGENTS.md |
| Background workers, queues |
packages/queue/AGENTS.md |
| Event bus, subscribers |
packages/events/AGENTS.md |
| AI agents, MCP tools |
packages/ai-assistant/AGENTS.md |
| Integration providers |
packages/core/src/modules/integrations/AGENTS.md |
| Customer portal, portal auth |
packages/ui/AGENTS.md → Portal Extension |
| Webhooks |
packages/webhooks/AGENTS.md |
| Notifications |
packages/core/AGENTS.md → Notifications |
| Widget injection, component replacement |
packages/core/AGENTS.md → Widget Injection |
Database migrations, db:generate |
packages/cli/AGENTS.md |
Step 2 — Load and read the target AGENTS.md
Read the identified AGENTS.md file. Look for:
- Import paths and package names
- MUST rules relevant to the question
- Code patterns, examples, file conventions
Step 3 — Answer grounded in the file
Provide a specific answer citing:
- The exact import or file path
- The relevant MUST rule(s)
- A minimal code pattern or checklist
Do not answer from model training data alone — ground every claim in the loaded AGENTS.md.
References
- Skill catalog (all om-* skills, tiers, triggers, sequencing):
references/skills-catalog.md
- Workflow sequences (named workflows with ordered skill lists):
references/workflow-sequences.md
Load references/skills-catalog.md when the user asks which skill to use.
Load references/workflow-sequences.md when the user asks about sequencing or "where to start".
Load both when the user is fully disoriented.
1---2name: om-help3description: Open Mercato workflow navigator. Use when a developer or agent asks: "what should I do now?", "which skill should I use?", "where do I start?", "next steps?", "I'm lost", "what comes after X?", "how do I add/create/build Y in Open Mercato?", "where does Z go?", "what's the order for a feature/bugfix/PR?", "how do I do X" (module, search, RBAC, events, commands, migrations, UI, AI agents, integrations). Covers both orientation (navigation mode) and technical how-to (knowledge mode).4---56# om-help — Open Mercato Navigator78Two modes: pick the one that matches the question.910---1112## Mode 1: Navigation — "What do I do now?"1314**Triggers:** "what now?", "next steps?", "where do I start?", "which skill?", "I'm lost"1516### Step 1 — Read current context1718Run these commands to understand where the developer is:1920```bash21git branch --show-current22git status --short23ls .ai/specs/ 2>/dev/null | sort | tail -1024gh pr list --author "@me" --state open --json number,title,labels 2>/dev/null || true25```2627### Step 2 — Map to a workflow sequence2829Read `references/workflow-sequences.md`. Match the context:3031| Signal | Likely sequence |32|--------|-----------------|33| No spec, no open PR, task described | New Feature or New Module |34| Spec exists in `.ai/specs/`, not implemented | pre-implement-spec → implement-spec |35| Spec exists, implementation in progress | implement-spec (continue from last phase) |36| Code changed, no PR | code-review → check-and-commit → auto-create-pr |37| PR open, no review | auto-review-pr |38| Bug report / error logs | root-cause → fix |39| UI files touched | ds-guardian → code-review |40| MikroORM errors | migrate-mikro-orm |4142### Step 3 — Recommend4344Output a recommendation in this format:4546```47**Where you are:** <one sentence: branch, active spec or PR if any>4849**Recommended next step:** `/om-<skill-name>`5051**Why:** <one sentence explaining the match>5253**After that:** `/om-<next-skill>` → `/om-<skill-after>`54```5556If multiple paths are valid, present at most two options.5758---5960## Mode 2: Knowledge — "How do I do X in Open Mercato?"6162**Triggers:** "how do I add X?", "how do I build Y?", "where does Z go?", "what import for W?"6364### Step 1 — Map question to Task Router6566Read the Task Router table in the root `AGENTS.md`. Find the row whose description best matches the question.6768Common mappings (quick reference):6970| Question topic | Task Router row / Guide |71|---------------|-------------------------|72| New module, scaffolding, auto-discovery | `packages/core/AGENTS.md` |73| CRUD routes, OpenAPI, `makeCrudRoute` | `packages/core/AGENTS.md` → API Routes |74| Events, subscribers, `createModuleEvents` | `packages/core/AGENTS.md` → Events |75| RBAC, ACL features, `acl.ts` | `packages/core/AGENTS.md` → Access Control |76| Custom fields, `cf.*`, `defineLink` | `packages/core/AGENTS.md` → Custom Fields |77| Search, `search.ts`, reindexing | `packages/search/AGENTS.md` |78| UI components, forms, `CrudForm`, `DataTable` | `packages/ui/AGENTS.md` |79| Backend pages, `apiCall`, `RowActions` | `packages/ui/src/backend/AGENTS.md` |80| i18n, `useT`, `resolveTranslations` | `packages/shared/AGENTS.md` |81| Cache, tag invalidation | `packages/cache/AGENTS.md` |82| Background workers, queues | `packages/queue/AGENTS.md` |83| Event bus, subscribers | `packages/events/AGENTS.md` |84| AI agents, MCP tools | `packages/ai-assistant/AGENTS.md` |85| Integration providers | `packages/core/src/modules/integrations/AGENTS.md` |86| Customer portal, portal auth | `packages/ui/AGENTS.md` → Portal Extension |87| Webhooks | `packages/webhooks/AGENTS.md` |88| Notifications | `packages/core/AGENTS.md` → Notifications |89| Widget injection, component replacement | `packages/core/AGENTS.md` → Widget Injection |90| Database migrations, `db:generate` | `packages/cli/AGENTS.md` |9192### Step 2 — Load and read the target AGENTS.md9394Read the identified `AGENTS.md` file. Look for:95- Import paths and package names96- MUST rules relevant to the question97- Code patterns, examples, file conventions9899### Step 3 — Answer grounded in the file100101Provide a specific answer citing:102- The exact import or file path103- The relevant MUST rule(s)104- A minimal code pattern or checklist105106Do not answer from model training data alone — ground every claim in the loaded AGENTS.md.107108---109110## References111112- **Skill catalog** (all om-* skills, tiers, triggers, sequencing): `references/skills-catalog.md`113- **Workflow sequences** (named workflows with ordered skill lists): `references/workflow-sequences.md`114115Load `references/skills-catalog.md` when the user asks which skill to use. 116Load `references/workflow-sequences.md` when the user asks about sequencing or "where to start". 117Load both when the user is fully disoriented.
open-mercato