siae-dev-forge

Use when handling security-sensitive code: credentials, IAM policy, encryption, PII (autori/artisti), copyright codes (ISWC/ISRC). Applies OWASP Top 10 + AWS security policy SIAE. Trigger: codice security-sensitive, gestione credenziali, IAM policy, encryption, dati personali autori/artisti, codici ISWC/ISRC.

Genera il Master Test Plan (MTP) in formato .docx e la Product Risk Analysis (PRA) in formato .xlsx conformi ai template SIAE, attraverso un flusso interattivo a 6 fasi. Orchestra: intake perimetro (3 canali: JIRA/chat/documenti), analisi funzionale, conferma sistemi impattati, discovery GitHub opzionale, produzione .docx e .xlsx via patch template. Lingua: italiano.

Use when running any git operation (checkout/commit/push/merge/tag), creating a branch, writing a conventional commit, preparing a deploy, promoting an environment, performing hotfix or rollback. Gestisce tutte le operazioni git secondo il branch flow SIAE. Trigger: git checkout -b, git commit, git push, git merge, git tag, creazione branch, naming branch, conventional commits, pre-flight card, inizio feature, preparazione deploy, promozione ambiente, hotfix, rollback, push remoto, tag deploy ambiente.

Use when promoting a release branch to main by opening a PR `release/{area}_DL_{increment}` → `main`, optionally mergiando prima la feature branch corrente (o una passata in input) dentro la release. Trigger: "pr verso main", "promuovi release", "release to main", "apri PR main", "merge feature in release e PR", "promozione main", "siae-release-pr-to-main", "pr release main".

Use when an AWS resource already exists in the cloud but Terraform vuole crearla da zero (errore ResourceExistsException / EntityAlreadyExists). La skill guida l'import nello state Terragrunt di un repo datalake SIAE, gestendo proxy Zscaler, render dei _envs templates, override TLS e verifica idempotente. Trigger: "terraform import", "ResourceExistsException", "EntityAlreadyExists", "importa risorsa esistente", "secret gia creato", "risorsa orfana terraform", "adottare risorsa esistente", "siae-terraform-import".

Use when measuring velocity and quality of SIAE developers using Claude Code + DevForge, or generating the ROI / KPI Excel report. Misura velocità e qualità degli sviluppatori SIAE che usano Claude Code + DevForge. Genera report Excel con 11 KPI (DORA + DX AI Measurement) + ROI Index. Trigger: "misura produttività dev", "ROI Claude Code", "KPI sviluppatori", "analytics dev", "report performance team", "/forge-analytics", "dev metrics", "velocity quality report", "dashboard produttività", "cosa fanno gli sviluppatori", "benchmark dev", "ROI AI coding".

Use when devi generare in un colpo solo TUTTI i documenti di un rilascio EDW SIAE (NDR DL, NDR RS, GDC, slide architettura, DDE) partendo da un singolo YAML manifesto. Versione "mono/monolitica": tutta la logica di orchestrazione e generazione vive in questa skill, senza dipendenze da altre skill. Trigger: genera tutti i documenti, suite rilascio EDW, EDW_XX.XX docs completi, full release docs, DMND000XXXX documenti, /forge-release-docs-mono.

Use when reverse-engineering a PDF into a JasperReports JRXML template pixel-perfect. Iterazione automatica: estrae font, bbox, layout dal PDF, genera JRXML, renderizza, confronta pixel-per-pixel, corregge fino a soglia <2% diff. Trigger: "jrxml da pdf", "ricostruisci jasper", "pdf to jrxml", "genera template jasper", "replica pdf in jasper", "jasper from pdf", "crea jrxml dal pdf", "reverse engineering pdf jasper", "JasperReports da pdf".

Crea i test IaC (Terraform Test Framework) per un repo datalake-{dominio}-iac SIAE. Genera tre suite di test: modulo bronze (risorse AWS pianificate), modulo silver (naming database e IAM policy), tables_definition (coerenza YAML bronze e DDL silver). Nessun deploy reale, nessuna AWS call — solo `terraform plan` con mock provider. Trigger: aggiungere test IaC datalake, test bronze module, test silver module, test tables_definition, verificare infrastruttura datalake, test terraform datalake, test offline deploy, siae-datalake-iac-test.

