Explore / Field notes
Field notes · STARTER COLLECTION

The best demo includes the part that broke.

A practical recipe for sharing an AI experiment that someone else can actually learn from.

AWAI / FIELD NOTESSHOW
THE MESSY
MIDDLE.
Ideas are better when shared.

Give people a starting point

State the problem in one sentence. Include the tool or repository, version, setup, and a small public input. Explain what a successful result would look like before you show the output.

Report what happened

Separate observed results from your hopes. Include a failure case and describe any human corrections. If you report speed or accuracy, describe the measurement and environment so another person can try it.

End with an invitation

Offer a small next experiment. Invite a specific improvement, such as a clearer setup guide or a second test case. A useful contribution can be a paragraph, not just a polished application.

Keep the idea moving.

Have a question, improvement, or your own experiment? Bring it to the repository.

Discuss on GitHubSuggest an edit