aw-spec-cli 0.1.3 → 0.1.4

package/assets/docs/domainspecs/UIVisualization/chart-survival.md

@@ -0,0 +1,69 @@
+# SurvivalCurveChart — Chart Rule
+
+> Load **only when "Survival / Kaplan-Meier / retention" (or "all plots") is selected** (see [[domain-requirements]]).
+> Component: `SurvivalCurveChart` in `components/charts/generic/SurvivalCurveChart.tsx`. Built on [[charting-standards.domain]].
+
+## Purpose
+Kaplan-Meier–style **step-function** curves with optional CI shading, median markers, and a
+significance annotation. Use for clinical OS/PFS, user-cohort retention, component MTTF, churn.
+
+## Props contract
+```ts
+interface SurvivalPoint {
+  time: number
+  survival: number             // 0–1 (×100 applied) or 0–100
+  ciLower?: number; ciUpper?: number   // same scale as survival
+  nAtRisk?: number
+}
+interface SurvivalArm {
+  label: string; color: string        // colour REQUIRED — distinguishes arms
+  points: SurvivalPoint[]
+  medianTime?: number | null          // null = not reached
+}
+interface SurvivalCurveChartProps {
+  arms: SurvivalArm[]          // REQUIRED
+  timeLabel?: string           // default "Time"
+  survivalLabel?: string       // default "Survival Probability (%)"
+  eventLabel?: string          // "Death", "Churn", "Failure" …
+  medianLabel?: string         // "mOS", "mPFS", "Median retention"
+  curveType?: string           // corner badge: "OS", "KM", "Retention"
+  pValue?: string              // "< 0.001", "n.s."
+  showCI?: boolean             // default true (needs ciLower/ciUpper)
+  xMax?: number; height?: number
+}
+```
+
+## Rules
+- Curve is a **step function** (`shape: 'hv'`) — survival is constant between events. Pass points
+  at event/censor times; the chart draws the steps.
+- `survival` accepts either 0–1 or 0–100 — the chart normalises; be consistent within an arm.
+- CI shading requires `ciLower`/`ciUpper` on the points and `showCI` (default on).
+- `medianTime: null` renders "Not reached" — use it, don't fake a value.
+
+## Adapter example (agent reference)
+```tsx
+'use client'
+import { SurvivalCurveChart } from '@/components/charts/generic'
+import type { TrialArm } from '@/lib/types/pharma'
+
+export default function KaplanMeierChart({ arms, height }: { arms: TrialArm[]; height?: number }) {
+  return (
+    <SurvivalCurveChart
+      arms={arms.map(a => ({
+        label: a.name, color: a.color, medianTime: a.medianSurvival,
+        points: a.points.map(p => ({ time: p.time, survival: p.survival,
+          ciLower: p.ciLower, ciUpper: p.ciUpper, nAtRisk: p.nAtRisk })),
+      }))}
+      timeLabel="Days" survivalLabel="Survival Probability (%)" medianLabel="mOS"
+      curveType="OS" pValue="< 0.001" showCI height={height}
+    />
+  )
+}
+```
+
+## Scaffolds when selected
+- generic `SurvivalCurveChart` + `app/survival/` (or `trials/`) route + nav tab + optional adapter;
+  an optional number-at-risk table consumes `nAtRisk`.
+
+## Related
+- [[charting-standards.domain]] · [[component-contracts.domain]] · [[clean-architecture.domain]]

package/assets/docs/domainspecs/UIVisualization/chart-trellis.md

