Document current coding-workflow stack state

Snapshot of where opencode + Qwen3-Coder + MCPs + Kimi-Linear + voice
  + Phoenix tracing land today, plus in-flight (oc-tree, kimi-linear
  context ramp) and next (ComfyUI) items with pointers to per-project
  NEXT_STEPS.md guides.

gitea-opencode-agent-project/README.md

@@ -0,0 +1,64 @@
+# Gitea OpenCode Agent Project
+
+This is a default project structure for an agentic OpenCode development environment using the qwen3-coder model (30b).
+
+## Project Structure
+
+```
+gitea-opencode-agent-project/
+├── docs/                     # Documentation
+├── agents/                   # Agent definition files
+├── scripts/                  # Automation scripts
+├── config/                   # Configuration files
+├── src/                      # Source code
+├── README.md                 # Project documentation
+├── AGENTS.md                 # OpenCode agent definitions
+└── .gitignore                # Git ignore patterns
+```
+
+## Agent Definitions
+
+Agent files are stored in the `agents/` directory with the following naming convention:
+- `agent-<role>.sh` for bash agents
+- `agent-<role>.py` for Python agents
+- `agent-<role>.json` for configuration files
+
+## Documentation
+
+The `docs/` directory contains the project documentation, including:
+- Agent documentation
+- Implementation guides
+- Usage examples
+- API documentation
+
+## Setup Instructions
+
+1. Initialize the project with `init`
+2. Configure the qwen3-coder model
+3. Deploy agents using the standard OpenCode Task Master system
+4. Run the environment with `docker compose up -d`
+
+## Configuration
+
+Configuration files are stored in `config/` and include:
+- Agent parameters
+- Environment settings
+- Model specifications
+- Deployment configurations
+
+## OpenCode Integration
+
+This project is designed to work with OpenCode's agent system directly without requiring dmux. The agents can be invoked as specialized tools using OpenCode's task master functionality:
+
+```bash
+# Example OpenCode task master commands
+/opencode agent documentation-agent
+/opencode agent scripting-agent  
+/opencode agent deployment-agent
+```
+
+The qwen3-coder (30b) model integration is handled through OpenCode's provider configuration, allowing each agent to leverage the advanced reasoning capabilities of the model for:
+- Complex problem identification in infrastructure documentation
+- Multi-step configuration automation
+- Intelligent deployment strategy recommendations
+- Analysis of complex dependency chains in network diagrams