# Kalika Domain Guide

This guide answers "which Kalika tool do I use for X?" across the math, physics,
data, notebook, and research-agent libraries. Use it with the
[generated API reference](../api-reference/README.md) for symbol-level details
and the [tutorial notebooks](../tutorial-notebooks/README.md) for runnable
onboarding workflows.

The companion [`domain-map.json`](./domain-map.json) is the machine-checkable
source for package pointers in this guide. Validate it with:

```bash
pnpm kalika:domain-guide:check
```

For implementation sequencing, use the
[Kalika build-order graph](../build-order.md). It documents phase dependencies,
the critical path, and the packages that are intentionally buildable before
their historical parent phases.

## Which Tool Do I Use?

| Need                                                                    | Start With                      | Then Add                                                      |
| ----------------------------------------------------------------------- | ------------------------------- | ------------------------------------------------------------- |
| Run local CAS, matrix, tensor, or numeric jobs                          | `@kalika/sdk`                   | `@kalika/core` for expression trees and derivation provenance |
| Simplify, rewrite, serialize, or prove expression transformations       | `@kalika/core`                  | `@kalika/formal-verification` for Lean/SMT/ATP checks         |
| Exact matrix algebra, finite groups, and spectral invariants            | `@kalika/algebra`               | `@kalika/analysis` for numerical/asymptotic follow-up         |
| Fourier, complex analysis, Hilbert-space, and asymptotic calculations   | `@kalika/analysis`              | `@kalika/renderer` for plots and visual diagnostics           |
| Primes, factorization, elliptic curves, modular forms, and L-functions  | `@kalika/number-theory`         | `@kalika/database` for LMFDB/OEIS-backed data                 |
| CW/simplicial complexes, homology, homotopy, knots, and persistence     | `@kalika/topology`              | `@kalika/renderer` for diagrams                               |
| Lie algebras, Weyl groups, Casimirs, and gauge anomaly checks           | `@kalika/lie-theory`            | `@kalika/quantum-field-theory` for gauge models               |
| Schrodinger solvers, spectra, scattering, and spin/angular momentum     | `@kalika/quantum-mechanics`     | `@kalika/analysis` for Hilbert-space utilities                |
| Entanglement, density matrices, channels, and open-system evolution     | `@kalika/information-theory`    | `@kalika/quantum-mechanics` for Hamiltonians                  |
| MPS/DMRG/PEPS/MERA and gauge-invariant tensor blocks                    | `@kalika/tensor-networks`       | `@kalika/condensed-matter` for model Hamiltonians             |
| Gauge models, Feynman rules, loop integrals, RGE, and QFT benchmarks    | `@kalika/quantum-field-theory`  | `@kalika/renderer` for Feynman diagrams                       |
| PDG data, BSM spectra, flavor, dark matter, and precision observables   | `@kalika/hep-phenomenology`     | `@kalika/database` for HEPData import                         |
| Lattice gauge actions, HMC, and lattice measurements                    | `@kalika/lattice`               | `@kalika/numerical` for validation harnesses                  |
| ADM/BSSN, curvature tensors, exact GR solutions, and geodesics          | `@kalika/general-relativity`    | `@kalika/renderer` for Penrose/spacetime diagrams             |
| Cosmological background, inflation, CMB, dark energy, and structure     | `@kalika/cosmology`             | `@kalika/general-relativity` for relativistic corrections     |
| Waveforms, detector response, compact binaries, and SXS comparisons     | `@kalika/gravitational-waves`   | `@kalika/database` for SXS catalog import                     |
| Calabi-Yau, dualities, CFT, string amplitudes, and Virasoro algebra     | `@kalika/string-theory`         | `@kalika/number-theory` for modular data                      |
| LQG, spin networks, CDT, and asymptotic safety                          | `@kalika/quantum-gravity`       | `@kalika/topology` for combinatorial structures               |
| Ensembles, partition functions, exact lattice models, and RG            | `@kalika/statistical-mechanics` | `@kalika/condensed-matter` for material models                |
| Tight-binding, Hubbard, BCS, quantum Hall, and topological bands        | `@kalika/condensed-matter`      | `@kalika/tensor-networks` for many-body solvers               |
| Distributions, Markov chains, stochastic processes, random matrices     | `@kalika/probability`           | `@kalika/numerical` for sampling checks                       |
| Notebook documents, cell execution, Jupyter interop, and exports        | `@kalika/notebooks`             | `@kalika/typesetting` for paper output                        |
| Citations, DOI metadata, and citation graphs                            | `@kalika/citations`             | `@kalika/knowledge-graph` for concept links                   |
| Knowledge graphs, theorem dependencies, semantic concept linking        | `@kalika/knowledge-graph`       | `@kalika/research-agents` for literature workflows            |
| Plots, diagrams, tensor networks, circuits, lattices, and manifolds     | `@kalika/renderer`              | Domain library outputs as input data                          |
| Caches, job scheduling, checkpoints, distributed compute, cost tracking | `@kalika/hpc-orchestrator`      | `@kalika/database` for persisted records                      |
| Literature-informed computation, conjectures, proof search, and agents  | `@kalika/research-agents`       | `@kalika/formal-verification` for proof closure               |
| Equation discovery, AI-Feynman benchmarks, and symbolic regression      | `@kalika/symbolic-regression`   | `@kalika/research-agents` for conjecture loops                |
| PINNs, DeepONet, Fourier neural operators, AD, ONNX, and WGPU plans     | `@kalika/neural-physics`        | `@kalika/numerical` for validation data                       |