@@ -0,0 +1,68 @@
+# TrellisGrid — Chart Rule
+
+> Load **only when "Trellis / facet / small-multiples" (or "all plots") is selected** (see [[domain-requirements]]).
+> Component: `TrellisGrid` in `components/charts/generic/TrellisGrid.tsx`. Built on [[charting-standards.domain]];
+> uses Plotly subplot `grid`.
+
+## Purpose
+An **N×M grid of the same chart type** — one panel per data subset (small multiples / facets).
+Use for KPI by region, IC₅₀ by target class, sensor readings by machine, feature distributions
+per class.
+
+## Props contract
+```ts
+interface TrellisTrace {
+  type: 'bar' | 'scatter' | 'line' | 'box'
+  x: (string|number)[]; y: number[]
+  label: string; color?: string
+  mode?: 'markers' | 'lines' | 'lines+markers'   // scatter/line only
+}
+interface TrellisPanel { title: string; traces: TrellisTrace[] }
+
+interface TrellisGridProps {
+  panels: TrellisPanel[]       // REQUIRED — one per subset
+  cols?: number                // grid columns (default 3); rows auto
+  xLabel?: string; yLabel?: string   // shared axis labels
+  sharedXAxis?: boolean        // align x-range across panels
+  sharedYAxis?: boolean        // align y-range — ESSENTIAL for fair comparison
+  panelHeight?: number         // px per panel (total = rows × panelHeight)
+  title?: string
+}
+```
+
+## Rules
+- All panels render the **same trace type** — that is the point of small multiples. Don't mix bar
+  and line across panels.
+- Turn on **`sharedYAxis`** whenever comparing magnitudes across panels — otherwise each panel
+  auto-scales and the comparison misleads.
+- `panels` is built by grouping the dataset on the facet dimension (target, region, class) in the
+  adapter/page.
+- `TrellisGrid` sizes by `rows × panelHeight` (it does not fill-parent); pick `panelHeight` for the
+  card and let the page scroll if needed.
+
+## Page/adapter example (agent reference)
+```tsx
+'use client'
+import { TrellisGrid } from '@/components/charts/generic'
+import { PHARMA_COLORS } from '@/components/charts/PlotlyChart'
+import type { Compound } from '@/lib/types/pharma'
+
+export default function Ic50ByTarget({ compounds }: { compounds: Compound[] }) {
+  const targets = [...new Set(compounds.map(c => c.target))]
+  const panels = targets.map((t, i) => {
+    const g = compounds.filter(c => c.target === t).sort((a, b) => a.ic50_nM - b.ic50_nM)
+    return {
+      title: t,
+      traces: [{ type: 'bar' as const, label: t, color: PHARMA_COLORS[i % PHARMA_COLORS.length],
+        x: g.map(c => c.name), y: g.map(c => Math.min(c.ic50_nM, 800)) }],
+    }
+  })
+  return <TrellisGrid panels={panels} cols={4} xLabel="Compound" yLabel="IC₅₀ (nM)" sharedYAxis panelHeight={210} />
+}
+```
+
+## Scaffolds when selected
+- generic `TrellisGrid` + `app/trellis/page.tsx` + nav tab + optional adapter.
+
+## Related
+- [[charting-standards.domain]] · [[component-contracts.domain]] · [[clean-architecture.domain]]

package/assets/docs/domainspecs/UIVisualization/chart-violin.md

