Checklist

Specify the interface where responsibility changes hands

Many ambiguous requirements live in the space between two owners.

About 1 min read

Before you use it

Use when
  • Each component looks correct in isolation but failures occur at handoffs between teams, systems or process steps.

Keep this limit in mind

  • Interface detail should match risk; do not create heavyweight documents for trivial internal calls that are already governed by stable contracts.

An idea to explore.

Try this idea.

Inspect the example, try the idea in your situation, then check your next move.

Keep reading

Checklist

  • Producer and consumer
  • Data/object/event transferred
  • Trigger and timing
  • Format or contract
  • Acknowledgement or success signal
  • Failure/retry behavior
  • Owner when the handoff fails

Why it matters

For each important interface, name the producer, consumer, object transferred, trigger, format or contract, timing, error signal, retry or fallback, and who owns a failed handoff. Treat the boundary as a requirement surface, not invisible plumbing.

An example

An outbound IDoc interface specifies who sends it, message type, trigger, acknowledgement, retry behavior and which team owns an unprocessed message.

Check your result

A handoff failure can be assigned and diagnosed without first debating where one component ends and the next begins.

Save and practise this idea

My learning

Read. Recall. Repeat.

Save this idea and return to it on any device.

Use email
Keep exploring

Connected ideas

You are readingSpecify the interface where responsibility changes hands

Evidence and sources
Supports

NASA's requirements checklist emphasizes clarity, one thought per requirement, completeness, explicit assumptions, consistency, traceability, feasibility and verifiability.

The checklist is for systems engineering; smaller tasks can apply the principles proportionally.

Appendix C: How to Write a Good Requirement · Requirements validation checklist

All sources (1)
Edition and review

Version 0.1.0

No review details are supplied for this edition.

Read this idea as JSON · Release details