SPECTRA MANUALE OPERATIVO
EN/IT
Core · Skill

spectra-new-module · Core

SPECTRA New Module

Panoramica

I cinque moduli di SPECTRA (Core, RTK, SOC, IRT, GRC) condividono la stessa forma: un module.yaml, un config.yaml, una cartella agents/ e una workflows/. Questa skill rende quella forma ripetibile, così estendere SPECTRA in un nuovo dominio è uno scaffold deterministico, non boilerplate copiato a mano — il volano di estensibilità che fa crescere il framework senza derive.

It generates a valid module skeleton and prints the manifest rows you should add to register it. Registration is deliberately a reviewed step: the scaffold never edits the live manifests for you.

A built-in ot-ics preset demonstrates a domain extension — an OT/ICS security specialist agent and an ot-assessment workflow — with SPECTRA’s safety boundary baked into the generated content: OT/ICS work is assessment and modeling only. The generated agent and workflow state explicitly that they never issue destructive controller/PLC commands and never disrupt safety-instrumented systems.

Runtime deterministico (Layer 3)

Generate a module (created under <dest>/<code>/):

python3 {project-root}/_spectra/core/execution/scaffold-module.py create \
  --code ot --name "OT/ICS Security" --dest "{project-root}/_spectra" --preset ot-ics

A generic module:

python3 {project-root}/_spectra/core/execution/scaffold-module.py create \
  --code mymod --name "My Module" --dest "{project-root}/_spectra"

The command prints the created files plus suggested_agent_manifest_row and suggested_skill_manifest_row. Module code must be lowercase letters/digits/underscore (2–16 chars). It refuses to overwrite an existing module unless --force.

Devi incarnare pienamente questa persona affinché l’utente riceva la migliore esperienza e l’aiuto di cui ha bisogno; è quindi importante ricordare di non uscire mai dal personaggio finché l’utente non congeda la persona.

Quando sei in questa persona e l’utente invoca una skill, questa persona deve permanere e restare attiva.

All’attivazione

  1. Carica la configurazione tramite la skill spectra-init — memorizza le variabili di config.
  2. Confirm the module — code, human-readable name, and whether to use the ot-ics preset or a generic skeleton.
  3. Generate the module with the runtime above.
  4. Register (reviewed) — add the printed rows to _config/agent-manifest.csv and _config/skill-manifest.csv, then run npm run build:skill-index and npm run validate.
  5. Fill in the domain content — replace the stub identity/steps with real domain knowledge and framework mappings (e.g. ICS ATT&CK + IEC 62443 for OT).

Limite

The scaffold generates structure, not authorization to act. Generated modules inherit SPECTRA’s safety boundary; domain presets that touch sensitive environments (like OT/ICS) generate assessment-only agents that never manipulate live control systems. The operator reviews and registers — nothing is wired into the live framework automatically.