API First Design

Domain: Package Ideation

🎯 Motivation

Designing the interface before implementation forces you to think about the user experience first. A clean API is easier to implement well than a messy one patched into shape later.

πŸ“‹ Concrete Example

Write the README example before the code: from mypkg import parse_timetable; parse_timetable("schedule.xlsx"). If that call feels awkward, fix the design now β€” not after 500 lines of internals.

πŸ”— Analogy

Architects draw the floor plan and faΓ§ade before pouring concrete. You live in the rooms, not the foundation, so the layout must feel right before construction begins.