Design ideas and proposals for gt4py. Drop an idea, cross-check it against what already exists, and surface conflicts early.

This index is the map of everything here. Each entry lists keywords for the topics a document discusses — scan them to find overlapping or conflicting ideas. See AGENTS.md in the repository root for how to add a proposal and keep this index current. (Keep entries and their keywords in sync with each document’s tags.)

Shared

Proposals the group broadly agrees are implementation-ready.

Personal

Work-in-progress proposals, organized by contributor.

havogt

edopao

egparedes

  • internal decoupling — keywords: architecture, layering, tach, modularity, public-api, semi-public, internal, packaging, dependencies, refactoring, infrastructure, over-engineering, otf, workflow, dsl, config, allocators, caching, fingerprint, compiled-program, process-pool, factory-boy, instrumentation, adr, jax, decoupling, migration, tech-debt
  • Dissolving gt4py.next.otf into a toolchain core and DSL-agnostic build infrastructure — keywords: otf, toolchain, workflow, pipeline, refactoring, architecture, layering, modularity, backend, bindings, build-system, caching, runners, compiled-program, factory-boy, naming, observability, stage-inspection, adr, tach, tech-debt
  • A discretization-independent surface syntax for finite-difference computations — keywords: finite-difference, finite-volume, mesh-invariant, structured, unstructured, exterior-calculus, dec, mimetic, de-rham, location-typing, stencil, weight-generation, rbf-fd, gfdm, moment-matching, conservation, field-operators, icon, pace, pmap, fv3, ifs-fvm, arakawa-staggering, c-grid, d-grid, a-grid, dynamical-core, hevi, vertical-solve, elliptic-solve, mpdata, semi-implicit, miura, atlas, prior-art, dsl-design

Knowledge

Reference material that proposals can lean on — not proposals themselves.

Software engineering

  • Working Principles — keywords: software-design, principles, complexity, modularity, dry, domain-modelling, architecture, code-review, checklist