## Foundation, CAS, SDK, Units, and Typesetting

Use this layer when the task is about expression representation, local compute,
serialization, units, provenance, or publication output.

| Package                    | Use For                                                                                                                         | Start Here                                                                                                    |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| `@kalika/core`             | Expression ASTs, assumptions, serialization, rewrite rules, e-graphs, derivation chains, and provenance-aware results.          | `ExprInterner`, `createRewriteRule`, `parseExprPattern`, `runEqualitySaturation`, `serializeExprToLatex`      |
| `@kalika/sdk`              | Server-free symbolic operations, numeric evaluation, matrix/tensor calls, physics constants, and batch jobs.                    | `createKalikaSdk`, `KalikaSdk`, `evaluateNumericExpression`                                                   |
| `@kalika/utils`            | Dimensional analysis, physical constants, unit conversion, and dimension-safe quantities.                                       | `PHYSICAL_CONSTANTS`, `createPhysicalQuantity`, `convertPhysicalQuantity`                                     |
| `@kalika/numerical`        | Arbitrary precision arithmetic, Mellin-Barnes integration, Monte Carlo validation, ODE/PDE validation, and benchmark harnesses. | `evaluateSpecialFunction`, `meijerG`, `createMonteCarloIntegrationValidationSuite`, `createOdeBenchmarkSuite` |
| `@kalika/numerical-engine` | Rust-backed low-level numerical kernels consumed by higher-level Kalika wrappers.                                               | Use through TypeScript wrappers unless you are extending native kernels.                                      |
| `@kalika/typesetting`      | LaTeX, equation, derivation, and paper rendering for notebook-to-publication workflows.                                         | `typesetDerivation`, `draftPaperFromNotebook`, `renderLatexEquation`                                          |

Primary workflows:

- CAS cell: `@kalika/sdk` for execution, `@kalika/core` for expression and
  derivation representation, `@kalika/formal-verification` for proof status.
- Unit-aware physics result: `@kalika/utils` for quantity construction and
  conversion, then `@kalika/typesetting` for report output.
- Publication export: `@kalika/notebooks` selects cells, `@kalika/typesetting`
  turns derivations/equations into LaTeX.

## Algebra, Analysis, Combinatorics, and Category Theory

Use this group for exact algebraic manipulation, analytic transforms, series and
asymptotic analysis, discrete enumeration, and structural category-theory
models.

| Package                   | Use For                                                                                                                           | Start Here                                                                                                                    |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| `@kalika/algebra`         | Exact rational matrices, decompositions, finite groups, Galois computations, modules, rings, and spectral invariants.             | `RationalField`, `rationalMatrix`, `determinant`, `reducedRowEchelonForm`, `characteristicPolynomial`, `createSymmetricGroup` |
| `@kalika/analysis`        | Fourier methods, complex analysis, Hilbert spaces, integral transforms, operator theory, series tests, and asymptotics.           | `complex`, `fft`, `inverseFft`, `ratioTest`, `taylorAsymptoticExpansion`, `createHilbertSpace`                                |
| `@kalika/combinatorics`   | Binomial coefficients, integer partitions, Catalan numbers, graph algorithms, species, and tableaux.                              | `binomial`, `integerPartitions`, `catalanNumber`, `createGraph`                                                               |
| `@kalika/category-theory` | Categories, functors, natural transformations, universal constructions, abelian categories, monoidal categories, and topos tools. | `createCategory`, `object`, `morphism`, `productObject`, `yonedaLemma`, `createTopos`                                         |

