Skip to content

Governance layer has no awareness of personal squad paths #344

@jsturtevant

Description

@jsturtevant

Problem

The personal squad path resolution (resolveGlobalSquadPath() → platform-specific dirs like ~/.config/squad/) lives entirely in SDK code. The governance layer — squad.agent.md, charter templates, and skills — has zero awareness of personal squads.

What's missing

1. squad.agent.md (coordinator instructions)

  • Init Mode references --global but doesn't explain where it resolves to
  • No guidance for agents operating in consult mode against a personal squad
  • The TEAM_ROOT concept works, but nothing tells the coordinator that a personal squad has different semantics (shared across projects, skills are portable, etc.)

2. Charter templates (.squad/templates/charter.md)

  • No personal-squad-aware patterns
  • When casting a personal squad, charters should reflect that skills/knowledge are project-agnostic
  • No guidance on "this agent lives in a personal squad and will be used across multiple repos"

3. Skills and templates

  • All .squad/skills/ and .squad/templates/ reference .squad/ as project-relative only
  • No skill for "how to behave when spawned from a personal squad" or "how consult mode changes agent behavior"

Impact

  • Agents spawned via consult mode don't know they're backed by a personal squad
  • The coordinator can't give agents context about personal vs project squads
  • Personal squad casting has no template support (related: CLI casting bypasses CastingEngine template system #342)
  • Skills earned in one project via a personal squad have no guidance on portability

Expected Behavior

The governance layer should:

  1. Define personal squad semantics in squad.agent.md (how consult mode works, what TEAM_ROOT means when pointing to a personal squad)
  2. Provide charter template variants for personal squad agents (project-agnostic framing)
  3. Include a skill or template for consult-mode behavior (what's different when the squad is personal)

Related

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions