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

# API Reference — Building Security Awareness Content

## Agent Script

### Commands

| Command | Description |
|---|---|
| `node agent.js create-module --topic phishing --format interactive --duration 15` | Create a training module |
| `node agent.js micro-learning --topic password-hygiene --format video-script` | Generate micro-learning content |
| `node agent.js poster --topic clean-desk --style modern` | Generate security awareness poster content |
| `node agent.js content-calendar --quarter Q2-2026 --threats current` | Build content calendar aligned to threats |

### Examples

```bash
# Primary workflow
node agent.js create-module --topic phishing --format interactive --duration 15

# Secondary analysis
node agent.js micro-learning --topic password-hygiene --format video-script

# Generate deliverable
node agent.js poster --topic clean-desk --style modern

# Measure and report
node agent.js content-calendar --quarter Q2-2026 --threats current
```

## External Tools

| Tool | Command | Purpose |
|---|---|---|
| Articulate Rise | `rise --export module.zip` | Interactive e-learning authoring |
| Canva | `canva --template poster` | Graphic design for posters |
| Vyond | `vyond --render video.mp4` | Animated video creation |

## Content Format Effectiveness

| Format | Engagement | Retention | Cost | Best For |
|---|---|---|---|---|
| Interactive scenario | High | High | Medium | Decision-making skills |
| Short video (< 3 min) | High | Medium | Medium | Concept introduction |
| Micro-learning | Medium | Medium | Low | Reinforcement |
| Infographic/poster | Medium | Low | Low | Awareness reminders |
| Live workshop | High | High | High | Complex topics |
| Gamified challenge | High | High | Medium | Competitive teams |
