PyAutoLabs · Jammy2211 · Aug 28, 2026 · Aug 28, 2026 · Aug 28, 2026 · Aug 28, 2026
diff --git a/.github/workflows/dashboard_refresh.yml b/.github/workflows/dashboard_refresh.yml
@@ -36,6 +36,7 @@ on:
       - "planned.md"
       - "condemned.md"
       - "bundles.md"
+      - "themes.md"
       - "dashboard.md"
       - "dashboard.html"
   pull_request:
@@ -47,6 +48,7 @@ on:
       - "planned.md"
       - "condemned.md"
       - "bundles.md"
+      - "themes.md"
       - "dashboard.md"
       - "dashboard.html"
   workflow_dispatch:

diff --git a/REFERENCE.md b/REFERENCE.md
@@ -297,6 +297,9 @@ Free-form markdown. Strong conventions:
   Repos:
   - PyAutoLens
   - autolens_workspace
+  Themes:                   # optional; vocabulary in themes.md, primary first
+  - mge
+  - jax-gradient
   Difficulty: medium        # small | medium | large | too-large
   Autonomy: supervised      # safe | supervised | human-required
   Priority: normal          # low | normal | high
@@ -353,6 +356,31 @@ Free-form markdown. Strong conventions:
   since it is already spoken for. A slug naming no registry entry still
   groups, loudly (⚠️ on the page), so a typo is visible rather than silent.
 
+  **Declaring what the work is ABOUT — `Themes:`.** Optional, and the same
+  list shape as `Repos:` — a bare `Themes:` line, then one `- keyword` bullet
+  each. `Target:` says where the code lives; `Themes:` says what the work is
+  about, which is usually the more useful grouping and is routinely cross-repo:
+
+  ```markdown
+  Themes:
+  - mge
+  - jax-gradient
+  ```
+
+  The **first** keyword is the primary theme and is what the dashboard's
+  auto-bundler groups on, so a card reads "three things about MGE" rather than
+  "three things that live in autoarray"; the remaining keywords are affinity,
+  deciding which prompts pack together inside that group. One to three keywords
+  is the intended shape, primary first. A prompt with no `Themes:` still
+  bundles — the bundler falls back to `Target:` — so nothing waits on a theme.
+
+  The vocabulary is [`themes.md`](themes.md), a plain markdown list a human
+  edits directly (PyAutoBrain reads that file rather than holding its own
+  copy). A keyword that is not in it still groups, loudly: ⚠️ on the bundle
+  card and a count in the dashboard's Hygiene section, so the list never rots
+  into free-text tags. The **Intake (Conception) Agent** assigns `Themes:` when
+  it formalises a prompt.
+
   The optional `Difficulty:` / `Autonomy:` / `Priority:` keys let both people and
   PyAutoBrain see, at a glance, how hard a task is, whether an agent can safely
   take it on, and how urgent it is. What each `Autonomy:` level *does* at every
@@ -511,7 +539,7 @@ no prompt.
 | Ledger — merged automatically | Code — always a human |
 |---|---|
 | `draft/**`, `active/**`, `complete/**` | `scripts/`, `tests/`, `.github/`, `skills/`, `policy/`, `docs/` |
-| `active.md`, `planned.md`, `parked.md`, `condemned.md`, `epics.md`, `bundles.md`, `ideas.md`, `autonomy_log.md` | `repos.yaml`, `README.md`, `AGENTS.md`, `REFERENCE.md`, `ROUTING.md`, … |
+| `active.md`, `planned.md`, `parked.md`, `condemned.md`, `epics.md`, `bundles.md`, `ideas.md`, `autonomy_log.md` | `repos.yaml`, `themes.md`, `README.md`, `AGENTS.md`, `REFERENCE.md`, `ROUTING.md`, … |
 | `dashboard.md`, `dashboard.html` | anything unclassified — a new root file, a new top-level folder |
 
 Two exceptions inside the ledger dirs: a **dot-path** anywhere, and a file

diff --git a/dashboard.html b/dashboard.html
diff --git a/dashboard.md b/dashboard.md
diff --git a/draft/bug/autoarray/PROBE_adapt_double_square_coefficient.md b/draft/bug/autoarray/PROBE_adapt_double_square_coefficient.md
@@ -4,6 +4,8 @@ Type: bug
 Target: autoarray
 Repos:
 - @PyAutoArray