@@ -0,0 +1,61 @@
+# ViolinPlot — Chart Rule
+
+> Load **only when "Violin / distribution" (or "all plots") is selected** (see [[domain-requirements]]).
+> Component: `ViolinPlot` in `components/charts/generic/ViolinPlot.tsx`.
+> Built on [[charting-standards.domain]]; uses Plotly's native `violin` (KDE + box computed for you).
+
+## Purpose
+Distribution **shape (KDE)** of a numeric variable across groups, with optional box plot and
+jittered points. Use for biomarker expression by cohort, API latency by endpoint, salary by band,
+any group-wise distribution comparison.
+
+## Props contract
+```ts
+interface ViolinGroup {
+  label: string                // x-axis category
+  values: number[]             // RAW observations — Plotly computes KDE/IQR/whiskers
+  color?: string
+}
+type PointDisplayMode = 'none' | 'outliers' | 'all' | 'suspected'
+
+interface ViolinPlotProps {
+  groups: ViolinGroup[]        // REQUIRED
+  yLabel?: string; xLabel?: string
+  showBox?: boolean            // overlay median/IQR box (default true)
+  showMean?: boolean           // mean line (default false)
+  showPoints?: PointDisplayMode // default 'outliers'
+  side?: 'both' | 'positive' | 'negative'  // split violin for back-to-back compare
+  bandwidth?: 'normal reference' | 'scott' | 'silverman'
+  fillOpacity?: number
+  title?: string; height?: number
+}
+```
+
+## Rules
+- Pass **raw values** — never pre-binned or pre-summarised; the chart computes KDE, quartiles and
+  whiskers. Each group needs enough points (≥ ~10) for a meaningful KDE.
+- Use `showPoints="outliers"` for clinical/quality data; `"all"` only for small n.
+- `side="positive"`/`"negative"` enables split (back-to-back) violins for two-condition compares.
+
+## Page/adapter example (agent reference)
+```tsx
+'use client'
+import { ViolinPlot } from '@/components/charts/generic'
+
+// readings: { group: string; value: number }[]
+export default function ExpressionViolin({ readings }: { readings: { group: string; value: number }[] }) {
+  const groups = [...new Set(readings.map(r => r.group))].map(g => ({
+    label: g, values: readings.filter(r => r.group === g).map(r => r.value),
+  }))
+  return (
+    <ViolinPlot groups={groups} yLabel="Expression (log₂FC)" xLabel="Treatment"
+      showBox showMean showPoints="outliers" />
+  )
+}
+```
+
+## Scaffolds when selected
+- generic `ViolinPlot` + `app/violin/page.tsx` + nav tab + optional adapter.
+
+## Related
+- [[charting-standards.domain]] · [[component-contracts.domain]] · [[clean-architecture.domain]]

package/assets/docs/domainspecs/UIVisualization/chart-volcano.md

@@ -0,0 +1,63 @@
+# VolcanoPlot — Chart Rule
+
+> Load **only when "Volcano" (or "all plots") is selected** (see [[domain-requirements]]).
+> Component: `VolcanoPlot` in `components/charts/generic/VolcanoPlot.tsx`. Built on [[charting-standards.domain]].
+
+## Purpose
+**Magnitude vs. significance** scatter, partitioned into up / down / not-significant by two
+thresholds. Use for differential expression (RNA-seq/proteomics), A/B-test lift vs significance,
+GWAS hits, ML feature importance, adverse-event signals.
+
+## Props contract
+```ts
+interface VolcanoPoint {
+  x: number                    // magnitude (e.g. log₂FC, effect size)
+  y: number                    // significance (e.g. -log₁₀ p-value)
+  label: string
+  meta?: Record<string, string|number>
+}
+interface VolcanoPlotProps {
+  points: VolcanoPoint[]       // REQUIRED
+  xLabel?: string              // default "log₂(Fold Change)"
+  yLabel?: string              // default "-log₁₀(p-value)"
+  foldChangeThreshold?: number // |x| above → "changed" (default 1.0)
+  significanceThreshold?: number // y above → significant (default 1.301 ≈ p<0.05)
+  upColor?: string; downColor?: string; nsColor?: string
+  upLabel?: string; downLabel?: string; nsLabel?: string
+  labelTopN?: number           // annotate top-N by |x·y| (default 10; 0 disables)
+  title?: string; height?: number
+}
+```
+
+## Rules
+- The caller supplies **already-computed** statistics: `x` = effect/log₂FC, `y` = `-log10(p)`.
+  The chart does not run the test.
+- `significanceThreshold` is in **`-log10(p)`** units (1.301 = p 0.05; 2 = p 0.01). State the test
+  basis in `yLabel`.
+- The chart partitions points by the two thresholds and labels the top-N hits — keep `labelTopN`
+  small (≤ 15) to avoid clutter.
+
+## Page/adapter example (agent reference)
+```tsx
+'use client'
+import { VolcanoPlot } from '@/components/charts/generic'
+
+// genes: { name, log2FC, pValue }[]
+export default function DiffExpressionVolcano({ genes }: { genes: { name: string; log2FC: number; pValue: number }[] }) {
+  return (
+    <VolcanoPlot
+      points={genes.map(g => ({ x: g.log2FC, y: -Math.log10(g.pValue), label: g.name,
+        meta: { 'p-value': g.pValue.toExponential(2) } }))}
+      xLabel="log₂(Fold Change)" yLabel="-log₁₀(p-value)"
+      foldChangeThreshold={1} significanceThreshold={1.301}
+      upLabel="Up-regulated" downLabel="Down-regulated" labelTopN={10}
+    />
+  )
+}
+```
+
+## Scaffolds when selected
+- generic `VolcanoPlot` + `app/volcano/page.tsx` + nav tab + optional adapter.
+
+## Related
+- [[charting-standards.domain]] · [[component-contracts.domain]] · [[clean-architecture.domain]]

