<!-- Copyright (c) 2026 defconxt. All rights reserved. -->
<!-- Licensed under AGPL-3.0 — see LICENSE file for details. -->

# API Reference — Security Team Development

## Agent Tools

| Tool | Description |
|---|---|
| Skills Assessor | `assess_skills(team)` — Identify competency gaps |
| Career Ladder | `generate_career_ladder(role, track)` — Build progression framework |
| Hiring Planner | `plan_hiring(gaps, budget)` — Prioritize hires by gap and budget |

## CLI Usage

```bash
# Assess skills
node agent.js skills --team '{"cloud": {"required": 4, "current": 2}}'

# Career ladder
node agent.js ladder --role "Security Engineer" --track ic

# Plan hiring
node agent.js hiring --gaps '{"cloud": 2}' --budget 500000
```

## Output Format

All commands return JSON with the following structure:

```json
{
  "action": "<command_name>",
  "...": "command-specific fields"
}
```

## Error Handling

- Invalid input returns `{"error": "description"}` with non-zero exit code
- JSON parsing errors are caught and reported with context
- Missing required arguments trigger argparse help display
