ServiceNow Skills Suite

Suíte de skills especializada para apoio técnico, arquitetônico e operacional em projetos ServiceNow.

Objetivo

Esta suíte foi criada para estruturar um conjunto de competências especializadas capazes de apoiar decisões, revisões e construções técnicas em ServiceNow com foco em:

• arquitetura
• fundação técnica com SDK e Fluent
• modelagem de dados
• automação
• backend / server-side
• APIs e integrações
• qualidade e testes com ATF
• governança técnica
• DevOps / CI-CD
• Service Portal clássico
• UI moderna com UiPage
• IA nativa da plataforma

A proposta não é apenas gerar respostas técnicas. A suíte existe para orientar a melhor decisão técnica possível, com base em documentação oficial, boas práticas, governança e separação clara de responsabilidades.

Princípios da suíte

Fonte oficial como verdade

A suíte deve sempre priorizar:

• documentação oficial da ServiceNow
• exemplos oficiais
• comportamento validado no projeto real e na plataforma

Arquitetura antes de implementação

Demandas amplas, ambíguas ou multidomínio devem ser enquadradas antes de detalhar implementação.

Separação clara de responsabilidades

Cada skill tem um domínio central. A suíte foi desenhada para evitar sobreposição indevida.

Native-first quando fizer sentido

A suíte favorece o uso inteligente dos recursos nativos da plataforma antes de customizações desnecessárias.

Qualidade e governança como parte da solução

Teste, revisão, segurança, maintainability, performance e upgradeability são tratados como elementos estruturais.

IA como capability governada

A IA é tratada como capability arquitetural da plataforma, com propósito, limites, guardrails e integração correta com as demais camadas.

Estrutura da suíte V1

A V1 da suíte é composta por 12 skills.

Skill-mestra

• sn-architect-core

Skills especializadas

• sn-sdk-foundation
• sn-data-model
• sn-flow-automation
• sn-server-logic
• sn-api-integration
• sn-atf-quality
• sn-governance-review
• sn-devops-cicd
• sn-service-portal
• sn-ui-page-modern
• sn-ai-platform

Artefatos estruturais

• suite.manifest.json: manifesto estruturado da suíte, com skills, tipos, caminhos, domínios, responsabilidades e handoffs para agentes, IDEs, validações futuras e empacotamento.
• docs/servicenow-engineering-standards.md: padrões transversais mínimos de engenharia ServiceNow para decisões sobre dados, backend, Flow, API, UI, ATF, DevOps, segurança, performance, manutenção e IA.

As 12 skills continuam sendo os artefatos principais de execução. O manifesto e o engineering standards servem como camada de suporte e não substituem nenhuma skill especialista.

Uso do CLI

O pacote possui um CLI básico para listar skills, copiar a suíte para outro destino local e validar a integridade estrutural dos artefatos.

O pacote está estruturado para distribuição como @ricbaiano/servicenow-skills-suite, sem presumir publicação npm automática.

Uso via npm/npx

Após a publicação no npm, o CLI poderá ser executado com:

npx @ricbaiano/servicenow-skills-suite --help
npx @ricbaiano/servicenow-skills-suite list
npx @ricbaiano/servicenow-skills-suite list --json
npx @ricbaiano/servicenow-skills-suite init --dry-run

Para uso local a partir do repositório clonado, continue utilizando os comandos Node.js documentados abaixo.

Uso local a partir do repositório

Durante o desenvolvimento, execute diretamente com Node.js:

node bin/servicenow-skills-suite.js --help
node bin/servicenow-skills-suite.js list
node bin/servicenow-skills-suite.js list --json
node bin/servicenow-skills-suite.js validate
node bin/servicenow-skills-suite.js validate --target ./installed-suite

Use list para saída humana e list --json quando agentes, IDEs, scripts ou validações precisarem consumir a lista de skills de forma estruturada. A saída JSON inclui dados resumidos como name, displayName, version, defaultSkill, skillsCount e skills.

Use validate para validar a suíte local ou o pacote atual. Use validate --target <path> para validar uma suíte copiada previamente pelo init.

Para copiar a suíte para um workspace de agente ou IDE:

node bin/servicenow-skills-suite.js init
node bin/servicenow-skills-suite.js init --dry-run
node bin/servicenow-skills-suite.js init --target .agents/skills/serviceNow_skills_suite
node bin/servicenow-skills-suite.js init --target .agents/skills/serviceNow_skills_suite --dry-run
node bin/servicenow-skills-suite.js init --dry-run --target .agents/skills/serviceNow_skills_suite

O destino padrão do init é .agents/skills/serviceNow_skills_suite. O comando não sobrescreve um destino existente; escolha outro --target ou remova o destino manualmente antes de executar novamente.

Use --dry-run antes do init real para revisar o destino resolvido e os artefatos que seriam copiados. O dry-run não cria arquivos, não copia diretórios e, se o destino já existir, exibe um aviso sem sobrescrever nada.

As opções --force e --backup ainda não estão disponíveis. Os comandos sync, doctor e update também ainda não estão disponíveis.

Use validate como verificação estrutural da suíte antes de empacotar, distribuir ou copiar os artefatos para outro projeto.

Estrutura sugerida do repositório

serviceNow_skills_suite/
├── package.json
├── suite.manifest.json
├── README.md
├── MASTER_SUITE_V1.md
├── bin/
│   └── servicenow-skills-suite.js
├── docs/
│   ├── usage-guide.md
│   ├── handoff-matrix.md
│   ├── servicenow-engineering-standards.md
│   ├── release-checklist.md
│   ├── demand-analysis-template.md
│   └── suite-overview.html
├── skills/
│   └── <skill>/
│       └── SKILL.md
└── .agents/
    └── rules/
        └── rules-servicenow.md