+Themes:
+- pixelization
 Difficulty: medium
 Autonomy: supervised
 Priority: normal

diff --git a/draft/bug/autoarray/reconstruction_noise_map_solver_mismatch.md b/draft/bug/autoarray/reconstruction_noise_map_solver_mismatch.md
@@ -4,6 +4,8 @@ Type: bug
 Target: autoarray
 Repos:
 - @PyAutoArray
+Themes:
+- pixelization
 Difficulty: medium
 Autonomy: human-required
 Priority: low

diff --git a/draft/bug/autofit/ep_scale_collapse_basin_cure_or_caveat.md b/draft/bug/autofit/ep_scale_collapse_basin_cure_or_caveat.md
@@ -4,6 +4,8 @@ Type: bug
 Target: PyAutoFit
 Repos:
 - PyAutoFit
+Themes:
+- graphical-ep
 Difficulty: too-large
 Autonomy: human-required
 Priority: high

diff --git a/draft/bug/autogalaxy/lenscalc_numpy_hessian_step_is_too_coarse.md b/draft/bug/autogalaxy/lenscalc_numpy_hessian_step_is_too_coarse.md
@@ -5,6 +5,9 @@ Target: PyAutoGalaxy
 Repos:
 - PyAutoGalaxy
 - PyAutoLens
+Themes:
+- point-source
+- jax-gradient
 Difficulty: large
 Autonomy: supervised
 Priority: high

diff --git a/draft/bug/autolens/jit_cache_not_hit_modeling_visualization.md b/draft/bug/autolens/jit_cache_not_hit_modeling_visualization.md
@@ -5,6 +5,10 @@ Target: autolens
 Repos:
 - PyAutoLens
 - autolens_workspace_test
+Themes:
+- jax-compile
+- visualization
+- pixelization
 Difficulty: medium
 Autonomy: supervised
 Priority: normal

diff --git a/draft/bug/autolens/point_solver_error_bisect_health.md b/draft/bug/autolens/point_solver_error_bisect_health.md
@@ -7,6 +7,8 @@ Repos:
 - PyAutoLens
 - autolens_profiling
 - PyAutoNerves
+Themes:
+- point-source
 Difficulty: too-large
 Autonomy: supervised
 Priority: high

diff --git a/draft/bug/autolens_workspace_test/gradient_eager_jit_divergence_py313.md b/draft/bug/autolens_workspace_test/gradient_eager_jit_divergence_py313.md
@@ -5,6 +5,10 @@ Target: autolens_workspace_test
 Repos:
 - @autolens_workspace_test
 - @PyAutoArray
+Themes:
+- jax-gradient
+- interferometer
+- pixelization
 Difficulty: medium
 Autonomy: supervised
 Priority: normal

diff --git a/draft/bug/ci/jax_vmap_jit_compile_stall.md b/draft/bug/ci/jax_vmap_jit_compile_stall.md
@@ -6,6 +6,9 @@ Repos:
 - @autogalaxy_workspace_test
 - @autolens_workspace_test
 - @PyAutoFit
+Themes:
+- jax-compile
+- ci-smoke
 Difficulty: too-large
 Autonomy: supervised
 Priority: high

diff --git a/draft/bug/health_fixes/jax_runtime_and_parity.md b/draft/bug/health_fixes/jax_runtime_and_parity.md
@@ -2,6 +2,9 @@
 
 Type: bug
 Target: health_fixes
+Themes:
+- release
+- ci-smoke
 Difficulty: too-large
 Autonomy: supervised
 Priority: high

diff --git a/draft/bug/health_fixes/jit_visualization_outputs.md b/draft/bug/health_fixes/jit_visualization_outputs.md
@@ -2,6 +2,10 @@
 
 Type: bug
 Target: health_fixes
+Themes:
+- visualization
+- jax-compile
+- release
 Difficulty: too-large
 Autonomy: supervised
 Priority: high

diff --git a/draft/bug/health_fixes/release_timeout_policy.md b/draft/bug/health_fixes/release_timeout_policy.md
@@ -2,6 +2,9 @@
 
 Type: bug
 Target: health_fixes
+Themes:
+- release
+- ci-smoke
 Difficulty: too-large
 Autonomy: supervised
 Priority: normal

