pos-ai: Skill for Claude Code

Team Management Skill

Setup

Before starting: check .handoff/sessions/ for active sessions, read context status.yaml, run git status. Follow .rules/universal.md (Plan -> Approve -> Execute).

Manage teams in the POS. Teams are organizational units led by TPMs.

Commands

• /team create {name} - Create a new team with full setup
• /team list - List all teams
• /team status {name} - Show team status
• /team add-engineer {team} {specialty} - Add engineer to team

/team create {name} - Full Setup

Required Information: Team name (kebab-case), description, focus areas, tech stack, port range, engineer specialties.

Steps

1. Create directory structure

   mkdir -p {teams_dir}/{team-name}/{repos,plans/sprints,logs,projects,docs}
   

2. Create team.yaml at {teams_dir}/{team}/team.yaml:

   name: "{team-name}"
   tpm: tpm-{team-name}
   description: "{description}"
   client:
     name: "{Client or Internal}"
     type: internal_product
   focus_areas: [...]
   tech_stack:
     backend: {framework}
     frontend: {framework}
     database: {db}
   engineers: [eng-backend, eng-frontend, eng-testing, eng-devops]
   active_projects: []
   ports:
     range: "8X00-8X99 (backend), 3X00-3X99 (frontend)"
   created: "{today}"
   

3. Create status.yaml at {teams_dir}/{team}/status.yaml with session_active: false, empty task/blockers/sprints.

4. Create QUICK-START.md with team name, TPM, focus, quick commands, key file paths, tech stack.

5. Add to platform registry - Edit pos.yaml with team entry under teams:.

6. Create TPM agent at .ai/agents/tpm-{team-name}.md with responsibilities (planning, coordination, quality, communication), available engineers, and workflow (receive assignment, create plan, execute after approval, report).

7. Run agent linking:

   ./scripts/link-team-agents.sh
   

   Restart Claude Code after linking.