undefined | Better HN

0 pointsslashdev26d ago0 comments

I have this at the bottom of my AGENTS.md:

You will also add a markdown file to the changelog directory named with the current date and time `date -u +"%Y-%m-%dT%H-%M-%SZ"`, record the prompt, and a brief summary of what changes you made, this should be the same summary you gave the developer in the chat.

From that I get the prompt and the summary for each change. It's not perfect but it at least adds some context around the commit.

0 comments

atmosx25d ago

Isn’t the commit message a better place to add what and why? You might need to feed some info that the agent doesn’t have access to “we are developing feature X this change will such and such to blah blah”. The agent will write a pretty good commit message most of the times. Why do you need a markdown file? Are releasing new versions of the software for third parties?

Belphemur25d ago

Cheaper and faster retrieval to be added to the context and discoverable by the agent.

You need more git commands to find the right commit that contains the context you want (either you the human or the LLM burning too many token and time) than just include the right MD file or use grep with proper keywords.

Moreover you could need multiple commits to get the full context, while if you ask the LLM to keep the MD file up to date, you have everything together.

atmosx25d ago

I doubt you can give more context to an LLM from a README file than 500 properly written commits. Or to a human for that matter.

1 more reply

mort9625d ago

How often, in your experience, do people read those auto-generated markdown files? Do you have any empirical data on how useful people find reading other people's agents' auto-generated files?

addaon25d ago

How often is it the same summary given to the developer in the chat?

j / k navigate · click thread line to collapse

0 pointsslashdev26d ago0 comments

I have this at the bottom of my AGENTS.md:

From that I get the prompt and the summary for each change. It's not perfect but it at least adds some context around the commit.

0 comments

atmosx25d ago

Belphemur25d ago

Cheaper and faster retrieval to be added to the context and discoverable by the agent.

Moreover you could need multiple commits to get the full context, while if you ask the LLM to keep the MD file up to date, you have everything together.

atmosx25d ago

I doubt you can give more context to an LLM from a README file than 500 properly written commits. Or to a human for that matter.

1 more reply

mort9625d ago

How often, in your experience, do people read those auto-generated markdown files? Do you have any empirical data on how useful people find reading other people's agents' auto-generated files?

addaon25d ago

How often is it the same summary given to the developer in the chat?

j / k navigate · click thread line to collapse