Decisions

Decision log (ADR-style) for this initiative.

001 — Workspace layout: sibling directory, one clone per connector

Date: 2026-03-22 Status: Accepted Context: Need a consistent place to check out Fivetran quickstart dbt repos for dashboard pack development. Options: (a) monorepo inside Dataface, (b) sibling directory with one clone per connector, (c) scattered ad-hoc clones. Decision: Use a sibling directory (../quickstart-dbt-workspace/ or $QUICKSTART_DBT_WORKSPACE) with one git clone per connector using the Fivetran connector slug as directory name. Run dft init in each checkout's dbt project root. Research notes stay in Dataface at ai_notes/quickstart-dashboards/<slug>/. Rationale: Keeps Dataface git clean (no submodules or ignored dirs), allows independent version control per connector, and dft init works naturally from each project root. Research notes live in Dataface because they inform dashboard design and are version-controlled with the initiative. Alternatives rejected: Monorepo approach would pollute Dataface git and create a massive worktree; ad-hoc clones lose repeatability.