docs: Add AGENTS.md conventions for coding agents

[mike-scott]

Give AI coding agents standing instructions for working in this repository: grounding requirements, analysis and verification expectations, answer format and voice, scope limits, and commit conventions. CLAUDE.md points Claude Code at AGENTS.md so both tools share one source.

[doanac]

I have no idea what best practices are for this file. Comparing to meta-qcom I notice that:

• this is much more verbose - perhaps that's a good thing?
• doesn't include procedures for common tasks like building

[mike-scott]

I have no idea what best practices are for this file. Comparing to meta-qcom I notice that:

• this is much more verbose - perhaps that's a good thing?
• doesn't include procedures for common tasks like building

Yep, this sets up the "persona" and basic backgrounder files. We can also add a first "How can I help you get started?" type response back to the user with a path of things it should know how to help with:

• Building
• Testing (especially the E2E testing setup)
• Contributing
• Etc

[mike-scott]

Added a STYLE.md based on findings in #238

[mike-scott]

Oof. I realize, I should have used: https://github.com/foundriesio/fio-style/blob/main/style-guide.md

[kprosise]

Oof. I realize, I should have used: https://github.com/foundriesio/fio-style/blob/main/style-guide.md

No worries. In the near future, the style guide will be downloaded with the rest of fio-style—along with a set of skills and linter rules—for all our repos.

[mike-scott]

@kprosise Should we wait for the work you're doing on fiostyle?

[kprosise]

@kprosise Should we wait for the work you're doing on fiostyle?

Up to you. On the one hand I don't have Agent specific skills set, will need to setup everything to make it easier to use and semi-automated, and this will take a little bit…on the other hand, you could potentially point the agent to the style guide/merge this PR now while I work on finishing fio-style stuff, and then we can change it up later.