diff --git a/draft/bug/health_fixes/samples_parameter_paths.md b/draft/bug/health_fixes/samples_parameter_paths.md
@@ -2,6 +2,9 @@
 
 Type: bug
 Target: health_fixes
+Themes:
+- release
+- samplers
 Difficulty: too-large
 Autonomy: supervised
 Priority: high

diff --git a/draft/bug/priors/14_replace_transform_stack_with_bijectors.md b/draft/bug/priors/14_replace_transform_stack_with_bijectors.md
@@ -2,6 +2,8 @@
 
 Type: bug
 Target: priors
+Themes:
+- graphical-ep
 Difficulty: too-large
 Autonomy: supervised
 Priority: normal

diff --git a/draft/bug/priors/15_transformed_message_logpdf_jacobian.md b/draft/bug/priors/15_transformed_message_logpdf_jacobian.md
@@ -2,6 +2,8 @@
 
 Type: bug
 Target: priors
+Themes:
+- graphical-ep
 Difficulty: medium
 Autonomy: supervised
 Priority: normal

diff --git a/draft/bug/priors/z_features.md b/draft/bug/priors/z_features.md
@@ -2,6 +2,8 @@
 
 Type: bug
 Target: priors
+Themes:
+- graphical-ep
 Difficulty: too-large
 Autonomy: supervised
 Priority: normal

diff --git a/draft/bug/pyautolens/point_source_json_datasets_record_no_regime.md b/draft/bug/pyautolens/point_source_json_datasets_record_no_regime.md
@@ -6,6 +6,9 @@ Repos:
 - @PyAutoLens
 - @PyAutoArray
 - @PyAutoNerves
+Themes:
+- point-source
+- ci-smoke
 Difficulty: medium
 Autonomy: supervised
 Priority: low

diff --git a/draft/bug/workspaces/gradient_pixelization_pin_residual_drift.md b/draft/bug/workspaces/gradient_pixelization_pin_residual_drift.md
@@ -5,6 +5,10 @@ Target: workspaces
 Repos:
 - @autolens_workspace_developer
 - @PyAutoArray
+Themes:
+- pixelization
+- profiling
+- jax-gradient
 Difficulty: medium
 Autonomy: supervised
 Priority: normal

diff --git a/draft/docs/autocti/api_rst_rewrite.md b/draft/docs/autocti/api_rst_rewrite.md
@@ -4,6 +4,9 @@ Type: docs
 Target: PyAutoCTI
 Repos:
 - PyAutoCTI
+Themes:
+- docs-hub
+- cti
 Difficulty: medium
 Autonomy: supervised
 Priority: normal

diff --git a/draft/docs/autolens/multi_galaxy_package.md b/draft/docs/autolens/multi_galaxy_package.md
@@ -5,6 +5,9 @@ Target: autolens_workspace
 Repos:
 - autolens_workspace
 - autolens_workspace_test
+Themes:
+- notebooks
+- cluster
 Difficulty: large
 Autonomy: supervised
 Priority: high

diff --git a/draft/docs/autolens/split_lensing_regimes.md b/draft/docs/autolens/split_lensing_regimes.md
@@ -10,6 +10,10 @@ Repos:
 - autogalaxy_workspace
 - autogalaxy_workspace_test
 - autolens_assistant
+Themes:
+- cluster
+- docs-hub
+- notebooks
 Difficulty: too-large
 Autonomy: supervised
 Priority: high

diff --git a/draft/docs/autolens_workspace/markdown_regeneration_sigma_min.md b/draft/docs/autolens_workspace/markdown_regeneration_sigma_min.md
@@ -4,6 +4,10 @@ Type: docs
 Target: autolens_workspace
 Repos:
 - autolens_workspace
+Themes:
+- mge
+- notebooks
+- docs-hub
 Difficulty: small
 Autonomy: supervised
 Priority: normal

diff --git a/draft/docs/howtolens/ch4_mask_overlay_never_drawn.md b/draft/docs/howtolens/ch4_mask_overlay_never_drawn.md
@@ -4,6 +4,9 @@ Type: docs
 Target: howtolens
 Repos:
 - HowToLens
+Themes:
+- notebooks
+- visualization
 Difficulty: small
 Autonomy: supervised
 Priority: low

diff --git a/draft/docs/howtolens/cluster_pixelized_source.md b/draft/docs/howtolens/cluster_pixelized_source.md
@@ -6,6 +6,10 @@ Repos:
 - PyAutoLens
 - autolens_workspace
 - howtolens
