interesting approach. I usually use a session-level tmp folder with free reign for markdown then ask the agent at the end of the session to take all that info and update persistent markdowns with useful info for future sessions. I feel like you need some mechanism to de-slop the markdowns when you let the agent put whatever info it wants into them.

Combined views

2.6K

2 posts, first seen 6h ago

10 likes comments

2 comments

7 saves

Sentiment

Positive100%0%Negative

Positive Read

Users are interested in adding an agent appendix to READMEs because it lets them hide AI instructions as markdown comments without cluttering sections for human readers.

Based on 1 visible X reactions from 2 accounts; directional sample.

Digg Deeper

Ask a question below.

Published answers will appear here.

Reactions from the X community

AN anirudh@kamathematic

7:30 PM · Jul 17, 2026

@chrisalbon Interesting! I was experimenting with a similar approach, just putting stuff for agents as markdown comments so humans don’t have to read them

CR Cameron R. Wolfe, Ph.D.@cwolferesearch

8:06 PM · Jul 17, 2026

1942TECH

CA Chris Albon@chrisalbon

7:17 PM · Jul 17, 2026

1035TECH

I have started making my READMEs with an Agent Appendix where the agent can dump whatever it wants.