# Capability Ownership Map

> [!CAUTION]
> **🧪 EXPERIMENTAL — LABS PROJECT**
> This package is not production-ready. No stability guarantees, no support, no warranty. See [README](../README.md) for full disclaimer.

This document defines which command/skill is the source of truth for each capability.

Use it to avoid duplicate guidance and conflicting instructions.

If you want the higher-level "which agent/skill should I use, how do I invoke it, and where does it fit in the SDLC?" view, start with [Agents & Skills Guide](agents-and-skills-guide.md) and use this document as the ownership backstop.

## Ownership Table

| Capability | Owner | Why |
|---|---|---|
| Automated diagnostics and guarded deploy execution | `flow-run` (`bin/cli.mjs`) | Deterministic checks + JSON report + explicit safety gates |
| Manual module deployment steps | `content/cli/skills/fluent-module-deploy/SKILL.md` | Human-guided deployment with operator decisions |
| Workflow operations (list, download, merge, workflowlog) | `content/cli/skills/fluent-workflow/SKILL.md` | Operational CLI source of truth |
| Fluent CLI settings inspection (`fluent setting list/get`) | `content/cli/skills/fluent-cli-settings/SKILL.md` | Canonical CLI guidance for reading/auditing settings in profile+retailer context |
| Fluent CLI retailer lifecycle (`fluent retailer create/list`) | `content/cli/skills/fluent-cli-retailer/SKILL.md` | Canonical CLI guidance for retailer bootstrap and context validation |
| Fluent CLI MCP setup and CI/CD guarded deploy patterns | `content/cli/skills/fluent-cli-mcp-cicd/SKILL.md` | Canonical CLI guidance for `fluent mcp server --stdio` setup and pipeline-safe deploy flow |
| Fluent CLI cross-family routing | `content/cli/skills/fluent-cli-index/SKILL.md` | Single entry point for broad or mixed Fluent CLI requests |
| Complete CLI command reference (all subcommands + flags) | `content/cli/skills/fluent-cli-reference/SKILL.md` | Canonical reference for every Fluent CLI command, flag, and option |
| Account bootstrap (profile, retailer, MCP, workflows, source) | `content/cli/skills/fluent-bootstrap/SKILL.md` | Complete Fluent Commerce account bootstrap wizard with mandatory planning gate |
| CLI profile management (create, switch, list, export) | `content/cli/skills/fluent-profile/SKILL.md` | Manage Fluent CLI profiles for connecting to Fluent Commerce accounts |
| Ready For Launch (RFL) assessment | `content/rfl/skills/fluent-rfl-assess/SKILL.md` | Production readiness audit across workflows, rules, settings, and architecture |
| Workflow design patterns and validation checklist | `content/dev/skills/fluent-workflow-builder/SKILL.md` | Architecture/design guidance for new workflow behavior |
| Build, version bump, package steps | `content/dev/skills/fluent-build/SKILL.md` | Code/module build lifecycle ownership |
| Event tracing and diagnostic decision trees | `content/dev/skills/fluent-trace/SKILL.md` | Investigation workflow ownership |
| Event API model, types, categories, query patterns, event contracts, causality analysis, integration patterns | `content/dev/skills/fluent-event-api/SKILL.md` | Event data model knowledge, filter parameters, event contracts (pre-send validation), causality tracing patterns (`sourceEvents`, `rootEntityRef`, cross-entity chains), and common integration event patterns (inventory, PIM, WMS, carrier) |
| Aggregate platform observability and metrics anomaly triage | `content/dev/skills/fluent-system-monitoring/SKILL.md` | Prometheus/Event API aggregate monitoring, threshold checks, and incident triage routing |
| Opaque rule logic analysis (source request + JAR decompile fallback) | `content/dev/skills/fluent-trace/SKILL.md` + `docs/dev-workflow.md` | Ensures workflow explanations are grounded in executable rule behavior |
| E2E scenario patterns and polling strategy | `content/dev/skills/fluent-e2e-test/SKILL.md` | Scenario-driven behavior verification |
| Workflow structural analysis and dependency mapping | `content/dev/skills/fluent-workflow-analyzer/SKILL.md` | Status graph, event chain tracing, orphan detection |
| Custom source-code understanding and reusable artifact output | `content/dev/skills/fluent-custom-code/SKILL.md` | Source-map, workflow-rule-map, constraints, behavior-map, extension-plan |
| Transition API user action discovery | `content/dev/skills/fluent-transition-api/SKILL.md` | Runtime user action queries, attribute mapping for events |
| Test data discovery and payload generation | `content/dev/skills/fluent-test-data/SKILL.md` | Discover retailer environment (locations, products, catalogues, inventory) and generate valid test entity creation payloads dynamically |
| Settings management | `content/dev/skills/fluent-settings/SKILL.md` | Manage retailer settings — discover, audit against workflows, create/update, migrate between environments |
| Retailer environment configuration | `content/dev/skills/fluent-retailer-config/SKILL.md` | Configure retailer environments — create locations, networks, catalogues, inventory, carriers via GraphQL |
| Module inventory, classification, and structure validation | `content/dev/skills/fluent-module-validate/SKILL.md` | Inventory all deployed modules (reference vs custom), classify by symbolic name, validate custom extension structure; cached JSON artifacts |
| OOTB-vs-custom rule decision | `content/dev/skills/fluent-rule-scaffold/SKILL.md` | Pre-scaffolding check: search registered rules via plugin.list, recommend OOTB if match exists, scaffold custom only when needed |
| MCP extension tool reference (syntax/limits) | `content/mcp-extn/skills/fluent-mcp-tools/SKILL.md` | Canonical tool-level reference |
| MCP core setup and GraphQL core utilities | `content/mcp-extn/skills/fluent-mcp-core/SKILL.md` | Canonical official MCP server reference (now under `mcp-extn` group) |
| Account connection, workspace discovery, JAR decompilation, and cached state | `content/cli/skills/fluent-connect/SKILL.md` | Guided onboarding — discovers profiles, wires MCP, downloads workflows, decompiles JARs, builds rule inventory, persists workspace state |
| Connection topology, cross-entity dependency maps, static-vs-dynamic runtime diffs, webhook/setting conformance | `content/dev/skills/fluent-connection-analysis/SKILL.md` | Topology analysis, orphan detection, process flow classification, --validate mode for runtime coverage comparison, settings conformance inventories |
| JOB/BATCH entity lifecycle diagnostics and monitoring | `content/dev/skills/fluent-job-batch/SKILL.md` | JOB/BATCH orchestration lifecycle, batch ingestion monitoring, job status tracking |
| Session change tracking, audit reporting (text + JSON), and compliance export | `content/dev/skills/fluent-session/SKILL.md` | Running change log of all write operations, skill invocations (with gate results and handoff signals), and MCP tool calls; structured summary on demand; lightweight JSON export; machine-readable JSON audit trail with `skillInvocations[]`, `toolCalls[]`, `decisionTrail[]`, traceability matrix, rollback commands, compliance metadata |
| Module skeleton scaffolding (Maven, POMs, module.json, rules) | `content/dev/skills/fluent-module-scaffold/SKILL.md` | New-vs-extend decision tree; generates buildable module under `accounts/<PROFILE>/SOURCE/` |
| Scope document decomposition into task lists | `content/dev/skills/fluent-scope-decompose/SKILL.md` | Parses ADD scope docs into ordered tasks with dependency DAG, skill mappings, ambiguity flags |
| Version lifecycle (read, bump, sync, tag) | `content/dev/skills/fluent-version-manage/SKILL.md` | Semver bumps across POM files, module.json, CHANGELOG; git tag creation |
| Pre-deployment quality gates | `content/dev/skills/fluent-pre-deploy-check/SKILL.md` | 26 gates across 8 phases; blocks deployment on critical failures |
| Feature reverse-engineering and architecture documentation | `content/dev/skills/fluent-feature-explain/SKILL.md` | Synthesizes workflow, code, connection, and runtime analysis into a persisted Feature Architecture Document with Mermaid diagrams. Tiered evidence: plugin.list (always) → decompiled JAR / original source → runtime. Auto-discovers entities for runtime, decompiles JARs when no source. Includes Analysis Confidence section with per-rule evidence levels. |
| Feature implementation planning (multi-artifact) | `content/dev/skills/fluent-feature-plan/SKILL.md` | Produces comprehensive 18-section feature plans with universal NEW/EXISTING/MODIFIED/REUSED/OOTB Source classification across all artifacts (rules, rulesets, statuses, settings, webhooks, GraphQL ops, cross-entity impacts). For NEW rules: pseudo logic contract. For OOTB: prop configuration. Template at `PLAN_TEMPLATE.md` (sibling file in skill directory). |
| Source code onboarding into Fluent module format | `content/dev/skills/fluent-source-onboard/SKILL.md` | Restructures non-standard Java source (loose files, decompiled JARs, Gradle projects, partial modules) into Maven multi-module Fluent extension module format. Validates with module-validate, attempts build, reconciles against deployed rules. |
| Sourcing framework reference (profiles, strategies, conditions, criteria, scoring, extensions) | `content/dev/skills/fluent-sourcing/SKILL.md` | Comprehensive reference for Responsive Sourcing Framework v2.1+. Covers evaluation flow, 10 condition operators, 11 built-in criteria with scoring models, normalization algorithm, permutation search, settings schema, workflow integration rules, custom Java extensions, and operational GraphQL patterns. Chains to `/fluent-rule-scaffold` for custom extension wiring, `/fluent-workflow-builder` for sourcing rulesets, `/fluent-settings` for sourcing settings CRUD. |
| Business requirements gathering (interactive wizard + document analysis) | `content/dev/skills/fluent-use-case-discover/SKILL.md` | Structured business spec production that feeds feature planning. Interactive mode walks through use cases, actors, business rules. Document analysis mode extracts from existing docs. |
| Feature lifecycle dashboard and status tracking | `content/dev/skills/fluent-feature-status/SKILL.md` | Scans all `features/*/status.json`, presents consolidated table with filtering, sorting, and attention items across profiles |
| Feature archival and lifecycle cleanup | `content/dev/skills/fluent-archive/SKILL.md` | Transitions features to ARCHIVED status with confirmation gate. Blocked for IN_PROGRESS without --force. |
| Deployment rollback (workflows, modules, settings) | `content/dev/skills/fluent-rollback/SKILL.md` | Guided rollback with mandatory planning gate and dry-run mode. Workflow version revert, module redeploy, settings restore. |
| Workspace structure visualization | `content/dev/skills/fluent-workspace-tree/SKILL.md` | Read-only annotated workspace tree showing all artifacts by category with counts and status overlays |
| Implementation reverse-engineering and feature inventory | `content/dev/skills/fluent-implementation-map/SKILL.md` | Top-of-pyramid analysis: discovers features from workflows/rules/settings, maps cross-feature dependencies, scores customisation depth, identifies gaps. Output to `analysis/implementation-map/`. |
| Workflow deployment with validation and fallback | `content/dev/skills/fluent-workflow-deploy/SKILL.md` | MCP-primary workflow upload with pre-flight checks, version verification, automatic REST API fallback, and rollback support |
| Data module scaffolding (no Java plugins) | `content/dev/skills/fluent-data-module-scaffold/SKILL.md` | Generates module structure with assets directories, module.json, config template, and build script for non-plugin modules |
| Mermaid diagram syntax validation | `knowledge/mermaid-syntax-rules.md` | Internalized as knowledge doc. Validates stateDiagram-v2, sequenceDiagram, flowchart, erDiagram syntax. Referenced by diagram-generating skills. |
| Mystique manifest validation (schema, components, props, queries, i18n) | `content/dev/skills/fluent-mystique-validate/SKILL.md` | 49 validation rules across 6 phases. Canonical OOTB component alias registry (73 aliases). Schema compliance, component resolution, data/query validation, template string checking, prop verification, cross-manifest consistency. |
| Mystique manifest building and editing | `content/dev/skills/fluent-mystique-builder/SKILL.md` | 6 operations (create manifest, add page, add component, build fragment, generate data query, edit manifest). 7 composition patterns. Entity type-to-GraphQL query mapping. Full manifest v2.0 schema. Build vs Configure decision framework. |
| Mystique SDK component scaffolding | `content/dev/skills/fluent-mystique-scaffold/SKILL.md` | Generate complete buildable SDK component projects (webpack, TypeScript, Storybook, Jest, component registration). Only invoked when Build vs Configure framework determines OOTB components cannot meet the requirement. |
| Frontend SDK build pipeline (7 gates) | `content/dev/skills/fluent-frontend-build/SKILL.md` | TypeScript compilation → lint → tests with coverage → production webpack build → bundle verification (size, version.json) → externals check (React/MUI not bundled) → GraphQL schema validation (3-tier: source queries, deployed manifests, workflow cross-ref). Produces structured build report. |
| Frontend SDK code quality audit (9 phases) | `content/dev/skills/fluent-frontend-review/SKILL.md` | TypeScript quality, React patterns, SDK compliance, GraphQL schema validation (3-tier), code documentation, test quality, README completeness, bundle health, deployment readiness. Graded A-F scoring. Read-only — does not auto-fix. |
| Frontend SDK README generation | `content/dev/skills/fluent-frontend-readme/SKILL.md` | Auto-generates README.md from source code. Inspects ComponentRegistry registrations, hook usage, settings dependencies, GraphQL queries, and build config to produce accurate documentation. |
| Mystique manifest analysis and complexity scoring | `content/dev/skills/fluent-mystique-analyze/SKILL.md` | 7 analysis dimensions with weighted complexity scoring (0-100). 15 pattern detection rules. Mermaid diagram generation (route graph, component tree, data flow). Architectural health assessment. |
| Browser-based UI testing for deployed Mystique manifests | `content/dev/skills/fluent-ui-test/SKILL.md` | Chrome DevTools MCP-based browser testing — login, navigation, component rendering verification, screenshot capture, DOM snapshot, console error detection. Requires `chrome-devtools` server in `.mcp.json`. |
| Skill execution feedback loop (dashboard, review, promote) | `content/dev/skills/fluent-feedback/SKILL.md` | View per-skill success/failure rates, review recurring issues, promote confirmed learnings into SKILL.md Known Pitfalls sections. Storage: `accounts/<PROFILE>/feedback/`. |
| Annotated UI walkthroughs and evidence recording | `content/dev/skills/fluent-ui-record/SKILL.md` | Captures before/after screenshots with DOM annotations, optional Chrome DevTools MCP video recording, manifest diff reports, and HTML evidence reports. Companion to `/fluent-ui-test`. |
| Project knowledge initialization and management | `content/dev/skills/fluent-knowledge-init/SKILL.md` | Interactive wizard to set up partner conventions, client business rules, integrations, and test data in `accounts/<PROFILE>/knowledge/` directory. Supports doc ingestion, conversational capture, and progressive learning. |
| Feature delivery phasing (vertical slices) | `content/dev/skills/fluent-feature-phase/SKILL.md` | Breaks a large approved feature into independently deliverable vertical slices. Each phase delivers end-to-end value. Sits between spec approval and feature planning. |
| Feature dashboard (live HTML) | `content/dev/skills/fluent-feature-dashboard/SKILL.md` | Interactive HTML dashboard showing feature lifecycle status, specs, plans, architecture diagrams, feedback metrics, reports, and session history. Auto-starts a live-reload server. |
| Mystique SDK component addition | `content/dev/skills/fluent-mystique-component/SKILL.md` | Adds new components, form fields, or template helpers to an existing Mystique SDK project. Generates component files, registers with the appropriate registry, and wires into the build. |
| Mystique UI preview (mock/modify/remove) | `content/dev/skills/fluent-mystique-preview/SKILL.md` | Mock, modify, and preview Mystique UI components in the live Fluent Commerce app before building or deploying. Three modes: ADD (inject new), MODIFY (alter existing), REMOVE (preview without). |
| Virtual inventory catalog management | `content/dev/skills/fluent-inventory-catalog/SKILL.md` | Manage Fluent Commerce virtual inventory: catalogues, positions, segments, feeds, and control groups. Schema-gated — only runs when VirtualSegment type exists. |

