ai-setup-meta

Repository di governance AI. Contiene i template multi-dominio, gli asset condivisi (agents, skills, profili) e il sistema plugin + marketplace che li distribuisce ai progetti degli sviluppatori.

Setup per sviluppatori

Claude Code

Per aggiungere il workflow AI-Native a qualsiasi progetto (nuovo o esistente):

# 1. Aggiungi il marketplace Acadevmy (una tantum)
/plugin marketplace add acadevmy/ai-setup-meta

# 2. Installa il plugin dev-setup
/plugin install dev-setup@acadevmy

# 3. Avvia il setup nel tuo progetto
/dev-setup:setup

L'agente analizzera' il progetto e applichera' tutto in modo adattivo:

Progetto esistente: innesta solo il workflow AI (CONSTITUTION, AGENT, skills, MCP) senza toccare il tooling
Progetto nuovo (greenfield): setup completo con quality tools, profilo stack, MCP

Prerequisiti: git, claude CLI. Opzionale: gh CLI (per MCP ClickUp e operazioni greenfield).

Cursor

Il plugin dev-setup è distribuito nativamente anche per Cursor. Per installarlo localmente:

# 1. Build del plugin (se non è già aggiornato)
bash scripts/build-plugin.sh dev-setup

# 2. Installa il plugin locale in Cursor
ln -s $(pwd)/dist/dev-setup ~/.cursor/plugins/local/dev-setup

# 3. Ricarica Cursor
# Developer → Reload Window

Il plugin Cursor condivide skills e agents con la versione Claude. Aggiunge:

commands/ — invocabili da Cursor con /skill-name
mcp.json — MCP servers (ClickUp, Figma, Context7) compatibili con Cursor
hooks/hooks.cursor.json — hooks con path variable Cursor-native

Prerequisiti: Cursor, jq.

Gemini CLI

I template che supportano Gemini (attualmente pm-setup) distribuiscono comandi .toml in dist/<template>/gemini/. Per la guida completa vedi dist/pm-setup/gemini/README.md.

Prerequisiti: gemini CLI, Node.js 18+, account ClickUp.

Architettura

┌─────────────────────────────────────────────────────────────┐
│                      ai-setup-meta                          │
│  (questo repo — sorgente di verita' E marketplace)          │
│                                                             │
│  templates/     — sorgente dei template per dominio         │
│  shared/        — agents e skills condivisi                 │
│  dist/          — plugin built (generati da build script)   │
│  marketplace.json — indice plugin per Claude Code           │
│                                                             │
│  Ogni modifica a main passa per PR obbligatoria.            │
└────────────────────────┬────────────────────────────────────┘
                         │
                         │  /plugin marketplace add
                         │  /plugin install dev-setup@acadevmy
                         ▼
┌─────────────────────────────────────────────────────────────┐
│            Repo progetto sviluppatore                        │
│                                                             │
│  /dev-setup:setup                                           │
│  → Rileva modalita' (UPDATE/GREENFIELD/EXISTING)            │
│  → Auto-detect stack                                        │
│  → Installa CONSTITUTION, AGENTS.md, CLAUDE.md, REGISTRY    │
│  → Configura MCP (ClickUp, Context7, Figma)                │
│  → Skills disponibili via plugin                            │
└─────────────────────────────────────────────────────────────┘

Struttura del meta-repo

ai-setup-meta/
├── marketplace.json             # Indice plugin per Claude Code
├── shared/                      # Asset comuni distribuiti ai template
│   ├── agents/
│   │   └── clickup.md
│   └── skills/
│       ├── clickup/
│       └── github-ops/
├── templates/                   # Sorgente dei template per dominio
│   └── dev-setup/
│       ├── manifest.json               # Dipendenze da shared/ e file specifici
│       ├── setup-skill.md              # Setup skill (logica di bootstrap)
│       ├── dev-setup-agent.md          # Agent legacy (reference)
│       ├── AGENTS.template.md          # Template per AGENTS.md generato
│       ├── CONSTITUTION.md
│       ├── REGISTRY.md
│       ├── CHANGELOG.md
│       ├── .claude/
│       │   ├── settings.json           # Permessi + hooks (sorgente)
│       │   ├── hooks/                  # protect-files, post-edit, on-compact
│       │   └── skills/                 # 9 workflow skills
│       └── profiles/
│           ├── web-frontend.md
│           ├── backend-node.md
│           └── mobile.md
├── dist/                        # Plugin built (generati, committati)
│   ├── dev-setup/               # Plugin Claude + Cursor (root condivisa)
│   │   ├── .claude-plugin/      # Manifest Claude Code
│   │   ├── .cursor-plugin/      # Manifest Cursor
│   │   ├── skills/              # 13 skills (condiviso Claude + Cursor)
│   │   ├── agents/              # 2 agents (condiviso Claude + Cursor)
│   │   ├── hooks/               # hooks.json (Claude) + hooks.cursor.json (Cursor)
│   │   ├── commands/            # Commands Cursor (generati da skills)
│   │   ├── .mcp.json            # MCP config Claude
│   │   └── mcp.json             # MCP config Cursor (type rimosso)
│   └── pm-setup/                # Plugin PM multi-piattaforma
│       ├── .claude-plugin/      # Claude Code
│       ├── gemini/              # Gemini CLI (comandi .toml, mcp-remote)
│       └── codex/               # Codex CLI (SKILL.md nativi, config.toml)
├── scripts/
│   ├── build-plugin.sh          # Orchestratore: legge manifest, invoca i builder
│   ├── builders/
│   │   ├── common.sh            # Funzioni condivise (ok, warn, fail, step)
│   │   ├── build-claude.sh      # Builder Claude Code (sempre eseguito)
│   │   ├── build-gemini.sh      # Builder Gemini CLI (se gemini_support)
│   │   ├── build-codex.sh       # Builder Codex CLI (se codex_support)
│   │   └── build-cursor.sh      # Builder Cursor (se cursor_support)
│   ├── release-plugin.sh        # Release: version bump + build + tag + push
│   ├── init-meta.sh
│   └── validate-setup-urls.sh
├── mcp/
│   └── mcp.json.example
└── docs/
    ├── onboarding.md
    ├── developer-guide.md
    └── workflow.md

Build e release

# Build plugin (genera dist/dev-setup/)
bash scripts/build-plugin.sh dev-setup

# Validazione plugin
claude plugin validate dist/dev-setup/

# Test locale
claude --plugin-dir dist/dev-setup/

# Release (version bump + build + changelog + tag + push + GitHub Release)
bash scripts/release-plugin.sh patch dev-setup

Regole operative

Nessun push diretto su main — nemmeno dall'agente. Sempre PR.
La CONSTITUTION.md nel template e' la sorgente di verita' per quel dominio.
Le API key non entrano mai nel repo — solo in .env.local (gitignored) o nei secret GitHub.
dist/ e' generato da build-plugin.sh ma committato (il marketplace punta li').

