Strix — Process & runbooks index
Who this is for
Anyone who will actually run Strix — security analysts kicking off scans, developers
integrating it into CI, or operators triaging findings. If you only need to
understand the system, ../00_START_HERE.md and ../01_overview.md are the better
starting point; come back here once you're ready to type commands.
Note the docs here split into two distinct sets: operating Strix (the
first four rows below — running scans, triaging findings) and maintaining
this documentation project's own generator tooling (the last two rows —
regenerating architecture.html and friends). Don't confuse the two; they
have separate runbooks for a reason.
Which doc to use when
| Situation | Doc |
|---|---|
| First time setting up Strix on a machine (Docker, LLM key) | runbooks/setup-and-credentials.md |
| Running an actual scan against a target | runbooks/run-a-detection-scan.md |
| A scan finished (or stopped) and findings need triage | runbooks/review-and-triage-findings.md |
| Understanding the overall SOP for operating Strix as a recurring practice | process-operate-strix.md |
| Wanting Strix's own consumer-facing skill packages for driving it from Claude Code, Cursor, etc. | see "External agent skills" below |
| Regenerating this project's own documentation (architecture.html, HLD/LLD HTML, module-docs index) after editing a generator script | harness-maintenance-process.md + runbooks/regenerate-documentation.md |
| Improving the doc-harness workflow itself (waste analysis, future-state plan) | harness-process-optimization.md |
External agent skills (not the same as strix/skills/)
The top-level repository folder skills/ (as opposed to strix/skills/, the
internal knowledge packs described in ../modules/skills.md) ships four SKILL.md
packages meant for external coding agents driving Strix:
penetration-testing-with-strix (run headless scans, read results),
managed-pentesting-with-strix (drive app.strix.ai via REST, no local Docker/LLM
key needed), fix-security-vulnerabilities-with-strix (remediate findings, re-scan to
verify), and ci-security-scanning-with-strix (PR scanning in CI). Install with:
npx skills add usestrix/strix
Conventions
- Every command in these docs was checked against a runnable copy of the real source
kept at
../../samples/strix/(seeAGENTS.mdandREADME.mdthere) — none are reconstructed from memory. - ⚠️ marks any step that edits code, spends LLM budget, or runs exploitation attempts against a live target.
- All runbooks assume Docker is already running and an LLM API key is available, unless the runbook itself is the setup step.
Related: STRIX — Process and Runbooks, STRIX — Map of Content.