Devolvendo às pessoas o poder de criar
Início Rápido · Agentes · ADE · Squads
Framework open source de orquestração de IA que devolve o controle a quem tem coragem de construir. Agentes especializados, workflows e experiência CLI First para qualquer domínio.
Se é sua primeira vez no Yard, siga este caminho linear:
# novo projeto
npx yard-core init meu-projeto
# projeto existente
cd seu-projeto
npx yard-core install
/agent-name/yard-menu → /yard-<agent>/skills → yard-<agent-id>docs/ide-integration.md*help ou equivalente) para validar first-value.Definição de first-value (binária): ativação de agente + greeting válido + comando inicial com output útil em <= 10 minutos.
Muitos recursos avançados do Yard dependem de eventos de ciclo de vida (hooks). A tabela abaixo mostra a paridade real entre IDEs/plataformas:
| IDE/CLI | Paridade de Hooks vs Claude | Impacto Prático |
|---|---|---|
| Claude Code | Completa (referência) | Automação máxima de contexto, guardrails e auditoria |
| Gemini CLI | Alta (eventos nativos) | Cobertura forte de automações pre/post tool e sessão |
| Codex CLI | Parcial/limitada | Parte das automações depende de AGENTS.md, /skills, MCP e fluxo operacional |
| Cursor | Sem lifecycle hooks equivalentes | Menor automação de pre/post tool; foco em regras, MCP e fluxo do agente |
| GitHub Copilot | Sem lifecycle hooks equivalentes | Menor automação de sessão/tooling; foco em instruções de repositório + MCP no VS Code |
| AntiGravity | Workflow-based (não hook-based) | Integração por workflows, não por eventos de hook equivalentes ao Claude |
Impactos e mitigação detalhados: docs/ide-integration.md.
O Yard segue uma hierarquia clara de prioridades:
CLI First → Observability Second → UI Third
| Camada | Prioridade | Foco | Exemplos |
|---|---|---|---|
| CLI | Máxima | Onde a inteligência vive. Toda execução, decisões e automação acontecem aqui. | Agentes (@dev, @qa), workflows, comandos |
| Observability | Secundária | Observar e monitorar o que acontece no CLI em tempo real. | Dashboard SSE, logs, métricas, timeline |
| UI | Terciária | Gestão pontual e visualizações quando necessário. | Kanban, settings, story management |
Princípios derivados:
1. Planejamento Agêntico: Agentes dedicados (analyst, pm, architect) colaboram com você para criar documentos de PRD e Arquitetura detalhados e consistentes. Através de engenharia avançada de prompts e refinamento com human-in-the-loop, estes agentes de planejamento produzem especificações abrangentes que vão muito além da geração genérica de tarefas de IA.
2. Desenvolvimento Contextualizado por Engenharia: O agente sm (Scrum Master) então transforma estes planos detalhados em histórias de desenvolvimento hiperdetalhadas que contêm tudo que o agente dev precisa — contexto completo, detalhes de implementação e orientação arquitetural incorporada diretamente nos arquivos de histórias.
Esta abordagem de duas fases elimina tanto a inconsistência de planejamento quanto a perda de contexto — os maiores problemas no desenvolvimento assistido por IA. Seu agente dev abre um arquivo de história com compreensão completa do que construir, como construir e por quê.
📖 Veja o fluxo de trabalho completo no Guia do Usuário — Fase de planejamento, ciclo de desenvolvimento e todos os papéis dos agentes
[!TIP] Problemas de instalação? Consulte o Guia de Troubleshooting
Guias específicos por plataforma:
Documentação disponível em: English | Português
Antes de mergulhar, revise estes diagramas críticos de fluxo de trabalho que explicam como o YARD funciona:
[!IMPORTANT] Estes diagramas explicam 90% da confusão sobre o fluxo YARD Agentic Agile. Entender a criação de PRD+Arquitetura e o fluxo de trabalho sm/dev/qa e como os agentes passam notas através de arquivos de histórias é essencial — e também explica por que isto NÃO é taskmaster ou apenas um simples executor de tarefas!
Mantenha-se atualizado sem esforço. Para atualizar sua instalação YARD existente:
npx yard-core@latest install
Isto vai:
.bak para quaisquer modificações customizadasIsto facilita beneficiar-se das últimas melhorias, correções de bugs e novos agentes sem perder suas customizações!
Instale o YARD com um único comando:
# Criar um novo projeto com assistente interativo moderno
npx yard-core init meu-projeto
# Ou instalar em projeto existente
cd seu-projeto
npx yard-core install
# Ou usar uma versão específica
npx yard-core@latest init meu-projeto
O YARD agora inclui uma experiência de instalação interativa de última geração, inspirada em ferramentas modernas como Vite e Next.js:
Recursos do Instalador Interativo:
| Recurso | Descrição |
|---|---|
| Interface Moderna | Prompts coloridos e visuais com @clack/prompts |
| Validação em Tempo Real | Feedback instantâneo sobre entradas inválidas |
| Indicadores de Progresso | Spinners para operações longas |
| Seleção Multi-Componente | Escolha quais componentes instalar |
| Escolha de Package Manager | Selecione entre npm, yarn ou pnpm |
| Suporte a Cancelamento | Ctrl+C ou ESC para sair graciosamente |
| Resumo de Instalação | Visualize todas as configurações antes de prosseguir |
| Rastreamento de Duração | Veja quanto tempo levou a instalação |
O instalador oferece:
[!NOTE] Sem clonar, sem configuração manual — apenas um comando e você está pronto para começar com uma experiência de instalação moderna e profissional.
Pré-requisitos: Node.js v18+ necessário (v20+ recomendado) | Troubleshooting
Se você já tem o YARD instalado:
npx yard-core@latest install
# O instalador detectará sua instalação existente e a atualizará
O YARD inclui regras pré-configuradas para IDE para melhorar sua experiência de desenvolvimento:
.cursor/global-rules.md.claude/CLAUDE.md é carregado automaticamentenpm run sync:ide:claudenpm run validate:claude-sync && npm run validate:claude-integrationAGENTS.md na raiz é carregado automaticamentenpm run sync:ide:codexnpm run sync:skills:codexnpm run sync:skills:codex:global apenas fora deste projeto (para evitar duplicidade no /skills)npm run validate:codex-sync && npm run validate:codex-integrationnpm run validate:codex-skills && npm run validate:pathsnpm run sync:ide:gemini.gemini/rules.md, .gemini/rules/YARD/agents/ e .gemini/commands/*.toml.gemini/hooks/ + .gemini/settings.json)/yard-menu, /yard-dev, /yard-architect, etc.)npm run validate:gemini-sync && npm run validate:gemini-integrationnpm run validate:parityEstas regras fornecem reconhecimento de comandos de agentes, fluxo de trabalho dirigido por histórias, rastreamento automático de checkboxes, padrões de teste e validação, e padrões de código específicos do YARD.
npx yard-core init meu-projeto@analyst para começar a criar seu briefing*help para ver comandos disponíveisO YARD oferece uma CLI moderna e cross-platform com comandos intuitivos:
# Gerenciamento de Projeto (com assistente interativo)
npx yard-core init <nome-projeto> [opções]
--force Forçar criação em diretório não vazio
--skip-install Pular instalação de dependências npm
--template <nome> Usar template específico (default, minimal, enterprise)
# Instalação e Configuração (com prompts modernos)
npx yard-core install [opções]
--force Sobrescrever configuração existente
--quiet Saída mínima durante instalação
--dry-run Simular instalação sem modificar arquivos
# Comandos do Sistema
npx yard-core --version Exibir versão instalada
npx yard-core --help Exibir ajuda detalhada
npx yard-core info Exibir informações do sistema
npx yard-core doctor Executar diagnósticos do sistema
npx yard-core doctor --fix Corrigir problemas detectados automaticamente
# Manutenção
npx yard-core update Atualizar para versão mais recente
npx yard-core uninstall Remover YARD
Recursos da CLI:
| Recurso | Descrição |
|---|---|
| Help System Abrangente | --help em qualquer comando mostra documentação detalhada |
| Validação de Entrada | Feedback imediato sobre parâmetros inválidos |
| Mensagens Coloridas | Erros em vermelho, sucessos em verde, avisos em amarelo |
| Cross-Platform | Funciona perfeitamente em Windows, macOS e Linux |
| Suporte a Dry-Run | Teste instalações sem modificar arquivos |
$ npx yard-core install
🚀 YARD Installation
◆ What is your project name?
│ my-awesome-project
│
◇ Which directory should we use?
│ ./my-awesome-project
│
◆ Choose components to install:
│ ● Core Framework (Required)
│ ● Agent System (Required)
│ ● Squads (optional)
│ ○ Example Projects (optional)
│
◇ Select package manager:
│ ● npm
│ ○ yarn
│ ○ pnpm
│
◆ Initialize Git repository?
│ Yes
│
◆ Install dependencies?
│ Yes
│
▸ Creating project directory...
▸ Copying framework files...
▸ Initializing Git repository...
▸ Installing dependencies (this may take a minute)...
▸ Configuring environment...
▸ Running post-installation setup...
✔ Installation completed successfully! (34.2s)
Next steps:
cd my-awesome-project
yard-core doctor # Verify installation
yard-core --help # See available commands
# Instalação automatizada sem prompts
$ npx yard-core install --quiet --force
✔ YARD installed successfully
# Testar instalação sem modificar arquivos
$ npx yard-core install --dry-run
[DRY RUN] Would create: ./my-project/
[DRY RUN] Would copy: .yard-core/ (45 files)
[DRY RUN] Would initialize: Git repository
[DRY RUN] Would install: npm dependencies
✔ Dry run completed - no files were modified
$ npx yard-core doctor
🏥 YARD System Diagnostics
✔ Node.js version: v20.10.0 (meets requirement: >=18.0.0)
✔ npm version: 10.2.3
✔ Git installed: version 2.43.0
✔ GitHub CLI: gh 2.40.1
✔ YARD: v4.2.11
Configuration:
✔ .yard-core/ directory exists
✔ Agent files: 11 found
✔ Workflow files: 8 found
✔ Templates: 15 found
Dependencies:
✔ @clack/prompts: ^0.7.0
✔ commander: ^12.0.0
✔ execa: ^9.0.0
✔ fs-extra: ^11.0.0
✔ picocolors: ^1.0.0
✅ All checks passed! Your installation is healthy.
$ npx yard-core --help
Usage: yard-core [options] [command]
YARD: AI-Orchestrated System for Full Stack Development
Options:
-V, --version output the version number
-h, --help display help for command
Commands:
init <project-name> Create new YARD project with interactive wizard
install [options] Install YARD in current directory
info Display system information
doctor [options] Run system diagnostics and health checks
help [command] display help for command
Run 'yard-core <command> --help' for detailed information about each command.
Para contribuidores ou usuários avançados que queiram modificar o código fonte:
# Clonar o repositório
git clone https://github.com/ernesto-langa/yard-core.git
cd yard-core
# Instalar dependências
npm install
# Executar o instalador
npx yard-core install
Para membros da equipe ingressando no projeto:
# Instalar YARD no projeto
npx yard-core@latest install
# Isto vai:
# 1. Detectar instalação existente (se houver)
# 2. Instalar/atualizar framework YARD
# 3. Configurar agentes e workflows
O framework de linguagem natural do YARD funciona em QUALQUER domínio. Os Squads fornecem agentes IA especializados para escrita criativa, estratégia de negócios, saúde e bem-estar, educação e muito mais. Além disso, os Squads podem expandir o núcleo do YARD com funcionalidade específica que não é genérica para todos os casos. Veja o Guia de Squads e aprenda a criar os seus próprios!
O YARD vem com 12 agentes especializados:
| Agente | Descrição |
|---|---|
| yard-master | Agente mestre de orquestração (inclui capacidades de desenvolvimento de framework) |
| yard-orchestrator | Orquestrador de fluxo de trabalho e coordenação de equipe |
| Agente | Descrição |
|---|---|
| analyst | Especialista em análise de negócios e criação de PRD |
| pm (Product Manager) | Gerente de produto e priorização |
| architect | Arquiteto de sistema e design técnico |
| ux-expert | Design de experiência do usuário e usabilidade |
| Agente | Descrição |
|---|---|
| sm (Scrum Master) | Gerenciamento de sprint e criação de histórias |
| dev | Desenvolvedor e implementação |
| qa | Garantia de qualidade e testes |
| po (Product Owner) | Gerenciamento de backlog e histórias |
| data-engineer | Design de banco de dados e modelagem de dados |
| devops | CI/CD, infraestrutura e operações git (autoridade exclusiva de push) |
O YARD introduz o Autonomous Development Engine (ADE) — um sistema completo para desenvolvimento autônomo que transforma requisitos em código funcional.
ADE é um conjunto de 7 Epics que habilitam execução autônoma de desenvolvimento:
| Epic | Nome | Descrição |
|---|---|---|
| 1 | Worktree Manager | Isolamento de branches via Git worktrees |
| 2 | Migration V2→V3 | Migração para formato autoClaude V3 |
| 3 | Spec Pipeline | Transforma requisitos em specs executáveis |
| 4 | Execution Engine | Executa specs com 13 steps + self-critique |
| 5 | Recovery System | Recuperação automática de falhas |
| 6 | QA Evolution | Review estruturado em 10 fases |
| 7 | Memory Layer | Memória persistente de padrões e insights |
User Request → Spec Pipeline → Execution Engine → QA Review → Working Code
↓
Recovery System
↓
Memory Layer
# 1. Criar spec a partir de requisito
@pm *gather-requirements
@architect *assess-complexity
@analyst *research-deps
@pm *write-spec
@qa *critique-spec
# 2. Executar spec aprovada
@architect *create-plan
@architect *create-context
@dev *execute-subtask 1.1
# 3. QA Review
@qa *review-build STORY-42
@devops:
*create-worktree, *list-worktrees, *merge-worktree, *cleanup-worktrees*inventory-assets, *analyze-paths, *migrate-agent, *migrate-batch@pm:
*gather-requirements, *write-spec@architect:
*assess-complexity, *create-plan, *create-context, *map-codebase@analyst:
*research-deps, *extract-patterns@qa:
*critique-spec, *review-build, *request-fix, *verify-fix@dev:
*execute-subtask, *track-attempt, *rollback, *capture-insights, *list-gotchas, *apply-qa-fixSquads permitem estender o YARD para qualquer domínio. Estrutura básica:
squads/seu-squad/
├── config.yaml # Configuração do squad
├── agents/ # Agentes especializados
├── tasks/ # Fluxos de trabalho de tarefas
├── templates/ # Templates de documentos
├── checklists/ # Checklists de validação
├── data/ # Base de conhecimento
├── README.md # Documentação do squad
└── user-guide.md # Guia do usuário
Veja o Guia de Squads para instruções detalhadas.
Squads são equipes modulares de agentes IA. Veja a Visão Geral de Squads para mais informações.
O Yard Pro (@ernesto-langa/yard-pro) é o módulo premium do Yard, oferecendo funcionalidades avançadas para equipes e projetos de maior escala.
[!NOTE] Disponibilidade restrita: O Yard Pro está disponível exclusivamente para membros do Yard Cohort Advanced. Saiba mais sobre o programa.
npm install @ernesto-langa/yard-pro
| Feature | Descrição |
|---|---|
| Squads Avançados | Squads especializados com capacidades expandidas |
| Memory Layer | Memória persistente de padrões e insights entre sessões |
| Métricas & Analytics | Dashboard de produtividade e métricas de desenvolvimento |
| Integrações Enterprise | Conectores para Jira, Linear, Notion e mais |
| Configuração em Camadas | Sistema de configuração L1-L4 com herança |
| Licenciamento | Gerenciamento de licença via npx yard-pro activate --key <KEY> |
Para mais informações, execute npx yard-pro --help após a instalação.
O YARD implementa um sistema de validação de múltiplas camadas para garantir qualidade do código e consistência.
Camada 1: Pre-commit (Local — Rápida)
Camada 2: Pre-push (Local — Validação de Stories)
Camada 3: CI/CD (Cloud — Obrigatório para merge)
# Validações locais
npm run lint # ESLint
npm run typecheck # TypeScript
npm test # Testes
npm run test:coverage # Testes com cobertura
# Validador YARD
node .yard-core/utils/yard-validator.js pre-commit # Validação pre-commit
node .yard-core/utils/yard-validator.js pre-push # Validação pre-push
node .yard-core/utils/yard-validator.js stories # Validar todas stories
Configure proteção da branch master com:
node scripts/setup-branch-protection.js
Requer GitHub CLI (gh) instalado e autenticado, e acesso de admin ao repositório.
Estamos empolgados com contribuições e acolhemos suas ideias, melhorias e Squads!
Para contribuir:
git checkout -b feature/MinhaNovaFeature)git commit -m 'feat: Adicionar nova feature')git push origin feature/MinhaNovaFeature)Veja também:
| Documento | English | Português |
|---|---|---|
| Licença | MIT License | — |
| Modelo de Licença | Core vs Pro | — |
| Privacidade | Privacy Policy | — |
| Termos de Uso | Terms of Use | — |
| Código de Conduta | Code of Conduct | PT-BR |
| Contribuição | Contributing | PT-BR |
| Segurança | Security | PT-BR |
| Comunidade | Community | PT-BR |
| Roadmap | Roadmap | PT-BR |
| Changelog | Version History | — |
FAQs
Yard: AI-Orchestrated System for Full Stack Development - Core Framework
We found that yard-core demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Multiple high-impact npm maintainers confirm they have been targeted in the same social engineering campaign that compromised Axios.
Security News
Axios compromise traced to social engineering, showing how attacks on maintainers can bypass controls and expose the broader software supply chain.
Security News
Node.js has paused its bug bounty program after funding ended, removing payouts for vulnerability reports but keeping its security process unchanged.