Skills distribuite dal plugin dev-setup

Flusso consigliato

/dev-setup:setup          ← una tantum, bootstrap del progetto
       │
       ▼
/dev-setup:sdd-discovery  ← intervista strutturata per raccogliere requisiti
       │
       ▼
/dev-setup:sdd-spec       ← genera specifica tecnica dal discovery
       │
       ▼
/dev-setup:sdd-plan       ← presenta la spec per discussione e approvazione
       │
       ▼
/dev-setup:sdd-dev        ← sviluppo guidato dalla spec approvata (TDD/BDD)
       │
       ▼
/dev-setup:review         ← code review con conformita' CONSTITUTION

/dev-setup:sdd orchestra l'intero flusso in un unico comando: task selection → branch → discovery → spec → approval → dev → simplify → verify → review → PR.

Workflow skills

Skill	Descrizione
`/dev-setup:setup`	Bootstrap AI-Native (rileva stack, installa governance)
`/dev-setup:sdd`	Flow Spec-Driven completo: task → discovery → spec → approval → dev → review → PR
`/dev-setup:sdd-discovery`	Intervista strutturata per raccogliere requisiti prima della spec
`/dev-setup:sdd-spec`	Genera specifica tecnica
`/dev-setup:sdd-plan`	Presenta spec per discussione
`/dev-setup:sdd-dev`	Sviluppo da spec approvata

Methodology skills

Skill	Descrizione
`/dev-setup:tdd`	Test-Driven Development (Red-Green-Refactor)
`/dev-setup:bdd`	Behavior-Driven Development (Given/When/Then)
Nessuna	Sviluppo diretto senza ciclo test-first
`/dev-setup:review`	Code review con conformita' CONSTITUTION

Shared skills

Skill	Descrizione
`/dev-setup:clickup`	Operazioni ClickUp via MCP
`/dev-setup:github-ops`	Branch, PR, release su GitHub (`gh` CLI). Si auto-disattiva se il repo non punta a GitHub.
`/dev-setup:gitlab-ops`	Branch, MR, release su GitLab (`glab` CLI). Legge `.gitlab/merge_request_templates/Default.md` quando presente. Si auto-disattiva se il repo non punta a GitLab.

Agents

Agent	Ruolo
review	Code review, conformita' CONSTITUTION, aggiorna REGISTRY
clickup	CRUD ClickUp generico (passthrough MCP)

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Repository files navigation

ai-setup-meta

Setup per sviluppatori

Claude Code

Cursor

Gemini CLI

Architettura

Struttura del meta-repo

Build e release

Regole operative

Skills distribuite dal plugin dev-setup

Flusso consigliato

Workflow skills

Methodology skills

Shared skills

Agents

About

Releases

Packages

Contributors

Languages

Name		Name	Last commit message	Last commit date
Latest commit History 167 Commits
.claude-plugin		.claude-plugin
.claude		.claude
.cursor-plugin		.cursor-plugin
.github/workflows		.github/workflows
dist/dev-setup		dist/dev-setup
docs		docs
mcp		mcp
scripts		scripts
shared		shared
templates/dev-setup		templates/dev-setup
.gitignore		.gitignore
.release-please-manifest.json		.release-please-manifest.json
AGENTS.md		AGENTS.md
CLAUDE.md		CLAUDE.md
README.md		README.md
release-please-config.json		release-please-config.json

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

ai-setup-meta

Setup per sviluppatori

Claude Code

Cursor

Gemini CLI

Architettura

Struttura del meta-repo

Build e release

Regole operative

Skills distribuite dal plugin dev-setup

Flusso consigliato

Workflow skills

Methodology skills

Shared skills

Agents

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages