[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6AD981HWR1YA7M2YK1HPG4H":3,"skill-same:01M6AD981HWR1YA7M2YK1HPG4H":60},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":30,"linkOnly":31,"markdownContent":32,"markdownBody":33,"frontMatter":34,"refName":36,"commitSha":37,"skillDirectory":38,"forksCount":39,"repositoryHtmlUrl":40,"repositoryHomepageUrl":41,"ownerHtmlUrl":42,"ownerBlogUrl":43,"ownerDescription":44,"updatedAt":45,"install":46,"resources":59},"01M6AD981HWR1YA7M2YK1HPG4H","cross-machine-coordination",null,"Enables squad agents on different machines to share work via git-based task queuing","github\u002Fgh-aw","github","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F9919?v=4","01M6AC83DS133TPXFSP1DHNCC6","GitHub","01M6AD3VCZ4WKQSFSRTPN7N9DN",5636,"MIT","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fgh-aw\u002Fblob\u002Fmain\u002F.squad\u002Ftemplates\u002Fskills\u002Fcross-machine-coordination\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28,29],"cross machine coordination","coordination","machine","orchestration","squad","git","share","work","task","via","manual","2026-11-10 10:12:30",false,"---\nname: \"cross-machine-coordination\"\ndescription: \"Enables squad agents on different machines to share work via git-based task queuing\"\ndomain: \"orchestration\"\nconfidence: \"medium\"\nsource: \"manual\"\n---\n\n# Skill: Cross-Machine Coordination Pattern\n\n**Skill ID:** `cross-machine-coordination`  \n**Owner:** Ralph (Work Monitor)  \n**Squad Integration:** All agents  \n**Status:** Specification (ready for implementation)  \n\n---\n\n## Overview\n\nEnables squad agents running on different machines (laptop, DevBox, Azure VM) to securely share work, coordinate execution, and pass results without manual intervention.\n\n**Pattern:** Git-based task queuing + GitHub Issues supplement\n\n---\n\n## Usage\n\n### For Task Sources (Orchestrating Machine)\n\n**To assign work to DevBox:**\n\n```bash\n# Create task file\ncat > .squad\u002Fcross-machine\u002Ftasks\u002F2026-03-14T1530Z-laptop-gpu-voice-clone.yaml \u003C\u003C 'EOF'\nid: gpu-voice-clone-001\nsource_machine: laptop-machine\ntarget_machine: devbox\npriority: high\ncreated_at: 2026-03-14T15:30:00Z\ntask_type: gpu_workload\npayload:\n  command: \"python scripts\u002Fvoice-clone.py --input voice.wav --output cloned.wav\"\n  expected_duration_min: 15\n  resources:\n    gpu: true\n    memory_gb: 8\nstatus: pending\nEOF\n\n# Commit & push\ngit add .squad\u002Fcross-machine\u002Ftasks\u002F\ngit commit -m \"Cross-machine task: GPU voice cloning [squad:machine-devbox]\"\ngit push origin main\n```\n\nRalph on DevBox will:\n1. Pull the task on next cycle (5-10 min)\n2. Validate schema & command whitelist\n3. Execute the GPU workload\n4. Write result to `.squad\u002Fcross-machine\u002Fresults\u002Fgpu-voice-clone-001.yaml`\n5. Commit & push the result\n\n---\n\n### For Task Executors (DevBox, Azure VMs)\n\nRalph automatically watches `.squad\u002Fcross-machine\u002Ftasks\u002F` for work targeted at this machine.\n\n**On each cycle (5-10 min):**\n\n```python\n# Pseudo-code (Ralph implementation)\n1. git pull origin main\n2. Load all .yaml files in .squad\u002Fcross-machine\u002Ftasks\u002F\n3. Filter for status=pending AND target_machine=HOSTNAME\n4. For each task:\n   a. Validate schema (must have: id, source_machine, target_machine, payload)\n   b. Validate command against whitelist\n   c. Execute task (with timeout)\n   d. Write result to .squad\u002Fcross-machine\u002Fresults\u002F{id}.yaml\n   e. Commit & push result\n```\n\n---\n\n### For Urgent\u002FAd-Hoc Tasks\n\n**Use GitHub Issues with `squad:machine-{name}` label:**\n\n```bash\n# Create issue\ngh issue create \\\n  --title \"GPU: Clone voice profile from sample.wav\" \\\n  --body \"Execute voice cloning on DevBox. Input: \u002Fpath\u002Fto\u002Fvoice-input.wav\" \\\n  --label \"squad:machine-devbox\" \\\n  --label \"urgent\"\n```\n\nRalph on DevBox will:\n1. Detect issue with `squad:machine-devbox` label\n2. Parse task from issue body\n3. Execute task\n4. Comment with result\n5. Close issue\n\n---\n\n## File Formats\n\n### Task File (YAML)\n\n**Location:** `.squad\u002Fcross-machine\u002Ftasks\u002F{timestamp}-{machine}-{task-id}.yaml`\n\n**Required Fields:**\n```yaml\nid: {task-id}                      # Unique identifier (alphanumeric + dash)\nsource_machine: {hostname}         # Where task was created\ntarget_machine: {hostname}         # Where task will execute\npriority: high|normal|low          # Execution priority\ncreated_at: 2026-03-14T15:30:00Z   # ISO 8601 timestamp\ntask_type: gpu_workload|script|... # Category\npayload:\n  command: \"...\"                   # Shell command to execute\n  expected_duration_min: 15        # Timeout (minutes)\n  resources:\n    gpu: true|false\n    memory_gb: 8\n    cpu_cores: 4\nstatus: pending|executing|completed|failed\n```\n\n**Optional Fields:**\n```yaml\ndescription: \"Human-readable task description\"\ntimeout_override_min: 120          # Override default timeout\nretry_count: 3                     # Retry failed tasks\n```\n\n### Result File (YAML)\n\n**Location:** `.squad\u002Fcross-machine\u002Fresults\u002F{task-id}.yaml`\n\n```yaml\nid: {task-id}                          # Links back to task\ntarget_machine: devbox                 # Executed on\ncompleted_at: 2026-03-14T15:45:00Z    # When it finished\nstatus: completed|failed|timeout       # Outcome\nexit_code: 0                           # Shell exit code\nstdout: \"...\"                          # Captured output\nstderr: \"...\"                          # Captured errors\nduration_seconds: 900                  # How long it took\nartifacts:\n  - path: \"\u002Fpath\u002Fto\u002Fartifacts\u002F...\"   # Location of results\n    type: audio|text|model|...\n    size_mb: 2.5\n```\n\n---\n\n## Security Model\n\n### Validation Pipeline\n\nAll tasks go through:\n\n1. **Schema Validation**\n   - YAML structure matches spec\n   - Required fields present\n   - No unexpected fields (reject)\n\n2. **Command Whitelist**\n   - Only approved commands allowed\n   - Path validation (no `..\u002F..\u002F` escapes)\n   - Environment variable sanitization\n   - No inline shell operators (`&&`, `|`, `>`)\n\n3. **Resource Limits**\n   - Timeout enforced (default: 60 min)\n   - Memory cap: 16GB (adjustable)\n   - CPU threads: 4 (adjustable)\n   - Disk write: 100GB (adjustable)\n\n4. **Execution Isolation**\n   - Runs as unprivileged user\n   - Temp directory cleaned after execution\n   - Network access: read-only (no outbound writes)\n\n5. **Audit Trail**\n   - All executions logged to git\n   - Commit signed with Ralph's key\n   - Result stored immutably\n\n### Threat Mitigations\n\n| Threat | Mitigation |\n|--------|-----------|\n| **Malicious task injection** | Branch protection + PR review before merge |\n| **Credential leakage** | Pre-commit secret scan + environment scrubbing |\n| **Resource exhaustion** | Timeout + memory limits |\n| **Code injection** | Command whitelist + no shell evaluation |\n| **Result tampering** | Git commit history is immutable |\n\n---\n\n## Configuration\n\nRalph reads config from `.squad\u002Fconfig.json`:\n\n```json\n{\n  \"cross_machine\": {\n    \"enabled\": true,\n    \"poll_interval_seconds\": 300,\n    \"this_machine\": \"devbox\",\n    \"max_concurrent_tasks\": 2,\n    \"task_timeout_minutes\": 60,\n    \"command_whitelist\": [\n      \"python scripts\u002Fvoice-clone.py\",\n      \"python scripts\u002Fdata-process.py\",\n      \"bash scripts\u002Fcleanup.sh\"\n    ],\n    \"result_ttl_days\": 30\n  }\n}\n```\n\n---\n\n## Examples\n\n### Example 1: GPU Voice Cloning (Laptop → DevBox)\n\n**1. Laptop creates task:**\n\n```yaml\n# .squad\u002Fcross-machine\u002Ftasks\u002F2026-03-14T1530Z-laptop-gpu-001.yaml\nid: gpu-voice-clone-001\nsource_machine: laptop-machine\ntarget_machine: devbox\npriority: high\ncreated_at: 2026-03-14T15:30:00Z\ntask_type: gpu_workload\npayload:\n  command: \"python scripts\u002Fvoice-clone.py --input voice.wav --output cloned.wav\"\n  expected_duration_min: 15\n  resources:\n    gpu: true\n    memory_gb: 8\nstatus: pending\n```\n\n**2. Laptop commits & pushes:**\n\n```bash\ngit add .squad\u002Fcross-machine\u002Ftasks\u002F\ngit commit -m \"Task: GPU voice cloning [squad:machine-devbox]\"\ngit push origin main\n```\n\n**3. DevBox Ralph (5 min later):**\n\n```\n[Ralph Watch Cycle]\n- Pulled origin\u002Fmain\n- Detected: gpu-voice-clone-001 (status: pending, target: devbox)\n- Validation: ✅ Schema OK, command whitelisted\n- Executing: python scripts\u002Fvoice-clone.py ...\n- [15 minutes of processing]\n- Completed: exit code 0\n- Writing result...\n- Committing & pushing...\n```\n\n**4. Laptop Ralph (next cycle) sees result:**\n\n```yaml\n# .squad\u002Fcross-machine\u002Fresults\u002Fgpu-voice-clone-001.yaml\nid: gpu-voice-clone-001\ntarget_machine: devbox\ncompleted_at: 2026-03-14T15:45:00Z\nstatus: completed\nexit_code: 0\nstdout: \"Voice cloning completed. Output written to \u002Ftmp\u002Fcloned.wav\"\nstderr: \"\"\nduration_seconds: 900\nartifacts:\n  - path: \"\u002Fpath\u002Fto\u002Fartifacts\u002Fvoice-clone-001\u002Foutput.wav\"\n    type: audio\n    size_mb: 2.5\n```\n\n---\n\n### Example 2: Urgent Debug Request (Human → DevBox via Issue)\n\n**Create issue:**\n\n```bash\ngh issue create \\\n  --title \"DevBox: Debug voice model failure\" \\\n  --body \"Error: Model failed to load on last run. Please check \u002Ftmp\u002Fmodel.log and report findings.\" \\\n  --label \"squad:machine-devbox\" \\\n  --label \"urgent\"\n```\n\n**DevBox Ralph detects → executes → comments:**\n\n```\n✅ Executed on devbox at 2026-03-14 15:47:00\nCommand: python scripts\u002Fdebug-model.py\n\nResult:\n------\nModel file: \u002Ftmp\u002Fmodel-v2.bin (OK)\nChecksum: a1b2c3d4e5f6 (matches expected)\nMemory available: 12 GB (sufficient)\n\nERROR FOUND: Config file permission issue\n  - File: ~\u002F.config\u002Fvoice\u002Fmodel.yaml\n  - Permissions: -rw------- (owner-only)\n  - Expected: -rw-r--r-- (world-readable for service)\n\nFIX: Run: chmod 644 ~\u002F.config\u002Fvoice\u002Fmodel.yaml\n```\n\n---\n\n## Error Handling\n\n### Task Execution Failures\n\nIf a task fails (exit code != 0):\n\n1. Result written with `status: failed` + exit code\n2. stderr captured in result\n3. Committed to git for audit\n4. Source machine can retry by re-pushing task with `status: pending`\n\n### Stalled Tasks\n\nIf a task doesn't complete within timeout:\n\n1. Process killed\n2. Result written with `status: timeout`\n3. stderr: \"Execution exceeded X minutes\"\n4. Source can investigate or retry\n\n### Network Failures\n\nIf git push\u002Fpull fails:\n\n- Ralph retries on next cycle\n- Tasks queue locally until connectivity restored\n- No tasks lost (stored in local repo)\n\n---\n\n## Monitoring & Debugging\n\n### Check Task Queue\n\n```bash\nls -la .squad\u002Fcross-machine\u002Ftasks\u002F\ncat .squad\u002Fcross-machine\u002Ftasks\u002F*.yaml | grep -E \"^(id|status|target_machine):\"\n```\n\n### Check Results\n\n```bash\nls -la .squad\u002Fcross-machine\u002Fresults\u002F\ncat .squad\u002Fcross-machine\u002Fresults\u002F{task-id}.yaml\n```\n\n### View Execution History\n\n```bash\ngit log --oneline .squad\u002Fcross-machine\u002F | head -20\n```\n\n### Monitor Ralph Cycles\n\n```bash\ntail -f .squad\u002Flog\u002Fralph-watch.log | grep \"cross-machine\"\n```\n\n---\n\n## Integration with Ralph Watch\n\nRalph automatically includes this pattern in its watch loop:\n\n```\nRalph Watch Cycle (every 5-10 min):\n1. Fetch GitHub issues with squad:machine-* labels\n2. Poll .squad\u002Fcross-machine\u002Ftasks\u002F\n3. For each matching task:\n   - Validate\n   - Execute\n   - Write result\n   - Commit & push\n4. Update status in issue (if applicable)\n5. Sleep until next cycle\n```\n\nNo manual Ralph configuration needed — just create task files or issues with the right labels.\n\n---\n\n## Migration from Manual Handoff\n\n**Before (today):**\n- Laptop → user manually copies file to Teams chat\n- user pastes into target terminal\n- user copies output back\n- user pastes result manually\n\n**After (with this pattern):**\n- Laptop Ralph writes task file → git push\n- DevBox Ralph auto-executes → git push result\n- Laptop Ralph auto-reads result\n- 0 human intervention needed\n\n---\n\n## Future Enhancements\n\nPotential expansions (Phase 2+):\n\n1. **Task Priorities:** Execution order based on priority field\n2. **Serial Pipelines:** Machine A → B → C task chains\n3. **GPU Availability Polling:** Query DevBox before submitting work\n4. **Cost Tracking:** Log resource usage per task\n5. **Notification Webhooks:** Alert on task completion\n6. **Web Dashboard:** Real-time task status visualization\n\n---\n\n## Questions?\n\nRefer to research report: `research\u002Factive\u002Fcross-machine-agents\u002FREADME.md`\n\nContact: Seven (Research & Docs) or Ralph (Work Monitor)\n","# Skill: Cross-Machine Coordination Pattern\n\n**Skill ID:** `cross-machine-coordination`  \n**Owner:** Ralph (Work Monitor)  \n**Squad Integration:** All agents  \n**Status:** Specification (ready for implementation)  \n\n---\n\n## Overview\n\nEnables squad agents running on different machines (laptop, DevBox, Azure VM) to securely share work, coordinate execution, and pass results without manual intervention.\n\n**Pattern:** Git-based task queuing + GitHub Issues supplement\n\n---\n\n## Usage\n\n### For Task Sources (Orchestrating Machine)\n\n**To assign work to DevBox:**\n\n```bash\n# Create task file\ncat > .squad\u002Fcross-machine\u002Ftasks\u002F2026-03-14T1530Z-laptop-gpu-voice-clone.yaml \u003C\u003C 'EOF'\nid: gpu-voice-clone-001\nsource_machine: laptop-machine\ntarget_machine: devbox\npriority: high\ncreated_at: 2026-03-14T15:30:00Z\ntask_type: gpu_workload\npayload:\n  command: \"python scripts\u002Fvoice-clone.py --input voice.wav --output cloned.wav\"\n  expected_duration_min: 15\n  resources:\n    gpu: true\n    memory_gb: 8\nstatus: pending\nEOF\n\n# Commit & push\ngit add .squad\u002Fcross-machine\u002Ftasks\u002F\ngit commit -m \"Cross-machine task: GPU voice cloning [squad:machine-devbox]\"\ngit push origin main\n```\n\nRalph on DevBox will:\n1. Pull the task on next cycle (5-10 min)\n2. Validate schema & command whitelist\n3. Execute the GPU workload\n4. Write result to `.squad\u002Fcross-machine\u002Fresults\u002Fgpu-voice-clone-001.yaml`\n5. Commit & push the result\n\n---\n\n### For Task Executors (DevBox, Azure VMs)\n\nRalph automatically watches `.squad\u002Fcross-machine\u002Ftasks\u002F` for work targeted at this machine.\n\n**On each cycle (5-10 min):**\n\n```python\n# Pseudo-code (Ralph implementation)\n1. git pull origin main\n2. Load all .yaml files in .squad\u002Fcross-machine\u002Ftasks\u002F\n3. Filter for status=pending AND target_machine=HOSTNAME\n4. For each task:\n   a. Validate schema (must have: id, source_machine, target_machine, payload)\n   b. Validate command against whitelist\n   c. Execute task (with timeout)\n   d. Write result to .squad\u002Fcross-machine\u002Fresults\u002F{id}.yaml\n   e. Commit & push result\n```\n\n---\n\n### For Urgent\u002FAd-Hoc Tasks\n\n**Use GitHub Issues with `squad:machine-{name}` label:**\n\n```bash\n# Create issue\ngh issue create \\\n  --title \"GPU: Clone voice profile from sample.wav\" \\\n  --body \"Execute voice cloning on DevBox. Input: \u002Fpath\u002Fto\u002Fvoice-input.wav\" \\\n  --label \"squad:machine-devbox\" \\\n  --label \"urgent\"\n```\n\nRalph on DevBox will:\n1. Detect issue with `squad:machine-devbox` label\n2. Parse task from issue body\n3. Execute task\n4. Comment with result\n5. Close issue\n\n---\n\n## File Formats\n\n### Task File (YAML)\n\n**Location:** `.squad\u002Fcross-machine\u002Ftasks\u002F{timestamp}-{machine}-{task-id}.yaml`\n\n**Required Fields:**\n```yaml\nid: {task-id}                      # Unique identifier (alphanumeric + dash)\nsource_machine: {hostname}         # Where task was created\ntarget_machine: {hostname}         # Where task will execute\npriority: high|normal|low          # Execution priority\ncreated_at: 2026-03-14T15:30:00Z   # ISO 8601 timestamp\ntask_type: gpu_workload|script|... # Category\npayload:\n  command: \"...\"                   # Shell command to execute\n  expected_duration_min: 15        # Timeout (minutes)\n  resources:\n    gpu: true|false\n    memory_gb: 8\n    cpu_cores: 4\nstatus: pending|executing|completed|failed\n```\n\n**Optional Fields:**\n```yaml\ndescription: \"Human-readable task description\"\ntimeout_override_min: 120          # Override default timeout\nretry_count: 3                     # Retry failed tasks\n```\n\n### Result File (YAML)\n\n**Location:** `.squad\u002Fcross-machine\u002Fresults\u002F{task-id}.yaml`\n\n```yaml\nid: {task-id}                          # Links back to task\ntarget_machine: devbox                 # Executed on\ncompleted_at: 2026-03-14T15:45:00Z    # When it finished\nstatus: completed|failed|timeout       # Outcome\nexit_code: 0                           # Shell exit code\nstdout: \"...\"                          # Captured output\nstderr: \"...\"                          # Captured errors\nduration_seconds: 900                  # How long it took\nartifacts:\n  - path: \"\u002Fpath\u002Fto\u002Fartifacts\u002F...\"   # Location of results\n    type: audio|text|model|...\n    size_mb: 2.5\n```\n\n---\n\n## Security Model\n\n### Validation Pipeline\n\nAll tasks go through:\n\n1. **Schema Validation**\n   - YAML structure matches spec\n   - Required fields present\n   - No unexpected fields (reject)\n\n2. **Command Whitelist**\n   - Only approved commands allowed\n   - Path validation (no `..\u002F..\u002F` escapes)\n   - Environment variable sanitization\n   - No inline shell operators (`&&`, `|`, `>`)\n\n3. **Resource Limits**\n   - Timeout enforced (default: 60 min)\n   - Memory cap: 16GB (adjustable)\n   - CPU threads: 4 (adjustable)\n   - Disk write: 100GB (adjustable)\n\n4. **Execution Isolation**\n   - Runs as unprivileged user\n   - Temp directory cleaned after execution\n   - Network access: read-only (no outbound writes)\n\n5. **Audit Trail**\n   - All executions logged to git\n   - Commit signed with Ralph's key\n   - Result stored immutably\n\n### Threat Mitigations\n\n| Threat | Mitigation |\n|--------|-----------|\n| **Malicious task injection** | Branch protection + PR review before merge |\n| **Credential leakage** | Pre-commit secret scan + environment scrubbing |\n| **Resource exhaustion** | Timeout + memory limits |\n| **Code injection** | Command whitelist + no shell evaluation |\n| **Result tampering** | Git commit history is immutable |\n\n---\n\n## Configuration\n\nRalph reads config from `.squad\u002Fconfig.json`:\n\n```json\n{\n  \"cross_machine\": {\n    \"enabled\": true,\n    \"poll_interval_seconds\": 300,\n    \"this_machine\": \"devbox\",\n    \"max_concurrent_tasks\": 2,\n    \"task_timeout_minutes\": 60,\n    \"command_whitelist\": [\n      \"python scripts\u002Fvoice-clone.py\",\n      \"python scripts\u002Fdata-process.py\",\n      \"bash scripts\u002Fcleanup.sh\"\n    ],\n    \"result_ttl_days\": 30\n  }\n}\n```\n\n---\n\n## Examples\n\n### Example 1: GPU Voice Cloning (Laptop → DevBox)\n\n**1. Laptop creates task:**\n\n```yaml\n# .squad\u002Fcross-machine\u002Ftasks\u002F2026-03-14T1530Z-laptop-gpu-001.yaml\nid: gpu-voice-clone-001\nsource_machine: laptop-machine\ntarget_machine: devbox\npriority: high\ncreated_at: 2026-03-14T15:30:00Z\ntask_type: gpu_workload\npayload:\n  command: \"python scripts\u002Fvoice-clone.py --input voice.wav --output cloned.wav\"\n  expected_duration_min: 15\n  resources:\n    gpu: true\n    memory_gb: 8\nstatus: pending\n```\n\n**2. Laptop commits & pushes:**\n\n```bash\ngit add .squad\u002Fcross-machine\u002Ftasks\u002F\ngit commit -m \"Task: GPU voice cloning [squad:machine-devbox]\"\ngit push origin main\n```\n\n**3. DevBox Ralph (5 min later):**\n\n```\n[Ralph Watch Cycle]\n- Pulled origin\u002Fmain\n- Detected: gpu-voice-clone-001 (status: pending, target: devbox)\n- Validation: ✅ Schema OK, command whitelisted\n- Executing: python scripts\u002Fvoice-clone.py ...\n- [15 minutes of processing]\n- Completed: exit code 0\n- Writing result...\n- Committing & pushing...\n```\n\n**4. Laptop Ralph (next cycle) sees result:**\n\n```yaml\n# .squad\u002Fcross-machine\u002Fresults\u002Fgpu-voice-clone-001.yaml\nid: gpu-voice-clone-001\ntarget_machine: devbox\ncompleted_at: 2026-03-14T15:45:00Z\nstatus: completed\nexit_code: 0\nstdout: \"Voice cloning completed. Output written to \u002Ftmp\u002Fcloned.wav\"\nstderr: \"\"\nduration_seconds: 900\nartifacts:\n  - path: \"\u002Fpath\u002Fto\u002Fartifacts\u002Fvoice-clone-001\u002Foutput.wav\"\n    type: audio\n    size_mb: 2.5\n```\n\n---\n\n### Example 2: Urgent Debug Request (Human → DevBox via Issue)\n\n**Create issue:**\n\n```bash\ngh issue create \\\n  --title \"DevBox: Debug voice model failure\" \\\n  --body \"Error: Model failed to load on last run. Please check \u002Ftmp\u002Fmodel.log and report findings.\" \\\n  --label \"squad:machine-devbox\" \\\n  --label \"urgent\"\n```\n\n**DevBox Ralph detects → executes → comments:**\n\n```\n✅ Executed on devbox at 2026-03-14 15:47:00\nCommand: python scripts\u002Fdebug-model.py\n\nResult:\n------\nModel file: \u002Ftmp\u002Fmodel-v2.bin (OK)\nChecksum: a1b2c3d4e5f6 (matches expected)\nMemory available: 12 GB (sufficient)\n\nERROR FOUND: Config file permission issue\n  - File: ~\u002F.config\u002Fvoice\u002Fmodel.yaml\n  - Permissions: -rw------- (owner-only)\n  - Expected: -rw-r--r-- (world-readable for service)\n\nFIX: Run: chmod 644 ~\u002F.config\u002Fvoice\u002Fmodel.yaml\n```\n\n---\n\n## Error Handling\n\n### Task Execution Failures\n\nIf a task fails (exit code != 0):\n\n1. Result written with `status: failed` + exit code\n2. stderr captured in result\n3. Committed to git for audit\n4. Source machine can retry by re-pushing task with `status: pending`\n\n### Stalled Tasks\n\nIf a task doesn't complete within timeout:\n\n1. Process killed\n2. Result written with `status: timeout`\n3. stderr: \"Execution exceeded X minutes\"\n4. Source can investigate or retry\n\n### Network Failures\n\nIf git push\u002Fpull fails:\n\n- Ralph retries on next cycle\n- Tasks queue locally until connectivity restored\n- No tasks lost (stored in local repo)\n\n---\n\n## Monitoring & Debugging\n\n### Check Task Queue\n\n```bash\nls -la .squad\u002Fcross-machine\u002Ftasks\u002F\ncat .squad\u002Fcross-machine\u002Ftasks\u002F*.yaml | grep -E \"^(id|status|target_machine):\"\n```\n\n### Check Results\n\n```bash\nls -la .squad\u002Fcross-machine\u002Fresults\u002F\ncat .squad\u002Fcross-machine\u002Fresults\u002F{task-id}.yaml\n```\n\n### View Execution History\n\n```bash\ngit log --oneline .squad\u002Fcross-machine\u002F | head -20\n```\n\n### Monitor Ralph Cycles\n\n```bash\ntail -f .squad\u002Flog\u002Fralph-watch.log | grep \"cross-machine\"\n```\n\n---\n\n## Integration with Ralph Watch\n\nRalph automatically includes this pattern in its watch loop:\n\n```\nRalph Watch Cycle (every 5-10 min):\n1. Fetch GitHub issues with squad:machine-* labels\n2. Poll .squad\u002Fcross-machine\u002Ftasks\u002F\n3. For each matching task:\n   - Validate\n   - Execute\n   - Write result\n   - Commit & push\n4. Update status in issue (if applicable)\n5. Sleep until next cycle\n```\n\nNo manual Ralph configuration needed — just create task files or issues with the right labels.\n\n---\n\n## Migration from Manual Handoff\n\n**Before (today):**\n- Laptop → user manually copies file to Teams chat\n- user pastes into target terminal\n- user copies output back\n- user pastes result manually\n\n**After (with this pattern):**\n- Laptop Ralph writes task file → git push\n- DevBox Ralph auto-executes → git push result\n- Laptop Ralph auto-reads result\n- 0 human intervention needed\n\n---\n\n## Future Enhancements\n\nPotential expansions (Phase 2+):\n\n1. **Task Priorities:** Execution order based on priority field\n2. **Serial Pipelines:** Machine A → B → C task chains\n3. **GPU Availability Polling:** Query DevBox before submitting work\n4. **Cost Tracking:** Log resource usage per task\n5. **Notification Webhooks:** Alert on task completion\n6. **Web Dashboard:** Real-time task status visualization\n\n---\n\n## Questions?\n\nRefer to research report: `research\u002Factive\u002Fcross-machine-agents\u002FREADME.md`\n\nContact: Seven (Research & Docs) or Ralph (Work Monitor)\n",{"name":5,"domain":22,"source":29,"confidence":35,"description":7},"medium","main","8541229759617347888641eba917d3b0ad66a984",".squad\u002Ftemplates\u002Fskills\u002Fcross-machine-coordination",626,"https:\u002F\u002Fgithub.com\u002Fgithub\u002Fgh-aw","https:\u002F\u002Fgh.io\u002Fgh-aw","https:\u002F\u002Fgithub.com\u002Fgithub","https:\u002F\u002Fgithub.com\u002Fabout","How people build software.","2026-11-15 06:45:15",{"source":8,"skillName":5,"commands":47,"prompt":57,"zipAvailable":58},[48,51,54],{"tool":49,"command":50},"npx","npx skills add github\u002Fgh-aw --skill cross-machine-coordination",{"tool":52,"command":53},"bunx","bunx skills add github\u002Fgh-aw --skill cross-machine-coordination",{"tool":55,"command":56},"pnpm","pnpm dlx skills add github\u002Fgh-aw --skill cross-machine-coordination","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fgithub\u002Fgh-aw\u002Fblob\u002Fmain\u002F.squad\u002Ftemplates\u002Fskills\u002Fcross-machine-coordination\u002FSKILL.md",true,[],[61,69,77,106,123,147],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":68},"01M7DQYVZ9W9DDXKQ9452SNP8J","cracktro","Edit, preview, and verify the standalone interactive talk deck in docs\u002Fpublic\u002Fcracktro (slides, SVG diagrams, transitions, WebAudio sound).","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fgh-aw\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fcracktro\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":76},"01M7612HQ4378TK8QZ5HPAF4KR","create-connector","Create or extend a declaration-only third-party connector, with narrow reads, separate safe outputs, optional protected triggers, and offline conformance evidence.","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fgh-aw\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fcreate-connector\u002FSKILL.md",[],[],"2026-11-12 13:55:43",{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":91,"publishedAt":30},"01M6ADC942STTXHFV410J4DH0X","GitHub Agentic Workflows","GitHub Agentic Workflows (`gh-aw`) is a GitHub CLI extension for writing Agentic Workflows in markdown and compiling them to GitHub Actions.","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fgh-aw\u002Fblob\u002Fmain\u002FSKILL.md",[83,88],{"categoryNo":84,"categoryName":85,"taxonomyType":86,"taxonomyTypeDesc":87},"01JBSEEDCAT000000000000011","运维与部署","SCENARIO","使用场景",{"categoryNo":89,"categoryName":90,"taxonomyType":86,"taxonomyTypeDesc":87},"01JBSEEDCAT000000000000023","Skill与智能体开发",[9,92,93,94,95,96,97,98,99,100,101,102,103,104,105],"github agentic workflows","agentic workflows","workflows","agentic","extension","markdown","github cli","cli","gh","for","compiling","writing","github actions","actions",{"skillNo":107,"name":108,"nameZh":6,"description":109,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":110,"categories":111,"keywords":112,"publishedAt":30},"01M6ADC6ZXSA46N9XD6VNAP1MS","windows-compatibility","Cross-platform path handling and command patterns","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fgh-aw\u002Fblob\u002Fmain\u002F.squad\u002Ftemplates\u002Fskills\u002Fwindows-compatibility\u002FSKILL.md",[],[113,114,115,116,24,117,118,119,120,121,122],"windows","windows compatibility","compatibility","command","bugs","platform","high","patterns","cross-platform","path",{"skillNo":124,"name":125,"nameZh":6,"description":126,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":127,"categories":128,"keywords":129,"publishedAt":30},"01M6ADC44957SVQF96R5YY247P","versioning-policy","Semver versioning rules for Squad SDK and CLI — prevents prerelease version incidents","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fgh-aw\u002Fblob\u002Fmain\u002F.squad\u002Ftemplates\u002Fskills\u002Fversioning-policy\u002FSKILL.md",[],[130,131,132,133,134,99,135,136,137,138,139,140,141,23,101,142,143,144,145,146],"versioning","policy","versioning policy","gate","implementation","workspace","pr","sdk","release","ci","npm","semver","incident","incidents","Rules","version","resolution",{"skillNo":148,"name":149,"nameZh":6,"description":150,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":151,"categories":152,"keywords":157,"publishedAt":30},"01M6ADC1PHMEAEVR87F8PDR89X","tiered-memory","Three-tier agent memory model (hot\u002Fcold\u002Fwiki) for context reduction per spawn","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fgh-aw\u002Fblob\u002Fmain\u002F.squad\u002Ftemplates\u002Fskills\u002Ftiered-memory\u002FSKILL.md",[153,156],{"categoryNo":154,"categoryName":155,"taxonomyType":86,"taxonomyTypeDesc":87},"01JBSEEDCAT000000000000015","视觉设计",{"categoryNo":89,"categoryName":90,"taxonomyType":86,"taxonomyTypeDesc":87},[158,159,160,161,162,163,164,165,166,167,168,169,170,101,171,172],"tiered memory","memory","performance","design","agent memory","proposal","cold","model","wiki","spawn","memory-management","context","three","runtime","management"]