[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6X132PEH32WA0JWENGD9513":3,"skill-same:01M6X132PEH32WA0JWENGD9513":54},{"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":22,"linkOnly":23,"markdownContent":24,"markdownBody":25,"frontMatter":26,"refName":30,"commitSha":31,"skillDirectory":32,"forksCount":33,"repositoryHtmlUrl":34,"repositoryHomepageUrl":35,"ownerHtmlUrl":36,"ownerBlogUrl":37,"ownerDescription":38,"updatedAt":39,"install":40,"resources":53},"01M6X132PEH32WA0JWENGD9513","retro-enforcement",null,"Keep retrospectives on schedule and track their action items as GitHub Issues, not markdown checklists","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\u002F.squad-templates\u002Fskills\u002Fretro-enforcement\u002FSKILL.md",[],[19,20,21],"enforcement","retro enforcement","retro","2026-11-10 10:12:30",false,"---\nname: \"retro-enforcement\"\ndescription: \"Keep retrospectives on schedule and track their action items as GitHub Issues, not markdown checklists\"\ndomain: \"process\"\nconfidence: \"high\"\nsource: \"team-decision\"\n---\n\n# Skill: Retro Enforcement\n\n## Purpose\n\nEnsure retrospectives happen on schedule and that their action items are tracked in GitHub Issues — not markdown checklists.\n\nThis skill addresses a specific, measured failure mode: **0% completion rate on markdown retro action items across 6 consecutive retrospectives**. GitHub Issues have an 85%+ completion rate in the same squad. The format was the problem, not the people.\n\n## Core Function: Test-RetroOverdue\n\n```powershell\nfunction Test-RetroOverdue {\n    param(\n        [string]$LogDir    = \".squad\u002Flog\",\n        [int]$WindowDays   = 7,\n        [string]$Pattern   = \"*retrospective*\"\n    )\n\n    $cutoff = (Get-Date).AddDays(-$WindowDays)\n\n    $retroLogs = Get-ChildItem -Path $LogDir -Filter $Pattern -ErrorAction SilentlyContinue |\n                 Where-Object { $_.LastWriteTime -ge $cutoff }\n\n    return ($retroLogs.Count -eq 0)\n}\n```\n\n### Returns\n- `$true` — No retro log found within the window. **Retro is overdue. Block other work.**\n- `$false` — At least one retro log found within the window. Proceed normally.\n\n### Detection Logic\n\nThe function checks `.squad\u002Flog\u002F` for any file matching `*retrospective*` dated within the last `$WindowDays` days (default: 7). If none is found, the retro is overdue.\n\n**File naming convention:** `.squad\u002Flog\u002F{ISO8601-timestamp}-retrospective.md`\n\nExample: `.squad\u002Flog\u002F2026-03-24T14-45-00Z-retrospective.md`\n\n## Coordinator Integration\n\nCall `Test-RetroOverdue` **at the start of every round**, before building the work queue.\n\n```powershell\n# At round start — before any work queue construction\nif (Test-RetroOverdue -LogDir \".squad\u002Flog\" -WindowDays 7) {\n    Write-Host \"[RETROSPECTIVE] Retrospective overdue. Running before other work.\"\n\n    # Spawn retro facilitator\n    Invoke-RetroSession -Mode \"catch-up\"\n\n    # Wait for retro log to be written\n    # Then resume normal round\n}\n\n# Proceed with normal work queue\n$workQueue = Get-PendingIssues | Sort-Object -Property Priority\n```\n\n### Blocking Semantics\n\nWhen `Test-RetroOverdue` returns `$true`:\n\n1. **Do not start any other work** until the retro completes\n2. **Spawn the facilitator agent** (Scribe or designated) with retro mode\n3. **Wait for the log file** to be written to `.squad\u002Flog\u002F`\n4. **Verify action items** were created as GitHub Issues (not markdown)\n5. **Resume normal round** after retro log confirmed\n\n## Action Item Enforcement\n\nEvery retro action item MUST become a GitHub Issue. The facilitator agent is responsible for this. The coordinator verifies.\n\n### Verification Check\n\n```powershell\nfunction Test-RetroActionItemsCreated {\n    param([string]$RetroLogPath)\n\n    $content = Get-Content $RetroLogPath -Raw\n\n    # Check for Issue references (e.g., #1478, https:\u002F\u002Fgithub.com\u002F...\u002Fissues\u002F1478)\n    $issueRefs = [regex]::Matches($content, '(?:#\\d{3,}|issues\u002F\\d{3,})')\n\n    # Check for unclosed markdown checkboxes (bad pattern)\n    $openCheckboxes = [regex]::Matches($content, '- \\[ \\]')\n\n    if ($openCheckboxes.Count -gt 0) {\n        Write-Warning \"[RETROSPECTIVE] Found $($openCheckboxes.Count) markdown checkboxes — convert to Issues\"\n        return $false\n    }\n\n    return ($issueRefs.Count -gt 0)\n}\n```\n\n### Why Not Markdown Checklists\n\nFrom production data in tamirdresher\u002Ftamresearch1:\n\n| Retro | Action Items Format | Completion |\n|-------|---------------------|------------|\n| 2025-12-05 | Markdown `- [ ]` | 0\u002F4 = **0%** |\n| 2025-12-19 | Markdown `- [ ]` | 0\u002F3 = **0%** |\n| 2026-01-09 | Markdown `- [ ]` | 0\u002F5 = **0%** |\n| 2026-01-23 | Markdown `- [ ]` | 0\u002F4 = **0%** |\n| 2026-02-07 | Markdown `- [ ]` | 0\u002F3 = **0%** |\n| 2026-02-21 | Markdown `- [ ]` | 0\u002F4 = **0%** |\n| 2026-03-24 | GitHub Issues | 4\u002F4 = **100%** (after enforcement) |\n\n**Root cause:** Markdown checklists have no assignee, no notifications, no close event, and no query surface. They are invisible to every workflow that drives completion.\n\n## Cadence Enforcement\n\n### Recommended schedule\n- Weekly squads: window = 7 days\n- Bi-weekly squads: window = 14 days\n\n### Ralph integration example\n\n```powershell\n# ralph-watch.ps1 — round start hook\nfunction Invoke-RoundStart {\n    # 1. Always check retro first\n    if (Test-RetroOverdue -LogDir \"$RepoRoot\u002F.squad\u002Flog\" -WindowDays 7) {\n        Write-Host \"[RALPH] Retro overdue — enforcing before work queue\"\n        Invoke-RetroSession\n        return  # Re-enter round after retro completes\n    }\n\n    # 2. Normal work queue\n    $issues = Get-ReadyIssues\n    foreach ($issue in $issues) {\n        Invoke-WorkItem -Issue $issue\n    }\n}\n```\n\n## Skill Metadata\n\n| Field | Value |\n|-------|-------|\n| **Skill ID** | `retro-enforcement` |\n| **Category** | Ceremonies \u002F Process |\n| **Trigger** | Coordinator round start |\n| **Dependencies** | `.squad\u002Flog\u002F` directory, GitHub Issues API |\n| **Tested in** | tamirdresher\u002Ftamresearch1 (production, March 2026) |\n| **Outcome** | Retro cadence restored; action item completion 0% → 100% |\n","# Skill: Retro Enforcement\n\n## Purpose\n\nEnsure retrospectives happen on schedule and that their action items are tracked in GitHub Issues — not markdown checklists.\n\nThis skill addresses a specific, measured failure mode: **0% completion rate on markdown retro action items across 6 consecutive retrospectives**. GitHub Issues have an 85%+ completion rate in the same squad. The format was the problem, not the people.\n\n## Core Function: Test-RetroOverdue\n\n```powershell\nfunction Test-RetroOverdue {\n    param(\n        [string]$LogDir    = \".squad\u002Flog\",\n        [int]$WindowDays   = 7,\n        [string]$Pattern   = \"*retrospective*\"\n    )\n\n    $cutoff = (Get-Date).AddDays(-$WindowDays)\n\n    $retroLogs = Get-ChildItem -Path $LogDir -Filter $Pattern -ErrorAction SilentlyContinue |\n                 Where-Object { $_.LastWriteTime -ge $cutoff }\n\n    return ($retroLogs.Count -eq 0)\n}\n```\n\n### Returns\n- `$true` — No retro log found within the window. **Retro is overdue. Block other work.**\n- `$false` — At least one retro log found within the window. Proceed normally.\n\n### Detection Logic\n\nThe function checks `.squad\u002Flog\u002F` for any file matching `*retrospective*` dated within the last `$WindowDays` days (default: 7). If none is found, the retro is overdue.\n\n**File naming convention:** `.squad\u002Flog\u002F{ISO8601-timestamp}-retrospective.md`\n\nExample: `.squad\u002Flog\u002F2026-03-24T14-45-00Z-retrospective.md`\n\n## Coordinator Integration\n\nCall `Test-RetroOverdue` **at the start of every round**, before building the work queue.\n\n```powershell\n# At round start — before any work queue construction\nif (Test-RetroOverdue -LogDir \".squad\u002Flog\" -WindowDays 7) {\n    Write-Host \"[RETROSPECTIVE] Retrospective overdue. Running before other work.\"\n\n    # Spawn retro facilitator\n    Invoke-RetroSession -Mode \"catch-up\"\n\n    # Wait for retro log to be written\n    # Then resume normal round\n}\n\n# Proceed with normal work queue\n$workQueue = Get-PendingIssues | Sort-Object -Property Priority\n```\n\n### Blocking Semantics\n\nWhen `Test-RetroOverdue` returns `$true`:\n\n1. **Do not start any other work** until the retro completes\n2. **Spawn the facilitator agent** (Scribe or designated) with retro mode\n3. **Wait for the log file** to be written to `.squad\u002Flog\u002F`\n4. **Verify action items** were created as GitHub Issues (not markdown)\n5. **Resume normal round** after retro log confirmed\n\n## Action Item Enforcement\n\nEvery retro action item MUST become a GitHub Issue. The facilitator agent is responsible for this. The coordinator verifies.\n\n### Verification Check\n\n```powershell\nfunction Test-RetroActionItemsCreated {\n    param([string]$RetroLogPath)\n\n    $content = Get-Content $RetroLogPath -Raw\n\n    # Check for Issue references (e.g., #1478, https:\u002F\u002Fgithub.com\u002F...\u002Fissues\u002F1478)\n    $issueRefs = [regex]::Matches($content, '(?:#\\d{3,}|issues\u002F\\d{3,})')\n\n    # Check for unclosed markdown checkboxes (bad pattern)\n    $openCheckboxes = [regex]::Matches($content, '- \\[ \\]')\n\n    if ($openCheckboxes.Count -gt 0) {\n        Write-Warning \"[RETROSPECTIVE] Found $($openCheckboxes.Count) markdown checkboxes — convert to Issues\"\n        return $false\n    }\n\n    return ($issueRefs.Count -gt 0)\n}\n```\n\n### Why Not Markdown Checklists\n\nFrom production data in tamirdresher\u002Ftamresearch1:\n\n| Retro | Action Items Format | Completion |\n|-------|---------------------|------------|\n| 2025-12-05 | Markdown `- [ ]` | 0\u002F4 = **0%** |\n| 2025-12-19 | Markdown `- [ ]` | 0\u002F3 = **0%** |\n| 2026-01-09 | Markdown `- [ ]` | 0\u002F5 = **0%** |\n| 2026-01-23 | Markdown `- [ ]` | 0\u002F4 = **0%** |\n| 2026-02-07 | Markdown `- [ ]` | 0\u002F3 = **0%** |\n| 2026-02-21 | Markdown `- [ ]` | 0\u002F4 = **0%** |\n| 2026-03-24 | GitHub Issues | 4\u002F4 = **100%** (after enforcement) |\n\n**Root cause:** Markdown checklists have no assignee, no notifications, no close event, and no query surface. They are invisible to every workflow that drives completion.\n\n## Cadence Enforcement\n\n### Recommended schedule\n- Weekly squads: window = 7 days\n- Bi-weekly squads: window = 14 days\n\n### Ralph integration example\n\n```powershell\n# ralph-watch.ps1 — round start hook\nfunction Invoke-RoundStart {\n    # 1. Always check retro first\n    if (Test-RetroOverdue -LogDir \"$RepoRoot\u002F.squad\u002Flog\" -WindowDays 7) {\n        Write-Host \"[RALPH] Retro overdue — enforcing before work queue\"\n        Invoke-RetroSession\n        return  # Re-enter round after retro completes\n    }\n\n    # 2. Normal work queue\n    $issues = Get-ReadyIssues\n    foreach ($issue in $issues) {\n        Invoke-WorkItem -Issue $issue\n    }\n}\n```\n\n## Skill Metadata\n\n| Field | Value |\n|-------|-------|\n| **Skill ID** | `retro-enforcement` |\n| **Category** | Ceremonies \u002F Process |\n| **Trigger** | Coordinator round start |\n| **Dependencies** | `.squad\u002Flog\u002F` directory, GitHub Issues API |\n| **Tested in** | tamirdresher\u002Ftamresearch1 (production, March 2026) |\n| **Outcome** | Retro cadence restored; action item completion 0% → 100% |\n",{"name":5,"domain":27,"source":28,"confidence":29,"description":7},"process","team-decision","high","dev","f229547fbcf4ca60c4524c5a69ef26d1924b7023",".squad-templates\u002Fskills\u002Fretro-enforcement",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":41,"prompt":51,"zipAvailable":52},[42,45,48],{"tool":43,"command":44},"npx","npx skills add github\u002Fsquad --skill retro-enforcement",{"tool":46,"command":47},"bunx","bunx skills add github\u002Fsquad --skill retro-enforcement",{"tool":49,"command":50},"pnpm","pnpm dlx skills add github\u002Fsquad --skill retro-enforcement","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fgithub\u002Fsquad\u002Fblob\u002Fdev\u002F.squad-templates\u002Fskills\u002Fretro-enforcement\u002FSKILL.md",true,[],[55,63,70,77,84,91],{"skillNo":56,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":62},"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",[],[],"2026-11-12 13:55:43",{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":62},"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":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":62},"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":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":83,"publishedAt":62},"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":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":62},"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":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":97,"publishedAt":62},"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",[],[]]