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/.dmux-hooks/README.md

@@ -0,0 +1,38 @@
+# Agent Orchestration Hooks
+
+This directory contains dmux hooks that define how agents work in the OpenCode environment.
+
+## Available Hooks
+
+- `worktree_created` - Triggered when a new worktree is created
+- `run_test` - For running tests
+- `run_dev` - For development tasks
+- `post_merge` - After merging changes
+
+## Hook Usage
+
+Each hook should be executable and contain logic for the specific agent role:
+
+```bash
+#!/bin/bash
+# Example hook for documentation agent
+# .dmux-hooks/worktree_created
+
+# Set environment for qwen3-coder
+export DMUX_AGENT="opencode"
+export QWEN_MODEL="qwen3-coder:30b"
+export AGENT_CONTEXT="homelab-documentation"
+
+# Run qwen3-coder documentation tasks
+echo "Initializing homelab documentation agent..."
+qwen3-coder --generate-docs \
+  --model "qwen3-coder:30b" \
+  --output "$DMUX_WORKTREE_PATH/docs/homelab.md"
+```
+
+## Agent Roles
+
+- `documentation-agent.sh` - Generates documentation using qwen3-coder
+- `scripting-agent.sh` - Creates automation scripts
+- `deployment-agent.sh` - Manages deployments
+- `monitoring-agent.sh` - Tracks system performance

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

gitea-opencode-agent-project/agents/README.md

@@ -0,0 +1,57 @@
+# Agent Orchestration
+
+This project uses OpenCode's Task Master system for agent orchestration instead of dmux.
+
+## Available Agents
+
+- `documentation-agent.sh` - Generates documentation using qwen3-coder
+- `scripting-agent.sh` - Creates automation scripts and configurations  
+- `deployment-agent.sh` - Manages deployments and optimizations
+- `monitoring-agent.sh` - Tracks system health and performance
+
+## Usage with OpenCode
+
+Agents can be invoked using OpenCode's Task Master system:
+
+```bash
+# Initialize the project
+/init
+
+# Run specific agents
+/opencode agent documentation-agent
+/opencode agent scripting-agent
+/opencode agent deployment-agent
+
+# Run all agents
+/opencode agents all
+```
+
+## Integration with qwen3-coder (30b)
+
+Each agent leverages the qwen3-coder model's advanced reasoning capabilities:
+- Complex problem identification in infrastructure documentation
+- Multi-step configuration automation
+- Intelligent deployment strategy recommendations
+- Analysis of complex dependency chains in network diagrams
+
+## Agent Responsibilities
+
+### Documentation Agent
+- Generates documentation from code analysis
+- Creates standardized documentation templates
+- Updates documentation based on infrastructure changes
+
+### Scripting Agent
+- Creates Docker Compose configurations
+- Generates setup scripts
+- Writes automation routines
+
+### Deployment Agent
+- Analyzes deployment strategies
+- Optimizes container configurations
+- Manages multi-service deployments
+
+### Monitoring Agent
+- Monitors system performance
+- Analyzes infrastructure health
+- Detects potential issues

gitea-opencode-agent-project/agents/deployment-agent.sh

@@ -0,0 +1,26 @@
+# Deployment Agent
+
+## Overview
+This agent specializes in managing deployments and configurations using the qwen3-coder model (30b) for the homelab infrastructure project.
+
+## Capabilities
+- Analyzes deployment strategies
+- Optimizes container configurations
+- Manages multi-service deployments
+- Provides intelligent deployment recommendations
+
+## Usage
+```bash
+# Optimize deployment with qwen3-coder
+qwen3-coder --optimize-deployment \
+  --model "qwen3-coder:30b" \
+  --config "docker-compose.yml" \
+  --target "homelab-system"
+```
+
+## Integration
+This agent integrates with:
+- Docker Compose configurations
+- CI/CD pipelines
+- Network documentation
+- Security configurations

gitea-opencode-agent-project/agents/documentation-agent.sh

@@ -0,0 +1,26 @@
+# Documentation Agent
+
+## Overview
+This agent specializes in generating and maintaining documentation using the qwen3-coder model (30b) for the homelab infrastructure project.
+
+## Capabilities
+- Generates documentation from code analysis
+- Creates standardized documentation templates
+- Updates documentation based on infrastructure changes
+- Analyzes documentation gaps and suggests improvements
+
+## Usage
+```bash
+# Generate documentation with qwen3-coder
+qwen3-coder --generate-docs \
+  --model "qwen3-coder:30b" \
+  --project "homelab-infrastructure" \
+  --output "docs/homelab.md"
+```
+
+## Integration
+This agent integrates with:
+- Code repositories
+- Network diagrams
+- Configuration files
+- Deployment scripts

gitea-opencode-agent-project/agents/monitoring-agent.sh

@@ -0,0 +1,26 @@
+# Monitoring Agent
+
+## Overview
+This agent specializes in monitoring system health and performance using the qwen3-coder model (30b) for the homelab infrastructure project.
+
+## Capabilities
+- Monitors system performance
+- Analyzes infrastructure health
+- Detects potential issues
+- Provides optimization suggestions
+
+## Usage
+```bash
+# Monitor system with qwen3-coder
+qwen3-coder --monitor-system \
+  --model "qwen3-coder:30b" \
+  --target "homelab-network" \
+  --output "reports/health.md"
+```
+
+## Integration
+This agent integrates with:
+- System logs
+- Performance metrics
+- Configuration files
+- Documentation updates

gitea-opencode-agent-project/agents/scripting-agent.sh

@@ -0,0 +1,26 @@
+# Scripting Agent
+
+## Overview
+This agent specializes in generating automation scripts and configurations using the qwen3-coder model (30b) for the homelab infrastructure project.
+
+## Capabilities
+- Creates Docker Compose configurations
+- Generates setup scripts
+- Writes automation routines
+- Creates deployment manifests
+
+## Usage
+```bash
+# Generate automation script with qwen3-coder
+qwen3-coder --generate-script \
+  --model "qwen3-coder:30b" \
+  --task "docker-compose generation" \
+  --output "docker-compose.yml"
+```
+
+## Integration
+This agent integrates with:
+- Docker Compose templates
+- Configuration files
+- Deployment workflows
+- Network documentation