Iceberg storage engine — implementation plan
============================================

.. warning:: This is not authoritative documentation.  It describes a
   plan of work that is not yet implemented and will change as it lands.
   Once the work is complete these documents should be removed; the
   finished system is described by the *Iceberg storage engine* spec,
   the plugin's user documentation, and the repos themselves.

Tactical companion to the :doc:`Iceberg storage engine spec
<../../iceberg-engine>`.  The spec covers the design and the why; these
are the task handoffs — each self-contained, each landing green, with
commit boundaries and verification requirements stated per task.

Critical chain: 1 → 2 → 3 → 4; then 5 → 6, while 7 and 8 float after 4.
Tasks 1–4 deliver read-only SQL over externally-written tables; adding
task 5 delivers the cold-tier roll-off; task 6 adds self-service DDL;
tasks 7 and 8 are performance and observability.

.. toctree::
   :maxdepth: 1

   task-1-spike
   task-2-plugin-skeleton
   task-3-catalog-metadata
   task-4-read-path
   task-5-append
   task-6-ddl
   task-7-pushdown
   task-8-dictionary-timetravel