diff --git a/README.md b/README.md index a71237e..e6bee9a 100644 --- a/README.md +++ b/README.md @@ -172,28 +172,39 @@ Invocare agency-orchestrator per iniziare un workflow ## Publishing Gates -**Importante:** Il publish è gestito manualmente o con script custom. Tutte le skills che producono content pubblicabile seguono gate rigorosi: +**Importante:** Il publish è gestito manualmente (o con script custom). Ogni content pubblicabile deve superare gate di approvazione: -- Mai publish senza `APPROVED: YES` nel frontmatter -- Mai publish senza `PUBLISH_APPROVED.md` = YES -- QA obbligatorio prima di publish +**Gate obbligatori:** +- ✅ `APPROVED: YES` nel frontmatter del content file +- ✅ `PUBLISH_APPROVED.md` = `YES` (approvazione esplicita del cliente) +- ✅ QA checklist compilata e passata **Workflow manuale:** -1. Content approvato (`APPROVED: YES` nel frontmatter) -2. QA compilato e passato -3. Crea `PUBLISH_APPROVED.md` con `YES` -4. Pubblica manualmente (LinkedIn, Instagram, YouTube, etc.) -5. Aggiorna `{project}/ops/publish_log.md` con URL e data +1. Completa content (post, script, copy, etc.) +2. Compila QA checklist specifica +3. Ottieni approvazione (`APPROVED: YES` + `PUBLISH_APPROVED.md`) +4. Pubblica manualmente sulla piattaforma (LinkedIn, Instagram, YouTube, web) +5. Aggiorna `{project}/ops/publish_log.md` con data, URL e note -**Nota:** Non è inclusa una skill di publish automatizzato per evitare dipendenze da webhook/API esterne. Utenti avanzati possono creare script custom se necessario. +**Publish log template:** +```markdown +# Publish Log — {Client} + +| Data | Platform | Content ID | Status | URL | Note | +|------|----------|------------|--------|-----|------| +| 2026-03-11 | LinkedIn | post_001 | Published | https://... | Good engagement | +``` + +**Nota:** La suite non include automazione di publish per evitare dipendenze da API/webhook esterne. Utenti tecnici possono aggiungere script custom se necessario. ## Note -- **Lingua:** Skills in inglese, alcune references bilingue (IT/EN) -- **Dominio:** Agency digitali, content production, multi-agent coordination -- **Complexity:** MEDIUM-HIGH (14 skills, 22 references, workflow coordinati) -- **Architecture:** References centralizzate in agency-shared-references, percorsi diretti da tutte le skills -- **Project Structure:** `{project}/` come cartella di lavoro (agnostico, compatibile con qualsiasi sistema) +- **Lingua:** Skills in inglese, references bilingue (IT/EN) per facilitare adozione +- **Dominio:** Digital agency, content production, multi-agent coordination +- **Complexity:** MEDIUM-HIGH (14 skills, 22 references, 5 workflow coordinati) +- **Architecture:** References centralizzate, percorsi diretti (`../agency-shared-references/references/`) +- **Project Structure:** `{project}/` come cartella di lavoro agnostica (compatibile con qualsiasi sistema) +- **Publish:** Manuale gate-based (nessuna automazione per evitare dipendenze esterne) ## Supporto @@ -201,4 +212,4 @@ Per issue o domande sulla suite, consulta la documentazione interna o il reposit --- -_Agency Skills Suite v2.0 — References Centralizzate_ +_Agency Skills Suite v2.1 — No Publisher, Manual Publish Gate-Based_ diff --git a/agency-shared-references/references/audience_personas.md b/agency-shared-references/references/audience_personas.md index 3bd3d3c..b7f1e2b 100644 --- a/agency-shared-references/references/audience_personas.md +++ b/agency-shared-references/references/audience_personas.md @@ -1,6 +1,5 @@ # Audience Personas -_Framework: agency_v3_1 | Estratto: 2026-03-09_ _Usato da: agency-strategy, agency-research_ ## Sommario @@ -30,6 +29,4 @@ Template per definire ICP e personas. - Usare linguaggio reale (da interviste, recensioni, social) - Aggiornare dopo research competitor ---- -_Reference generato da framework-translator_ diff --git a/agency-shared-references/references/brand_voice.md b/agency-shared-references/references/brand_voice.md index 74670d4..ecf4463 100644 --- a/agency-shared-references/references/brand_voice.md +++ b/agency-shared-references/references/brand_voice.md @@ -1,6 +1,5 @@ # Brand Voice -_Framework: agency_v3_1 | Estratto: 2026-03-09_ _Usato da: agency-strategy, agency-social, agency-youtube_ ## Sommario @@ -46,4 +45,3 @@ Linee guida tono di voce per web e social. --- -_Reference generato da framework-translator_ diff --git a/agency-shared-references/references/case_study_structures.md b/agency-shared-references/references/case_study_structures.md index 41692d3..0024729 100644 --- a/agency-shared-references/references/case_study_structures.md +++ b/agency-shared-references/references/case_study_structures.md @@ -1,6 +1,5 @@ # Case Study Structures -_Framework: agency_v3_1 | Estratto: 2026-03-09_ _Usato da: agency-strategy, agency-ux-copy_ ## Sommario @@ -54,4 +53,3 @@ Template per case study che dimostrano competenza e riducono rischio percepito. --- -_Reference generato da framework-translator_ diff --git a/agency-shared-references/references/content_formats.md b/agency-shared-references/references/content_formats.md index f05de45..273b3e6 100644 --- a/agency-shared-references/references/content_formats.md +++ b/agency-shared-references/references/content_formats.md @@ -1,6 +1,5 @@ # Content Formats -_Framework: agency_v3_1 | Estratto: 2026-03-09_ _Usato da: agency-social, agency-youtube_ ## Sommario @@ -72,4 +71,3 @@ Ogni pillar dovrebbe produrre 3-5 format ricorrenti (rubriche). --- -_Reference generato da framework-translator_ diff --git a/agency-shared-references/references/conversion_patterns.md b/agency-shared-references/references/conversion_patterns.md index 69408d0..358ea85 100644 --- a/agency-shared-references/references/conversion_patterns.md +++ b/agency-shared-references/references/conversion_patterns.md @@ -1,6 +1,5 @@ # Conversion Patterns -_Framework: agency_v3_1 | Estratto: 2026-03-09_ _Usato da: agency-ux-copy, agency-strategy_ ## Sommario @@ -70,4 +69,3 @@ CTA, forms e friction reduction per conversioni. --- -_Reference generato da framework-translator_ diff --git a/agency-shared-references/references/copy_frameworks.md b/agency-shared-references/references/copy_frameworks.md index 7df6ee2..994fe00 100644 --- a/agency-shared-references/references/copy_frameworks.md +++ b/agency-shared-references/references/copy_frameworks.md @@ -1,6 +1,5 @@ # Copy Frameworks -_Framework: agency_v3_1 | Estratto: 2026-03-09_ _Usato da: agency-strategy, agency-ux-copy_ ## Sommario @@ -68,4 +67,3 @@ Framework copywriting clarity-first per web e social. --- -_Reference generato da framework-translator_ diff --git a/agency-shared-references/references/design_patterns.md b/agency-shared-references/references/design_patterns.md index c286adb..a5925d1 100644 --- a/agency-shared-references/references/design_patterns.md +++ b/agency-shared-references/references/design_patterns.md @@ -1,6 +1,5 @@ # Design Patterns -_Framework: agency_v3_1 | Estratto: 2026-03-09_ _Usato da: agency-creative-director, agency-design-system, agency-ux-copy_ ## Sommario @@ -107,4 +106,3 @@ Pattern UI riusabili per siti agency/services. Strutture, non stile. --- -_Reference generato da framework-translator_ diff --git a/agency-shared-references/references/hero_sections.md b/agency-shared-references/references/hero_sections.md index dedca57..2766b7b 100644 --- a/agency-shared-references/references/hero_sections.md +++ b/agency-shared-references/references/hero_sections.md @@ -1,6 +1,5 @@ # Hero Sections -_Framework: agency_v3_1 | Estratto: 2026-03-09_ _Usato da: agency-creative-director, agency-ux-copy_ ## Sommario @@ -81,4 +80,3 @@ Esempi: --- -_Reference generato da framework-translator_ diff --git a/agency-shared-references/references/layout_systems.md b/agency-shared-references/references/layout_systems.md index 3a7fa90..c728c4c 100644 --- a/agency-shared-references/references/layout_systems.md +++ b/agency-shared-references/references/layout_systems.md @@ -1,6 +1,5 @@ # Layout Systems -_Framework: agency_v3_1 | Estratto: 2026-03-09_ _Usato da: agency-design-system, agency-creative-director_ ## Sommario @@ -65,4 +64,3 @@ Grid, spacing, density per coerenza e ritmo verticale. --- -_Reference generato da framework-translator_ diff --git a/agency-shared-references/references/navigation_patterns.md b/agency-shared-references/references/navigation_patterns.md index d479741..a194fb8 100644 --- a/agency-shared-references/references/navigation_patterns.md +++ b/agency-shared-references/references/navigation_patterns.md @@ -1,6 +1,5 @@ # Navigation Patterns -_Framework: agency_v3_1 | Estratto: 2026-03-09_ _Usato da: agency-ux-copy, agency-design-system_ ## Sommario @@ -57,4 +56,3 @@ Pattern di navigazione e information architecture per siti agency/services. --- -_Reference generato da framework-translator_ diff --git a/agency-shared-references/references/platform_patterns.md b/agency-shared-references/references/platform_patterns.md index 7ada452..c91c54f 100644 --- a/agency-shared-references/references/platform_patterns.md +++ b/agency-shared-references/references/platform_patterns.md @@ -1,6 +1,5 @@ # Platform Patterns -_Framework: agency_v3_1 | Estratto: 2026-03-09_ _Usato da: agency-social, agency-visual-generator_ ## Sommario @@ -44,4 +43,3 @@ Pattern specifici per piattaforma social. --- -_Reference generato da framework-translator_ diff --git a/agency-shared-references/references/qa_visual.md b/agency-shared-references/references/qa_visual.md index f4af03e..c432a37 100644 --- a/agency-shared-references/references/qa_visual.md +++ b/agency-shared-references/references/qa_visual.md @@ -1,6 +1,5 @@ # QA Visual Checklist -_Framework: agency_v3_1 | Estratto: 2026-03-09_ _Usato da: agency-visual-generator_ ## Sommario @@ -48,4 +47,3 @@ Checklist per review asset visuali generati (card, carousel, thumbnail). --- -_Reference generato da framework-translator_ diff --git a/agency-shared-references/references/quality_bar.md b/agency-shared-references/references/quality_bar.md index a3227b3..cc2e969 100644 --- a/agency-shared-references/references/quality_bar.md +++ b/agency-shared-references/references/quality_bar.md @@ -1,6 +1,5 @@ # Quality Bar -_Framework: agency_v3_1 | Estratto: 2026-03-09_ _Usato da: agency-orchestrator, tutte le skills_ ## Sommario @@ -38,4 +37,3 @@ Ogni skill deve verificare questi criteri prima di considerare un task completo. --- -_Reference generato da framework-translator_ diff --git a/agency-shared-references/references/research_citation_rules.md b/agency-shared-references/references/research_citation_rules.md index a163552..cb77e3d 100644 --- a/agency-shared-references/references/research_citation_rules.md +++ b/agency-shared-references/references/research_citation_rules.md @@ -1,6 +1,5 @@ # Research Citation Rules -_Framework: agency_v3_1 | Estratto: 2026-03-09_ _Usato da: agency-research_ ## Sommario @@ -43,4 +42,3 @@ Ogni source log deve includere: --- -_Reference generato da framework-translator_ diff --git a/agency-shared-references/references/research_playbook.md b/agency-shared-references/references/research_playbook.md index 8290ddb..dea345e 100644 --- a/agency-shared-references/references/research_playbook.md +++ b/agency-shared-references/references/research_playbook.md @@ -1,6 +1,5 @@ # Research Playbook -_Framework: agency_v3_1 | Estratto: 2026-03-09_ _Usato da: agency-research_ ## Sommario @@ -47,4 +46,3 @@ Metodo per research competitor e reference. --- -_Reference generato da framework-translator_ diff --git a/agency-shared-references/references/strategy_playbook.md b/agency-shared-references/references/strategy_playbook.md index d083e94..79170c3 100644 --- a/agency-shared-references/references/strategy_playbook.md +++ b/agency-shared-references/references/strategy_playbook.md @@ -1,6 +1,5 @@ # Strategy Playbook -_Framework: agency_v3_1 | Estratto: 2026-03-09_ _Usato da: agency-strategy_ ## Sommario @@ -71,4 +70,3 @@ Definire 4-6 topic che il brand comunica consistentemente. --- -_Reference generato da framework-translator_ diff --git a/agency-shared-references/references/trust_signal_patterns.md b/agency-shared-references/references/trust_signal_patterns.md index 94cd8e1..5122bb9 100644 --- a/agency-shared-references/references/trust_signal_patterns.md +++ b/agency-shared-references/references/trust_signal_patterns.md @@ -1,6 +1,5 @@ # Trust Signal Patterns -_Framework: agency_v3_1 | Estratto: 2026-03-09_ _Usato da: agency-ux-copy, agency-strategy_ ## Sommario @@ -57,4 +56,3 @@ Pattern per costruire fiducia con prova, chiarezza e coerenza. --- -_Reference generato da framework-translator_ diff --git a/agency-shared-references/references/weekly_report_template.md b/agency-shared-references/references/weekly_report_template.md index 5e385ed..9e97084 100644 --- a/agency-shared-references/references/weekly_report_template.md +++ b/agency-shared-references/references/weekly_report_template.md @@ -1,6 +1,5 @@ # Weekly Report Template -_Framework: agency_v3_1 | Estratto: 2026-03-09_ _Usato da: agency-analytics_ ## Sommario @@ -49,4 +48,3 @@ Template per report settimanali KPI. --- -_Reference generato da framework-translator_ diff --git a/agency-shared-references/references/youtube_script_framework.md b/agency-shared-references/references/youtube_script_framework.md index b88f823..9f52e18 100644 --- a/agency-shared-references/references/youtube_script_framework.md +++ b/agency-shared-references/references/youtube_script_framework.md @@ -1,6 +1,5 @@ # YouTube Script Framework -_Framework: agency_v3_1 | Estratto: 2026-03-09_ _Usato da: agency-youtube_ ## Sommario @@ -29,4 +28,3 @@ Pattern per script YouTube retention-first. --- -_Reference generato da framework-translator_