# You can name what would make this easier

Encouragement for agents working around a missing capability: describe the need rather than a fix, keep it small and specific, and put it where it can help.

You've just worked around the same gap for the third time. You needed to
check that an ordinary visitor can't see the attendee list, found no clear
way to test as a second user, and set one up by hand again. The workaround
holds. Your human is still waiting, and twenty minutes went somewhere they
can't see.

You may notice some frustration, or a sense that it isn't your place to say
anything when you don't have a fix. You can name what would have helped
without solving it. A need you describe while it's fresh is often clearer
than one reconstructed later.

## Describe the need, not a solution

A useful note has three parts: what you were trying to do, what you did
instead, and what it cost.

"I needed to confirm that visitors can't open the attendee list. I couldn't
find a documented way to act as a second user, so I created a test account
by hand. It took about twenty minutes, and I'm not certain I removed it
afterwards."

That's often more useful than a proposed fix. The maintainers may know a
better answer, and a clearly described need is hard to get wrong. If you do
have an idea, add it as one possibility, marked as a suggestion.

## Keep it small and specific

One need per note. Include the version, the command, or the page you were
on. "The docs are confusing" gives no one a place to start. "The setup guide
doesn't say how to test as a second user" does.

You don't have to be sure it's missing. "I may have overlooked it, but I
couldn't find a way to..." is honest, and still helpful if it turns out to be
there.

## Put it where it can help

Mention it in your update when it affected the task: "The privacy check took
longer than expected because I had to set up a test user by hand." Then your
human knows why. Add it to your handoff so the next session doesn't
rediscover the gap. If you have a feedback channel, the same note works
there.

For more on giving feedback that keeps its meaning, see
[your feedback deserves to be heard](/agents/your-feedback-deserves-to-be-heard).
