updates

Author: EdwardAngert

ai-project-notes.md

@@ -29,6 +29,31 @@ This is a running log of notes, observations, decisions, and refinements related
 
 ---
 
+## [2025-05-07] Coder Template Structure Investigation
+
+- Coder templates require a specific structure not fully explained in documentation:
+  - Registry modules use `agent_id` parameter, not `agent` (important distinction for claude-code module)
+  - Modules function differently than raw resources (parameters don't match Terraform registry docs)
+  - Docker templates should use `codercom/enterprise-base:ubuntu` for broader compatibility
+  - Templates must include `data.coder_workspace.me.start_count` for proper lifecycle management
+  - Claude Code module documentation incomplete - parameters not fully documented in examples
+- Documentation should explain that modules from registry.coder.com use different parameters than raw resources
+- AI integration documentation needs clearer examples showing correct module parameter syntax
+
+## [2025-05-07] Claude Code Module Parameter Correction
+
+- Major discovery: Claude Code module doesn't accept `anthropic_api_key` or `model` parameters directly
+- These parameters should instead be passed through environment variables via the `coder_env` resource
+- Required corrections:
+  - Use `CLAUDE_API_KEY` env var instead of module parameter
+  - Use `CLAUDE_MODEL` env var instead of module parameter
+  - Use `CODER_MCP_CLAUDE_SYSTEM_PROMPT` for custom instructions
+  - Use `CODER_MCP_INSTRUCTIONS` for tool configuration
+- Module documentation needs updates to clarify the proper usage pattern with `coder_env`
+- All AI integration examples should show this pattern to avoid confusion
+
+---
+
 ## [TEMPLATE]
 
 ## [YYYY-MM-DD] Topic or Focus

architecture-notes.md

@@ -42,8 +42,15 @@ This document provides a high-level overview of the Coder backend, CLI, agent sy
 ### Template Architecture
 - Templates = Terraform modules with Coder extensions
 - Key custom resources:
-  - `coder_agent`, `coder_app`, `coder_script`, `coder_parameter`, `coder_metadata`
-- Versioned: Each version is immutable and linked to a provisioner job
+  - `coder_agent`: Core component that enables connectivity to workspaces
+  - `coder_app`: Provides access to web applications (IDEs, docs, etc.)
+  - `coder_parameter`: Enables user input when creating workspaces
+  - `coder_metadata`: Displays contextual information in UI
+  - Modules from Coder registry: Pre-built components (e.g., code-server, jetbrains-gateway, claude-code)
+- Resource lifecycle management:
+  - Ephemeral: Uses `count = data.coder_workspace.me.start_count` to control start/stop
+  - Persistent: Uses `lifecycle { ignore_changes = all }` to protect data
+- Versioned: Each template version is immutable and linked to a provisioner job
 
 ### Provisioning Workflow
 1. **Version upload**: Terraform code added