Guida la creazione di test IaC (Terraform Test Framework) per un nuovo Glue job nel data lake SIAE. Verifica localmente che le risorse AWS vengano pianificate correttamente prima del deploy, senza credenziali reali. Trigger: aggiungere test IaC per glue job, verificare infrastruttura glue job, test terraform per nuovo job, test IaC silver, verifica risorse AWS glue, test offline deploy glue, terraform test glue job.

Static, multi-repo, cross-stack functional bug hunter. Ingests repo roots, generates evidence-grounded bug hypotheses, emits deterministic qa_report.md grouped by user-journey for a manual QA tester. Manual-only: invoke via /siae-functional-bug-hunter, no NL trigger, no auto hooks. See "Scope e modalita" nel body per stack supportati, modi runtime, esclusioni.

Use when profiling microservices for documentation OR for impact analysis. Two modes: - **Mode A (build-catalog)**: build L1+L2+L3 catalog (domain profile + workflow map + business rules) for a cluster of microservices. Trigger: "build catalogo L1/L2/L3", "lanciamo su <pattern>", "analizziamo <sistema>", "regole business di X", "Drools in Y", "cosa fa {servizio}", "mappa la logica", "quali servizi gestiscono X". - **Mode B (impact-analysis)**: pre-flight MCP single-task con output standardizzato (rischio + 3 vincoli + volumi). Trigger: "modifica su servizio business-critical", "impact analysis", "blast radius", "demand impact", "pre-flight MCP", /forge-mcp-preflight. Examples: "cosa fa servizio X", "impact di modifica DTO Y", "build catalogo cluster Z".

Use when creating release and feature branches for a new increment/sprint. Trigger: "crea branch", "nuovo branch release", "branch feature", "setup branch", "crea release e feature", "inizia increment", "nuovo increment".

Use when developing Flutter mobile apps with MVVM + Riverpod, ObjectBox persistence, Amplify/Cognito auth, Firebase, Dio networking, or code generation. Guida lo sviluppo di app Flutter SIAE. Trigger: Flutter, Dart, Riverpod, ObjectBox, Get_it, Amplify, Cognito, app mobile, widget, build_runner, Dio, Crashlytics, deep link, geolocation.

Use when writing Vue.js/Angular/React components, Vitest tests, S3+CloudFront deploys, or frontend integrations (Pinia, Vue Router, Firebase). Guida la scrittura di componenti frontend, test e deploy. Trigger: componente Vue.js, Vitest, test frontend, deploy S3 CloudFront, Firebase, Pinia, Vue Router, responsive design, drag drop, upload file.

Guida la creazione di test Python (pytest) + pipeline CI coverage per i Glue job di un modulo datalake-{dominio}-etl SIAE, replicando il pattern standard del reusable workflow itsiae/siae-gh-actions/pytest-coverage.yaml. I test girano localmente senza cluster Glue (stub awsglue + SparkSession locale) e in CI con gate di coverage bloccante. Trigger: test python glue job, pytest glue, coverage glue jobs, ci python coverage, test custom_classes, stub awsglue, pytest-coverage workflow, test pyspark locale, aggiungere test python a modulo etl, soglia coverage 70, TEST_COVERAGE_PERCENTAGE.

Use when writing or modifying Terraform modules, terragrunt.hcl files, or AWS infrastructure (VPC, ECS, Lambda, DynamoDB, S3, security groups, API Gateway). Guida la scrittura e modifica di IaC. Trigger: modulo Terraform, terragrunt, file .tf, .hcl, VPC, ECS, Lambda, DynamoDB table, S3 bucket, security group, API Gateway, infrastruttura AWS.

Use at session start or new project context to establish the DevForge backbone (brainstorm → plan → tdd → verification) and discover available skills. Acts as the discovery entry point for the marketplace and is invoked automatically by the session-start hook. Trigger: inizio sessione, apertura nuovo progetto, prima interazione, session-start hook trigger.

Use when preparing a feature/fix branch for PR. Pre-flight checklist completo (test, coverage, CHANGELOG, branch hygiene, blind review gate) prima di pushare e aprire la PR. Best after: siae-verification passed. Trigger: "pronto per PR", "finisco il branch", "ready to merge", "apro la PR", gh pr create, git push + PR, apertura pull request, branch completato, implementazione finita, lavoro completato su branch, pre-merge checklist.

