feedback: agents + humans #2
Description
Thanks for your work, I really wish the .agents folder would be documented.
In your current spec, there is a fundamental problem IMO:
A whole code repo is for agents + humans (assuming at least 1 human prompting the repo creation + some helper humans)
Hence ideally .agents should only contain stuff that is specific to agents and of no use to humans. Everything else should NOT be in .agents
OK in .agents:
- specific prompt complementing the root README.md / CONTRIBUTING.md (no duplication)
- skills
- other similar agent-formatted files, ex. settings
NOT ok in .agents: (it's for humans as well!)
- coding rules
- context
- specs
- documentation on setting up the repo
A common repository structure could be another spec...