Add AGENTS.md to repo-smith

[VikramGoyal23]

AGENTS.md provides instructions for AI coding agents working with the repo-smith codebase.

[jovnc]

@VikramGoyal23 Is there a reason for putting it in copilot-instructions.md instead of in Agents.md?

Ideally we would want our instructions to be AI-agnostic and not provide context for github copilot only right?

[VikramGoyal23]

@jovnc Forgive me, this draft is incomplete. Chat instructions are meant to be added in the copilot-instructions.md file. I am still working on adding support for multiple agents, I have marked this PR as a draft.

[jovnc]

@VikramGoyal23 Let's try to finish this by end of week

[VikramGoyal23]

@jovnc The file is ready for review.

[jovnc]

Other than that LGTM, content-wise it's ok

[jovnc]

This AGENTS.md file would work if working in multi-agent environment
eg. core orchestrator that spawns sub-agents and delegates tasks to them

However, I'm not sure if it is supported by most agentic tools currently, eg. github copilot does not support this. This seems more suitable for tools like Claude Code.

AGENTS.md being a universal context should be independent of this, hence maybe it's better to phrase it another way than specifying different agents, eg. can use SKILL.md instead, or simply just state the responsibility of the agent when performing X task

[VikramGoyal23]

@jovnc What do you think of this small extra comment? Also, I am slightly torn on the state of the file, since I feel as if this amount of context would be too much for a typical agent to have out the gate.