docs: add AUTONOMOUS.md - #2479
Conversation
![gemini-code-assist[bot]](https://cdn.statically.io/img/avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
There was a problem hiding this comment.
Code Review
This pull request refines the documentation for coding agents by introducing a new AUTONOMOUS.md file for agents operating without human oversight and updating AGENTS.md to provide more generalized guidance for interactive assistants. Key changes include standardizing the directory structure for planning documents and updating references from CLAUDE.md to AGENTS.md. Review feedback focused on improving the clarity and consistency of instructions regarding where to save specifications and plans, suggesting more concise wording for these sections.
| – Enter plan mode for ANY non-trivial task (3+ steps or touches multiple libs) | ||
| – Brainstorm first (design → spec), then write an implementation plan | ||
| – Save specs to `docs/superpowers/specs/`, plans to `docs/superpowers/plans/` | ||
| – Save specs and plans in the repo's established planning docs. Prefer `docs/specs/` and `docs/plans/`; if the repo already uses another planning directory, follow that convention. |
There was a problem hiding this comment.
The wording here is a bit redundant. It's better to provide a clear, concise instruction for the agent to follow. Consider simplifying the sentence to make it more direct.
| – Save specs and plans in the repo's established planning docs. Prefer `docs/specs/` and `docs/plans/`; if the repo already uses another planning directory, follow that convention. | |
| – Save specs and plans to `docs/specs/` and `docs/plans/` (or the repo's established planning directory). |
|
|
||
| ## Task Management | ||
| 1. Brainstorm → Spec → Plan — save to `docs/superpowers/specs/` and `docs/superpowers/plans/` | ||
| 1. Brainstorm → Spec → Plan — save to the repo's established planning docs, preferably `docs/specs/` and `docs/plans/` |
There was a problem hiding this comment.
This line repeats the same instruction as line 10. For better maintainability and to avoid confusion, it's best to keep these instructions consistent and concise.
| 1. Brainstorm → Spec → Plan — save to the repo's established planning docs, preferably `docs/specs/` and `docs/plans/` | |
| 1. Brainstorm → Spec → Plan — save to `docs/specs/` and `docs/plans/` (or the repo's established planning directory) |
1 participant
No description provided.