+Themes:
+- cluster
+- pixelization
+- notebooks
 Difficulty: large
 Autonomy: supervised
 Priority: normal

diff --git a/draft/docs/pyautobrain/rtd_organism_currency.md b/draft/docs/pyautobrain/rtd_organism_currency.md
@@ -4,6 +4,9 @@ Type: docs
 Target: pyautobrain
 Repos:
 - PyAutoBrain
+Themes:
+- docs-hub
+- mind-workflow
 Difficulty: small
 Autonomy: supervised
 Priority: normal

diff --git a/draft/docs/workspaces/assistants_regime_extension.md b/draft/docs/workspaces/assistants_regime_extension.md
@@ -4,6 +4,9 @@ Type: docs
 Target: autolens_assistant
 Repos:
 - autolens_assistant
+Themes:
+- assistants
+- cluster
 Difficulty: medium
 Autonomy: supervised
 Priority: low

diff --git a/draft/docs/workspaces/cluster_regime_narrative.md b/draft/docs/workspaces/cluster_regime_narrative.md
@@ -5,6 +5,10 @@ Target: autolens_workspace
 Repos:
 - autolens_workspace
 - autolens_workspace_test
+Themes:
+- cluster
+- point-source
+- notebooks
 Difficulty: medium
 Autonomy: supervised
 Priority: high

diff --git a/draft/docs/workspaces/preloads_advanced_workspace_guide.md b/draft/docs/workspaces/preloads_advanced_workspace_guide.md
@@ -2,6 +2,9 @@
 
 Type: docs
 Target: workspaces
+Themes:
+- notebooks
+- interferometer
 Difficulty: too-large
 Autonomy: supervised
 Priority: high

diff --git a/draft/docs/workspaces/propagate_shear_galaxy_idiom_to_group_cluster.md b/draft/docs/workspaces/propagate_shear_galaxy_idiom_to_group_cluster.md
@@ -4,6 +4,9 @@ Type: docs
 Target: autolens_workspace
 Repos:
 - autolens_workspace
+Themes:
+- cluster
+- notebooks
 Difficulty: small
 Autonomy: supervised
 Priority: normal

diff --git a/draft/docs/workspaces/rectangular_mesh_enzi_citation_examples.md b/draft/docs/workspaces/rectangular_mesh_enzi_citation_examples.md
@@ -5,6 +5,10 @@ Target: workspaces
 Repos:
 - autolens_workspace
 - autogalaxy_workspace
+Themes:
+- pixelization
+- notebooks
+- docs-hub
 Difficulty: small
 Autonomy: supervised
 Priority: normal

diff --git a/draft/feature/autoarray/arcsecond_to_decimal.md b/draft/feature/autoarray/arcsecond_to_decimal.md
@@ -2,6 +2,8 @@
 
 Type: feature
 Target: PyAutoArray
+Themes:
+- visualization
 Difficulty: large
 Autonomy: supervised
 Priority: normal

diff --git a/draft/feature/autoarray/multiwavelength_inversion.md b/draft/feature/autoarray/multiwavelength_inversion.md
@@ -2,6 +2,9 @@
 
 Type: feature
 Target: PyAutoArray
+Themes:
+- multi-band
+- pixelization
 Difficulty: medium
 Autonomy: supervised
 Priority: normal

diff --git a/draft/feature/autoarray/numba_cpu_likelihood_kernel_cdf_fast_path.md b/draft/feature/autoarray/numba_cpu_likelihood_kernel_cdf_fast_path.md
@@ -17,6 +17,9 @@ Phase: 2
 Target: autoarray
 Repos:
 - @PyAutoArray
+Themes:
+- numba-cpu
+- pixelization
 Difficulty: large
 Autonomy: supervised
 Priority: high

diff --git a/draft/feature/autoarray/rectangular_bilinear_rtu_mesh_split.md b/draft/feature/autoarray/rectangular_bilinear_rtu_mesh_split.md
@@ -7,6 +7,9 @@ Repos:
 - @autolens_workspace
 - @autogalaxy_workspace
 - @autolens_workspace_test
+Themes:
+- pixelization
+- numba-cpu
 Difficulty: medium
 Autonomy: supervised
 Priority: high