eblume/blumeops
1
1
Fork 0
Code Issues Pull requests Projects Releases 83 Packages Wiki Activity Actions

C0: adopt AGENTS.md as canonical agent config

Browse source
This commit is contained in:
Erich Blume 2026-04-18 20:15:30 -07:00
commit deedeecef9
7 changed files with 179 additions and 171 deletions
Download patch file Download diff file Expand all files Collapse all files

4
docs/tutorials/ai-assistance-guide.md
View file

@ -10,7 +10,7 @@ tags:
> **Audiences:** AI, Owner
This guide provides context for AI agents (like Claude Code) assisting with BlumeOps operations, and helps Erich understand how to work effectively with AI assistance.
This guide provides context for AI agents assisting with BlumeOps operations, and helps Erich understand how to work effectively with AI assistance.
## Critical Rules
@ -22,7 +22,7 @@ These are non-negotiable for AI agents working in this repo:
4. **Wait for user review before deploying** - Create PRs, don't auto-deploy
5. **Never merge PRs without explicit request** - The user merges after review
Full rules are in the repo's `CLAUDE.md`. See [[agent-change-process]] for the C0/C1/C2 change classification methodology — C0 (direct to main), C1 (feature branch + PR), C2 (Mikado Branch Invariant).
Full rules are in the repo's `AGENTS.md`. See [[agent-change-process]] for the C0/C1/C2 change classification methodology — C0 (direct to main), C1 (feature branch + PR), C2 (Mikado Branch Invariant).
## Workflow Conventions

8
docs/tutorials/exploring-the-docs.md
View file

@ -30,15 +30,15 @@ The docs follow the [Diataxis](https://diataxis.fr/) framework:
You probably want quick access to operational details:
- [How-to](/how-to/) guides for common operations (deploy, troubleshoot, update ACLs)
- [Reference](/reference/) has service URLs, commands, and config locations
- [[ai-assistance-guide]] explains how to work effectively with Claude
- [[ai-assistance-guide]] explains how to work effectively with AI agents
- Run `mise run ai-docs` to prime AI context with key documentation
### For Claude/AI Agents
### For AI Agents
Context for effective assistance:
- Read [[ai-assistance-guide]] for operational conventions
- [Reference](/reference/) has the technical specifics you'll need
- The repo's `CLAUDE.md` has critical rules (especially the kubectl context requirement)
- The repo's `AGENTS.md` has critical rules (especially the kubectl context requirement)
### For External Readers
@ -81,7 +81,7 @@ The `ai-docs` mise task concatenates key documentation files for AI context:
mise run ai-docs
```
This outputs key documentation files and a full tree listing of all docs, providing Claude with essential context for BlumeOps operations.
This outputs key documentation files and a full tree listing of all docs, providing an agent with essential context for BlumeOps operations.
## Related