Commit graph

45 commits

Author SHA1 Message Date
AgentePotente
7bcd874e32 feat(css_layout): add grid-by-item-count guidance
- Add .grid-6 class for 6-column layouts
- New section: Grid by Item Count with decision table
- Concrete examples for 2, 4, 6 items
- Anti-pattern warning: avoid 4 items in 3-col grid
- Prevents empty space issues in layouts
2026-03-11 18:47:05 +01:00
AgentePotente
91d70558ac feat(placeholder): add placeholder mode for asset-missing workflows
- agency-archivist: frontmatter updated + 3-option pattern + placeholder section
- agency-visual-generator: 3-option pattern (block/placeholder/skip)
- agency-web-developer: placeholder inline SVG/CSS option
- agency-design-system: placeholder tokens option

All consuming skills now offer:
1. Block and request assets (traditional)
2. Placeholder mode for continuous workflow 
3. Skip asset if optional

Pattern allows prototyping without real assets.
2026-03-11 10:42:47 +01:00
092bae7608 Update agency-shared-references/references/quality_bar.md 2026-03-10 23:29:41 +00:00
0dd0fa88b1 Update agency-shared-references/SKILL.md 2026-03-10 23:29:02 +00:00
fc22f633b6 Update agency-analytics/SKILL.md 2026-03-10 23:27:55 +00:00
b368bca23e Update agency-orchestrator/SKILL.md 2026-03-10 23:26:47 +00:00
ae3058fc38 Update agency-orchestrator/SKILL.md 2026-03-10 23:25:39 +00:00
420fb26616 Update agency-orchestrator/SKILL.md 2026-03-10 23:20:47 +00:00
0d939fefcb Update README.md 2026-03-10 23:17:50 +00:00
AgentePotente
3ac65557a0 Pulizia README e references: Publishing Gates rivisto, rimossi header/footer framework
README.md:
- Publishing Gates: sezione riscritta più chiara con workflow manuale dettagliato
- Note finali: aggiornate per coerenza (publish manuale, 5 workflow)
- Versione: v2.1 — No Publisher, Manual Publish Gate-Based

References (19 file):
- Rimosso '_Framework: agency_v3_1 | Estratto: 2026-03-09_' dall'header
- Rimosso '_Reference generato da framework-translator_' dal footer
- Mantenuto solo '_Usato da:_' dove presente

Files modificati: 20 (1 README + 19 references)
2026-03-11 01:24:00 +01:00
AgentePotente
5ef7b67e40 Rimozione agency-publisher: skill inutilizzabile senza integrazioni webhook/API esterne
- Eliminata cartella agency-publisher/
- Aggiornato README: 14 skills (da 15), workflow publish manuale
- Aggiornato agency-orchestrator: publish gate gestiti manualmente
- Rimosso riferimenti da qa_visual.md e resource_types.md
- Aggiunto report analisi in PUBLISHER_REMOVAL_REPORT.md

Publish ora gestito manualmente con:
- APPROVED: YES nel frontmatter
- PUBLISH_APPROVED.md
- publish_log.md per tracciabilità
2026-03-11 01:19:04 +01:00
AgentePotente
4cf13b3e8e Fix: aggiornato struttura path da clients/{client} a {project} nelle references 2026-03-11 01:11:12 +01:00
AgentePotente
84168d1b12 Rimozione publishing_gates.md: reference inutile, gate gestiti direttamente nelle skills tramite frontmatter APPROVED e PUBLISH_APPROVED.md 2026-03-11 01:04:01 +01:00
13ad0b935d Delete AGENCY_ARCHIVIST_DELIVERY.md 2026-03-10 22:44:48 +00:00
c3d96a1b18 Delete CONVERSION_REPORT.md 2026-03-10 22:44:20 +00:00
e1ac0ce8e9 Update README.md 2026-03-10 22:44:09 +00:00
ff96aefd7c Delete agency-archivist/README.md 2026-03-10 22:43:00 +00:00
0b4c6befec Update README.md 2026-03-10 22:42:12 +00:00
AgentePotente
35087157c2 Aggiornato CONVERSION_REPORT.md con Iterazione 5 (script archivist universalmente compatibili) 2026-03-11 00:48:57 +01:00
AgentePotente
0b4c56d744 Script agency-archivist: compatibilità universale e {project}/
- extract_archive.js: --client → --project, rimossa dipendenza da .openclaw
- scan_resources.js: --client → --project, basePath configurabile
- generate_catalog.js: --client → --project, basePath configurabile
- Environment variable: AGENCY_PROJECTS_BASE per specificare base directory
- Default: current working directory (compatibile con qualsiasi sistema)
- Percorsi aggiornati: clients/{client}/ → {project}/
- Documentazione script aggiornata (usage, options, examples)

