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 GitHubMCP 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-app1 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
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
| Agent | Modèle | Phase | Rôle court |
|---|---|---|---|
brainstorming | opus | Specify | Idéation, personas, vision |
spec-writer | sonnet | Specify | PRD, fiches feature SDD |
designer | opus | Specify (UI) | Wireframes, maquettes, tokens |
architect | opus | Plan | Stack, BDD, API, ADR |
developer | sonnet | Implement | Code sur branche feature |
code-reviewer | opus | Validate | Audit qualité/sécu/perf (lecture seule) |
tester | sonnet | Validate | Tests unit + intégration + E2E |
devops | sonnet | Bootstrap + après-coup | CI/CD, infra, monitoring |
doc-writer | sonnet | Post-Validate | README, 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.
| MCP | Usage | Authentification |
|---|---|---|
github | Issues, PR, commits | PAT GitHub dans le header Authorization |
vercel | Déploiements, preview URLs | OAuth : /mcp puis authentifier |
supabase | BDD, migrations, types | OAuth : /mcp puis authentifier |
stripe | Paiements, customers, prices | OAuth : /mcp puis authentifier |
brevo | Emails transactionnels (défaut) | API key dans le header api-key |
resend | Emails (alternative à Brevo) | API key dans le header Authorization |
notion | Page projet source de vérité | OAuth : /mcp puis authentifier |
figma | Maquettes, design tokens | OAuth : /mcp puis authentifier |
context7 | Doc technique à jour | aucune |
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 :
| Hook | Bloque |
|---|---|
branch-guard.sh | git 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.sh | git reset --hard, git push --force (sauf --force-with-lease), git checkout --, git clean -f, git branch -D, git rebase -i |
secret-scan.sh | Commits 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) surmain.
Templates fournis
Tous dans templates/, copiés dans votre projet par les agents/skills :
CLAUDE.md.template—CLAUDE.mdprojet (placeholders à remplir pararchitect).PRD.md.template— Structure PRD.feature-spec.md.template— Fiche SDD avec Given-When-Then.plan.md.template— Plan technique pourdeveloper.gitignore.template—.gitignoreNext.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
- Documentation officielle Claude Code Plugins : https://code.claude.com/docs/en/plugins-reference
- Méthode SDD (Spec Kit) : https://github.com/github/spec-kit
- Site Ottho : https://ottho.co
Licence
MIT — cf LICENSE.