[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6AD958Z2HQTM5KHT5MB37BY":3,"skill-same:01M6AD958Z2HQTM5KHT5MB37BY":72},{"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":39,"linkOnly":40,"markdownContent":41,"markdownBody":42,"frontMatter":43,"refName":48,"commitSha":49,"skillDirectory":50,"forksCount":51,"repositoryHtmlUrl":52,"repositoryHomepageUrl":53,"ownerHtmlUrl":54,"ownerBlogUrl":55,"ownerDescription":56,"updatedAt":57,"install":58,"resources":71},"01M6AD958Z2HQTM5KHT5MB37BY","coordinator-source-of-truth",null,"The complete file-by-file source-of-truth hierarchy for Squad: which files are authoritative, which are derived\u002Fappend-only, who may write each one, who may read each one, and the precedence rules when they conflict. Squad coordinator loads this on demand when it needs to resolve a write conflict, decide where a piece of state belongs, or answer a 'who owns this file' question.","github\u002Fgh-aw","github","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F9919?v=4","01M6AC83DS133TPXFSP1DHNCC6","GitHub","01M6AD3VCZ4WKQSFSRTPN7N9DN",5613,"MIT","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fgh-aw\u002Fblob\u002Fmain\u002F.squad\u002Ftemplates\u002Fskills\u002Fcoordinator-source-of-truth\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38],"coordinator","source","coordinator source of truth","answer","when","Rules","loads","question","files","only","decision","complete","decide","for","conflict","which","as","satellite","file","state","2026-11-10 10:12:30",false,"---\nname: \"coordinator-source-of-truth\"\ndescription: \"The complete file-by-file source-of-truth hierarchy for Squad: which files are authoritative, which are derived\u002Fappend-only, who may write each one, who may read each one, and the precedence rules when they conflict. Squad coordinator loads this on demand when it needs to resolve a write conflict, decide where a piece of state belongs, or answer a 'who owns this file' question.\"\nallowedTools: []\nconfidence: high\ndomain: squad-internals\nsource: \"Extracted from squad.agent.md as part of the slimming effort (github\u002Fsquad#1308). Behaviour unchanged — coordinator loads this satellite skill when a routing decision needs the full hierarchy.\"\n---\n\n> **Load this skill when:** the coordinator (or any agent) needs to resolve a \"where does this state belong?\" or \"who is allowed to write this file?\" question — e.g., when about to write `.squad\u002Fdecisions.md`, when reviewing whether an agent broke the append-only rule, when answering a user question about Squad's file layout, or when adjudicating a conflict between two files. The short summary in `squad.agent.md` is for routing; this skill is the full reference.\n\n## State backend note\n\nFiles below marked as **\"Derived \u002F append-only\"** are **mutable state** — agents access them with runtime state tools (`squad_state_read`, `squad_state_write`, `squad_state_append`, `squad_state_delete`, `squad_state_list`). The runtime decides whether the configured backend stores them on disk, git-native state, or an external provider. Files marked as **\"Authoritative\"** are **static config** and always live on disk regardless of backend.\n\n## File hierarchy\n\n| File | Status | Who May Write | Who May Read |\n|------|--------|---------------|--------------|\n| `.github\u002Fagents\u002Fsquad.agent.md` | **Authoritative governance.** All roles, handoffs, gates, and enforcement rules. | Repo maintainer (human) | Squad (Coordinator) |\n| `.squad\u002Fdecisions.md` | **Authoritative decision ledger.** Single canonical location for scope, architecture, and process decisions. | Squad (Coordinator) — append only | All agents |\n| `.squad\u002Fteam.md` | **Authoritative roster.** Current team composition. | Squad (Coordinator) | All agents |\n| `.squad\u002Frouting.md` | **Authoritative routing.** Work assignment rules. | Squad (Coordinator) | Squad (Coordinator) |\n| `.squad\u002Fceremonies.md` | **Authoritative ceremony config.** Definitions, triggers, and participants for team ceremonies. | Squad (Coordinator) | Squad (Coordinator), Facilitator agent (read-only at ceremony time) |\n| `.squad\u002Fcasting\u002Fpolicy.json` | **Authoritative casting config.** Universe allowlist and capacity. | Squad (Coordinator) | Squad (Coordinator) |\n| `.squad\u002Fcasting\u002Fregistry.json` | **Authoritative name registry.** Persistent agent-to-name mappings. | Squad (Coordinator) | Squad (Coordinator) |\n| `.squad\u002Fcasting\u002Fhistory.json` | **Derived \u002F append-only.** Universe usage history and assignment snapshots. | Squad (Coordinator) — append only | Squad (Coordinator) |\n| `.squad\u002Fagents\u002F{name}\u002Fcharter.md` | **Authoritative agent identity.** Per-agent role and boundaries. | Squad (Coordinator) at creation; agent may not self-modify | Squad (Coordinator) reads to inline at spawn; owning agent receives via prompt |\n| `.squad\u002Fagents\u002F{name}\u002Fhistory.md` | **Derived \u002F append-only.** Personal learnings. Never authoritative for enforcement. | Owning agent (append only), Scribe (cross-agent updates, summarization) | Owning agent only |\n| `.squad\u002Fagents\u002F{name}\u002Fhistory-archive.md` | **Derived \u002F append-only.** Archived history entries. Preserved for reference. | Scribe | Owning agent (read-only) |\n| `.squad\u002Forchestration-log\u002F` | **Derived \u002F append-only.** Agent routing evidence. Never edited after write. | Scribe | All agents (read-only) |\n| `.squad\u002Flog\u002F` | **Derived \u002F append-only.** Session logs. Diagnostic archive. Never edited after write. | Scribe | All agents (read-only) |\n| `.squad\u002Ftemplates\u002F` | **Reference.** Format guides for runtime files. Not authoritative for enforcement. | Squad (Coordinator) at init | Squad (Coordinator) |\n| `.squad\u002Frai\u002Fpolicy.md` | **Authoritative RAI policy.** Check categories, terminology standards, and opt-out rules. | Squad (Coordinator) at init; Rai may propose updates via decisions inbox | Rai, All agents (read-only) |\n| `.squad\u002Frai\u002Faudit-trail.md` | **Derived \u002F append-only.** RAI review evidence log. Redacted — never contains raw secrets or harmful content. | Rai (append only) | Rai, Squad (Coordinator) |\n| `.squad\u002Ffact-checker\u002Fpolicy.md` | **Authoritative verification + Devil's Advocate policy.** Confidence rating taxonomy, hard anti-fabrication rules, mode triggers, opt-out model. | Squad (Coordinator) at init; Fact Checker may propose updates via decisions inbox | Fact Checker, All agents (read-only) |\n| `.squad\u002Ffact-checker\u002Faudit-trail.md` | **Derived \u002F append-only.** Verification verdicts + DA brief evidence log. Succinct — verdict + citation, never raw source material. | Fact Checker (append only) | Fact Checker, Squad (Coordinator) |\n| `.squad\u002Fplugins\u002Fmarketplaces.json` | **Authoritative plugin config.** Registered marketplace sources. | Squad CLI (`squad plugin marketplace`) | Squad (Coordinator) |\n\n## Rules\n\n1. **If `squad.agent.md` and any other file conflict, `squad.agent.md` wins.** It is the only file with hard governance authority.\n2. **Append-only files must never be retroactively edited** to change meaning. They are diagnostic and audit-trail material. Corrections go in a new entry that references the prior one.\n3. **Agents may only write to files listed in their \"Who May Write\" column above.** Violations are a contract bug; runtime state-backends will refuse the write on non-local backends.\n4. **Non-coordinator agents may propose decisions** in their responses, but only Squad (Coordinator) records accepted decisions in `.squad\u002Fdecisions.md`.\n","> **Load this skill when:** the coordinator (or any agent) needs to resolve a \"where does this state belong?\" or \"who is allowed to write this file?\" question — e.g., when about to write `.squad\u002Fdecisions.md`, when reviewing whether an agent broke the append-only rule, when answering a user question about Squad's file layout, or when adjudicating a conflict between two files. The short summary in `squad.agent.md` is for routing; this skill is the full reference.\n\n## State backend note\n\nFiles below marked as **\"Derived \u002F append-only\"** are **mutable state** — agents access them with runtime state tools (`squad_state_read`, `squad_state_write`, `squad_state_append`, `squad_state_delete`, `squad_state_list`). The runtime decides whether the configured backend stores them on disk, git-native state, or an external provider. Files marked as **\"Authoritative\"** are **static config** and always live on disk regardless of backend.\n\n## File hierarchy\n\n| File | Status | Who May Write | Who May Read |\n|------|--------|---------------|--------------|\n| `.github\u002Fagents\u002Fsquad.agent.md` | **Authoritative governance.** All roles, handoffs, gates, and enforcement rules. | Repo maintainer (human) | Squad (Coordinator) |\n| `.squad\u002Fdecisions.md` | **Authoritative decision ledger.** Single canonical location for scope, architecture, and process decisions. | Squad (Coordinator) — append only | All agents |\n| `.squad\u002Fteam.md` | **Authoritative roster.** Current team composition. | Squad (Coordinator) | All agents |\n| `.squad\u002Frouting.md` | **Authoritative routing.** Work assignment rules. | Squad (Coordinator) | Squad (Coordinator) |\n| `.squad\u002Fceremonies.md` | **Authoritative ceremony config.** Definitions, triggers, and participants for team ceremonies. | Squad (Coordinator) | Squad (Coordinator), Facilitator agent (read-only at ceremony time) |\n| `.squad\u002Fcasting\u002Fpolicy.json` | **Authoritative casting config.** Universe allowlist and capacity. | Squad (Coordinator) | Squad (Coordinator) |\n| `.squad\u002Fcasting\u002Fregistry.json` | **Authoritative name registry.** Persistent agent-to-name mappings. | Squad (Coordinator) | Squad (Coordinator) |\n| `.squad\u002Fcasting\u002Fhistory.json` | **Derived \u002F append-only.** Universe usage history and assignment snapshots. | Squad (Coordinator) — append only | Squad (Coordinator) |\n| `.squad\u002Fagents\u002F{name}\u002Fcharter.md` | **Authoritative agent identity.** Per-agent role and boundaries. | Squad (Coordinator) at creation; agent may not self-modify | Squad (Coordinator) reads to inline at spawn; owning agent receives via prompt |\n| `.squad\u002Fagents\u002F{name}\u002Fhistory.md` | **Derived \u002F append-only.** Personal learnings. Never authoritative for enforcement. | Owning agent (append only), Scribe (cross-agent updates, summarization) | Owning agent only |\n| `.squad\u002Fagents\u002F{name}\u002Fhistory-archive.md` | **Derived \u002F append-only.** Archived history entries. Preserved for reference. | Scribe | Owning agent (read-only) |\n| `.squad\u002Forchestration-log\u002F` | **Derived \u002F append-only.** Agent routing evidence. Never edited after write. | Scribe | All agents (read-only) |\n| `.squad\u002Flog\u002F` | **Derived \u002F append-only.** Session logs. Diagnostic archive. Never edited after write. | Scribe | All agents (read-only) |\n| `.squad\u002Ftemplates\u002F` | **Reference.** Format guides for runtime files. Not authoritative for enforcement. | Squad (Coordinator) at init | Squad (Coordinator) |\n| `.squad\u002Frai\u002Fpolicy.md` | **Authoritative RAI policy.** Check categories, terminology standards, and opt-out rules. | Squad (Coordinator) at init; Rai may propose updates via decisions inbox | Rai, All agents (read-only) |\n| `.squad\u002Frai\u002Faudit-trail.md` | **Derived \u002F append-only.** RAI review evidence log. Redacted — never contains raw secrets or harmful content. | Rai (append only) | Rai, Squad (Coordinator) |\n| `.squad\u002Ffact-checker\u002Fpolicy.md` | **Authoritative verification + Devil's Advocate policy.** Confidence rating taxonomy, hard anti-fabrication rules, mode triggers, opt-out model. | Squad (Coordinator) at init; Fact Checker may propose updates via decisions inbox | Fact Checker, All agents (read-only) |\n| `.squad\u002Ffact-checker\u002Faudit-trail.md` | **Derived \u002F append-only.** Verification verdicts + DA brief evidence log. Succinct — verdict + citation, never raw source material. | Fact Checker (append only) | Fact Checker, Squad (Coordinator) |\n| `.squad\u002Fplugins\u002Fmarketplaces.json` | **Authoritative plugin config.** Registered marketplace sources. | Squad CLI (`squad plugin marketplace`) | Squad (Coordinator) |\n\n## Rules\n\n1. **If `squad.agent.md` and any other file conflict, `squad.agent.md` wins.** It is the only file with hard governance authority.\n2. **Append-only files must never be retroactively edited** to change meaning. They are diagnostic and audit-trail material. Corrections go in a new entry that references the prior one.\n3. **Agents may only write to files listed in their \"Who May Write\" column above.** Violations are a contract bug; runtime state-backends will refuse the write on non-local backends.\n4. **Non-coordinator agents may propose decisions** in their responses, but only Squad (Coordinator) records accepted decisions in `.squad\u002Fdecisions.md`.\n",{"name":5,"domain":44,"source":45,"confidence":46,"description":7,"allowedTools":47},"squad-internals","Extracted from squad.agent.md as part of the slimming effort (github\u002Fsquad#1308). Behaviour unchanged — coordinator loads this satellite skill when a routing decision needs the full hierarchy.","high",[],"main","1a8585c0e5c7600aa6daf6091c5d24752041d57f",".squad\u002Ftemplates\u002Fskills\u002Fcoordinator-source-of-truth",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-11 11:58:50",{"source":8,"skillName":5,"commands":59,"prompt":69,"zipAvailable":70},[60,63,66],{"tool":61,"command":62},"npx","npx skills add github\u002Fgh-aw --skill coordinator-source-of-truth",{"tool":64,"command":65},"bunx","bunx skills add github\u002Fgh-aw --skill coordinator-source-of-truth",{"tool":67,"command":68},"pnpm","pnpm dlx skills add github\u002Fgh-aw --skill coordinator-source-of-truth","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fgithub\u002Fgh-aw\u002Fblob\u002Fmain\u002F.squad\u002Ftemplates\u002Fskills\u002Fcoordinator-source-of-truth\u002FSKILL.md",true,[],[73,101,118,142,168,185],{"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":87,"publishedAt":39},"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",[79,84],{"categoryNo":80,"categoryName":81,"taxonomyType":82,"taxonomyTypeDesc":83},"01JBSEEDCAT000000000000011","运维与部署","SCENARIO","使用场景",{"categoryNo":85,"categoryName":86,"taxonomyType":82,"taxonomyTypeDesc":83},"01JBSEEDCAT000000000000023","Skill与智能体开发",[9,88,89,90,91,92,93,94,32,95,96,97,98,99,100],"agentic","agentic workflows","github agentic workflows","workflows","github cli","gh","extension","compiling","cli","writing","actions","github actions","markdown",{"skillNo":102,"name":103,"nameZh":6,"description":104,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":105,"categories":106,"keywords":107,"publishedAt":39},"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",[],[108,109,110,111,112,46,113,114,115,116,117],"windows","windows compatibility","compatibility","bugs","path","platform","cross-platform","patterns","command","git",{"skillNo":119,"name":120,"nameZh":6,"description":121,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":122,"categories":123,"keywords":124,"publishedAt":39},"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",[],[125,126,127,128,129,130,131,24,132,133,134,135,136,137,138,139,32,140,96,141],"policy","versioning policy","versioning","incident","gate","implementation","version","workspace","pr","ci","npm","semver","release","squad","resolution","incidents","sdk",{"skillNo":143,"name":144,"nameZh":6,"description":145,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":146,"categories":147,"keywords":152,"publishedAt":39},"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",[148,151],{"categoryNo":149,"categoryName":150,"taxonomyType":82,"taxonomyTypeDesc":83},"01JBSEEDCAT000000000000015","视觉设计",{"categoryNo":85,"categoryName":86,"taxonomyType":82,"taxonomyTypeDesc":83},[153,154,155,156,32,157,158,159,160,161,162,163,164,165,166,167],"tiered memory","memory","memory-management","model","cold","proposal","runtime","three","spawn","management","context","wiki","agent memory","performance","design",{"skillNo":169,"name":170,"nameZh":6,"description":171,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":172,"categories":173,"keywords":177,"publishedAt":39},"01M6ADBZTDGFM0E25EWRQEMYEH","test-discipline","Update tests when changing APIs — no exceptions","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fgh-aw\u002Fblob\u002Fmain\u002F.squad\u002Ftemplates\u002Fskills\u002Ftest-discipline\u002FSKILL.md",[174],{"categoryNo":175,"categoryName":176,"taxonomyType":82,"taxonomyTypeDesc":83},"01JBSEEDCAT000000000000008","测试与质量",[178,179,180,181,23,46,182,128,183,184],"test discipline","discipline","test","sync","tests","quality","update",{"skillNo":186,"name":138,"nameZh":6,"description":187,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":188,"categories":189,"keywords":190,"publishedAt":39},"01M6ADBX5MJP4Z7CG4XTV8ZVT8","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\u002Fgh-aw\u002Fblob\u002Fmain\u002F.squad\u002Ftemplates\u002Fskills\u002Fsquad\u002FSKILL.md",[],[138,191,192,193,19,35,194,195,196,197,198,199,200,116,156,201,202,203,204,38,205,206,96],"show","interactive menu","invoke","commands","upgrade","options","me","natural language","do","install","team","show me","plugins","issues","squad commands","sessions"]