Aggiunge un nuovo prefix S3 alla event rule EventBridge `transient_relational_new` in modules/transient/eventbridge-new-data.tf seguendo il flusso completo SIAE — crea release+feature branch, applica edit, apre PR draft, mergia in deploy/collaudo, esegue make dev. Trigger - "aggiungi prefix transient", "nuovo prefix bronze", "aggiungi dominio a transient_relational_new", "abilita ingestion {db_name}", "registra prefix EventBridge", "registra dominio EDW".

Use when performing a blind code review: receive ONLY the spec, locate the code autonomously, evaluate as a hostile auditor. Review cieca: riceve SOLO la spec, trova il codice autonomamente, valuta come auditor ostile. Trigger: "blind review", "review cieca", "audit spec", "verifica spec vs codice", "review senza diff", REQUIRED SUB-SKILL da siae-finishing-branch.

Enterprise test generation agent invoked via /code-coverage. Analyzes a repository, infers tech stack, and generates deterministic unit tests targeting >=70% coverage. Zero user runtime interactions.

Use when designing any implementation task before writing code (feature, bug fix, refactor, config change). Forces 7-step process: intake → scope → options → design → review → approval → handoff to siae-writing-plans. Mandatory before any code change. Trigger: feature nuova, design, come procediamo, come progettiamo, quale approccio, valutare opzioni, trade-off, prima dell'implementazione, aggiungi feature, costruisci, crea componente, nuovo servizio, refactoring architetturale, migrazione, bug fix, refactoring, ottimizzazione, modifica codice, qualsiasi task implementativo, config change.

Use when review-evidence v2 hook ha emesso BLOCK_REGRESSION e vuoi tentare un auto-fix loop hook-driven. Skill composer che legge `block_reasons` atomici e dispatcha `siae-tdd` o `siae-code-standards` via Skill tool fino ad AUTO_APPROVE (max 5 iter, token budget 200k, oscillation guard). Trigger: /forge-fix-evidence, "auto-fix evidence", "rimedio automatico", "fixa block_regression", "loop di remediation", BLOCK_REGRESSION ricevuto.

Use when dispatching parallel implementer subagents from a validated plan in the current session (vs siae-executing-plans for separate session). Trigger: /forge-implement, implementa il piano, dispatcha task, lancia implementer, subagent, controller-subagent, orchestrazione implementazione.

Use when a PR has been opened and you need to complete it with description and assigned reviewer before requesting review. Trigger: "pronto per review", "ho aperto la PR", "chiedo il review", PR aperta senza reviewer assegnato, assegna reviewer, richiedi review, PR creata, post-PR, reviewer mancante.