Decision points:

- Use `@kalika/algebra` when the answer must stay exact over rationals, rings,
  groups, or modules.
- Use `@kalika/analysis` when the object is a function, series, contour,
  Hilbert-space vector, operator, transform, or asymptotic expansion.
- Use `@kalika/combinatorics` before symbolic regression when you need sequence
  data, enumeration, or graph structure.
- Use `@kalika/category-theory` when universal properties, functoriality, or
  internal logic are the real object being modeled.

## Number Theory, Topology, and Lie Theory

Use this group for arithmetic structures, topological invariants, and Lie
algebra data that feeds gauge theory, geometry, and representation workflows.

| Package                 | Use For                                                                                                                       | Start Here                                                                                                       |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| `@kalika/number-theory` | Primality, factorization, arithmetic functions, elliptic curves, modular forms, L-functions, number fields, and local fields. | `isPrime`, `factorInteger`, `divisorSigma`, `shortWeierstrassCurve`, `ellipticEulerFactor`, `functionalEquation` |
| `@kalika/topology`      | Simplicial and CW complexes, cellular homology, cohomology, homotopy, knot invariants, and persistent homology.               | `sphereCWComplex`, `cellularHomology`, `fundamentalGroup`, `vietorisRipsFiltration`, `persistenceDiagram`        |
| `@kalika/lie-theory`    | Lie algebra classification, root systems, Weyl groups, representations, Casimirs, and gauge anomaly checks.                   | `classifyLieAlgebra`, `cartanMatrix`, `weylGroup`, `quadraticCasimir`, `gaugeAnomalyCheck`                       |

Common combinations:

- Elliptic curve study: `@kalika/number-theory` for invariants and L-functions,
  `@kalika/database` for LMFDB import, `@kalika/typesetting` for formulas.
- Persistent topology: `@kalika/topology` for filtrations and diagrams,
  `@kalika/renderer` for visualization.
- Gauge representation work: `@kalika/lie-theory` for representation and anomaly
  checks, `@kalika/quantum-field-theory` for model assembly.

## Quantum Mechanics, Quantum Information, and Tensor Networks

Use this group for finite and continuum quantum systems, state diagnostics,
open-system evolution, and many-body tensor-network solvers.

| Package                      | Use For                                                                                                                                   | Start Here                                                                                                                  |
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| `@kalika/quantum-mechanics`  | Stationary and time-dependent Schrodinger solvers, exact potentials, angular momentum, spin algebra, scattering, and perturbation theory. | `harmonicOscillatorSolution`, `hydrogenAtomSolution`, `crankNicolsonStep`, `propagateSplitOperatorFft`, `coulombScattering` |
| `@kalika/information-theory` | Quantum information, density matrices, entanglement diagnostics, channels, and Lindblad evolution.                                        | `basisState`, `densityMatrixFromState`, `vonNeumannEntropy`, `reducedDensityMatrix`, `lindbladEulerStep`                    |
| `@kalika/tensor-networks`    | Tensor networks, MPS/MPO, DMRG, PEPS, MERA, XXZ benchmarks, and gauge-invariant tensor constructions.                                     | `productMps`, `spinHalfXxzHamiltonian`, `dmrgGroundState`, `optimizeFinitePepsEnergy`, `gaugeInvariantTensor`               |

Recommended flow:

1. Build the Hamiltonian or exact potential with `@kalika/quantum-mechanics`.
2. Use `@kalika/analysis` or `@kalika/information-theory` for norms, entropies,
   channels, and diagnostics.
3. Move to `@kalika/tensor-networks` when Hilbert-space dimension is the
   limiting factor.

## Quantum Field Theory, HEP Phenomenology, and Lattice Gauge Theory

