Prostě buď si verzi nech a nebo uděláš upgrade. Hlavně není až tak časté, že by se veřejné API mělo měnit. Pokud máš nelopatí návrh, tak víš předem, co bude potřeba. Jen patláci dělají "agilně" a vše pořád mění.
Ony jsou u API dva svety - jeden, kdy sve klienty znas (idealne je mas o kancl vedle) a pak je to ta situace, kdy nemas sanci tusit, kdo to je. Jak to vypada, kdyz jsi pak "odvazny", jsme videli trebas u pridani metod do interfacu v JDBC (problem by nenastal, byt tam abstraktni tridy nebo pokud by se to stalo v JDK 8+). Ze nevis predem, co je potreba, je pravda. V zavislosti na metodice to nevis hodne nebo trochu. Prave proto je dobre se zamyslet nad tim, jak udelat ten navrh flexibilni (coz je casto kompozici, ale neni to pravidlo).
Az se naucis programovat, tak zkus kouknout trebas do Practical API design, neni to spatne cteni, pokud uz nejsi zacatecnicka lopatka.