## Reconciliation Rules

- Event API source docs are selectively extracted into skills; do not mirror full product docs.
- If deployment logic changes, update `flow-run` and `fluent-module-deploy`; link from `fluent-build` rather than duplicating deploy instructions.
- If workflow command syntax changes, update `fluent-workflow`; `fluent-workflow-builder` should reference it for operational steps.
- If MCP tool contracts change, update `fluent-mcp-tools` first; other skills should reference it for request syntax and limits.
- If workflow/ruleset intent is ambiguous, escalate to source/decompile flow owned by `fluent-trace` + `dev-workflow.md` before making behavioral claims.
- If module structure checks change, update `fluent-module-validate` first; `fluent-build` and `fluent-module-deploy` should read the cached report rather than duplicating checks.
- Keep skill files focused on decision logic and patterns; keep low-level command/tool reference centralized.
- If Mystique component registry or manifest schema changes, update `fluent-mystique-validate` first (canonical OOTB alias list); `fluent-mystique-builder` and `fluent-mystique-analyze` reference it for component resolution.
- Frontend skills (`fluent-mystique-*`, `fluent-frontend-*`, `fluent-ui-test`) own all Mystique/manifest/UI/SDK work. Backend skills should never generate or modify manifests. Cross-domain features route through `/fluent-feature-plan` at the orchestrator level.
- Browser-based UI testing (`fluent-ui-test`) requires Chrome DevTools MCP. If Chrome DevTools MCP is not configured, redirect user to add the `chrome-devtools` server entry to `.mcp.json`.

## Round-Robin Debugging Protocol

| Entry intent | Route to | Avoid |
|---|---|---|
| "What actions are available at this status?" | `fluent-transition-api` | Re-implementing transition discovery in other skills |
| "How do events/filters/causality work?" | `fluent-event-api` | Running full root-cause workflow here |
| "How do I call this MCP tool?" | `fluent-mcp-tools` | Redefining tool contracts per skill |
| "Run workflow end-to-end validation" | `fluent-e2e-test` | Duplicating trace decision trees |
| "Why did this fail / entity stuck?" | `fluent-trace` | Repeating generic setup when failure context is already known |
| "Explain feature / how does X work / document this flow" | `fluent-feature-explain` | Running individual analysis skills without synthesizing into a document |
| "Plan this feature / implement curbside / design the return flow" | `fluent-feature-plan` | Using individual skills without a comprehensive plan first |
| "How does sourcing work / configure sourcing profile / debug sourcing" | `fluent-sourcing` | Reimplementing sourcing logic reference in other skills |
| "Gather requirements / create business spec / define use cases" | `fluent-use-case-discover` | Starting `/fluent-feature-plan` without an approved spec |
| "Show feature status / what's in progress / feature dashboard" | `fluent-feature-status` | Manually scanning feature directories |
| "Archive this feature / mark as done / close feature" | `fluent-archive` | Manually editing status.json |
| "Roll back / undo deployment / revert workflow" | `fluent-rollback` | Manual GraphQL mutations or file restoration |
| "Show workspace / what's where / directory structure" | `fluent-workspace-tree` | Running `ls` or `find` commands |
| "Implementation map / what's been built / feature inventory / reverse engineer account" | `fluent-implementation-map` | Running individual analysis skills piecemeal |
| "Deploy workflow / upload workflow JSON" | `fluent-workflow-deploy` | Using `fluent-workflow` for deployment (that's read-only operations) |
| "Validate Mermaid / check diagram syntax" | `knowledge/mermaid-syntax-rules.md` | Reference knowledge doc directly |
| "Bootstrap account / set up new environment / initialize workspace" | `fluent-bootstrap` | Manual multi-step setup |
| "Create profile / switch profile / manage environments" | `fluent-profile` | Manual CLI profile management |
| "Ready for launch / go-live readiness / production audit" | `fluent-rfl-assess` | Manual checklist-based assessment |
| "Build manifest / create page / add route / edit UI" | `fluent-mystique-builder` | Building manifests outside the builder skill |
| "Validate manifest / check UI / lint manifest" | `fluent-mystique-validate` | Re-implementing component validation elsewhere |
| "Scaffold SDK component / new Mystique project" | `fluent-mystique-scaffold` | Building SDK projects without the Build vs Configure decision framework |
| "Build SDK project / compile / run tests / check bundle" | `fluent-frontend-build` | Re-implementing build pipeline in other skills |
| "Review frontend code / audit quality / check patterns" | `fluent-frontend-review` | Re-implementing code analysis in other skills |
| "Generate README / document components" | `fluent-frontend-readme` | Manually writing README for SDK projects |
| "Analyze manifest / UI audit / manifest complexity" | `fluent-mystique-analyze` | Re-implementing analysis elsewhere |
| "Test the page in browser / verify UI / check if page loads" | `fluent-ui-test` | Manual browser testing or re-implementing Chrome DevTools MCP logic in other skills |
| "Show feedback / skill success rate / recurring issues" | `fluent-feedback` | Manually reading feedback JSONL files |
| "Record UI walkthrough / capture before-after / evidence report" | `fluent-ui-record` | Manual screenshot gathering without annotations |
| "Set up knowledge / import conventions / capture business rules" | `fluent-knowledge-init` | Manually writing knowledge files |
| "Phase this feature / break into slices / delivery phases" | `fluent-feature-phase` | Manual phase planning |
| "Show feature dashboard / open dashboard" | `fluent-feature-dashboard` | Manually opening reports |
| "Add component to SDK project / new field / new helper" | `fluent-mystique-component` | Manually creating component files |
| "Preview UI change / mock component / what will it look like" | `fluent-mystique-preview` | Manual manifest editing for preview |
| "Manage inventory / virtual catalogue / segments" | `fluent-inventory-catalog` | Manual GraphQL inventory operations |

Handoff rule: when E2E fails, pass `entityRef`, `entityType`, `eventId` (if available), and expected vs actual status to `fluent-trace`.

## CLI Coverage Matrix

Tracks how fully the `cli` skill group covers Fluent CLI command families.

| Command Family | Status | Owner Skill |
|---|---|---|
| `fluent profile *` | full | `fluent-profile` |
| `fluent retailer *` | full | `fluent-cli-retailer` |
| `fluent module *` | full | `fluent-module-deploy` |
| `fluent workflow *` | full | `fluent-workflow` |
| `fluent workflowlog *` | full | `fluent-workflow` |
| `fluent setting *` | full | `fluent-cli-settings` |
| Cross-family routing | full | `fluent-cli-index` |
| `fluent mcp server *` | full | `fluent-cli-mcp-cicd` |
| Account bootstrap flow | full | `fluent-bootstrap` |
| CI/CD guarded deploy | full | `fluent-cli-mcp-cicd` |

Routing rule: for broad CLI requests, start with `/fluent-cli-index`, then delegate to the command-family specialist. For official MCP server internals, hand off to `/fluent-mcp-core`.
