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:
Rodrigo Rodriguez (Pragmatismo) 2026-04-18 10:29:58 -03:00
parent cf921bd28a
commit 27c19def7d
2 changed files with 2417 additions and 575 deletions

1873
AGENTS.md

File diff suppressed because it is too large Load diff

1119
PROD.md

File diff suppressed because it is too large Load diff