[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M76716BEVBW7HQWHPGWG2FYY":3,"skill-same:01M76716BEVBW7HQWHPGWG2FYY":51},{"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":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":27,"commitSha":28,"skillDirectory":29,"forksCount":30,"repositoryHtmlUrl":31,"repositoryHomepageUrl":32,"ownerHtmlUrl":33,"ownerBlogUrl":34,"ownerDescription":35,"updatedAt":36,"install":37,"resources":50},"01M76716BEVBW7HQWHPGWG2FYY","cross-machine-coordination",null,"Design proposal, not implemented: git-based task queuing between squad machines. For competing watchers, use squad watch work claims (ADR-002).","github\u002Fsquad","github","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F9919?v=4","01M6AC83DS133TPXFSP1DHNCC6","GitHub","01M6X0MZ6B0WYMMDPK3Q61KER6",3391,"MIT","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fsquad\u002Fblob\u002Fdev\u002Fplugins\u002Fsquad\u002Fskills\u002Fcross-machine-coordination\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: \"cross-machine-coordination\"\ndescription: \"Design proposal, not implemented: git-based task queuing between squad machines. For competing watchers, use squad watch work claims (ADR-002).\"\ndomain: \"orchestration\"\nconfidence: \"low\"\nsource: \"manual\"\n---\n\u003C!-- Generated by Squad from the Squad SDK (claude-plugin.ts). Do not edit: run `node scripts\u002Fbuild-claude-plugin.mjs`. -->\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:** Design proposal — NOT implemented\n\n> ⚠️ **Not implemented.** No Squad release reads `.squad\u002Fcross-machine\u002F`,\n> the `cross_machine` config block, or `squad:machine-{name}` labels. Ralph\n> and `squad watch` do not poll task files, run whitelisted commands, or\n> write result files. Everything below describes a proposed design, not\n> current behavior. Do not tell users it works, and do not create task files\n> expecting another machine to pick them up.\n>\n> **Use these instead:**\n>\n> - **Several machines or pods running `squad watch --execute` on one\n>   repository:** enable work claims (`squad watch --execute --claims\n>   git-ref`, or `watch.claims` in `.squad\u002Fconfig.json`). Claims are Git-ref\n>   leases that make sure only one watcher works on each issue. See ADR-002\n>   (`docs\u002Fspecification\u002Fadr-002-work-claims-and-external-queues.md`) and the\n>   \"Multi-Machine Watch with Work Claims\" docs scenario\n>   (`docs\u002Fsrc\u002Fcontent\u002Fdocs\u002Fscenarios\u002Fmulti-machine-watch.md`).\n> - **Sending work to a machine with specific hardware:** use capability\n>   routing with `needs:*` issue labels and a machine capabilities file.\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\nIn this proposal (not implemented), Ralph on DevBox would:\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\nIn this proposal (not implemented), Ralph would watch `.squad\u002Fcross-machine\u002Ftasks\u002F` for work targeted at this machine. Ralph does not do this today.\n\n**On each cycle (5-10 min), as proposed:**\n\n```python\n# Pseudo-code (proposed Ralph implementation; does not exist)\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\nIn this proposal (not implemented), Ralph on DevBox would:\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\nProposed `.squad\u002Fconfig.json` block. No Squad release reads it:\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\nNot implemented: `squad watch` does not include this pattern. The proposed watch loop was:\n\n```\nProposed Ralph 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\nUntil this is built, task files and `squad:machine-*` labels do nothing. To stop several watchers from picking the same issue, use work claims (`--claims git-ref`, ADR-002).\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 (if this proposal is built):**\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: the research and documentation owner or Ralph (Work Monitor)\n","\u003C!-- Generated by Squad from the Squad SDK (claude-plugin.ts). Do not edit: run `node scripts\u002Fbuild-claude-plugin.mjs`. -->\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:** Design proposal — NOT implemented\n\n> ⚠️ **Not implemented.** No Squad release reads `.squad\u002Fcross-machine\u002F`,\n> the `cross_machine` config block, or `squad:machine-{name}` labels. Ralph\n> and `squad watch` do not poll task files, run whitelisted commands, or\n> write result files. Everything below describes a proposed design, not\n> current behavior. Do not tell users it works, and do not create task files\n> expecting another machine to pick them up.\n>\n> **Use these instead:**\n>\n> - **Several machines or pods running `squad watch --execute` on one\n>   repository:** enable work claims (`squad watch --execute --claims\n>   git-ref`, or `watch.claims` in `.squad\u002Fconfig.json`). Claims are Git-ref\n>   leases that make sure only one watcher works on each issue. See ADR-002\n>   (`docs\u002Fspecification\u002Fadr-002-work-claims-and-external-queues.md`) and the\n>   \"Multi-Machine Watch with Work Claims\" docs scenario\n>   (`docs\u002Fsrc\u002Fcontent\u002Fdocs\u002Fscenarios\u002Fmulti-machine-watch.md`).\n> - **Sending work to a machine with specific hardware:** use capability\n>   routing with `needs:*` issue labels and a machine capabilities file.\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\nIn this proposal (not implemented), Ralph on DevBox would:\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\nIn this proposal (not implemented), Ralph would watch `.squad\u002Fcross-machine\u002Ftasks\u002F` for work targeted at this machine. Ralph does not do this today.\n\n**On each cycle (5-10 min), as proposed:**\n\n```python\n# Pseudo-code (proposed Ralph implementation; does not exist)\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\nIn this proposal (not implemented), Ralph on DevBox would:\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\nProposed `.squad\u002Fconfig.json` block. No Squad release reads it:\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\nNot implemented: `squad watch` does not include this pattern. The proposed watch loop was:\n\n```\nProposed Ralph 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\nUntil this is built, task files and `squad:machine-*` labels do nothing. To stop several watchers from picking the same issue, use work claims (`--claims git-ref`, ADR-002).\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 (if this proposal is built):**\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: the research and documentation owner or Ralph (Work Monitor)\n",{"name":5,"domain":24,"source":25,"confidence":26,"description":7},"orchestration","manual","low","dev","699589d781f9d9dbb6d8b8c6214c93dc7b828dbd","plugins\u002Fsquad\u002Fskills\u002Fcross-machine-coordination",520,"https:\u002F\u002Fgithub.com\u002Fgithub\u002Fsquad","https:\u002F\u002Fgithub.github.io\u002Fsquad\u002F","https:\u002F\u002Fgithub.com\u002Fgithub","https:\u002F\u002Fgithub.com\u002Fabout","How people build software.","2026-11-15 02:13:59",{"source":8,"skillName":5,"commands":38,"prompt":48,"zipAvailable":49},[39,42,45],{"tool":40,"command":41},"npx","npx skills add github\u002Fsquad --skill cross-machine-coordination",{"tool":43,"command":44},"bunx","bunx skills add github\u002Fsquad --skill cross-machine-coordination",{"tool":46,"command":47},"pnpm","pnpm dlx skills add github\u002Fsquad --skill cross-machine-coordination","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fgithub\u002Fsquad\u002Fblob\u002Fdev\u002Fplugins\u002Fsquad\u002Fskills\u002Fcross-machine-coordination\u002FSKILL.md",true,[],[52,59,66,73,80,87],{"skillNo":53,"name":54,"nameZh":6,"description":55,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":56,"categories":57,"keywords":58,"publishedAt":19},"01M76752CVNE7K6NWD59CRAYNJ","windows-compatibility","Cross-platform path handling and command patterns","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fsquad\u002Fblob\u002Fdev\u002Fplugins\u002Fsquad\u002Fskills\u002Fwindows-compatibility\u002FSKILL.md",[],[],{"skillNo":60,"name":61,"nameZh":6,"description":62,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":19},"01M767508W8A4G83NX1FKEW5VN","versioning-policy","SemVer rules for Squad's stable, preview, insider, and local package versions","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fsquad\u002Fblob\u002Fdev\u002Fplugins\u002Fsquad\u002Fskills\u002Fversioning-policy\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M7674X5JJKNJ74B3SS8PGXG2","tiered-memory","Three-tier agent memory model (hot\u002Fcold\u002Fwiki) for context reduction per spawn","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fsquad\u002Fblob\u002Fdev\u002Fplugins\u002Fsquad\u002Fskills\u002Ftiered-memory\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M7674V3S9H03A76H75M1KSAF","test-discipline","Design assertions that prove the actual contract and fail on realistic regressions","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fsquad\u002Fblob\u002Fdev\u002Fplugins\u002Fsquad\u002Fskills\u002Ftest-discipline\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M7674QB8CA61RNDX2Z0NAK71","squad","Squad's command catalog and interactive menu. Invoke via \u002Fsquad (slash command) or natural language (\"squad commands\", \"what can squad do\", \"show me squad options\"). Presents categorized operations (Install & Upgrade, Team Management, Issues & PRs, Plugins & Skills, Model & Cost, Sessions & State) as an interactive picker. Routes to the right squad CLI command or the Squad coordinator agent.","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fsquad\u002Fblob\u002Fdev\u002Fplugins\u002Fsquad\u002Fskills\u002Fsquad\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":19},"01M7674KTQ632N30HQB1TP7TXH","squad-version-check","Internals of how @bradygaster\u002Fsquad-cli stamps its version, how `squad upgrade` works (what it preserves vs overwrites), and how to probe the npm registry for the latest version from a coordinator prompt.","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fsquad\u002Fblob\u002Fdev\u002Fplugins\u002Fsquad\u002Fskills\u002Fsquad-version-check\u002FSKILL.md",[],[]]