ai-csuite

# AI C-Suite Multi-Agent Framework

Use this skill when the user needs a strategic decision on product, engineering, pricing,
go-to-market, hiring, operations, or competitive response.

The user's topic is: **$ARGUMENTS**

## Runtime Contract

This skill is operational via local scripts in `scripts/`:
- `prepare_session.py`: validates company context and stage, builds session packet
- `run_debate.py`: generates full multi-round debate + CEO decision
- `validate_output.py`: validates required output sections and fields
- `security_scan.py`: checks for suspicious code patterns for release safety

No hidden network execution, no obfuscation, and no credential reads are required.

## Required Inputs

Load company context from:
- `config/company.yaml`

If missing, ask the user for:
- company name + product line
- stage: `solo | pre-seed | seed | series-a`
- ARR or MRR
- runway (months)
- team size
- constraints list

## Stage Profiles

| Stage | Debate Agents | Rounds |
|---|---|---|
| solo | CEO, CTO, CPO, CFO, CoS | 2 |
| pre-seed | CEO, CTO, CPO, CoS, CV | 2 |
| seed | CEO, CTO, CPO, CMO, CRO, CoS, CV | 3 |
| series-a | CEO, CTO, CPO, CFO, CMO, CRO, COO, CSA, CISO, CoS, CV | 3 |

Data brief agents are always:
- `CV` for customer signals
- `CFO` for financial constraints

If `CV` or `CFO` are not in the debate roster for that stage, they still provide pre-round data.

## Squads

| Squad | Members | Lead |
|---|---|---|
| Strategy | CEO, CFO, COO, CoS | CFO |
| Product | CTO, CPO, CSA, CISO | CPO |
| Growth | CMO, CRO, CV | CRO |

Intra-squad challenges are direct. Cross-squad challenges are mediated by CoS.

## Execution Steps

1. Security pre-check:
```bash
python3 scripts/security_scan.py .
```

2. Build session packet:
```bash
python3 scripts/prepare_session.py --topic "$ARGUMENTS" --company-file config/company.yaml
```

3. Run full debate:
```bash
python3 scripts/run_debate.py --topic "$ARGUMENTS" --company-file config/company.yaml --output logs/latest-decision.md...

# ai-csuite

Script-backed AI C-Suite skill for structured strategic decisions.

## What this skill does

- Builds a stage-aware executive roster for SaaS teams.
- Runs a multi-round debate with role-based positions.
- Produces a structured `CEO BRIEF` and `CEO DECISION`.
- Validates output shape and scans the skill for publish-time safety checks.

## Included files

- `SKILL.md`: prompt workflow and operating rules.
- `config/company.yaml`: required company context template.
- `scripts/prepare_session.py`: validates context and builds session packet.
- `scripts/run_debate.py`: generates debate output markdown.
- `scripts/validate_output.py`: checks mandatory output markers.
- `scripts/security_scan.py`: static checks for risky patterns/imports.
- `.github/workflows/ci.yml`: GitHub Actions smoke checks.

## Requirements

- Python 3.11+ (stdlib only).
- No third-party Python dependencies.

## Quick start

1. Enter the skill directory:

```bash
cd ai-csuite
```

2. Fill company context:

```bash
cp config/company.yaml config/company.local.yaml
```

Edit `config/company.local.yaml` with your real values.

3. Run security scan:

```bash
python3 scripts/security_scan.py .
```

4. Prepare the session:

```bash
python3 scripts/prepare_session.py \
  --topic "Should we change pricing for SMB annual plans?" \
  --company-file config/company.local.yaml
```

5. Run the debate:

```bash
python3 scripts/run_debate.py \
  --topic "Should we change pricing for SMB annual plans?" \
  --company-file config/company.local.yaml \
  --output logs/latest-decision.md
```

6. Validate generated output:

```bash
python3 scripts/validate_output.py --file logs/latest-decision.md
```

If validation prints `PASS`, the decision file is complete.

## Company config schema

`config/company.yaml` must contain:

- `company_name`
- `product`
- `stage` (`solo | pre-seed | seed | series-a`)
- `arr_or_mrr`
- `runway_months`
- `team_size`
- `constraints` (YAML list)

## Stage behavior

- `solo`: 2 rounds...