docs: Update AGENTS.md and PROD.md with comprehensive operations guide
AGENTS.md (1,871 lines):
- Add complete system architecture diagram with WebSocket flow
- Document all MessageTypes (0-6) including TOOL_EXEC (type 6)
- Detail start.bas, tables.bas, {tool}.bas execution flow
- Add complete BASIC keywords reference:
* Common: TALK, HEAR, USE KB, USE WEBSITE, ADD SUGGESTION
* Database: GET, SAVE, FIND, FIRST/LAST/COUNT
* Files: CREATE/READ/WRITE FILE, UPLOAD
* HTTP: GET/POST HTTP, WEBHOOK
* Scheduling: CREATE_TASK, WAIT, ON events
* Memory: SET BOT MEMORY, REMEMBER, CONTEXT
* Multi-bot: ADD BOT, DELEGATE TO, BROADCAST
* Control flow: IF/ELSE, FOR EACH, SWITCH
* Built-in vars: TODAY, NOW, USER, SESSION, BOT
- Include AutoTask keywords from PROMPT.md files
- Production operations guide from historical versions
PROD.md (851 lines):
- Add complete container architecture table (16 containers)
* Service names, technologies, binary/log/data paths
* Network access internal/external URLs
- Expand troubleshooting section:
* Container without IPv4: diagnose + fix
* CI/ALM permission errors: chmod, ownership
* MinIO mc operations: setup + common commands
* Forgejo DB: SQL queries for CI runs
* Zitadel API v2: curl examples with Host header
* Common errors table with quick fixes
Both files now provide day-to-day operations without LLM assistance.
Refs: Consolidated from git history and PROMPT.md files
This commit is contained in:
parent
cf921bd28a
commit
27c19def7d