跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
开发与测试

coordinator-source-of-truth

The complete file-by-file source-of-truth hierarchy for Squad: which files are authoritative, which are derived/append-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.

microsoft · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add microsoft/waza --skill coordinator-source-of-truth

技能说明


name: "coordinator-source-of-truth" description: "The complete file-by-file source-of-truth hierarchy for Squad: which files are authoritative, which are derived/append-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." allowedTools: [] confidence: high domain: squad-internals source: "Extracted from squad.agent.md (bradygaster/squad#1308), with Waza project overrides for paired casting, delegated decision merges and charter-limited output ownership."

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/decisions.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.

State backend note

Files below marked as "Derived / 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.

File hierarchy

Waza support-review override (Squad only): Charter output/persistence restrictions take precedence over generic history, audit-trail or decision-inbox write permissions below. Rai and Fact Checker return findings in the current review response. Only an authorized coordinator or Scribe handles required persistence under the current state contract; no routine review logging is required. Preserve existing historical records. Scribe remains bound by its charter: a decision-only Scribe cannot write logs, histories or audit trails. The Coordinator arranges any required non-decision persistence through an authorized writer; a missing writer is a blocker, not permission for Scribe. These coordination rules do not apply to ordinary Copilot work.

FileStatusWho May WriteWho May Read
.github/agents/squad.agent.mdAuthoritative governance. All roles, handoffs, gates, and enforcement rules.Repo maintainer (human)Squad (Coordinator)
.squad/decisions.mdAuthoritative decision ledger. Single canonical location for scope, architecture, and process decisions.Coordinator or coordinator-delegated Scribe; already-accepted decisions only, append onlyAll agents
.squad/team.mdAuthoritative roster. Current team composition.Squad (Coordinator)All agents
.squad/routing.mdAuthoritative routing. Work assignment rules.Squad (Coordinator)Squad (Coordinator)
.squad/ceremonies.mdAuthoritative ceremony config. Definitions, triggers, and participants for team ceremonies.Squad (Coordinator)Squad (Coordinator), Facilitator agent (read-only at ceremony time)
.squad/casting/policy.jsonAuthoritative casting config. Universe allowlist and capacity.Squad (Coordinator)Squad (Coordinator)
.squad/casting/registry.jsonAuthoritative name registry; paired transaction. Persistent agent-to-name mappings.Squad (Coordinator), only via .squad/casting-transactions.md's locked SDK writerSquad (Coordinator), paired read
.squad/casting/history.jsonDerived / append-only contents; paired transaction. Universe usage history and assignment snapshots.Squad (Coordinator), only via the same paired writerSquad (Coordinator), paired read
.squad/casting/registry-history.commit.jsonSDK-owned transaction/hash manifest. Never hand-edit or discard to bypass validation.Locked SDK paired writer onlySDK paired reader
.squad/agents/{name}/charter.mdAuthoritative agent identity. Per-agent role and boundaries.Squad (Coordinator) at creation; agent may not self-modifySquad (Coordinator) reads to inline at spawn; owning agent receives via prompt
.squad/agents/{name}/history.mdDerived / append-only. Personal learnings. Never authoritative for enforcement.Owning agent only where charter permits; authorized Scribe for required contextOwning agent only
.squad/agents/{name}/history-archive.mdDerived / append-only. Archived history entries. Preserved for reference.ScribeOwning agent (read-only)
.squad/orchestration-log/Derived / append-only. Agent routing evidence. Never edited after write.ScribeAll agents (read-only)
.squad/log/Derived / append-only. Session logs. Diagnostic archive. Never edited after write.ScribeAll agents (read-only)
.squad/templates/Reference. Format guides for runtime files. Not authoritative for enforcement.Squad (Coordinator) at initSquad (Coordinator)
.squad/rai/policy.mdAuthoritative RAI policy. Check categories, terminology standards, and opt-out rules.Squad (Coordinator) at init or authorized policy changes; Rai read-onlyRai, All agents (read-only)
.squad/rai/audit-trail.mdDerived / append-only. Preserve existing redacted records; never raw secrets or harmful content; no routine reviewer logging.Authorized Coordinator/Scribe only when the current state contract requires persistenceRai, Squad (Coordinator)
.squad/fact-checker/policy.mdAuthoritative verification + Devil's Advocate policy. Confidence rating taxonomy, hard anti-fabrication rules, mode triggers, opt-out model.Squad (Coordinator) at init or authorized policy changes; Fact Checker read-
阅读完整来源 ↗