convez.ai
MCP ServerAutomaçãoAvançado
ottho-nocode

Ottho Code App — Método de Agência para Claude Code

ottho-nocode/ottho-code-app

Método SDD industrial: 9 agentes, CI/CD, templates e guards de Git

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server que implementa um método completo SDD (Specification-Driven Development) com 9 agentes especializados, orchestrados por 3 skills e 4 slash commands. Cobre todo o ciclo de vida de features (brainstorming até deployment) com hooks de segurança Git integrados, templates PRD e planos técnicos. Projetado para agências e freelancers que usam Claude Code com stack Next.js + Supabase + Stripe.

Instalação

$npx convez-ai ottho-nocode/ottho-code-app

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
2
Acompanhando
0
Saúde
42%
Último commit
há 3 semanas
Versão
—
Issues abertas
1
Contribuidores
1

Casos de uso

  • Agências web estruturando workflows com Claude Code
  • Ciclo de life feature (spec → design → code → review → teste)
  • Automação de PRD, fiche técnica e documentação
  • Proteção de branches e CI/CD com Vercel + Supabase

Veredito

Ferramenta muito completa e bem pensada para agências que precisam industrializar métodos com Claude. O nível de orquestração (9 agentes + skills + hooks Git) é avançado; exige compreensão clara de SDD e workflows para máximo valor. Recomendado para times com disciplina estruturada.

README

A tradução para o português deste README ainda está na fila.

Ottho Code App — Plugin Claude Code

Méthode complète d'agence pour livrer des applications web modernes avec Claude Code. SDD à 2 niveaux, 9 agents spécialisés, 9 MCP recommandés (non installés par défaut), hooks de sécurité Git.


Pour qui

Agences et freelances qui construisent des apps web (Next.js + Supabase + Brevo/Resend + Stripe) et veulent industrialiser leur méthode de travail avec Claude Code.

Ce que vous obtenez en une commande

  • 9 agents spécialisés qui couvrent le cycle de vie d'une feature : Brainstorming, Spec-Writer, Designer, Architect, Developer, Code-Reviewer, Tester, DevOps, Doc-Writer.
  • 3 skills qui orchestrent : agency-method (référence), project-bootstrap (démarrage projet), sdd-feature-cycle (cycle feature).
  • 4 slash commands : /init-agency-project, /new-feature, /validate-feature, /ship-feature.
  • 9 MCP recommandés — non installés par défaut : GitHub, Vercel, Supabase, Stripe, Brevo, Resend, Notion, Figma, Context7. À ajouter par projet, voir Les 9 MCP recommandés. (Pencil : fourni par l'app desktop pencil.dev, pas par le plugin.)
  • 3 hooks de sécurité Git : branch-guard (anti-commit direct main/develop), git-safe (anti-reset --hard / push --force), secret-scan (anti-fuite de clés API).
  • 5 templates : CLAUDE.md, PRD, fiche feature SDD, plan technique, .gitignore.

Installation

Via marketplace (recommandé une fois publié)

claude plugin marketplace add ottho-nocode/ottho-code-app
claude plugin install ottho-code-app@ottho-code-app

Via URL directe (dev/test)

claude --plugin-url https://github.com/ottho-nocode/ottho-code-app

Via dossier local (développement du plugin)

claude --plugin-dir ./ottho-code-app

Le plugin n'installe aucun serveur MCP. Les 9 MCP de la méthode sont recommandés mais s'ajoutent par projet, selon les besoins — voir la section Les 9 MCP recommandés.


Première utilisation

Démarrer un nouveau projet

/init-agency-project

Orchestrera : brainstorming → spec-writer (PRD) → architect (stack + CLAUDE.md) → devops (CI/CD, Vercel, Supabase).

Validation humaine obligatoire entre chaque agent.

Démarrer une feature

/new-feature "Page de connexion utilisateur"

Créera la branche feature/US-XX-page-de-connexion, puis enchaînera spec-writer → designer (si UI) → architect (plan technique).

Valider une feature

/validate-feature

Lance code-reviewer (audit) puis tester (tests + coverage).

Shipper une feature

/ship-feature

Met à jour la doc, push, ouvre la PR vers develop.


Cycle SDD à 2 niveaux

Niveau Projet (one-shot, au démarrage)

brainstorming → spec-writer → architect → devops
   vision/        PRD          stack/      CI/CD/
   personas      global        BDD         infra

Niveau Feature (répété par US)

[Specify]   brainstorming (opt) → spec-writer → designer (si UI)
                                ↓ validation humaine
[Plan]      architect (mode feature)
                                ↓ validation humaine
[Implement] developer
                                ↓ validation humaine
[Validate]  code-reviewer → tester
                                ↓
[Post]      doc-writer → /ship-feature → PR vers develop

Les 9 agents

AgentModèlePhaseRôle court
brainstormingopusSpecifyIdéation, personas, vision
spec-writersonnetSpecifyPRD, fiches feature SDD
designeropusSpecify (UI)Wireframes, maquettes, tokens
architectopusPlanStack, BDD, API, ADR
developersonnetImplementCode sur branche feature
code-revieweropusValidateAudit qualité/sécu/perf (lecture seule)
testersonnetValidateTests unit + intégration + E2E
devopssonnetBootstrap + après-coupCI/CD, infra, monitoring
doc-writersonnetPost-ValidateREADME, doc API, guides

Règle d'or : chaque agent recommande le suivant. L'orchestration est faite par les slash commands ou par vous. Un agent n'invoque jamais directement un autre agent.


Les 9 MCP recommandés (non installés par défaut)

Le plugin n'embarque aucun serveur MCP. Chaque projet ajoute les siens : copie un des blocs ci-dessous dans le .mcp.json à la racine du projet, ou ajoute-les un par un avec claude mcp add. Avantages : pas de serveurs « Failed to connect » fantômes dans les projets qui n'en ont pas l'usage, et des credentials gérés par projet.

MCPUsageAuthentification
githubIssues, PR, commitsPAT GitHub dans le header Authorization
vercelDéploiements, preview URLsOAuth : /mcp puis authentifier
supabaseBDD, migrations, typesOAuth : /mcp puis authentifier
stripePaiements, customers, pricesOAuth : /mcp puis authentifier
brevoEmails transactionnels (défaut)API key dans le header api-key
resendEmails (alternative à Brevo)API key dans le header Authorization
notionPage projet source de véritéOAuth : /mcp puis authentifier
figmaMaquettes, design tokensOAuth : /mcp puis authentifier
context7Doc technique à jouraucune

Serveurs OAuth + Context7 (aucune clé dans le fichier) :

{
  "mcpServers": {
    "vercel":   { "type": "http", "url": "https://mcp.vercel.com" },
    "supabase": { "type": "http", "url": "https://mcp.supabase.com/mcp" },
    "stripe":   { "type": "http", "url": "https://mcp.stripe.com" },
    "notion":   { "type": "http", "url": "https://mcp.notion.com/mcp" },
    "figma":    { "type": "http", "url": "https://mcp.figma.com/mcp" },
    "context7": { "type": "http", "url": "https://mcp.context7.com/mcp" }
  }
}

Serveurs à clé — toujours via variables d'environnement, jamais de clé en clair dans le fichier :

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": { "Authorization": "Bearer ${GITHUB_PAT}" }
    },
    "brevo": {
      "type": "http",
      "url": "https://mcp.brevo.com",
      "headers": { "api-key": "${BREVO_API_KEY}" }
    },
    "resend": {
      "type": "http",
      "url": "https://mcp.resend.com",
      "headers": { "Authorization": "Bearer ${RESEND_API_KEY}" }
    }
  }
}