Use this group for gauge models, Feynman rules, loop integral reduction,
collider/phenomenology workflows, and lattice gauge computations.

| Package                        | Use For                                                                                                                                                   | Start Here                                                                                                     |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| `@kalika/quantum-field-theory` | Gauge theory declarations, field definitions, Feynman rules, Passarino-Veltman integrals, IBP reduction, RGE running, cross sections, and QFT benchmarks. | `createGaugeTheoryModel`, `defineDiracSpinor`, `u1Group`, `suGroup`, `scalarB0`, `createQftBenchmarkSuite`     |
| `@kalika/hep-phenomenology`    | PDG particle data, MSSM/BSM spectrum generation, flavor physics, dark matter relic density, and electroweak precision observables.                        | `createPdgDatabase`, `generateMssmSpectrum`, `flavorObservables`, `thermalRelicDensity`, `predictElectroweak`  |
| `@kalika/lattice`              | Hypercubic lattices, gauge fields, Wilson plaquette actions, HMC trajectories, fermions, and lattice measurements.                                        | `createHypercubicLattice`, `coldGaugeField`, `wilsonPlaquetteAction`, `hmcTrajectory`, `rectangularWilsonLoop` |

Workflow choices:

- Analytic perturbation theory: start in `@kalika/quantum-field-theory`, then
  render diagrams with `@kalika/renderer`.
- Phenomenology pipeline: use `@kalika/quantum-field-theory` for model and
  amplitudes, `@kalika/hep-phenomenology` for spectra/constraints, and
  `@kalika/database` for HEPData/PDG-backed comparisons.
- Nonperturbative lattice study: use `@kalika/lattice`, then validate
  observables with `@kalika/numerical`.

## General Relativity, Cosmology, and Gravitational Waves

Use this group for curvature, exact spacetimes, numerical-relativity systems,
cosmological observables, and waveform/data-analysis workflows.

| Package                       | Use For                                                                                                                            | Start Here                                                                                                            |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| `@kalika/general-relativity`  | ADM and BSSN formalisms, curvature tensors, exact solutions, perturbations, geodesics, Penrose-Carter diagrams, and GR benchmarks. | `admSystem`, `bssnSystem`, `schwarzschildPenroseDiagram`, `createGrCurvatureBenchmarkSuite`, `integrateGeodesicRkf45` |
| `@kalika/cosmology`           | Friedmann evolution, inflation predictions, CMB power spectra, dark energy models, and structure formation.                        | `PLANCK_2018_COSMOLOGY`, `solveFriedmann`, `starobinskyPredictions`, `linearGrowthFactor`, `acousticAngularScale`     |
| `@kalika/gravitational-waves` | Compact-binary source modeling, waveform catalogs, detector response, data analysis, and numerical-relativity surrogate access.    | `compactBinaryChirpMass`, `lalSuiteWaveformCatalog`, `detectorPsd`, `matchedFilter`, `selectSxsSimulation`            |

Recommended flow:

- Exact solution: `@kalika/general-relativity` for metric/curvature/causal
  structure, `@kalika/renderer` for Penrose or spacetime diagrams.
- Cosmological observable: `@kalika/cosmology` for background and perturbation
  quantities, `@kalika/typesetting` for publication equations.
- Gravitational-wave event: `@kalika/gravitational-waves` for source and
  detector modeling, `@kalika/database` for SXS catalog comparisons.

## String Theory and Quantum Gravity

Use this group for compactification geometry, dualities, CFT/amplitude tools,
and quantum-gravity approaches.

| Package                   | Use For                                                                                                                                                        | Start Here                                                                                                           |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| `@kalika/string-theory`   | AdS/CFT data, Calabi-Yau geometry, mirror symmetry, flux compactifications, string dualities, spinor-helicity, Virasoro algebra, and color-kinematics duality. | `sl2z`, `transformAxioDilaton`, `electromagneticDualityRotation`, `virasoroBracket`, `gaugeAmplitudeFromCubicGraphs` |
| `@kalika/quantum-gravity` | Loop quantum gravity spectra, spin networks, causal dynamical triangulations, and asymptotic-safety fixed points.                                              | `areaSpectrum`, `SpinNetworkNode`, `validateSpinNetwork`, `findEinsteinHilbertFixedPoint`, `classifyCdtPhase`        |