package/assets/docs/domainspecs/UIVisualization/charting-standards.domain.md

@@ -0,0 +1,80 @@
+# Charting Standards — UI Visualization Domain
+
+> The base Plotly wrapper, theme, and rendering rules every chart depends on. NON-NEGOTIABLE.
+> Commands: `/aw-spec-plan`, `/aw-spec-tasks`, `/aw-spec-implement`.
+
+## Single base wrapper
+
+- **All** charts render through one component: `components/charts/PlotlyChart.tsx`. No chart imports
+  `plotly.js` directly.
+- Plotly is loaded via **dynamic import inside `useEffect`** (SSR-safe — Plotly touches `window`).
+  Never import it at module top level; never render it in a Server Component.
+- The wrapper exposes a shared `BASE_LAYOUT`, `BASE_CONFIG`, and `PHARMA_COLORS` palette that every
+  generic chart spreads over its own layout.
+- **Responsive fill:** when a chart is given no explicit `height`, it passes `fillHeight` and the
+  wrapper sizes to the parent (`height: 100%`); when given a number, that wins. Charts therefore
+  fill a flex card without manual measuring.
+
+## Canonical base wrapper (agent reference)
+
+```tsx
+// components/charts/PlotlyChart.tsx
+'use client'
+import { useEffect, useRef } from 'react'
+
+export const PHARMA_COLORS = ['#00d4b4','#3b82f6','#8b5cf6','#f59e0b','#ef4444','#10b981','#f97316','#ec4899']
+export const BASE_LAYOUT = {
+  paper_bgcolor: '#0a1628', plot_bgcolor: '#0a1628',
+  font: { color: '#8ba3c7', family: 'Inter, system-ui, sans-serif', size: 11 },
+  margin: { t: 30, r: 20, b: 50, l: 60 },
+  xaxis: { gridcolor: 'rgba(59,130,246,0.10)', zerolinecolor: 'rgba(59,130,246,0.10)' },
+  yaxis: { gridcolor: 'rgba(59,130,246,0.10)', zerolinecolor: 'rgba(59,130,246,0.10)' },
+  hoverlabel: { bgcolor: '#0f1e38', bordercolor: 'rgba(0,212,180,0.3)', font: { color: '#e2ecff' } },
+}
+export const BASE_CONFIG = { displayModeBar: true, displaylogo: false, responsive: true }
+
+interface Props { data: unknown[]; layout?: Record<string, unknown>; config?: Record<string, unknown>; className?: string; fillHeight?: boolean }
+
+export default function PlotlyChart({ data, layout = {}, config = {}, className, fillHeight = false }: Props) {
+  const ref = useRef<HTMLDivElement>(null)
+  useEffect(() => {
+    if (!ref.current) return
+    const el = ref.current; let cancelled = false
+    import('plotly.js-dist-min').then(Plotly => {
+      if (cancelled || !el) return
+      Plotly.react(el, data, { ...BASE_LAYOUT, ...layout }, { ...BASE_CONFIG, ...config })
+    })
+    return () => { cancelled = true; import('plotly.js-dist-min').then(P => { try { P.purge(el) } catch {} }) }
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [JSON.stringify(data), JSON.stringify(layout)])
+  return <div ref={ref} className={className} style={{ width: '100%', height: fillHeight ? '100%' : undefined }} />
+}
+```
+
+## Generic-chart contract (every chart in `generic/`)
+
+1. `'use client'` at the top; renders only via `PlotlyChart`.
+2. Accepts an **optional `height?: number`**; spreads `height` into layout only when defined,
+   else passes `fillHeight={height === undefined}` and adds `h-full` to the className.
+3. Builds `data` + `layout` from props, spreading `BASE_LAYOUT`.
+4. **No domain vocabulary** — all labels/units/colours come from props
+   (see [[component-contracts.domain]]).
+5. Colours default from `PHARMA_COLORS` (rename palette per project; keep the export name stable).
+
+## Theme tokens
+
+- Dark "glass" theme: `bg-mesh` background, `glass-card` + `gradient-border` chart cards,
+  accent teal `#00d4b4` / purple `#7c3aed`. Tokens live in `globals.css` and `tailwind.config.ts`.
+- Chart text/grid colours come from `BASE_LAYOUT` so every chart matches the shell automatically.
+
+## Rules
+
+- Purge the Plotly instance on unmount (the wrapper does this) to avoid leaks on route change.
+- Re-render keys off `JSON.stringify(data/layout)` — keep prop objects stable or memoised for
+  large datasets.
+- Never set a fixed pixel height in a page card; let `fillHeight` size to the flex parent.
+
+## Related
+- [[component-contracts.domain]] — the per-chart prop contract built on this base
+- [[clean-architecture.domain]] — the generic ring depends only on this wrapper
+- All `chart-*` rule files build on this base.