Vantaggi:
 Compatibile con OpenClaw e altri sistemi
 Non richiede struttura .openclaw/workspace
 Configurabile via ENV o --base-path
 Funziona in qualsiasi directory di progetto
2026-03-11 00:48:40 +01:00
AgentePotente
f0605645d3 Aggiornato CONVERSION_REPORT.md con Iterazione 4 (generalizzazione {project}/) 2026-03-11 00:43:06 +01:00
AgentePotente
a29db752af Generalizzazione: sostituito clients/{client}/ con {project}/
- Sostituite 135 occorrenze di clients/{client}/ con {project}/
- Aggiornati parametri: client_path → project_path in 11 skills
- README.md aggiornato con nuova convenzione {project}/
- Struttura cartelle ora agnostica: compatibile con clients/, projects/, o qualsiasi cartella
- Maggiore flessibilità per diversi sistemi e workflow

Vantaggi:
 Compatibile con qualsiasi struttura cartelle
 Non impone convenzione 'clients/'
 Utile per progetti interni, campagne, o clienti
 Più generale e riutilizzabile
2026-03-11 00:42:52 +01:00
AgentePotente
3e926f27eb Aggiornato CONVERSION_REPORT.md con Iterazione 3 (semplificazione installazione) 2026-03-11 00:35:19 +01:00
AgentePotente
72c497087e Semplificazione installazione: rimosse istruzioni dettagliate e INSTALL.sh
- README.md: sezione Installazione semplificata in 3 righe
- Istruzioni generiche per umani e agenti (chiudi archivio o copia diretta)
- Eliminato INSTALL.sh (non necessario, zero configurazione)
- Rimosso riferimento a ClawHub e metodi multipli
- Focus: copia cartella e verifica, niente symlink o setup
2026-03-11 00:35:07 +01:00
AgentePotente
0234cd0aaa Aggiornato agency-shared-references/SKILL.md: Indice referenze dettagliato
- Sostituita sezione 'Uso dalle Skills' con 'Indice delle Referenze'
- 24 documenti organizzati per categoria (Design, Copy, Strategy, Quality, Technical, Resources)
- Per ogni riferimento: titolo, descrizione contenuti, quando usarlo
- Struttura più utile per consultazione rapida
- Descrizione aggiornata nel frontmatter YAML
2026-03-11 00:27:01 +01:00
AgentePotente
d0d3bcad35 Aggiornato CONVERSION_REPORT.md con Iterazione 2 (eliminazione symlink) 2026-03-11 00:19:34 +01:00
AgentePotente
1feb27b149 Rimozione symlink: percorsi diretti verso agency-shared-references
- Eliminati tutti i symlink references/ dalle 14 skills
- Aggiornati tutti i riferimenti nei SKILL.md con percorsi completi
  (es. ../agency-shared-references/references/quality_bar.md)
- README.md aggiornato: nessuna configurazione symlink necessaria
- INSTALL.sh semplificato: solo copia e verifica, no symlink
- Struttura più semplice e compatibile con tutte le piattaforme
- Nessun file di configurazione o link simbolico richiesto
2026-03-11 00:19:22 +01:00
AgentePotente
a4587a3686 Aggiunto CONVERSION_REPORT.md - Documentazione completamento migrazione 2026-03-11 00:11:27 +01:00
AgentePotente
b289d87033 Conversione references in skill condivisa agency-shared-references
- Creata nuova skill agency-shared-references con 24 references centralizzate
- Spostate tutte le references da cartelle sparse (references/, agency-web-developer/, agency-archivist/) in un'unica posizione
- Aggiornati tutti i symlink delle 14 skills per puntare a ../agency-shared-references/references
- Aggiornati tutti i riferimenti nei SKILL.md (percorsi coerenti)
- README.md aggiornato con nuova struttura e istruzioni generiche
- INSTALL.sh semplificato con istruzioni platform-agnostic
- Eliminata cartella references/ dal root (ora centralizzata)
- Struttura più pulita e mantenibile, facile da installare su qualsiasi piattaforma
2026-03-11 00:11:03 +01:00
AgentePotente
c496db151c DOCS: Aggiornato README.md con agency-archivist
- Panoramica: 13 → 14 skills, 20 → 21 references
- Tabella skills: aggiunto agency-archivist ()
- References: aggiunta sezione Archivist con resource_types.md
- Workflow: inserito step Upload Risorse (Fase 1 opzionale)
- Struttura: dettagliata agency-archivist/ con scripts/
- Uso: aggiunta sezione per comandi archivist

