Comprehensive Documentation Update - April 2026

This document tracks all documentation updates for recent commits pushed to main (April 5-10, 2026).

Summary of Changes

Three major feature additions require comprehensive documentation:

Armor Pipeline System (PR #1142) - AI-powered armor generation with Meshy/Tripo integration
Autonomous Agent Quest System (PR #1124) - LLM-driven agent behavior with full quest autonomy
Terrain & Tree Visual Overhaul (PR #1126) - Complete rewrite of tree rendering, terrain colors, water shaders

Documentation Files Updated

Core Documentation

✅ AGENTS.md - Already contains comprehensive documentation for all three features
⏳ CLAUDE.md - Needs armor pipeline section added
⏳ README.md - Needs feature highlights updated
⏳ packages/asset-forge/README.md - Needs armor pipeline documentation
⏳ packages/server/.env.example - Needs new environment variables documented
⏳ packages/asset-forge/.env.example - Needs Tripo API key documentation

API Documentation Needed

Agent API endpoints (15+ new endpoints)
Armor pipeline API endpoints
Tripo pipeline API endpoints
Spectator token generation

Configuration Documentation Needed

LLM behavior configuration
Streaming duel eligibility
Armor pipeline API keys
Terrain/lighting constants
Tree rendering configuration

Key Documentation Gaps Identified

1. Armor Pipeline (PR #1142)

Missing Documentation:

AssetForge README needs complete armor pipeline section
API endpoint documentation for /api/armor-pipeline/* and /api/tripo/*
Environment variable documentation for MESHY_API_KEY and TRIPO_API_KEY
Security considerations (localhost-only publish, SSRF guards)
Workflow documentation (shell extraction → texturing → rigging → publish)

2. Autonomous Agents (PR #1124)

Missing Documentation:

Agent API endpoint reference
LLM behavior configuration guide
Dashboard interop documentation
Worker thread architecture
Database schema changes (migrations 0052-0054)

3. Terrain Overhaul (PR #1126)

Missing Documentation:

New terrain constants and their purposes
Tree type changes (removed Willow/Fir, added Eucalyptus/General/Magic/Mahogany)
Water shader configuration
Grass system architecture change
Lighting configuration centralization

Action Items

High Priority

Update packages/asset-forge/README.md with armor pipeline documentation
Update packages/asset-forge/.env.example with Tripo API key
Document new agent API endpoints
Update CLAUDE.md with armor pipeline section

Medium Priority

Create API reference documentation for new endpoints
Document terrain configuration constants
Update deployment guides for Railway/Docker changes
Document LLM behavior configuration

Low Priority

Create migration guide for breaking changes
Update troubleshooting guides

Files Requiring Updates

Environment Variables

packages/asset-forge/.env.example - Add TRIPO_API_KEY
packages/server/.env.example - Already has agent configuration

README Files

packages/asset-forge/README.md - Add armor pipeline section
Root README.md - Update feature list

Architecture Documentation

CLAUDE.md - Add armor pipeline section
Create docs/armor-pipeline.md for detailed workflow

API Documentation

Create docs/api/agent-endpoints.md
Create docs/api/armor-pipeline-endpoints.md
Create docs/api/tripo-pipeline-endpoints.md

Completion Checklist

CLAUDE.md updated with armor pipeline
README.md updated with new features
asset-forge README.md updated
asset-forge .env.example updated
API documentation created
Configuration guide updated
Deployment documentation updated
Migration guide created

⌘I