package/assets/docs/domainspecs/UIVisualization/clean-architecture.domain.md

@@ -0,0 +1,87 @@
+# Clean Architecture — UI Visualization Domain
+
+> Front-end layering for the visualization app. NON-NEGOTIABLE.
+> Commands: `/aw-spec-plan`, `/aw-spec-tasks`, `/aw-spec-implement`.
+
+## Dependency direction
+
+Dependencies flow **inward only**, toward the generic chart library:
+
+```
+Page (app/*/page.tsx)
+      │  composes
+      ▼
+Adapter (components/charts/<Domain>Chart.tsx)   ── maps domain data → generic props
+      │  depends on
+      ▼
+Generic Chart (components/charts/generic/*)      ← innermost ring; depends on nothing domain-specific
+      ▲
+      │  provides data (never imports a chart)
+Data Layer (lib/*, store/*)
+```
+
+The **generic chart library** is the innermost ring — every layer may depend on it; it depends on
+nothing but `PlotlyChart` + the shared palette/theme.
+
+## Layer responsibilities
+
+- **Page** (`app/*/page.tsx`) — route surface. Reads data from the store, lays out the chart card,
+  passes props to an adapter (or directly to a generic chart). MUST NOT contain Plotly trace
+  construction.
+- **Adapter** (`components/charts/<Domain>Chart.tsx`) — translates a **project/domain type**
+  (e.g. `Compound[]`, `TrialArm[]`) into a generic chart's props. The **only** place domain
+  vocabulary meets a chart (see [[component-contracts.domain]]).
+- **Generic chart** (`components/charts/generic/*`) — builds Plotly traces/layout from
+  **caller-supplied data, labels, colours**. Domain-agnostic and reusable across projects.
+- **Data layer** (`lib/*`, `store/*`) — types, parsing, formatting, state. Feeds data **into**
+  pages; MUST NOT import chart components.
+
+## Forbidden patterns
+
+- Domain logic, project types, or hard-coded domain labels inside `components/charts/generic/`.
+- A page constructing Plotly `data`/`layout` arrays directly (that belongs in a chart/adapter).
+- A generic chart importing from `lib/sample-data`, the store, or any `app/*` route.
+- The data layer importing a chart component (inversion of the dependency rule).
+
+## Canonical example (agent reference)
+
+The adapter is the dependency seam — the **page** depends on the **adapter**, the **adapter**
+depends on the **generic chart**; the generic chart knows nothing about the domain:
+
+```tsx
+// Page — app/compounds/page.tsx  (composition only)
+'use client'
+import CompoundScatterPlot from '@/components/charts/CompoundScatterPlot'
+import { useDataStore } from '@/store/data-store'
+
+export default function CompoundsPage() {
+  const { compounds } = useDataStore()
+  return <CompoundScatterPlot compounds={compounds} />
+}
+
+// Adapter — components/charts/CompoundScatterPlot.tsx  (domain → generic props)
+'use client'
+import { BubbleChart } from '@/components/charts/generic'
+import type { Compound } from '@/lib/types/pharma'
+
+export default function CompoundScatterPlot({ compounds }: { compounds: Compound[] }) {
+  const targets = [...new Set(compounds.map(c => c.target))]
+  return (
+    <BubbleChart
+      series={targets.map(t => ({
+        seriesLabel: t,
+        points: compounds.filter(c => c.target === t).map(c => ({
+          x: c.molecularWeight, y: Math.log10(c.ic50_nM),
+          size: c.selectivityRatio, label: c.name,
+        })),
+      }))}
+      xLabel="Molecular Weight (Da)" yLabel="log₁₀(IC₅₀, nM)" sizeLabel="Selectivity"
+    />
+  )
+}
+```
+
+## Related
+- [[component-contracts.domain]] — adapter prop contract
+- [[charting-standards.domain]] — the `PlotlyChart` base + theme the generic ring depends on
+- [[folder-structure.domain]] · [[state-management.domain]]

