The Way

Disclose AI use

Say when and how you used AI. Honest use is welcome. Hidden use is the problem.

Rule 5: disclose AI use. Tell people when and how you used AI in your work.

Why

  • Trust. Reviewers need to know what to check more carefully.
  • Learning. A coach can only help if they see what you did yourself.
  • Honesty. Using AI is fine. Hiding it is a bigger problem than the use itself.

What to disclose

For each piece of work, write one or two lines:

  • What the AI did (for example: “fixed grammar”, “drafted test cases”, “built issue 12”).
  • Which tool you used.
  • What you checked yourself afterwards.

Where to write it

  • In the merge request description.
  • In your weekly note.
  • In the Product Package, in a short “How I used AI” section.

A simple template

AI use for this change
- Tool: <name>
- What it did: <for example: drafted the unit tests for the lead form>
- What I decided myself: <for example: which fields the form collects>
- What I checked: <for example: I ran the tests and read every line>

What AI use is always allowed

Explaining a concept, spell-checking, translating your own text, summarising to read faster, searching for facts you then verify, and building issues from a milestone you wrote.

What it never replaces

Your epics, roadmap, personas, journey conclusions and decisions. See People write epics.

Key points

  • Disclose what the AI did and what you checked.
  • Using AI is fine. Hiding it is not.
  • The decisions stay yours and carry your name.

Back to the library