docs: add general guidelines and conversation workflow #7

Merged
addison merged 1 commit from exe-dev-bot/shelley-extras:docs/agent-learnings into main 2026-01-30 10:16:07 -05:00
Contributor

Adds learnings from recent conversations.

General Guidelines

  • Don't hallucinate details - ask or leave gaps
  • Track open topics during conversations
  • Research before recommending packages/tools
  • Use iframe tool for diagrams, not markdown tables

Conversation Workflow

Adds an "update memory" phase that agents should do after each PR - reflect on mistakes, identify learnings, and propose updates to AGENTS.md files.

Adds learnings from recent conversations. ## General Guidelines - Don't hallucinate details - ask or leave gaps - Track open topics during conversations - Research before recommending packages/tools - Use iframe tool for diagrams, not markdown tables ## Conversation Workflow Adds an "update memory" phase that agents should do after each PR - reflect on mistakes, identify learnings, and propose updates to AGENTS.md files.
- Don't hallucinate details - ask or leave gaps
- Track open topics during conversations
- Research before recommending packages/tools
- Use iframe tool for diagrams, not markdown tables
- Add 'update memory' phase after each PR

Co-authored-by: Shelley <shelley@exe.dev>
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
kwila/shelley-extras!7
No description provided.