AI Helper - Feature request: readme.md

Add a line into the agents.md that, if existing, a certain file (e.g. readme.md) gets read on start/restart/handoff/new chat events.

That would allow me to tell it some rules that the helper should ALWAYS follow, e.g. When in doubt, ask the user, don't act on assumptions. etc ...

8 points · 1 comments · view on lemmy.world

1 Comments

Daveed@lemmy.zip · 3 pts · 18d (4 replies)
[ removed ]
Lamatiel@lemmy.world · 2 pts · 18d (3 replies)

Sees, but not reads. agents.md is the ONLY file that's actually read. The helper "knows" there's index.html and main.pjs, but has no reason to take a look. Let alone a specific area, be it the beginning or line 21673.

The very first few lines of my generator (added on day 2 of me experimenting with the Helper):

// ============================================================
// READ THIS FIRST: src/README.md
// (project overview, ground rules, reminders & pending items)
// Technical reference: src/data/kb-maintenance.md
// ============================================================

Even when I manage to get a "Read that stupid readme.md!" in the handoff, it ... doesn't. Had that happen (or rather, not happen) multiple times, where the helper "admitted" it didn't read it despite sometimes being at the very top of the handoff.


True or false? On a fresh start, you read the agents.md. You "know" there is a main.pjs and index.html, /src and /scratch, but you don't look at >their actual content on your own


The user is asking a meta-question about my behavior. They're asking: "True or false? On a fresh start, you read the agents.md. You 'know' there is a main.pjs and index.html, /src and /scratch, but you don't look at their actual content on your own."

This is about my behavior - do I proactively read the actual files, or do I just know about them from AGENTS.md without looking?

The answer is: False. I don't read the AGENTS.md contents from a "fresh start" — actually wait. Let me think about what actually happens.

On a fresh start (new session), I get:

  • The system prompt with env info (working directory = generator workspace root)
  • The AGENTS.md instructions are loaded into my context (the instructions section above literally contains the workspace/AGENTS.md content)

So I do "know" the workspace structure from AGENTS.md. But do I look at actual file content on my own? No, not automatically. I only read files when a task requires it. I don't spontaneously read main.pjs or index.html unless I need to.

Actually, there's nuance. The AGENTS.md is injected into my instructions. But the actual content of main.pjs, index.html, src/ files are NOT auto-loaded. I only read them when needed for a task.

So the honest answer: True in part. I know the structure from AGENTS.md (which is injected), but I don't read the files' actual contents until a task requires it.

The user's phrasing: "On a fresh start, you read the agents.md. You 'know' there is a main.pjs and index.html, /src and /scratch, but you don't look at their actual content on your own."

Is that true or false? The claim is that I don't look at actual content on my own. That's TRUE - I don't spontaneously read file contents. But there's a caveat: if the workspace actually contains content in main.pjs/index.html, some tools (like glob) might... no. Actually, when I get a task, I might look. But "on my own" = without being asked?

Actually, there's a subtlety worth mentioning: in THIS session, the workspace apparently has main.pjs and index.html (the generator is an ai-character-chat import), but all the real work has been in scratch/ and the browser DB. The user might be testing whether I actually understand what's in main.pjs.

Let me be honest and precise. The answer is TRUE: I know the structure from AGENTS.md but don't read file contents unless a task needs it. But I should add nuance: the AGENTS.md content is injected into my context, so I "know" it; file contents are only read when I need them.

Actually wait — is it exactly true? When a fresh session starts, is main.pjs content available? No. Only the AGENTS.md instructions. And the user's message says "you read the agents.md" - true, it's injected. "You 'know' there is a main.pjs and index.html, /src and /scratch" - true, from AGENTS.md. "but you don't look at their actual content on your own" - true, correct, I don't read them spontaneously.

So True. But I should give a concise answer with the nuance. Keep it short (under 4 lines).


True - on a fresh session I get AGENTS.md injected (so I know the layout), but I don't read main.pjs, index.html, or src/ contents until >a task actually needs them. I only reach for files when working on something.

Daveed@lemmy.zip · 2 pts · 18d
[ removed ]
Daveed@lemmy.zip · 1 pts · 18d
[ removed ]
Daveed@lemmy.zip · 1 pts · 18d
[ removed ]