docs: update template system architecture and contributing guides

Author: josecelano

docs/contributing/pr-review-guide.md

@@ -44,7 +44,7 @@ Verify contributors followed these project conventions:
 ### Templates (if applicable)
 
 - [ ] **Tera templates use correct syntax**: `{{ variable }}` not `{ { variable } }` (see [templates.md](./templates.md))
-- [ ] **Static Ansible playbooks** (without `.tera` extension) are registered in `src/infrastructure/external_tools/ansible/template/renderer/mod.rs`
+- [ ] **Static Ansible playbooks** (without `.tera` extension) are registered in `src/infrastructure/external_tools/ansible/template/renderer/project_generator.rs`
 
 ## 🚩 Quick Red Flags
 

docs/contributing/templates.md

@@ -149,7 +149,7 @@ Write standard Ansible YAML with no Tera variables:
 
 **This is the step that's easy to miss!**
 
-Add your playbook filename to the array in `src/infrastructure/external_tools/ansible/template/renderer/mod.rs`:
+Add your playbook filename to the array in `src/infrastructure/external_tools/ansible/template/renderer/project_generator.rs`:
 
 ```rust
 // Find the copy_static_templates method
@@ -268,7 +268,7 @@ When adding a static Ansible playbook:
 
 - [ ] Create `.yml` file in `templates/ansible/`
 - [ ] Write standard Ansible YAML (no Tera variables)
-- [ ] Add filename to `copy_static_templates` array in `src/infrastructure/external_tools/ansible/template/renderer/mod.rs`
+- [ ] Add filename to `copy_static_templates` array in `src/infrastructure/external_tools/ansible/template/renderer/project_generator.rs`
 - [ ] Update file count in debug log
 - [ ] Run E2E tests to verify
 - [ ] Create application step to execute the playbook

docs/technical/template-system-architecture.md

@@ -82,18 +82,18 @@ For Ansible templates, the system uses a **hybrid approach** combining static pl
 - name: Configure UFW firewall
   hosts: all
   vars_files:
-    - variables.yml  # Load centralized variables
-  
+    - variables.yml # Load centralized variables
+
   tasks:
     - name: Allow SSH access
       community.general.ufw:
-        port: "{{ ssh_port }}"  # Variable from variables.yml
+        port: "{{ ssh_port }}" # Variable from variables.yml
 ```
 
 ```yaml
 # templates/ansible/variables.yml.tera (rendered once)
 ---
-ssh_port: {{ ssh_port }}
+ssh_port: { { ssh_port } }
 ```
 
 ## 🔧 Key Components
@@ -106,9 +106,14 @@ ssh_port: {{ ssh_port }}
 
 ### Template Renderers
 
-- **OpenTofu Renderer**: Processes infrastructure templates
-- **Ansible Renderer**: Processes configuration management templates
-- Handle the template → build directory rendering process
+The system uses a **Project Generator** pattern (Orchestrator/Worker) to standardize how different tools (OpenTofu, Ansible) generate their project files.
+
+- **Orchestrator (`ProjectGenerator`)**: Manages the overall generation process.
+  - `OpenTofuProjectGenerator`
+  - `AnsibleProjectGenerator`
+- **Workers (`Renderer`)**: Handle specific file types.
+  - **Static File Copying**: Copies files without `.tera` extension (requires explicit registration).
+  - **Dynamic Template Rendering**: Renders `.tera` files with variable substitution (e.g., `InventoryRenderer`, `VariablesRenderer`).
 
 **Two-Phase Processing:**