docs(D2): rewrite for readability per team meeting — decisions folded in, FR/NFR tags, response types, demo curl script Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>