Context
PR #162 (PACT v3.0 Agent Teams) added pact-plugin/hooks/shared/team_utils.py with functions that read from ~/.claude/teams/{name}/config.json. This path is assumed from the Agent Teams documentation but hasn't been empirically validated.
What to validate
When Agent Teams is first deployed:
- Run a session that creates a team via
TeamCreate
- Check if
~/.claude/teams/{team-name}/config.json exists on disk
- If so, verify the JSON structure matches what
get_team_members() expects (a members array with name, agentId, agentType fields)
- If the path or structure differs, update
team_utils.py accordingly
Impact if path is wrong
All functions degrade gracefully (return empty/False), but:
session_init._team_instruction() "survived compaction" message never appears
stop_audit.audit_team_state() reports no team members
checkpoint_builder._get_team_context() provides no team enrichment
No crashes, but reduced observability.
Files affected
pact-plugin/hooks/shared/team_utils.py (all functions)
pact-plugin/hooks/session_init.py (_team_instruction)
pact-plugin/hooks/stop_audit.py (audit_team_state)
pact-plugin/hooks/refresh/checkpoint_builder.py (_get_team_context)
Context
PR #162 (PACT v3.0 Agent Teams) added
pact-plugin/hooks/shared/team_utils.pywith functions that read from~/.claude/teams/{name}/config.json. This path is assumed from the Agent Teams documentation but hasn't been empirically validated.What to validate
When Agent Teams is first deployed:
TeamCreate~/.claude/teams/{team-name}/config.jsonexists on diskget_team_members()expects (amembersarray withname,agentId,agentTypefields)team_utils.pyaccordinglyImpact if path is wrong
All functions degrade gracefully (return empty/False), but:
session_init._team_instruction()"survived compaction" message never appearsstop_audit.audit_team_state()reports no team memberscheckpoint_builder._get_team_context()provides no team enrichmentNo crashes, but reduced observability.
Files affected
pact-plugin/hooks/shared/team_utils.py(all functions)pact-plugin/hooks/session_init.py(_team_instruction)pact-plugin/hooks/stop_audit.py(audit_team_state)pact-plugin/hooks/refresh/checkpoint_builder.py(_get_team_context)