tasks/workstreams/mcp-analyst-agent/initiatives/quickstart-dashboards/spec.md

Spec

Prerequisites

Scope

Workspace layout

  1. Choose a root directory (example: sibling to this repo, ../quickstart-dbt-workspace/, or $QUICKSTART_DBT_WORKSPACE). Do not assume paths inside dataface/ without documenting ignore/submodule policy.
  2. For each connector: git clone <quickstart-repo-url> <connector-slug> (exact naming convention TBD in program task—prefer connector slug from Fivetran naming).
  3. In each checkout: run dft init from the dbt project root (or documented subdirectory if the repo is monorepo-style).
  4. Dashboard YAML lives in that project following whatever dft init establishes (document any overrides per repo).

Per-connector flow

  1. Clone + dft init.
  2. Run quickstart-product-dashboard-research skill: capture native dashboards, question list, entity/detail topology, link matrix, model gaps.
  3. Implement a minimal first pack: executive/overview board + one entity-detail path with cross-links.
  4. Record retro notes in the pilot task; open new tasks for follow-on connectors or skill revisions.

Quality bar

Validation