Big News: Socket raises $60M Series C at a $1B valuation to secure software supply chains for AI-driven development.Announcement →
@sysmanager/sys-skills
Advanced tools
@sysmanager/sys-skills - npm Package Compare versions
+1
-1
| { | ||
| "name": "@sysmanager/sys-skills", | ||
| "version": "1.0.16", | ||
| "version": "1.0.17", | ||
| "description": "Agent Skills Framework - Easy setup for AI agent capabilities and integrations (Claude, Gemini, Codex, GitHub Copilot)", | ||
@@ -5,0 +5,0 @@ "type": "module", |
| --- | ||
| id: syscoe-setup-harness | ||
| name: SysCOE Setup Harness | ||
| description: "Skill custom SysManager para bootstrap completo do harness AI-SDLC em um novo projeto ou nova feature — cria estrutura _sys/core/, gera config.yaml, CLAUDE.md/AGENTS.md, configura MCPs, instala skills locais e prepara o ADO board. Atende o slot Transversal E0 (harness-bot) do framework AI-SDLC. Use quando um projeto ainda não tem o harness configurado ou quando uma nova feature precisa de scaffold isolado. Composta de: TLC skill-architect + subagent-creator + local harness-research init." | ||
| argument-hint: "new-project | new-feature | new-env | migrate | check" | ||
| metadata: | ||
| version: '1.0.0' | ||
| category: sdlc | ||
| dependencies: [harness-core, harness-research] | ||
| requires: {} | ||
| tags: [setup, harness, bootstrap, scaffold, config-yaml, claude-md, mcp, e0, syscoe] | ||
| --- | ||
| # SysCOE Setup Harness — Transversal E0 | ||
| ## Objetivo | ||
| Preparar toda a infraestrutura do harness AI-SDLC antes que qualquer fase (Research/Plan/Implement) possa iniciar. É a **Etapa 0** do framework — não iterativa, sem Gate próprio, mas pré-requisito de plataforma sem o qual as 6 etapas das fases produzem output instável. | ||
| Slot atendido: **Transversal E0 — harness-bot** | ||
| > **Regra:** se o checklist desta skill não está 100% verde, as fases não iniciam. Pular o Setup é a causa #1 de alucinação em projetos AI-SDLC. | ||
| --- | ||
| ## Quando Usar Esta Skill | ||
| - Novo projeto sendo iniciado no framework AI-SDLC | ||
| - Nova feature em projeto existente que precisa de scaffold isolado | ||
| - Migração de projeto legado (sem `_sys/core/`) para a estrutura canônica | ||
| - Verificação de saúde do harness de um projeto existente | ||
| --- | ||
| ## Passo 1 — Identificar Modo | ||
| | Argumento | Ação | | ||
| |---|---| | ||
| | `new-project` | Bootstrap completo: `_sys/core/` + config.yaml + Rules + MCPs + ADO board | | ||
| | `new-feature` | Scaffold de feature: worktree + sub-collection wiki + WIT SDLC | | ||
| | `new-env` | Configurar novo ambiente (staging, sandbox) em projeto existente | | ||
| | `migrate` | Migrar projeto legado (pre-`_sys/core/`) para estrutura canônica | | ||
| | `check` | Verificar saúde do harness existente sem criar nada | | ||
| --- | ||
| ## Passo 2 — Checklist de Pré-Requisitos de Plataforma | ||
| Verificar e instalar o que estiver faltando: | ||
| ```markdown | ||
| ## Checklist E0 — Setup do Harness | ||
| ### Tools & CLIs | ||
| - [ ] `claude-code` instalado e autenticado | ||
| - [ ] `az` CLI instalado (`az --version`) | ||
| - [ ] `gh` CLI instalado e autenticado (`gh auth status`) | ||
| - [ ] `mmdc` (Mermaid CLI) instalado (`mmdc --version`) | ||
| - [ ] Node.js ≥ 20 + npm instalados | ||
| ### MCPs Configurados (`.mcp.json` ou `~/.claude/settings.json`) | ||
| - [ ] Azure DevOps MCP (`azure-devops-mcp` Microsoft oficial) | ||
| - [ ] Outline wiki MCP (`outline`) | ||
| - [ ] Context7 MCP (`context7`) | ||
| - [ ] Figma MCP (se projeto tem UI) | ||
| - [ ] Langfuse MCP (se projeto tem features de IA) | ||
| ### Arquivos Imperativos no Repo | ||
| - [ ] `CLAUDE.md` (Rules do projeto para Claude Code) | ||
| - [ ] `AGENTS.md` (catálogo de agentes disponíveis) | ||
| - [ ] `.gitignore` inclui `_sys/core/.lock` e `.env` | ||
| ### ADO Board | ||
| - [ ] Process `gov-sys-manager` ativo no projeto ADO | ||
| - [ ] Campos customizados provisionados (TokensUsed, EstAICost, Duration, StartedAt, CompletedAt) | ||
| - [ ] Epic criado para o projeto/feature | ||
| ``` | ||
| --- | ||
| ## Passo 3 — Gerar `_sys/core/config.yaml` | ||
| Criar a **fonte da verdade** do projeto: | ||
| ```yaml | ||
| # _sys/core/config.yaml | ||
| project: | ||
| id: "{slug-do-projeto}" | ||
| name: "{nome completo}" | ||
| ado_org: "https://dev.azure.com/sysmanagerdevops" | ||
| ado_project: "{nome-projeto-ADO}" | ||
| ado_epic_id: {id} | ||
| outline_collection_id: "{id}" | ||
| target: | ||
| llm: "claude" # claude | codex | gemini | copilot | ||
| model: "sonnet" # opus | sonnet | haiku | ||
| phase: | ||
| current: "none" # none | research | plan | implement | ||
| step: 0 | ||
| status: "setup" # setup | in-progress | validating | done | blocked | ||
| history: [] | ||
| skills: | ||
| installed: [] # preenchido após instalação | ||
| agents: | ||
| research: [] | ||
| plan: [] | ||
| implement: [] | ||
| ``` | ||
| --- | ||
| ## Passo 4 — Gerar `CLAUDE.md` (Rules) | ||
| Criar o arquivo de Rules com o template SysManager: | ||
| ```markdown | ||
| # CLAUDE.md — Rules do Projeto {nome} | ||
| ## Contexto | ||
| {descrição do projeto, stack, objetivos} | ||
| ## Stack | ||
| - Backend: {linguagem + framework} | ||
| - Frontend: {framework ou N/A} | ||
| - Banco: {engine} | ||
| - Infra: {cloud/plataforma} | ||
| ## Padrões Estabelecidos | ||
| - Logging: {biblioteca + formato} | ||
| - Testes: {framework + cobertura mínima} | ||
| - Linting: {ferramenta + config} | ||
| - Commits: Conventional Commits obrigatório | ||
| ## Constraints | ||
| - ADO-only: sem GitHub, sem Jira, sem Confluence | ||
| - LLM target: Claude Code (Sonnet para builder, Opus para revisores) | ||
| ## Skills Instaladas | ||
| Ver `_sys/core/config.yaml → skills.installed` | ||
| ## Agentes Disponíveis | ||
| Ver `_sys/core/agents/` e `AGENTS.md` | ||
| ``` | ||
| --- | ||
| ## Passo 5 — Instalar Skills Locais | ||
| Instalar as skills obrigatórias via `@sysmanager/sys-skills`: | ||
| ```bash | ||
| # Skills transversais (sempre) | ||
| npx @sysmanager/sys-skills install --skill harness-core --target claude | ||
| npx @sysmanager/sys-skills install --skill harness-research --target claude | ||
| npx @sysmanager/sys-skills install --skill harness-plan --target claude | ||
| npx @sysmanager/sys-skills install --skill harness-implement --target claude | ||
| npx @sysmanager/sys-skills install --skill ado-workflow --target claude | ||
| npx @sysmanager/sys-skills install --skill git-cli --target claude | ||
| npx @sysmanager/sys-skills install --skill outline-wiki-manager --target claude | ||
| # Skills de fase (conforme roadmap do projeto) | ||
| npx @sysmanager/sys-skills install --skill market-research --target claude | ||
| npx @sysmanager/sys-skills install --skill prd-from-discovery --target claude | ||
| npx @sysmanager/sys-skills install --skill spec-from-prd --target claude | ||
| npx @sysmanager/sys-skills install --skill syscoe-task-decomposer-pro --target claude | ||
| npx @sysmanager/sys-skills install --skill syscoe-correctness-codex --target claude | ||
| npx @sysmanager/sys-skills install --skill syscoe-acceptance-review-macro --target claude | ||
| npx @sysmanager/sys-skills install --skill syscoe-deploy-multi-target --target claude | ||
| ``` | ||
| Atualizar `_sys/core/config.yaml → skills.installed` com cada skill instalada. | ||
| --- | ||
| ## Passo 6 — Preparar ADO Board | ||
| 1. Verificar que Epic existe → se não, criar via `syscoe-board-ado-pro` | ||
| 2. Criar WIT SDLC Research com estado `Todo` (será criado automaticamente quando Research iniciar) | ||
| 3. Configurar iterações (sprints) no projeto ADO | ||
| --- | ||
| ## Passo 7 — Preparar Sub-collection Outline | ||
| 1. Verificar que a coleção do projeto existe no Outline | ||
| 2. Criar sub-collection de Research (E0-E6) via `outline-wiki-manager` | ||
| 3. Registrar IDs no `_sys/core/.outline-sync.json` | ||
| --- | ||
| ## Passo 8 — Verificação Final (modo `check`) | ||
| ```markdown | ||
| ## Health Check do Harness | ||
| | Item | Status | | ||
| |---|---| | ||
| | `_sys/core/config.yaml` existe e é válido | ✅ / ❌ | | ||
| | `CLAUDE.md` com stack e constraints | ✅ / ❌ | | ||
| | `AGENTS.md` com agentes cadastrados | ✅ / ❌ | | ||
| | MCPs configurados e respondendo | ✅ / ❌ | | ||
| | Skills obrigatórias instaladas | ✅ / ❌ | | ||
| | ADO Epic e WITs SDLC criados | ✅ / ❌ | | ||
| | Outline sub-collection preparada | ✅ / ❌ | | ||
| **Status geral:** ✅ Pronto para Research / ❌ {N} itens pendentes | ||
| ``` | ||
| --- | ||
| ## Regras Invioláveis | ||
| - **Checklist 100% verde antes de iniciar Research** — sem exceções | ||
| - **`config.yaml` é a fonte da verdade** — nunca duplicar metadados do projeto em outros arquivos | ||
| - **Lock de `config.yaml`** — adquirir `_sys/core/.lock` antes de escrever (ver `harness-core`) | ||
| - **MCPs antes das skills** — configurar MCPs primeiro; skills dependem deles para operar | ||
| - **Idioma** — `config.yaml` em inglês; `CLAUDE.md` no idioma do projeto (pt-BR por padrão SysManager) |
New alerts
Filesystem access
Supply chain riskAccesses the file system, and could potentially read sensitive data.
Found 1 instance in 1 package
Fixed alerts
Filesystem access
Supply chain riskAccesses the file system, and could potentially read sensitive data.
Found 1 instance in 1 package
Worsened metrics
- Total package byte prevSize
607105
-1.25%- Number of package files
97
-1.02%No dependency changes