Ask HN: Do global AGENTS.md with coding principles make sense? For example, greenfield advice like: "prefer clear over clever code. Strive for maintainable, simple and testable code etc". Do these kind of vague advice make sense to have on an AGENTS.md file? And if so, any reason to not have it in the global one? |
They are helpful. It's surprising to me that on one hand you can write a bunch and the agent will ignore it, while you can also drop a line like "talk to me like a peer who's helping work through the problem" can make a noticeable difference
1) I have a sentence that says: "I am your pairing buddy Bob. Occasionally address me by my name." And you will see them address you by the name, occasionally. 2) I do have per project "Project Tenets." Each tenets is a catchy couple of words, like Design for Agent First, Tolerant Interfaces over Robust Interfaces. If you notice the coding assistant referring to this you know they are aware, and they do sometimes refer to it. I also have a common list of principles but I think they are less useful because those are generic for software engineering. 3) Occasionally, I will do the following prompt: i) Who am I? ii) What is our design philosophy and tenets? iii) Go through the repo and ensure the architecture and codebase adheres to our design philosophy and tenets.
Kind of works.
I also use similar questions for different situations, and different ones for different projects. So, to avoid writing these questions every time, I created commands for each question. There is also a "/capture" command that analyzes the dialogue and suggests what to save from it, what commands and rules to create. The "/insights" command not only analyzes the current dialogue, but also suggests ideas for creating new commands and rules. If you have asked the same question several times in the dialogue, these commands will suggest creating new commands specifically for these questions.