Useful pairings:

- Compactification: `@kalika/string-theory` plus `@kalika/number-theory` for
  modular data and arithmetic checks.
- Spin-network study: `@kalika/quantum-gravity` plus `@kalika/topology` for
  combinatorial/topological structure.

## Statistical Mechanics, Condensed Matter, and Probability

Use this group for ensembles, phases, random systems, many-body models, critical
phenomena, and stochastic diagnostics.

| Package                         | Use For                                                                                                                                        | Start Here                                                                                                                                                          |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `@kalika/statistical-mechanics` | Canonical/grand-canonical ensembles, thermodynamic potentials, exact lattice results, mean-field theory, and renormalization group catalogues. | `canonicalPartitionFunction`, `grandCanonicalPartitionFunction`, `oneDimensionalIsingPartitionFunction`, `wilsonFisherBetaFunctions`, `renormalizationGroupCatalog` |
| `@kalika/condensed-matter`      | Tight-binding models, Hubbard models, BCS superconductivity, quantum Hall physics, and topological band invariants.                            | `squareLatticeModel`, `exactDiagonalizeHubbard`, `solveBcsGapEquation`, `hallConductance`, `chernNumber`                                                            |
| `@kalika/probability`           | Probability distributions, Markov chains, stochastic processes, and random-matrix ensembles.                                                   | `normalDistribution`, `createMarkovChain`, `brownianMotion`, `gaussianEnsemble`                                                                                     |

Selection guide:

- Use `@kalika/statistical-mechanics` for general ensembles and RG.
- Use `@kalika/condensed-matter` when the system is a material, lattice model,
  band structure, superconducting phase, or quantum Hall state.
- Use `@kalika/probability` for stochastic models, random matrices, and
  distribution-level checks around simulations.

## Data, Notebooks, Knowledge, Citations, Rendering, and HPC

Use this group for persistence, import/export, collaboration, visualization,
knowledge management, and large-compute orchestration.

| Package                    | Use For                                                                                                                                                   | Start Here                                                                                                                                     |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `@kalika/database`         | PostgreSQL schema, migrations, computation cache, vector search, and external data importers for LMFDB, HEPData, SXS, OEIS, KnotInfo, and Kreuzer-Skarke. | `kalikaSchema`, `computationCache`, `KalikaLmfdbImporter`, `KalikaHepDataImporter`, `OeisClient`                                               |
| `@kalika/notebooks`        | Notebook document model, serialization, cell execution, provenance, collaboration, Jupyter interop, sharing, reproducibility, and exports.                | `createNotebookDocument`, `serializeNotebookToJson`, `executeNotebookCell`, `createNotebookVersionState`, `generateNotebookDependencyLockfile` |
| `@kalika/renderer`         | Plots, vector fields, Feynman diagrams, Penrose diagrams, quantum circuits, tensor networks, lattice visualizations, and 3D manifolds.                    | `renderFeynmanDiagram`, `plotFunctions`, `renderPenroseCarterDiagram`, `renderTensorNetworkDiagram`, `renderLatticeVisualization`              |
| `@kalika/citations`        | Citation records, BibTeX/RIS/CSL import/export, DOI metadata resolution, and citation graph visualizations.                                               | `CitationManager`, `InMemoryCitationDatabase`, `importCitations`, `exportCitations`, `buildCitationGraph`                                      |
| `@kalika/knowledge-graph`  | Ontology, concept linking, theorem dependency graphs, persistence snapshots, and graph queries.                                                           | `createKnowledgeGraphSnapshot`, `createTheoremDependencyGraph`, `suggestConceptLinks`, `postgresConceptDescendantsQuery`                       |
| `@kalika/hpc-orchestrator` | Computation caches, distributed decomposition, job scheduling, checkpointing, resource monitoring, and remote submission scripts.                         | `ComputationCache`, `HpcJobScheduler`, `ResourceMonitor`, `decomposeDomain2D`, `renderRemoteSubmissionScript`                                  |

Architecture notes:

- Store durable records in `@kalika/database`; keep notebook document behavior
  in `@kalika/notebooks`.
- Use `@kalika/citations` for bibliographic records and
  `@kalika/knowledge-graph` for concepts, theorems, and semantic relationships.
