⚡ zark-dev — Metodologia ZARK para desenvolvimento de software com IA

Scaffold de metodologia + contexto para IAs (Claude Code, Cursor, Codex, Aider) construírem software ZARK-grade no Brasil. Você é orquestrador. A IA é executora. Esta CLI planta o método; a IA escolhe stack, escreve código, roda testes.

mkdir meu-projeto && cd meu-projeto
npx zark-dev@latest start

O que é zark-dev

zark-dev é a CLI oficial da Metodologia ZARK — um método brasileiro, testado em produção, para desenvolver software com IA como executora principal sob orientação humana. A v3 reposiciona o CLI: ele não scaffolda código. Quem cria stack, instala deps, escreve código e roda testes é a IA — guiada por um INITIAL-PROMPT.md robusto que esta CLI gera no seu projeto.

A premissa é simples: modelos e ferramentas mudam todo trimestre; método de trabalho dura. zark-dev empacota esse método em arquivos versionados que qualquer agente IA lê na primeira sessão.

Por que importa

| Antes (vibe coding) | Com ZARK (método) | |---|---| | IA escolhe stack errada por padrão | IA propõe stack após 6 perguntas + brainstorm contextual | | Cada sessão recomeça do zero | Contexto em .ai-context/ + memória em 3 camadas | | Testes só "depois" | TDD obrigatório, 5 gates antes de cada commit | | Sem rastro de decisão | ADRs em docs/decisions/ indexados | | [PREENCHA] permanece pra sempre | Validação atômica — IA preenche durante brainstorm ou bloqueia |

🚀 Quick start

Requisito: Node ≥ 20.

Greenfield — projeto novo

mkdir meu-projeto && cd meu-projeto
npx zark-dev@latest start
# 3 perguntas: nome, descrição, prazo
# Cria methodology/, .ai-context/, INITIAL-PROMPT.md, SPEC.md, símbolos pra IA

claude   # ou cursor . / codex / aider
# IA lê INITIAL-PROMPT.md → brainstorm em lotes → propõe stack
# → npx create-X@latest → instala deps → executa M0+

Brownfield — projeto existente

cd projeto-legado
npx zark-dev@latest audit
# Detecta stack, identifica riscos, acopla metodologia ZARK sem tocar no código

claude
# IA usa subagent codebase-explorer → brainstorm → ADR "manter ou migrar"

Diagnóstico

npx zark-dev@latest doctor   # verifica saúde do scaffold ZARK
npx zark-dev@latest migrate  # atualiza projetos v1.x/v2.x → v3.0

A Metodologia ZARK em uma página

Esta CLI materializa o método ZARK. Pra entender a filosofia inteira, leia o curso Desenvolvimento de Software com IA (v1.2) — 20 módulos + 4 apêndices, ~4000 linhas. Resumo dos pilares:

• Você orquestra, a IA executa. Você decide escopo/arquitetura/prioridade; a IA cria pastas, escreve código, roda testes.
• 9 princípios (filosofia que sobrevive às ferramentas): Context-first · Economia de tokens via orquestração de modelos · Gates não-negociáveis · Validação incremental · Trilha dupla (greenfield ≠ brownfield) · Security não é anexo · Paralelismo controlado · Superfície simples + substância profunda · Documentação viva.
• 5 gates obrigatórios antes de cada commit: lint → type-check → test → build → security-scan.
• Memória em 3 camadas (M10.2): project (CLAUDE.md), session (conversa), long-term (~/.claude/memory/).
• 4 arquétipos de subagentes (M10.3): code-reviewer, security-scanner, codebase-explorer, migration-planner.
• Spec-verify (M10.1): toda implementação valida-se contra o SPEC.md antes do milestone fechar.

O Ecossistema ZARK

zark-dev é o coração do método. Os outros 3 pacotes ZARK complementam:

| Pacote | Pra que serve | Quando usar | |---|---|---| | zark-design | Design system híbrido (preset ZARK + modo custom com sua paleta/logos) — HTML + JSX side-by-side | Projetos com UI/frontend | | zark-seo | 17 skills SEO/GEO especialistas (Local SEO, SEO técnico, brand voice, keyword research, GEO/LLM) — foco mercado brasileiro | Projetos com presença web / SEO / clientes | | zark-skills | 5 skills Claude Code user-level: zark-skill, zark-dossie, zark-ensaios, zark-frontend, zark-slides | Workflow criativo / agência |

# Stack ZARK completo num cliente novo:
mkdir cliente-x && cd cliente-x
npx zark-dev@latest start          # metodologia
npx zark-design@latest init        # design system (se tiver UI)
npx zark-seo@latest init           # skills SEO (se tiver presença web)
npx zark-skills@latest install     # skills Claude Code (1x por máquina)
claude

Quem está por trás

Maycon Jordan — fundador da ZARK, desenvolvedor BR especializado em metodologia de desenvolvimento de software com IA. A metodologia ZARK nasceu de auditoria real em clientes (Limppetec, AllSec, VipCar, VipSeg, MixShop) e absorve aprendizados do Spec-Driven Development (SDD), Harness Engineering (LangChain/Viv) e prática sênior de produção em projetos brasileiros.

Documentação

• 📘 Curso completo (v1.2) — 4000+ linhas, 20 módulos, 4 apêndices
• 📋 Manual de uso ZARK Dev
• 🎓 Apêndice D — ZARK vs SDD vs Harness Engineering
• 🛠️ CHANGELOG

Tags

zark metodologia metodologia-zark zark-method desenvolvimento-com-ia ai-development claude-code cursor codex aider ai-agent scaffolding brazil brasil pt-br ai-tools-brasil tdd methodology-brazil

Licença

MIT — Maycon Jordan / ZARK · 2026

Se este pacote te ajudou: ⭐ no GitHub e compartilha. É assim que método brasileiro de desenvolvimento com IA se espalha.