Tutta la documentazione ora riflette la nuova skill di gestione risorse.
2026-03-10 23:51:32 +01:00
AgentePotente
f205028145 FIX: Aggiornati tutti i riferimenti script da .py a .js
- agency-archivist/SKILL.md: 2 riferimenti (Fase 2, Fase 3)
- agency-orchestrator/SKILL.md: 3 riferimenti (sezione Script)
- AGENCY_ARCHIVIST_DELIVERY.md: 7 riferimenti (file creati + esempi)

Totale: 12 riferimenti corretti da Python a Node.js
2026-03-10 23:49:21 +01:00
AgentePotente
94642c3501 PORTING: Python → Node.js per agency-archivist scripts
Motivazione:
- Node.js già installato (v25.7.0), zero privilegi necessari
- Nessuna dipendenza npm richiesta (usa built-in modules)
- Tool di sistema per estrazione: unzip, tar, identify (ImageMagick)
- Più gestibile in ambienti senza sudo

Cambiamenti:
- extract_archive.py → extract_archive.js (11.6KB)
  - Usa execSync per unzip/tar/unrar
  - Stessa logica, zero dipendenze esterne

- scan_resources.py → scan_resources.js (13.4KB)
  - Usa ImageMagick identify per metadata immagini
  - ffprobe opzionale per video
  - Genera tag e use case automaticamente

- generate_catalog.py → generate_catalog.js (8.7KB)
  - Stesso output markdown
  - Zero dipendenze

- README.md aggiornato con comandi Node.js
- SKILL.md aggiornato con riferimenti corretti

Dipendenze opzionali (tool di sistema):
- unrar: Supporto archivi RAR
- ffmpeg/ffprobe: Metadata video avanzati
2026-03-10 23:44:14 +01:00
AgentePotente
45825704e0 DOCS: agency-archivist delivery summary 2026-03-10 23:31:51 +01:00
AgentePotente
ea5b68beb9 STEP 3: Integrazione agency-archivist nelle skill
- agency-visual-generator/SKILL.md:
  - Lettura catalogo risorse prima di generare asset
  - Richiesta proattiva risorse mancanti (@agency-archivist)
  - Recupero logo e immagini da catalog.md

- agency-design-system/SKILL.md:
  - Verifica brand assets (logo, colori, font) prima di iniziare
  - Richiesta risorse mancanti con requisiti specifici
  - Integrazione resource_types.md nelle references

- agency-web-developer/SKILL.md:
  - Lettura catalogo per immagini sito (logo, hero, team, favicon)
  - Richiesta asset mancanti prima di sviluppare
  - Collegamento asset da assets/ a website/assets/
  - Integrazione resource_types.md e flusso consigliato

Pattern comune per tutte le skill:
1. Leggi clients/{client}/assets/catalog.md
2. Cerca risorse per tag/tipo
3. Se mancano: FERMATI, tagga @agency-archivist, specifica requisiti
4. Attendi sblocco dopo upload e re-scan
2026-03-10 23:31:32 +01:00
AgentePotente
b1f3ba033e STEP 2: agency-archivist - Nuova skill gestione risorse
- agency-archivist/SKILL.md: Skill per upload, estrazione, catalogazione
- scripts/extract_archive.py: Estrazione zip/URL in clients/{client}/assets/
- scripts/scan_resources.py: Scansione metadata (2 passate: base + vision)
- scripts/generate_catalog.py: Generazione catalogo.md con tag e use case
- references/resource_types.md: Tipologie risorse e use case per skill
- agency-orchestrator/SKILL.md: Integrazione archivist in Fase 1
  - Step opzionale upload risorse
  - Sezione dedicata gestione risorse
  - Comportamento proattivo (richiesta risorse mancanti)
  - Pattern per altre skill