- Use `@kalika/renderer` as the boundary from computed objects to visual
  artifacts.
- Use `@kalika/hpc-orchestrator` when a computation needs caching,
  checkpointing, scheduling, or remote execution.

## Research Agents, Symbolic Regression, Neural Physics, and Verification

Use this group for autonomous research workflows, theorem/proof workflows,
data-driven discovery, and neural scientific models.

| Package                       | Use For                                                                                                                                                         | Start Here                                                                                                                                         |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `@kalika/research-agents`     | Computation, literature, exploration, conjecture, proof, and orchestration agents with arXiv/INSPIRE/OEIS/OpenAlex/Semantic Scholar integration.                | `ResearchAgentBase`, `ComputationAgent`, `formulateConjectures`, `buildOeisGuidedConjectureSeeds`, `createConjectureGenerationBenchmarkSuite`      |
| `@kalika/symbolic-regression` | AI-Feynman benchmarks, genetic programming, transformer and LLM-guided symbolic regression, equation discovery, separability detection, and symmetry detection. | `createAiFeynmanBenchmarkSuite`, `fitSymbolicRegression`, `discoverSindyDynamics`, `detectSeparability`, `detectSymmetries`                        |
| `@kalika/neural-physics`      | DeepONet, Fourier neural operators, PINNs, separable PINNs, dense training infrastructure, AD, ONNX export, and WGPU inference plans.                           | `createDeepONet`, `createFourierNeuralOperator1D`, `createPinnNetwork`, `createSeparablePinn`, `trainDenseNetwork`                                 |
| `@kalika/formal-verification` | Kalika-to-Lean and Lean-to-Kalika translation, proof candidates, Lean process management, numerical spot checks, SMT/ATP translation, and decision procedures.  | `translateKalikaStatementToLean`, `translateKalikaExprToLeanTheorem`, `buildVerificationCandidates`, `numericalSpotCheck`, `translateExprToSmtLib` |

Workflow patterns:

- Compute and verify: `@kalika/sdk` or a domain package computes, `@kalika/core`
  records derivations, `@kalika/formal-verification` checks proof obligations.
- Explore and conjecture: domain package generates data,
  `@kalika/research-agents` formulates conjectures,
  `@kalika/formal-verification` or `@kalika/research-agents` proof tooling
  attacks them.
- Theory to observable: `@kalika/quantum-field-theory` builds the model,
  `@kalika/hep-phenomenology` computes constraints, `@kalika/database` imports
  experimental references.
- Equation discovery: `@kalika/symbolic-regression` proposes laws,
  `@kalika/neural-physics` supplies surrogate models or PDE training data, and
  `@kalika/formal-verification` checks symbolic claims where possible.

## Cross-Domain Recipes

| Workflow                                  | Libraries                                                                                                        |
| ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Compute and formally verify an integral   | `@kalika/sdk`, `@kalika/core`, `@kalika/formal-verification`, `@kalika/typesetting`                              |
| Build a publishable physics notebook      | `@kalika/notebooks`, one or more domain packages, `@kalika/renderer`, `@kalika/citations`, `@kalika/typesetting` |
| Compare a QFT prediction with data        | `@kalika/quantum-field-theory`, `@kalika/hep-phenomenology`, `@kalika/database`, `@kalika/citations`             |
| Analyze a gravitational-wave event        | `@kalika/gravitational-waves`, `@kalika/general-relativity`, `@kalika/database`, `@kalika/renderer`              |
| Search for number-theory conjectures      | `@kalika/number-theory`, `@kalika/combinatorics`, `@kalika/research-agents`, `@kalika/formal-verification`       |
| Study a strongly correlated lattice model | `@kalika/condensed-matter`, `@kalika/tensor-networks`, `@kalika/statistical-mechanics`, `@kalika/renderer`       |
| Run a large parameter scan                | Domain package, `@kalika/hpc-orchestrator`, `@kalika/database`, `@kalika/notebooks`                              |

## Maintenance

When adding a new Kalika library or a major public domain capability:

1. Add the package and entry symbols to [`domain-map.json`](./domain-map.json).
2. Add or update the matching section in this guide.
3. Run `pnpm kalika:domain-guide:check`.
4. Regenerate API reference if public APIs changed with
   `pnpm kalika:api-reference`.
