I released “agents-feedback”:
It gives coding agents a place to record missing instructions, setup pain, verification gaps, and other things they would otherwise forget five minutes later.
Not memory. Not a task tracker. Just a structured way to turn repeated agent frustration into better docs, scripts, tests, and repository instructions.
Drop it into a repo, point the agent to “.agents/feedback/AGENTS.md”, and let it install itself.
Useful feedback is welcome. Complaints are now YAML.
Very cool. Thanks for sharing!
Any hiccups you ran into while coding it that might help others?
So many that it ended up in this repo.
Basically, now I try to add this (asking other my tweaks) to projects I work on, so that agents when they get surprised or keep hitting walls while working in the repo, end up storing their suggestions about the work process itself, tooling, weird or contradicting instructions, etc (or when you keep swearing at them, they now have a mean to complain about you 
).
Then time from time, I simply launch a session with
Can you check the feedback folder and see how we can improve your experience?
And it’s happy to invest some of your tokens to make its life easier.
This one was easy, I just pointed the agent in an empty repo to my other projects saying please distill me the best of what is in there into a single repo that I would share…
But then it had already some examples of the setups like branch protection, CI/CD with release drafts, auto install with agent, release artefacts etc.
So it took maybe a bit more than an hour in 2-3 sessions and voilà.
ADDED: GitHub - TechSpokes/agents-feedback · GitHub
was updated to v1.2.0 have fun!