[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M719DE84ZXKB3AMY09KVNP2Q":3,"skill-same:01M719DE84ZXKB3AMY09KVNP2Q":68},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":38,"linkOnly":39,"markdownContent":40,"markdownBody":41,"frontMatter":42,"refName":47,"commitSha":48,"skillDirectory":49,"forksCount":50,"repositoryHtmlUrl":51,"repositoryHomepageUrl":6,"ownerHtmlUrl":52,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":53,"install":54,"resources":67},"01M719DE84ZXKB3AMY09KVNP2Q","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.","DeDuva\u002Fsquad","DeDuva","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F8153108?v=4","01M719BQB25861D0TKS3RVHMN2","01M719BQBSWR380PSYDD5M9YD4",1,"MIT","https:\u002F\u002Fgithub.com\u002FDeDuva\u002Fsquad\u002Fblob\u002Fdev\u002F.squad\u002Fskills\u002Fcoordinator-source-of-truth\u002FSKILL.md",[],[18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37],"coordinator","source","coordinator source of truth","state","file","when","Rules","loads","question","files","only","decision","complete","decide","answer","for","conflict","which","as","satellite","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 (bradygaster\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":43,"source":44,"confidence":45,"description":7,"allowedTools":46},"squad-internals","Extracted from squad.agent.md as part of the slimming effort (bradygaster\u002Fsquad#1308). Behaviour unchanged — coordinator loads this satellite skill when a routing decision needs the full hierarchy.","high",[],"dev","4ffda80d1bb1043d9169688cf161e53097345c72",".squad\u002Fskills\u002Fcoordinator-source-of-truth",0,"https:\u002F\u002Fgithub.com\u002FDeDuva\u002Fsquad","https:\u002F\u002Fgithub.com\u002FDeDuva","2026-11-09 20:24:44",{"source":8,"skillName":5,"commands":55,"prompt":65,"zipAvailable":66},[56,59,62],{"tool":57,"command":58},"npx","npx skills add DeDuva\u002Fsquad --skill coordinator-source-of-truth",{"tool":60,"command":61},"bunx","bunx skills add DeDuva\u002Fsquad --skill coordinator-source-of-truth",{"tool":63,"command":64},"pnpm","pnpm dlx skills add DeDuva\u002Fsquad --skill coordinator-source-of-truth","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FDeDuva\u002Fsquad\u002Fblob\u002Fdev\u002F.squad\u002Fskills\u002Fcoordinator-source-of-truth\u002FSKILL.md",true,[],[69,85,93,109,132,146],{"skillNo":70,"name":71,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":79,"publishedAt":38},"01M719NE6ZPZT80MKVWFDECJZ3","My Skill","https:\u002F\u002Fgithub.com\u002FDeDuva\u002Fsquad\u002Fblob\u002Fdev\u002Ftest-fixtures\u002Fskills-test-abb30454\u002Fmy-skill\u002FSKILL.md",[74],{"categoryNo":75,"categoryName":76,"taxonomyType":77,"taxonomyTypeDesc":78},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[80,81,82,83,84],"my","my skill","testing","vitest","tester",{"skillNo":86,"name":87,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":38},"01M719NDJAMEWM8D9H355SCNA8","bad-skill","https:\u002F\u002Fgithub.com\u002FDeDuva\u002Fsquad\u002Fblob\u002Fdev\u002Ftest-fixtures\u002Fskills-test-abb30454\u002Fbad-skill\u002FSKILL.md",[],[91,92],"bad skill","bad",{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":38},"01M719NCC1AZ02GHZ1V71YPEV7","squad-conventions","Core conventions and patterns used in the Squad codebase","https:\u002F\u002Fgithub.com\u002FDeDuva\u002Fsquad\u002Fblob\u002Fdev\u002Ftemplates\u002Fskills\u002Fsquad-conventions\u002FSKILL.md",[],[100,101,102,103,104,105,106,45,107,108],"conventions","squad","squad conventions","project-conventions","core","project","manual","codebase","patterns",{"skillNo":110,"name":111,"nameZh":6,"description":112,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":113,"categories":114,"keywords":115,"publishedAt":38},"01M719NAYM17B7X8MGP681EHKQ","rework-rate","Measure and interpret PR rework rate — the emerging 5th DORA metric","https:\u002F\u002Fgithub.com\u002FDeDuva\u002Fsquad\u002Fblob\u002Fdev\u002Ftemplates\u002Fskills\u002Frework-rate\u002FSKILL.md",[],[116,117,118,119,45,120,121,122,101,123,124,125,126,106,127,23,128,129,130,131],"rate","rework rate","health","analyze","review efficiency","quality","metric","metrics","efficiency","code quality","pr","prs","code","team","code-review","review",{"skillNo":133,"name":134,"nameZh":6,"description":135,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":136,"categories":137,"keywords":138,"publishedAt":38},"01M719NA136PDC3SQ10R4R88TH","nap","Context hygiene — compress, prune, archive .squad\u002F state","https:\u002F\u002Fgithub.com\u002FDeDuva\u002Fsquad\u002Fblob\u002Fdev\u002Ftemplates\u002Fskills\u002Fnap\u002FSKILL.md",[],[134,139,21,140,141,142,143,144,101,145],"prune","maintenance","context hygiene","archive","hygiene","compress","context",{"skillNo":147,"name":148,"nameZh":6,"description":149,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":150,"categories":151,"keywords":156,"publishedAt":38},"01M719N7B4PBQPNXW78TEJY4HQ","e2e-template-testing","End-to-end validation of coordinator and agent template changes","https:\u002F\u002Fgithub.com\u002FDeDuva\u002Fsquad\u002Fblob\u002Fdev\u002Ftemplates\u002Fskills\u002Fe2e-template-testing\u002FSKILL.md",[152,155],{"categoryNo":153,"categoryName":154,"taxonomyType":77,"taxonomyTypeDesc":78},"01JBSEEDCAT000000000000008","测试与质量",{"categoryNo":75,"categoryName":76,"taxonomyType":77,"taxonomyTypeDesc":78},[82,157,158,159,160,18,161,106,162,45,163],"e2e template testing","e2e","template","end","development","changes","validation"]