Imported from RafaelQSantos-RQS/LearningSwarm (AGENTS.md). Install upstream with npx skills add RafaelQSantos-RQS/LearningSwarm. Copyright stays with the author.

AGENTS.md - Guia para Assistentes de IA

Name: LearningSwarm
Author: RafaelQSantos-RQS

Estrutura das Aulas

Cada lição segue o padrão XX_topico:

00_docs - Documentação oficial e referência CLI
01_introducao - Conceitos básicos e init
02_nodes_cluster - Nodes, manager/worker, quorum
03_services - Services, réplicas, tasks
04_stacks - Stack deploy, compose no Swarm
05_networking - Overlay networks, ingress, discovery
06_secrets_configs - Dados sensíveis
07_updates_rollbacks - Rolling updates, rollbacks
08_constraints_labels - Placement de serviços
09_troubleshooting - Logs, inspect, debug
10_migracao_projetos - Do Compose para Swarm

Estrutura de Cada Pasta

Cada pasta de aula DEVE conter:

README.md - Roteiro da lição (teoria + exercícios)
codigo/ - Exemplos de configuração
exercicios/ - Desafios práticos

Pasta de Referência (00_docs)

Contém documentação oficial do Docker Swarm organizada em:

cli/ - Referência de comandos CLI

Cada comando tem seu próprio arquivo com: uso, opções, exemplos, "quando usar"

conceitos/ - Conceitos fundamentais

key-concepts.md, services.md, swarm-mode.md

arquitetura/ - Como o Swarm funciona por dentro

how-swarm-mode-works/, nodes, services, pki, raft

tutoriais/ - Tutoriais oficiais passo a passo

guia/ - Guias de administração

admin_guide, networking, secrets, configs, etc

Todas as aulas DEVEM referenciar esses arquivos na seção de prática.

Convenções

Exemplos em YAML para compose/swarm
Commits: conventional commits (feat:, fix:, docs:, etc.)
Código em português (comentários)
Cada conceito deve ter exemplo executável

Roteiro do README

Cada README deve seguir:

Objetivos - O que o aluno vai aprender
Teoria - Conceitos fundamentais com analogias ao Compose
Prática - Comandos e exemplos
- Incluir tabela de comandos usados com colunas: Comando, Descrição, Referência
- Adicionar notas "Quando usar" para cada comando/key feature
Exercícios - Desafios propostos
Referências - Links oficiais + referência aos arquivos em 00_docs

Fluxo de Trabalho

Criar/atualizar pasta da aula
Escrever README com roteiro
Implementar exemplos de código
Criar exercícios
Commitar com prefixo feat:

Analogias Compose vs Swarm

Compose	Swarm
`docker-compose up`	`docker stack deploy`
Container	Task
Networks	Overlay Networks
.env	Secrets
depends_on	deploy/constraints

{ "ocm": "1", "id": "rafaelqsantos-rqs-learningswarm-learningswarm", "kind": "skill", "name": "LearningSwarm", "description": "Cada lição segue o padrão `XX_topico`: - `00_docs` - Documentação oficial e referência CLI - `01_introducao` - Conceitos básicos e init - `02_nodes_cluster` - Nodes, manager/worker, quorum - `03_services` - Services, réplicas, tasks - `04_stacks` - Stack deploy, compose no Swarm - `05_networking` - Overlay networks, ingress, discovery - `06_secrets_configs` - Dados sensíveis - `07_updates_rollbacks` - Rolling updates, rollbacks - `08_constraints_labels` - Placement de serviços - `09_troubleshooting` - Logs, inspect, debug - `10_migracao_projetos` - Do Compose para Swarm", "publisher": "RafaelQSantos-RQS", "version": "1.0.0", "capabilities": { "domains": [ "coding" ], "tags": [ "skill-md", "github-agents" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Cada lição segue o padrão `XX_topico`: - `00_docs` - Documentação oficial e referência CLI - `01_introducao` - Conceitos básicos e init - `02_nodes_cluster` - Nodes, manager/worker, quorum - `03_services` - Services, réplicas, tasks - `04_stacks` - Stack deploy, compose no Swarm - `05_networking` - Overlay networks, ingress, discovery - `06_secrets_configs` - Dados sensíveis - `07_updates_rollbacks` - Rolling updates, rollbacks - `08_constraints_labels` - Placement de serviços - `09_troubleshooting` - Logs, inspect, debug - `10_migracao_projetos` - Do Compose para Swarm" ], "primary": false, "metadata": { "source": { "provider": "github-agents", "repository": "https://github.com/RafaelQSantos-RQS/LearningSwarm", "path": "AGENTS.md", "ref": "4ab924f1477c393e63bd41b204a0f6d30607f64d", "url": "https://github.com/RafaelQSantos-RQS/LearningSwarm/blob/4ab924f1477c393e63bd41b204a0f6d30607f64d/AGENTS.md", "key": "RafaelQSantos-RQS/LearningSwarm/AGENTS.md" } }, "instructions": "# AGENTS.md - Guia para Assistentes de IA\n\n## Estrutura das Aulas\n\nCada lição segue o padrão `XX_topico`:\n- `00_docs` - Documentação oficial e referência CLI\n- `01_introducao` - Conceitos básicos e init\n- `02_nodes_cluster` - Nodes, manager/worker, quorum\n- `03_services` - Services, réplicas, tasks\n- `04_stacks` - Stack deploy, compose no Swarm\n- `05_networking` - Overlay networks, ingress, discovery\n- `06_secrets_configs` - Dados sensíveis\n- `07_updates_rollbacks` - Rolling updates, rollbacks\n- `08_constraints_labels` - Placement de serviços\n- `09_troubleshooting` - Logs, inspect, debug\n- `10", "cost": { "context_tokens": 627 } }

LearningSwarm

About

AGENTS.md - Guia para Assistentes de IA

Estrutura das Aulas

Estrutura de Cada Pasta

Pasta de Referência (00_docs)

Convenções

Roteiro do README

Fluxo de Trabalho

Analogias Compose vs Swarm

Use it

Manifest

Reviews