This directory contains implementation-level specs for active and recent work on contentful.java.
Specs are small, focused documents that capture "what we're building now" for both engineers and agents. They are written before or alongside implementation and are marked as status: done once shipped.
# YYYY-MM-DD: Title
**Status:** Draft | In Progress | Done
**Author:** @name
**Related:** [DX-XXX](link), PR #NNN
## Problem
What are we solving and why?
## Design
How will it work? Include key decisions, API surface changes, and edge cases.
## Acceptance Criteria
How do we know it's done?
No active specs at this time.