## Summary Add `AGENTS.md` and `CLAUDE.md` files to the repository root to provide context and guidelines for engineers using AI coding assistants like [OpenCode](https://opencode.ai/) and [Claude Code](https://docs.anthropic.com/en/docs/claude-code). ## Background The [AGENTS.md specification](https://agents.md/) is an emerging standard for providing AI coding agents with project-specific context, coding conventions, and guidelines. This helps AI tools understand the codebase and generate more accurate, consistent code. ## Proposed Implementation ### 1. Create `AGENTS.md` This file should include: - Project overview (Step Runner purpose and architecture) - Language and framework conventions (Go patterns used in this project) - Code style guidelines - Testing conventions - Build and development commands - Key directories and their purposes - Any project-specific patterns or anti-patterns ### 2. Create `CLAUDE.md` This file should reference `AGENTS.md` to avoid duplication: ```markdown # Claude Code Configuration Please read and follow the guidelines in [AGENTS.md](./AGENTS.md). <!-- Any Claude-specific instructions can go here if needed --> ``` ## Benefits - Improved AI-assisted code generation quality - Consistent coding patterns when using AI tools - Reduced review cycles for AI-generated code - Better onboarding experience for engineers using AI assistants ## Acceptance Criteria - [ ] `AGENTS.md` created with comprehensive project guidelines - [ ] `CLAUDE.md` created referencing `AGENTS.md` - [ ] Both files are discoverable in the repository root