a-team — Claude Code hook: what it does and how to install
a-team is a hook for Claude Code that runs at session start and on clear or compact. It displays team status and loads session instructions.
MIT ★ 1,596 updated 2026-10-29
.claude/settings.jsonWhat a-team does
The a-team hook runs on SessionStart for startup, clear, or compact. It tries python, python3, and py to run scripts/status.py and display team status. If none of those commands works, it prints a message asking for Python to be installed.
The hook then reads hooks/session-start.md, falling back to skills/using-a-team/SKILL.md. If neither file is available, it prints a prompt to run /orchestrate init when .agent-sync/TEAM.md is missing. The a-team bundle includes 26 specialist agents, 20 workflow skills, an orchestrator, and quality gates; integration and hook support vary by platform.
What it helps with
- show team status when a session starts
- load team instructions after
clearorcompact - prompt initialization when
.agent-sync/TEAM.mdis missing
Example prompts for the agent
- Start a new session and show the a-team status.
- After
clear, load the team instructions and run/orchestrate initif.agent-sync/TEAM.mdis missing.
How to install a-team
Manually: put the files in place
.claude/settings.jsonThe hooks block: event (PreToolUse, PostToolUse, Stop…) → command. Personal ones go to ~/.claude/settings.json
Step by step, with commands for each platform: Claude Code hooks: what they are, where to configure them, how to block a risky command
Questions about a-team
How do I install a-team in Claude Code?
Add the hook configuration to .claude/settings.json.
What does the a-team hook do?
It displays team status and loads session instructions at startup and after clear or compact.
What does a-team need to show status?
The hook tries to run Python using python, python3, or py. If none works, it prints a message asking for Python to be installed.
Source text
hooks.json · MIT
Hooks bundle shipped with the a-team plugin for Claude Code.
A complete engineering team in one folder with 26 specialist agents, 20 workflow skills, an orchestrator, and quality gates; integration and hook support vary by coding platform.
Triggers on: SessionStart.
```json
{
"hooks": {
"SessionStart": [
{
"matcher": "startup|clear|compact",
"hooks": [
{
"type": "command",
"command": "python ${PLUGIN_ROOT}/scripts/status.py 2>/dev/null || python3 ${PLUGIN_ROOT}/scripts/status.py 2>/dev/null || py ${PLUGIN_ROOT}/scripts/status.py 2>/dev/null || echo '⚡ A Team · instala Python para ver o estado'",
"async": false
},
{
"type": "command",
"command": "cat \"${PLUGIN_ROOT}/hooks/session-start.md\" 2>/dev/null || cat \"${PLUGIN_ROOT}/skills/using-a-team/SKILL.md\" 2>/dev/null || echo '[A Team] Session started. Run /orchestrate init if .agent-sync/TEAM.md is missing.'",
"async": false
}
]
}
]
}
}
```
© RBraga01 · MIT · hashgraph-online/awesome-codex-plugins