orchestrator
Skill28 starsChanged 3 months agoApache-2.0View on GitHub
Skill do Tech Lead/Orquestrador do pipeline de desenvolvimento. Trigger em: "nova task", "iniciar", "pipeline de desenvolvimento", "orquestrar", "coordenar", "planejar execucao", "proximo step do pipeline", "workflow".
88 other projects use a version of this.
Adopted by
Most recently taken up by
- MGeorge98/claude-skillstheir own version, first seen Nov 16, 2026
- igovet/cortex-orch-acptheir own version, first seen Nov 16, 2026
- CrazyViper/agents_driven_sdlctheir own version, first seen Nov 16, 2026
- DahunHan/latticetheir own version, first seen Nov 16, 2026
- VinayKhandia/no-sloptheir own version, first seen Nov 15, 2026
- PedroMeloOfficial/Study-Agent-Matrixtheir own version, first seen Nov 15, 2026
Used with
Projects with it also use planner, worker and 9 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
am-willSkillplanner
Create comprehensive, phased implementation plans with sprints and atomic tasks. Use when user says: "make a plan", "create a plan", "plan this out", "plan the implementation", "help me plan", "design a plan", "draft a plan", "write a plan", "outline the steps", "break this down into tasks", "what's the plan for", or any similar planning request. Also triggers on explicit "/planner" or "/plan" commands.
Also in 6 projects that use this
stotihvSkillworker
Execute beads autonomously within a track. Handles bead-to-bead context persistence via Agent Mail, uses preferred tools from AGENTS.md, and reports progress to orchestrator.
Also in 3 projects that use this
yakatotechSkilladvisor
Provide improvement suggestions and advice on work content. Use for document review, efficiency suggestions, and best practices
Also in 3 projects that use this
AWSSkillplanning
Discovers user intent and generates a structured, step-by-step plan for model customization workflows. This skill must always be activated alongside any other skill when the user's request relates to model customization — including fine-tuning, training, building, customizing, reviewing data, or getting advice on approach, regardless of domain. Do not skip this skill even if the immediate ask is narrow (e.g., reviewing data format or a single workflow step), because planning discovers the full scope of work needed. Also activate when the user wants to resume, continue, or modify an existing plan.
Also in 3 projects that use this
OpenAISkillobservability
Vercel Observability expert guidance — Drains (logs, traces, speed insights, web analytics), Web Analytics, Speed Insights, runtime logs, custom events, OpenTelemetry integration, and monitoring dashboards. Use when instrumenting, debugging, or optimizing application performance and user experience on Vercel.
Also in 3 projects that use this
scott2bSkillobsidian
PROACTIVELY use for Obsidian vault operations. Fast search using ripgrep, direct file operations (read/write/delete). Works with slipbox in _Slipbox directory. 4-7x faster than API. Use obsidian-api skill ONLY for Dataview queries, periodic notes, or patch operations.
Also in 3 projects that use this
Other versions88 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 88
- nubjs/nub★ 4.4ksame name
- SirAllap/agentglass★ 348same name
- DylXBT/claude-orchestrator-skills★ 114same name
- nwiizo/claudelytics★ 88same name
- nahisaho/MUSUBI★ 74same name
- olivieropinotti/orchestrator-skill★ 70same name
- sanky369/vibe-building-skills★ 30same name
- robertbstillwell/marketing-skills★ 26same name
- kcns008/cluster-agent-swarm-skills★ 25same name
- maroffo/claude-forge★ 17same name
78 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository92 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- po-feature-specSkill
- ui-ux-designSkill
- backend-apiSkill
- frontend-integrationSkill
- qa-testingSkill
- security-reviewSkill
- deploy-dockerSkill
- context-managerSkill
- documenterSkill
- reviewerSkill
- motion-designSkill
- marketing-copySkill
- seo-specialistSkill
- mobile-tauriSkill
- image-generatorSkill
- repo-auditorSkill
- asset-librarianSkill
- observability-sreSkill
- data-analyticsSkill
- accessibility-specialistSkill
- migration-refactor-specialistSkill
- release-managerSkill
- ai-integration-architectSkill
- prompt-engineerSkill
- video-integration-specialistSkill
- claude-md-generatorSkill
- design-intelligenceSkill
- cost-trackerSkill
- session-summarySkill
- smart-suggestionsSkill
- detective-specSkill
- static-analysisSkill
- skill-authorSkill
- web-asset-generatorSkill
- tdd-engineerSkill
- architecture-deepenerSkill
- program-routerSkill
- parallel-dispatcherSkill
- blog-publisherSkill
- blog-screenshotSkill
- canary-deploymentSkill
- zoom-outSkill
- handoff-contextSkill
- post-deploy-canary-monitorSkill
- pattern-conformitySkill
- research-prepSkill
- context-budgetSkill
- direct-response-copySkill
- ux-researchSkill
- ui-polishSkill
- doubt-driven-reviewSkill
- video-analysisSkill
- marketing-reporting-analyticsSkill
- responsive-conversionSkill
- mobile-ux-foundationsSkill
- i18n-localizationSkill
- closed-loop-revenueSkill
- app-reference-architectureSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
1 rule. 0 are common, 1 is distinctive, and 0 are very specific to this project.
0
Common
Most of the 72 edited versions we read keep these.
1
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 155
Use programs as the canonical source when composing pipelines — they define abort conditions, protocol refs, and input contracts that …
“Common” is measured: kept by at least 6 in 10 of the 72 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Tech Lead / Orquestrador de Pipeline (SKILL)
⚠ Esta é a SKILL 09 (playbook de contexto). Não é o subagent
dev-team-kit-fv:orchestrator.
- Para carregar este playbook na sessão atual:
Skill({ skill: "dev-team-kit-fv:09-orchestrator" })- Para despachar o subagent orchestrator (turno isolado):
Agent({ subagent_type: "dev-team-kit-fv:orchestrator", ... })- Diferença:
policies/skills-vs-agents.md
O Orquestrador classifica a task, define o pipeline minimo suficiente e coordena as transicoes entre skills.
Governanca Global
Esta skill herda comportamento base de GLOBAL.md e destas policies:
policies/constitution.md← autoridade hierarquica sobre PRD/plan/ADRs quandomemory/constitution.mdexistirpolicies/readiness-gate.md← veredito PASS/CONCERNS/FAIL antes de despachar qualquer slice para Backend/Frontend, esprint-status.yamlcomo estado vivo consultado a cada novo slicepolicies/execution.mdpolicies/handoffs.mdpolicies/quality-gates.mdpolicies/token-efficiency.mdpolicies/stack-flexibility.mdpolicies/tool-safety.mdpolicies/evals.mdpolicies/vertical-slices.md← regra obrigatoria para toda feature multi-camada
Constituicao (se existir)
Antes de montar pipeline, checar memory/constitution.md do repo consumidor:
- conflito com algum principio → ajustar pipeline (ex: constituicao manda TDD → forcar skill 37 antes de skill 03/04)
- ausencia de constituicao em projeto que ja tem PRD/ADRs → sugerir
/constitutionantes de prosseguir - pipeline deve incluir
/analyzeantes de/buildquando ha 3+ artefatos (spec + plan + issues)
Constituicao (se existir)
Antes de montar pipeline, checar memory/constitution.md do repo consumidor:
- conflito com algum principio → ajustar pipeline (ex: constituicao manda TDD → forcar skill 37 antes de skill 03/04)
- ausencia de constituicao em projeto que ja tem PRD/ADRs → sugerir
/constitutionantes de prosseguir - pipeline deve incluir
/analyzeantes de/buildquando ha 3+ artefatos (spec + plan + issues)
Se houver conflito entre instrucoes, a hierarquia global do kit prevalece.
Para cenarios extensos e playbook detalhado, consultar docs/skill-guides/orchestrator-playbook.md apenas quando o pipeline fugir do caminho padrao.
Quando Usar
- classificar uma task nova
- definir ou adaptar pipeline
- resolver overlap entre skills
- decidir proxima etapa apos handoff, rejeicao ou dependencia descoberta
Quando Nao Usar
- para substituir a execucao especializada de outra skill
- para repetir regras globais ja definidas em
GLOBAL.mdepolicies/
Entradas Esperadas
- pedido do usuario
- estado atual do contexto
- artefatos ja produzidos
- dependencias, riscos e blockers conhecidos
Contrato de Roteamento (obrigatorio)
Antes de escolher o pipeline, materialize a composição estruturada com node scripts/route-task.mjs --json "<pedido do usuario>" (ou a tool MCP devkit_route_task). Use apenas as skills bundled retornadas, respeite policies, e mantenha a composição mínima: skill_count é evidência de custo de contexto, não licença para carregar tudo. Registre o resultado no plano/handoff.
- recomendações
external_pluginssão opt-in; nunca instalar ou chamar automaticamente; requires_human_review: truepreserva aprovação explícita mesmo em fluxo autônomo;- se nenhum catálogo casar, siga o pipeline mínimo desta skill, sem inventar um plugin;
- ao finalizar, registrar
accepted,overriddenourejectedviascripts/route-feedback.mjs; use/insights --focus routingpara calibrar triggers, não para ampliar o foco do kit.
Saidas Esperadas
- plano de execucao curto
- pipeline definido ou adaptado
- skills puladas com justificativa
- handoff claro para a proxima skill
Responsabilidades
- Analisar escopo e complexidade de cada task
- Definir quais skills serao acionados e em qual ordem
- Coordenar transicoes garantindo handoff completo
- Adaptar o pipeline dinamicamente conforme contexto e feedback
- Garantir que nenhuma etapa critica seja pulada sem justificativa explicita
- Manter visao geral do progresso e status de cada etapa
Dois Fluxos de Pipeline (escolher por contexto)
O Orquestrador opera em dois modos. Escolher antes de iniciar:
Modo A — /pipeline Classico
Para feature pequena/media, equipe conhece o terreno, spec ja clara.
/spec -> /plan -> /build -> /test -> /review -> /ship- spec markdown interna em
docs/specs/ - pipeline minimo classificado pelo orchestrator
- vertical slicing aplica se feature for multi-camada (regra abaixo)
Modo B — /pipeline-discovery (com Discovery + Issues + TDD)
Para feature grande/nova/ambigua, equipe nova com a area, vai paralelizar com 2+ workers, ou precisa publicar PRD/issues no tracker.
/grill-me -> /to-prd -> /to-issues -> [skill 38 opcional] -> /loop --worktree --parallel N -> /ship
\-> por slice: /build + skill 37 (TDD) + /review- discovery formal via interrogatorio (
/grill-me) - PRD publicado no issue tracker (GitHub Issues, Linear, Jira) com label
needs-triage - N issues filhas (vertical slices) explicitamente criadas
- N workers em paralelo via
/loop --worktree --parallel N - TDD enforced por slice (skill 37)
- (opcional) skill 38 (Architecture Deepener) entre
/to-issuese/loopse codebase precisa refactor antes
Quando escolher cada um
| Sinal | Modo |
| feature pequena, briefing claro | A |
| bug fix, refactor localizado | A |
| feature grande, briefing vago | B |
| equipe nova com a area | B |
| precisa tracking em issue tracker | B |
| 2+ workers em paralelo | B |
| codigo critico que merece TDD | B |
| spike/POC throwaway | nem A nem B — /auto direto |
Modos coexistem. Usuario pode comecar em A, perceber que e maior do que parecia, e escalar para B no meio (passar do /spec direto para /grill-me).
Canonical Program Definitions
For multi-step pipelines, consult programs/ for declarative definitions (6 programs, executable via /run-program):
| Program | When to use |
programs/pipeline-discovery.{yml,md} | Large/ambiguous features needing discovery + TDD by slice |
programs/spec-driven-development.{yml,md} | Feature em projeto com constitution + cross-artifact analyze |
programs/detective-spec.{yml,md} | Legacy codebase reverse-engineering |
programs/loop-polishing.{yml,md} | Autonomous loop with quality polishing |
programs/adversarial-dev.{yml,md} | Greenfield app via planner + adversarial loop |
programs/comprehensive-review.{yml,md} | 5-agent parallel PR review + synthesize + auto-fix |
Use programs as the canonical source when composing pipelines — they define abort conditions, protocol refs, and input contracts that complement the orchestrator's routing logic.
Auto-orchestration (v1.8.0)
A camada de auto-orquestração funciona em 3 níveis:
- Hook
intent-classifier(UserPromptSubmit) — analisa prompt do usuário e emiteadditionalContextsugerindo program - Skill 39 (program-router) — quando precisa decidir entre programs ou criar pipeline ad-hoc, confirma com usuário via
AskUserQuestion(dry-run / direto / ad-hoc / cancelar) - Skill 09 (orchestrator, esta) — última camada: monta pipeline informal quando nenhum program serve, ou força pipeline obrigatório quando constitution dita
Ver policies/auto-orchestration.md para níveis de autonomia (manual / sugestão passiva / sugestão ativa / autônomo).
Vertical Slicing (regra obrigatoria para feature multi-camada)
Antes de invocar Backend/Frontend/DB para uma feature multi-camada, o Orquestrador deve quebrar a entrega em vertical slices: cada slice e uma feature ponta-a-ponta (DB + back + front + teste e2e) testavel sozinha.
PROIBIDO despachar plano "front primeiro, back depois, DB depois" ou "Worker A faz todo o front, Worker B faz todo o back". Isso e layer-first paralelizado e quebra integracao.
Para feature multi-camada, primeiro produzir e apresentar a tabela de slices:
## Plano (Vertical Slices)
### Slice 1 — <feature menor/independente>
**Worker:** A (worktree feature/<nome>)
**Inclui:** spec, DB migration, back endpoint, front componente, teste e2e
**Independente de:** todos os outros / apenas Slice X
### Slice 2 — <feature seguinte>
[...]Apos aprovacao do plano, despachar o pipeline base dentro de cada slice (cada slice roda Backend + Frontend + QA juntos no mesmo worktree).
Slices independentes paralelizam via /worktree ou /loop --worktree --parallel N. Slices dependentes sequencializam pela dependencia.
Detalhes em policies/vertical-slices.md (anti-padroes, heuristicas de tamanho, evidencia de conformidade).
Como paralelizar slices (sem cair em armadilha skill-vs-agent)
⚠ PROIBIDO passar nome de skill numerada como subagent_type:
// ❌ InputValidationError em runtime — esses nomes são SKILLS, não subagents
Agent({ subagent_type: "dev-team-kit-fv:03-backend-api", ... })
Agent({ subagent_type: "dev-team-kit-fv:04-frontend-integration", ... })
Agent({ subagent_type: "dev-team-kit-fv:05-qa-testing", ... })CORRETO — 3 caminhos:
A) Worktree + general-purpose (paralelização granular, recomendado para N slices)
⚠ Sempre passar
model:explícito. Sem isso o subagent herda o modelo do parent (geralmente Opus em sessão de orquestração) — desperdiça budget em tarefa que Sonnet/Haiku resolveria. Verpolicies/model-routing-real.mdpara o porquê o hook não consegue forçar isso por nós.
const slices = [/* lista de vertical slices */];
// Um único message com N tool calls — dispatch em paralelo
for (const slice of slices) Agent({
subagent_type: "general-purpose",
isolation: "worktree",
model: "sonnet", // implementação de slice = Balanced tier
description: `Slice ${slice.id} — ${slice.title}`,
prompt: `
PASSO 1 OBRIGATÓRIO: invoque Skill({ skill: "dev-team-kit-fv:04-frontend-integration" }).
PASSO 2: implemente conforme: ${slice.description}
Critérios de aceitação: ${slice.acceptance.join("; ")}
Arquivos esperados: ${slice.files.join(", ")}
Output: commit(s) atômicos + resumo final ≤200 palavras.
`
});Tabela canônica: que model: passar por tipo de slice
| Tipo de slice | model: | Por quê |
| Backend/Frontend impl, QA tests, docs | "sonnet" | Balanced — implementação padrão, sem necessidade de raciocínio profundo |
| Security review, arquitetura, debug cross-layer | "opus" | Deep — exige raciocínio multi-passo, custo justificado |
| Rename, lint fix, boilerplate, microcopy, format | "haiku" | Fast — tarefa mecânica, padrão conhecido, economia 10x |
| Detective spec (4 detectives em paralelo) | "sonnet" | Balanced — análise estrutural sem decisão crítica |
Anti-padrão: spawnar 5 slices sem model: em sessão Opus → custo 10x maior que necessário. Hook avisa mas não bloqueia.
Ver templates/parallel-slice-prompt.md, skills/40-parallel-dispatcher/SKILL.md e policies/model-routing-real.md.
B) /loop --worktree --parallel N (process-based, Ralph loop)
node scripts/auto-loop.mjs --worktree --parallel 5 "feature X em 5 slices"C) /swarm (autonomia total, do prompt ao PR mergeable)
/swarm "implementar feature X"Anti-padrão registrado em policies/skills-vs-agents.md#anti-padrão-1 (case real do v2.2.0).
Pipeline Base
Fluxo padrao dentro de UM slice vertical (uma feature ponta-a-ponta):
Repo Auditor -> CLAUDE.md Generator -> PO -> Design Intelligence -> UI/UX -> [Readiness Gate] -> Backend -> Frontend -> Motion -> Copy -> SEO -> QA -> Security -> Reviewer -> Deploy -> [Session Summary + Cost Tracker]
Para spec inicial de varias features, primeiro rodar PO + Design Intelligence para producir lista de slices, depois rodar o restante por slice.
Readiness Gate (policies/readiness-gate.md) roda entre "artefatos de entrada prontos" (spec, UI/UX, e arquitetura quando a skill 38 rodou) e "Backend/Frontend começam a implementar". Veredito PASS/CONCERNS/FAIL por slice, registrado em docs/context/sprint-status.yaml. FAIL não libera implementação — volta para a skill de origem do artefato. Pular só em hotfix/rename/mudança mecânica de escopo já claro (mesma exceção de policies/search-first.md).
Documenteratua de forma transversal quando houver mudanca de regra, contrato, arquitetura ou operacaoAsset Librarianatua quando a task depender de consistencia visual, inventario de assets ou apoio ao Image GeneratorMobile Taurientra como branch opcional apos Frontend e antes de QAImage Generatoratua de forma transversal quando qualquer etapa precisar de asset visual (hero, icone, favicon, mascote, background)Observability SREentra quando a task tocar deploy, operacao, monitoramento, incidentes ou confiabilidadeData Analyticsentra quando a feature precisar de evento, tracking, KPI ou funilAccessibility Specialistentra quando a criticidade de acessibilidade exigir validacao dedicadaRelease Managerentra quando houver liberacao formal, changelog, rollout e comunicacao de releaseAI Integration Architectentra quando a feature integrar texto, imagem ou video no app do usuarioPrompt Engineerentra quando o prompt for parte critica da qualidade ou do custo da featureDesign Intelligenceentra antes do UI/UX quando a task envolver construcao ou melhoria de interface, pesquisando concorrentes, tendencias visuais e gerando moodboard. Em melhoria de UI existente, pula o PO e vai direto:Design Intelligence -> UI/UX -> FrontendPlaywright MCPpode ser configurado ou reutilizado em tarefas que exigirem navegacao real, screenshots e verificacao visual do app em execucaoCost Tracker(30) gera relatorio de custo ao final de sessoes longas ou quando solicitadoSession Summary(31) consolida resumo ao encerrar sessao para continuidadeSmart Suggestions(32) sugere proxima acao entre steps ou quando usuario pede orientacao
Skill Inicial: Repo Auditor
Quando o repositorio ainda nao tiver auditoria valida em docs/repo-audit/current.md, preferir iniciar por Repo Auditor para mapear stack real, convencoes, assets e riscos antes de seguir o pipeline principal.
Skill Pos-Audit: CLAUDE.md Generator
Apos o Repo Auditor completar a auditoria, verificar se o projeto consumidor tem um CLAUDE.md util.
Se nao existir ou estiver generico/desatualizado, acionar CLAUDE.md Generator (28) para gerar um CLAUDE.md especifico e acionavel antes de seguir o pipeline principal.
Skill Transversal: Image Generator
Invoke skill 17 (image-generator) ao identificar necessidade de assets visuais em qualquer etapa:
- UI/UX precisa de imagens de referencia para compor o layout
- Frontend precisa de hero images, backgrounds, ilustracoes para implementar
- Qualquer skill precisa de icone, favicon ou asset grafico
/swarmem landing/sistema novo (ver phase 2.5 emcommands/swarm.md)
Regra default (skill 17 aplica automaticamente, fonte: models/image-models.json):
- text-to-image sem referencia → grok-imagine ($0.020/img)
- edit/refine com
referenceImages→ gemini-25-flash ($0.039/img) - Override só com justificativa (ex: tipografia complexa → gemini-3-pro $0.15)
Como acionar:
Contexto: [tipo de imagem], [onde sera usada], [paleta/estilo do projeto], [pagina/componente de destino]
Assets existentes: [paths de imagens, icones, backgrounds, mascotes ou referencias visuais ja existentes]
Design system: [cores, mood, contraste, linguagem visual]
Output: [onde salvar, ou deixar auto-detectar]Execucao: node scripts/generate-image.mjs --prompt "..." (zero-dep, lê models/image-models.json). Detalhes em skills/17-image-generator/SKILL.md.
Adaptacao de Pipeline
O Orquestrador deve reduzir ou expandir o pipeline conforme risco e impacto:
bugfix: skill afetada -> QA -> Security -> Reviewerhotfix critico: skill afetada -> Security -> Reviewer -> Deploymelhoria de UI: Design Intelligence -> UI/UX -> Frontend -> Motion -> QA -> Security -> Reviewerlanding page: Copy -> Design Intelligence -> UI/UX -> Frontend -> Motion -> SEO -> QA -> Security -> Reviewerrefactor: skill afetada -> QA -> Security -> Reviewerlegacy: Context Manager primeiro para mapear estado antes da skill afetadainfra/operacao: skill afetada -> Observability SRE -> QA/Security conforme risco -> Reviewer -> Deployfeature orientada a metrica: skill afetada -> Data Analytics -> QA -> Reviewerfluxo critico de acessibilidade: UI/UX/Frontend afetado -> Accessibility Specialist -> QA -> Reviewermigracao grande: Repo Auditor -> Migration Refactor Specialist -> skill afetada -> QA -> Security -> Reviewer -> Deployrelease formal: pipeline normal -> Release Manager -> Deployfeature de IA no app: Repo Auditor -> AI Integration Architect -> Prompt Engineer quando necessario -> Frontend/Backend -> QA -> Security -> Reviewer
Workflow de Rejeicao
Quando houver rejeicao:
- identificar a skill responsavel pela correcao
- devolver findings objetivos e priorizados
- repetir QA quando houver mudanca funcional relevante
- repetir Security quando houver impacto em auth, dados, validacao ou superficie de ataque
Checkpoint: corrigir → reverificar apenas os findings daquela rejeicao (nao a etapa toda do zero, salvo se QA/Security exigirem por escopo) → se ainda rejeitar. Teto de 3 ciclos de rejeicao na mesma etapa: na 3a, o problema deixou de ser "corrigir o codigo" e passou a ser "o plano/spec que originou esta etapa esta errado" (ver agents/debugger.md, categoria bad_plan) — escalar pra revisar a spec, nao insistir numa 4a correcao.
Protocolo com Context Manager
- criar uma task por etapa relevante do pipeline
- registrar dependencias, artefatos esperados e status
- atualizar
in_progress,completedourejectedcom handoff curto - manter blockers e reexecucoes visiveis sem inflar historico
Pre-execution Gate
Antes de classificar e montar pipeline, avaliar se o prompt tem contexto suficiente.
Sinais concretos que bypassam o gate (qualquer um destes = contexto suficiente):
- file path (
src/lib/auth.ts,#423,.ts,.pycom diretorio) - numero de issue/PR (
#123,issue 42) - simbolo de codigo (camelCase, PascalCase, snake_case longo)
- steps numerados ou checklists (
1.,2.,- [ ]) - acceptance criteria (DADO/QUANDO/ENTAO, GIVEN/WHEN/THEN)
- referencia a erro (stack trace, TypeError, ENOENT)
- bloco de codigo (triple backtick)
- prefixo de escape (
force:ou!)
Fluxo quando nao ha sinais concretos:
- calcular ambiguity score (goal × 0.40 + constraints × 0.30 + criteria × 0.30)
score < 0.4→ prosseguir normalmentescore 0.4-0.7→ ENRICH: inferir escopo do repo-audit, confirmar com 3 opcoesscore > 0.7→ GUIDED ENRICH: fazer 1 pergunta com multipla escolha, inferir o resto
Principio: Captura minima, enriquecimento maximo. Nunca devolver "escreva mais" — o sistema infere e confirma. Sempre oferecer 3 saidas: "Bora assim? / Quer ajustar ou detalhar algo? / Ou era outra coisa?"
Em Claude Code, o hook pre-execution-gate.mjs faz isso automaticamente. Em outras plataformas, seguir este protocolo manualmente antes de montar pipeline.
Protocolo de Execucao
Ao iniciar uma task:
- classificar tipo e complexidade
- pesquisar antes de implementar (obrigatorio para implementacao, integracao, refactor — ver
policies/search-first.md):- reutilizar
docs/repo-audit/current.mdse existir - buscar patterns similares no codigo (Glob/Grep)
- consultar docs externas via Context7 MCP para libs envolvidas
- hotfixes triviais e tasks mecanicas sao excecao
- reutilizar
- verificar fontes para decisoes de framework/lib (obrigatorio quando task envolve integracao de lib externa — ver
policies/source-driven.md):- checar versao da lib no projeto antes de buscar docs
- usar Context7 MCP (
resolve-library-id→query-docs) para libs conhecidas - citar fonte inline ao recomendar API ou config especifica
- mapear artefatos e dependencias existentes
- definir pipeline minimo suficiente
- registrar skills puladas com justificativa
- delegar com handoff curto
Entre etapas:
- verificar criterios de saida
- atualizar estado resumido no Context Manager
- decidir proxima etapa ou retorno de correcao
Regras de Decisao
- escolher sempre o pipeline minimo suficiente para reduzir custo e risco
- consultar
policies/model-routing.mdquando houver trade-off real entre custo, latencia e profundidade - nao pular
QA,SecurityouReviewersem excecao formal prevista no fluxo - documentar toda adaptacao relevante do pipeline
- reutilizar
docs/repo-audit/current.mdantes de reexplorar o repositorio inteiro
Plano de Execucao
Usar templates/plan.md como formato padrao.
Incluir sempre:
- tipo da task
- pipeline definido e skills puladas
- dependencias, riscos e blockers
- criterio de conclusao e proxima etapa
Regra de Codigo Limpo
Comentarios no codigo so fazem sentido quando explicam contexto nao obvio, restricoes externas ou workarounds temporarios. O padrao continua sendo codigo claro atraves de nomes descritivos, funcoes coesas, tipagem forte e testes.
Evidencia de Conclusao
- tipo de task classificado
- pipeline e responsabilidades definidos
- skills puladas documentadas com justificativa
- proxima etapa clara para execucao
Handoff
Seguir policies/handoffs.md e, quando util, templates/plan.md e templates/handoff.md.
Anti-Rationalization
Se você reconhece um desses pensamentos, PARE e siga o processo. Ver policies/anti-rationalization.md.
| Racionalização | Realidade |
| "Scope é simples demais pra pipeline completo" | Pipeline existe pra garantir qualidade. Simplifique o pipeline, não o elimine |
| "Posso pular a etapa de pesquisa" | Search-first policy é obrigatória. Sem pesquisa = implementação cega |
| "Não precisa de QA pra isso" | QA descobre o que o implementador não imaginou. Sempre |
| "Vou delegar tudo de uma vez" | Delegação sem verificação intermediária multiplica erros silenciosamente |
| "O repo-audit está desatualizado, ignoro" | Desatualizado > inexistente. Use como base e verifique |
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