package/assets/docs/domainspecs/UIVisualization/coding-standards.domain.md

@@ -0,0 +1,47 @@
+# Coding Standards — UI Visualization Domain
+
+> TypeScript / React / Next.js conventions for the viz front-end. NON-NEGOTIABLE.
+> Commands: `/aw-spec-plan`, `/aw-spec-tasks`, `/aw-spec-implement`, `/aw-spec-analyze`.
+
+## TypeScript
+
+- `strict: true`. No implicit `any`; for Plotly's loose trace objects use a single
+  `as never[]` / `Record<string, unknown>` at the wrapper boundary, never sprinkled through code.
+- Data contracts are `interface`s in `lib/types/`; chart prop types are exported from each
+  generic chart and re-exported from `generic/index.ts`.
+- Prefer `type` unions for closed sets (`'sample' | 'excel' | 'api'`).
+
+## React / Next.js
+
+- Any component using hooks, Plotly, the store, or browser APIs is a **Client Component**
+  (`'use client'`). Pages that only compose may still be client when they read the store.
+- Charts and Plotly are **never** in Server Components (SSR-unsafe — see [[charting-standards.domain]]).
+- Keep render pure: no `set`/fetch in render bodies; mutations go through store actions
+  (see [[state-management.domain]]).
+- Memoise large derived datasets (`useMemo`) before passing to a chart so the wrapper's
+  `JSON.stringify` diff stays cheap.
+
+## Naming & layout
+
+- Generic charts: PascalCase noun (`Heatmap`, `BubbleChart`). Adapters: domain concept
+  (`CompoundScatterPlot`). Routes: kebab-case folder (`dose-response/`).
+- One component per file; co-locate a route's page in `app/<route>/page.tsx`.
+- Import charts from the barrel: `import { Heatmap } from '@/components/charts/generic'`.
+
+## Styling
+
+- Tailwind utility classes + the shared `cn()` helper (`clsx`). Theme tokens (glass, gradient,
+  accent) come from `globals.css` / `tailwind.config.ts` — don't inline ad-hoc colours that
+  fight the chart theme.
+- Chart text/grid colour comes from `BASE_LAYOUT`, not per-page overrides.
+
+## Forbidden patterns
+
+- `plotly.js` imported anywhere except inside `PlotlyChart`'s `useEffect`.
+- Domain strings/types inside `components/charts/generic/`.
+- A component calling Zustand `set` directly (use a named action).
+- Fixed pixel chart heights in page cards (use `fillHeight`).
+
+## Related
+- [[charting-standards.domain]] · [[component-contracts.domain]] · [[state-management.domain]] ·
+  [[testing.domain]]