Integrazione completa: orchestrator → archivist → visual-generator/design/web/social
2026-03-10 23:29:41 +01:00
6c1b04d39a Update agency-orchestrator/SKILL.md 2026-03-10 16:27:24 +00:00
AgentePotente
05f6d9d305 agency-orchestrator: supporto estrazione company profile da documento
- Aggiunta Modalità B di onboarding: accettazione documenti (PDF, DOCX, MD, PPTX, TXT)
- Estrazione automatica di tutti i campi del questionario da documenti esistenti
- Procedura di validazione e conferma dati estratti
- Gestione intelligente campi mancanti con assunzioni documentate
- Vantaggi: no questionari per il cliente, uso materiali esistenti, più professionale
2026-03-10 18:36:58 +01:00
AgentePotente
dc8894993d Pulizia riferimenti framework: README e orchestrator aggiornati con i 5 workflow ufficiali 2026-03-10 02:44:20 +01:00
AgentePotente
40efeb240c Fix YAML frontmatter: quote description fields to avoid colon parsing issues 2026-03-10 02:17:17 +01:00
a468678c6b Simplified definitions 2026-03-09 17:03:03 +00:00
AgentePotente
f974c469a8 Semplificazione: rimossi riferimenti a MVP e backlog da tutte le skills
- agency-orchestrator: eliminati MVP, backlog, P0/P1/P2; semplificato a progetto e workflow
- agency-analytics: rimosso riferimento a backlog, usato run_log per azioni
- Semplificata terminologia: 'V1' → 'standard di qualità', 'MVP' → 'workflow'
- Focus su esecuzione workflow invece di gestione backlog complessa
2026-03-09 18:47:47 +01:00
AgentePotente
6ad0b7dfd2 Update agency-orchestrator: questionario onboarding + creazione cartella cliente
- Rielaborata sezione Input: trasformata in questionario di onboarding completo con 6 sezioni (info base, obiettivi, audience, offerta, preferenze, workflow)
- Aggiornata Fase 1: aggiunto step di proposta path cliente con richiesta conferma esplicita prima di creare cartelle
- Definita struttura cartelle standard: knowledge/, research/, strategy/, design/, content/, ops/, published/
- Rafforzate regole: non bloccare per input mancanti, V1 prima, tracciabilità decisioni
2026-03-09 18:36:28 +01:00
AgentePotente
b916892ee5 feat: Cross-references tra web-developer e altre skills
Analisi completata:
- Web-developer references rimangono dedicate (tecniche: HTML/CSS/JS)
- Shared references rimangono per UX/design patterns (strategici)

Aggiunti riferimenti incrociati:

1. agency-web-developer:
   - +5 shared references (hero, design, navigation, conversion, layout patterns)
   - Flusso: leggi pattern UX → implementa con technical refs

2. agency-design-system:
   - +3 web-developer refs per handoff tecnico
   - Nota: produce design doc, web-developer implementa codice

3. agency-ux-copy:
   - +design_patterns.md
   - +2 web-developer refs per handoff HTML/CSS
   - Nota: produce copy, web-developer implementa codice

4. agency-seo:
   - +2 web-developer refs per implementazione on-page SEO
   - Nota: produce strategia SEO, web-developer implementa HTML

Flusso chiarito:
- Shared refs = COSA fare (pattern UX/design)
- Web-developer refs = COME codificare (implementazione tecnica)
2026-03-09 18:12:44 +01:00
AgentePotente
b79b28034a feat: Added agency-web-developer skill
- New skill for building static websites from copy + design system
- HTML semantic with accessibility + SEO best practices
- CSS layout with Bootstrap or custom support
- JS interactivity with jQuery + GSAP for smooth animations
- 3 reference files: html_semantics.md, css_layout.md, js_interactivity.md
- Updated README with new skill (13 total) and references (23 total)
- Workflow updated: agency-ux-copy → agency-web-developer → agency-seo

No overlap with existing skills:
- agency-visual-generator: generates images (PNG/webp) for social/YouTube
- agency-publisher: publishes content via webhook
- agency-web-developer: builds complete static websites (HTML/CSS/JS)
2026-03-09 14:21:32 +01:00
AgentePotente
6ac766172c Initial release: agency_v3_1-skills-suite v1.0
- 12 AgentSkills generate da agency_v3_1 framework
- 17 references centralizzate
- Script INSTALL.sh per installazione automatica
- README.md con documentazione completa

Skills incluse:
- agency-orchestrator (coordinamento + QA)
- agency-strategy (positioning, messaging)
- agency-research (competitive intelligence)
- agency-creative-director (direzione visiva)
- agency-design-system (tokens, components)
- agency-ux-copy (sitemap, copy)
- agency-seo (SEO tecnico)
- agency-social (social strategy)
- agency-youtube (YouTube strategy)
- agency-visual-generator (asset visuali)
- agency-analytics (report KPI)
- agency-publisher (publish gate-based)

Generated by framework-translator v2.0
Approved by: MarcoB (2026-03-09)
2026-03-09 12:23:58 +01:00