Pour les maquettes locales, l'agent designer peut aussi utiliser le MCP Pencil : il est installé par l'application desktop pencil.dev, pas par ce plugin.


Hooks de sécurité

Trois scripts (scripts/*.sh) attachés à PreToolUse matcher Bash :

HookBloque
branch-guard.shgit commit (si la branche du repo ciblé par la commande est main/develop) et git push avec refspec main/develop — repo du projet courant uniquement
git-safe.shgit reset --hard, git push --force (sauf --force-with-lease), git checkout --, git clean -f, git branch -D, git rebase -i
secret-scan.shCommits incluant .env (sauf .env.example) ou patterns de clés (sk_live_, sk_test_, re_, AKIA, ghp_, etc.)

Exit code 2 + message stderr → Claude voit le blocage et adapte.

Désactiver temporairement

claude plugin disable ottho-code-app
# ... action ponctuelle ...
claude plugin enable ottho-code-app

Conventions Git portées par le plugin

  • Branches : main (prod), develop (intégration), feature/US-XX-slug (travail), fix/*, refactor/*, chore/*.
  • Commits préfixés : feat(US-XX): ..., fix(US-XX): ..., test(US-XX): ..., docs(US-XX): ....
  • PR : feature/* → develop. develop → main à chaque release.
  • Tags : v1.0.0, v1.1.0, ... (semver) sur main.

Templates fournis

Tous dans templates/, copiés dans votre projet par les agents/skills :

  • CLAUDE.md.template — CLAUDE.md projet (placeholders à remplir par architect).
  • PRD.md.template — Structure PRD.
  • feature-spec.md.template — Fiche SDD avec Given-When-Then.
  • plan.md.template — Plan technique pour developer.
  • gitignore.template — .gitignore Next.js + sécurité.

Monitor expérimental (prêt, non-wiré)

monitors/monitors.json + scripts/rls-watch.sh sont prêts : un monitor supabase-rls-watch qui surveille supabase/migrations/ et alerte si une nouvelle table est créée sans RLS.

Pour l'activer, ajouter dans .claude-plugin/plugin.json (quand votre version du CLI supporte experimental — vérifier avec claude plugin validate) :

"experimental": {
  "monitors": "./monitors/monitors.json"
}

Le monitor démarre alors automatiquement quand le plugin est enabled (Claude Code v2.1.105+).


Validation du plugin

Avant publication :

claude plugin validate

Le plugin doit passer vert. Vérifie le schéma plugin.json, les frontmatters d'agents/skills/commands, et hooks/hooks.json.


Désinstallation

claude plugin uninstall ottho-code-app

Ajouter --keep-data pour préserver la directory persistante (rare pour ce plugin).


Liens


Licence

MIT — cf LICENSE.

Ver o original no GitHub

Bom para

Relacionados