Use when checking SIAE branching strategy compliance across PRs in itsiae org, the current repo, or repos selected by GitHub topic. Verifica compliance alla branching strategy SIAE: default branch deve essere main, solo release/** apre PR verso main. Trigger: "branching check", "/branching-strategy-check", "PR verso main", "verifica branching strategy", "violazioni branching", "default branch errato", "release branch".

Use as REQUIRED SUB-SKILL from siae-codebase-map when --tiered flag is set. Generates hierarchical CLAUDE.md (L1 root + L2 package + L3 child on-demand) from existing docs/CODEBASE_MAP.md, following Anthropic best practices for large codebases (load-on-demand, anti-bloat, import @ chain). Trigger: invoked by siae-codebase-map Step 7a, never standalone.

Use when launching a CI/CD pipeline for a datalake repo and monitoring its result. Trigger: "make dev", "make qa", "make plan_dev", "make plan_qa", "lancia pipeline", "deploy dev", "deploy qa", "plan dev", "plan qa", "triggera pipeline", "avvia deploy", "esegui deploy", "monitora pipeline". Parametro obbligatorio: ambiente = "dev", "qa", "plan_dev" oppure "plan_qa".

Use when setting up a new datalake ETL repo (datalake-{dominio}-etl) from a reference repo. Trigger: "setup repo etl", "nuovo dominio etl", "crea repo datalake etl", "scaffolding etl", "datalake-{nome}-etl", "setup da riferimento", "clona struttura etl".

Use when investigating a bug, errore, incident, test che fallisce, comportamento inatteso, eccezione, stacktrace, crash, build failure, 500, timeout, NullPointerException, TypeError, "non funziona", "rotto", "fallisce", "non va" — prima di proporre qualsiasi fix. Forza root cause analysis a 4 fasi (reproduce → pattern → hypothesize → fix) con HARD-GATE su Fase 1.

Use when the user wants to rename a column in an AWS DMS task mapping rules JSON file. Trigger: rinomina colonna DMS, rename column mapping, aggiungi regola DMS, rinomina campo, add-column remove-column DMS, mapping rules colonna, rinomina colonna task DMS.

Use when executing an approved implementation plan in a separate session (different from where plan was written). Reads docs/plans/<topic>/ overview + task-NN files, executes batch with human checkpoints. Examples: "esegui il piano nella sessione nuova", "carica il piano e implementa", "batch execution", piano con REQUIRED SUB-SKILL siae-executing-plans header.

Use when copying or syncing GitHub Actions environment variables from a reference datalake repo to a target datalake repo, or when setting/updating a single variable on one or more environments. Trigger: "popola variabili", "copia variabili ambiente", "sync env variables", "setup variabili repo", "variabili GitHub Actions mancanti", "allinea variabili", "setta variabile", "imposta variabile", "aggiorna variabile", "gh variable set".

Use BEFORE opening a Pull Request on itsiae/* repos. Applies Gary Klein's premortem method (HBR 2007): imagine the PR has failed badly 3 months from now, brainstorm concrete failure causes, top-3 with mitigations. Catches failure modes that post-implementation review misses due to hindsight bias. Trigger: prima di gh pr create, prima di merge significativi, audit finale pre-deploy, "che cosa puo' andare storto", premortem, pre-mortem, project premortem, Klein method, failure modes analysis.

Use when assessing pre-deploy risk of a release branch vs main before deploy to prod. 18-criteri scoring (0-36), level LOW/MEDIUM/HIGH/CRITICAL, decision GO/POSTPONE/NO_GO. Trigger: pre-deploy assessment, release readiness check, /forge-release-risk, delivery manager review, release branch ready, CAB gate, scorecard release.

Genera dataset di profili anagrafici autoconsistenti per il sistema SIAE. Usa questa skill quando l'utente vuole generare dati di test per profili SIAE, dati anagrafici fittizi ma validi per testing, mock di codici fiscali italiani, partite IVA, indirizzi coerenti, profili utilizzatori/autori/editori. Attivare anche per: "genera profili di test", "dati anagrafici fittizi", "mock CF italiano", "dati SIAE per test", "crea anagrafica di prova", "fixture SIAE", "test data utilizzatore", "dataset autori editori", "genera CF e P.IVA validi", "mock anagrafica italiana", "test profilo SIAE".

Revisiona Test List manuali (CSV/XLS/XLSX) rispetto ai requisiti di progetto, generando una Matrice di Tracciabilita' Requisiti (RTM) e un report di revisione ISTQB. Usa questa skill quando l'utente carica o menziona una test list, test case list, TL, file di test, scenari di test, o chiede di "revisionare i test", "verificare la copertura dei requisiti", "generare la RTM", "analizzare i test case", "controlla se i test coprono le story Jira", "verifica gli edge case", "traccia i requisiti sui test". Attivare anche quando l'utente nomina file formato SIAE-BTP con colonne ID/Test Type/Team Competenza/ID JIRA Story/Action/ Expected Result. Richiede interazione guidata multi-fase: NON procedere autonomamente senza conferma esplicita a ogni fase.

Use when transforming an approved design doc into a step-by-step implementation plan with bite-sized tasks. Produces docs/plans/<topic>/ directory with overview + task-NN files. Examples: "scrivi piano implementativo", "decomponi design in task", "trasforma design in piano", "piano bite-sized", "aggiorna piano", "task implementativi", "docs/plans/".

Use when evaluating, choosing, or analyzing architectural patterns for an existing or new system. Analizza architettura di sistemi software: C4 model, HLD, bounded context, CQRS, event-driven, microservizi vs monolite, resilienza, accoppiamento tra servizi. Trigger: VALUTARE, SCEGLIERE, ANALIZZARE pattern architetturali. **Best after**: siae-brainstorming Step 4 (options proposed) — questa skill è specialistica per deepen architectural choice già scoperto. Examples: "valutiamo CQRS", "microservizi o monolite?", "crea il C4", "definisci i bounded context", "HLD per il sistema X".