package/assets/docs/domainspecs/UIVisualization/comandrulemap.md

@@ -0,0 +1,130 @@
+# UI Visualization Domain — Command → Rule-File Map
+
+Per-AW-Spec-command list of the **UIVisualization domain** rule files in this folder.
+Technology standards already auto-load inside each command; the files below are the
+domain-specific ones to load **in addition** for a data-visualization front-end project.
+
+- All paths are workspace-relative and live in this folder: `docs/domainspecs/UIVisualization/`.
+- A skill reads this file and loads every path under the matching command heading.
+- `/aw-spec-select-domain UIVisualization` selects this folder as active.
+
+---
+
+## ⚠️ Chart-selection rule (applies to every command below)
+
+The `chart-*.md` files are **conditional**. Load the **core** rule files unconditionally; load a
+`chart-<name>.md` **only if that chart is in the developer's selection** (see
+[[domain-requirements]] → *Chart Selection*).
+
+- If the requirement says **"all plots" / "all charts" / "all"** → load **all 10** `chart-*` files.
+- If it names a subset → load only those `chart-*` files (match via the selection-token table in
+  [[domain-requirements]]).
+- If selection is **unspecified** → `/aw-spec-specify` / `/aw-spec-clarify` MUST ask which charts
+  before planning; do not assume "all".
+
+The 10 chart files: `chart-heatmap.md` · `chart-bubble.md` · `chart-scurve.md` ·
+`chart-survival.md` · `chart-volcano.md` · `chart-dimred.md` · `chart-parallel.md` ·
+`chart-violin.md` · `chart-network.md` · `chart-trellis.md`.
+
+---
+
+## /aw-spec-constitution
+- docs/domainspecs/UIVisualization/domain-requirements.md
+
+## /aw-spec-specify
+- docs/domainspecs/UIVisualization/domain-requirements.md
+- docs/domainspecs/UIVisualization/ui-viz-terms.md
+- docs/domainspecs/UIVisualization/component-contracts.domain.md
+- docs/domainspecs/UIVisualization/data-source.domain.md
+- (+ selected) docs/domainspecs/UIVisualization/chart-<name>.md   ← per selection, or ask
+
+## /aw-spec-clarify
+- docs/domainspecs/UIVisualization/domain-requirements.md
+- docs/domainspecs/UIVisualization/ui-viz-terms.md
+- docs/domainspecs/UIVisualization/component-contracts.domain.md
+- (resolve the chart selection here if not yet specified)
+
+## /aw-spec-plan
+- docs/domainspecs/UIVisualization/folder-structure.domain.md
+- docs/domainspecs/UIVisualization/clean-architecture.domain.md
+- docs/domainspecs/UIVisualization/state-management.domain.md
+- docs/domainspecs/UIVisualization/data-source.domain.md
+- docs/domainspecs/UIVisualization/charting-standards.domain.md
+- docs/domainspecs/UIVisualization/component-contracts.domain.md
+- docs/domainspecs/UIVisualization/coding-standards.domain.md
+- docs/domainspecs/UIVisualization/testing.domain.md
+- (+ selected) docs/domainspecs/UIVisualization/chart-<name>.md   ← one per selected chart
+
+## /aw-spec-tasks
+- docs/domainspecs/UIVisualization/folder-structure.domain.md
+- docs/domainspecs/UIVisualization/clean-architecture.domain.md
+- docs/domainspecs/UIVisualization/component-contracts.domain.md
+- docs/domainspecs/UIVisualization/charting-standards.domain.md
+- docs/domainspecs/UIVisualization/state-management.domain.md
+- docs/domainspecs/UIVisualization/data-source.domain.md
+- docs/domainspecs/UIVisualization/coding-standards.domain.md
+- (+ selected) docs/domainspecs/UIVisualization/chart-<name>.md
+
+## /aw-spec-analyze
+- docs/domainspecs/UIVisualization/clean-architecture.domain.md
+- docs/domainspecs/UIVisualization/component-contracts.domain.md
+- docs/domainspecs/UIVisualization/charting-standards.domain.md
+- docs/domainspecs/UIVisualization/coding-standards.domain.md
+- (+ selected) docs/domainspecs/UIVisualization/chart-<name>.md
+
+## /aw-spec-implement
+- docs/domainspecs/UIVisualization/folder-structure.domain.md
+- docs/domainspecs/UIVisualization/clean-architecture.domain.md
+- docs/domainspecs/UIVisualization/state-management.domain.md
+- docs/domainspecs/UIVisualization/data-source.domain.md
+- docs/domainspecs/UIVisualization/charting-standards.domain.md
+- docs/domainspecs/UIVisualization/component-contracts.domain.md
+- docs/domainspecs/UIVisualization/coding-standards.domain.md
+- docs/domainspecs/UIVisualization/testing.domain.md
+- (+ selected) docs/domainspecs/UIVisualization/chart-<name>.md   ← one per selected chart
+
+## /aw-spec-fast-implement
+
+> Fast path collapsing plan + tasks + analyze + implement into one pass. Deduplicated union of
+> those headings. Load **once** for the whole pass — do not reload per phase.
+
+- docs/domainspecs/UIVisualization/folder-structure.domain.md
+- docs/domainspecs/UIVisualization/clean-architecture.domain.md
+- docs/domainspecs/UIVisualization/state-management.domain.md
+- docs/domainspecs/UIVisualization/data-source.domain.md
+- docs/domainspecs/UIVisualization/charting-standards.domain.md
+- docs/domainspecs/UIVisualization/component-contracts.domain.md
+- docs/domainspecs/UIVisualization/coding-standards.domain.md
+- docs/domainspecs/UIVisualization/testing.domain.md
+- (+ selected) docs/domainspecs/UIVisualization/chart-<name>.md
+
+## /aw-spec-minimal-implementation
+
+> Single-step set — the per-domain knob. Loads the core charting rules + the selected chart files
+> to implement in one pass. For an audited build use `## /aw-spec-fast-implement`.
+
+- docs/domainspecs/UIVisualization/domain-requirements.md
+- docs/domainspecs/UIVisualization/folder-structure.domain.md
+- docs/domainspecs/UIVisualization/clean-architecture.domain.md
+- docs/domainspecs/UIVisualization/charting-standards.domain.md
+- docs/domainspecs/UIVisualization/component-contracts.domain.md
+- docs/domainspecs/UIVisualization/state-management.domain.md
+- (+ selected) docs/domainspecs/UIVisualization/chart-<name>.md
+
+---
+
+## Quick reference (command → core file count, excluding per-chart)
+
+| Command | Core domain rule files | + per selected chart |
+|---|---|---|
+| /aw-spec-constitution | 1 | — |
+| /aw-spec-specify | 4 | 1 each |
+| /aw-spec-clarify | 3 | resolve selection |
+| /aw-spec-plan | 8 | 1 each |
+| /aw-spec-tasks | 7 | 1 each |
+| /aw-spec-analyze | 4 | 1 each |
+| /aw-spec-implement | 8 | 1 each |
+| /aw-spec-fast-implement | 8 | 1 each |
+| /aw-spec-minimal-implementation | 6 | 1 each |
+
+> "all plots" = +10 chart files. A 3-chart project = +3.