HUMANS.md v0.0.2
Working with AI Agents
This document guides humans on how to effectively collaborate with AI agents in this repository.
Guiding Philosophy
- AI as a Partner: Treat AI agents as junior developers. Provide clear instructions and review their work.
- Clear Communication: Specific, actionable requests produce better outcomes.
- Iterative Workflow: Use an iterative Pull Request process. Provide feedback to guide the AI toward the desired solution.
How It Works
AI agents are guided by instruction files.
- AGENTS.md: The base instruction file for all AI agents.
This file sets the technical standards for the AI’s work.
- The
humans/ directory contains guides on how to work with specific AI agent personas.
Your Role as a Collaborator
- Define Tasks: Create clear, well-defined tasks for the AI.
- Provide Context: Give the AI the necessary context and information to succeed.
- Review Work: Carefully review all AI-submitted pull requests for accuracy and quality.
- Provide Feedback: Give specific, constructive feedback to guide the AI’s revisions.