josenaldo

Audita um galho e gera `<galho>/roadmap.md`. Galho-folha: uma entrada executável por nota (estado, score, plano, custo). Galho-pai: navega a árvore, descobre sub-galhos e folhas, e gera roadmap recursivamente (mapa de estado dos sub-galhos + roadmap de cada folha). É pré-condição da `enriquecer-galho`. Use quando o usuário pedir "diagnosticar galho", "criar roadmap do galho", "diagnosticar o galho-pai X", "gerar roadmaps da árvore", ou quando a `enriquecer-galho` detectar que falta `roadmap.md` num galho ou sub-galho.

Coordena o enriquecimento de um galho, nota a nota, com governança de tokens via ccusage e memória em disco (roadmap.md). Navega a árvore: em galho-pai, desce pelos sub-galhos até a próxima folha com nota pendente; em folha, roda o loop. Roda em Opus/opusplan (coordenação pura — nunca enriquece notas diretamente). Use quando o usuário pedir "enriquecer galho", "enriquecer o galho X", "enriquecer o galho-pai X", "rodar enriquecimento do galho", "continuar enriquecimento de <pasta>", ou "retomar enriquecer-galho".

Enriquece uma nota do vault com lentes selecionáveis (profundidade, lacunas, novidade com fonte, conexões, mídia), filtradas por um subagente crítico calibrado pela fase da nota. Apresenta plano antes de executar. Fase 0 diagnostica a estrutura e ativa Modo A (incremental) ou Modo B (elevação). Use quando o usuário invocar /enriquecer-nota [path] [instrução], ou pedir pra "enriquecer", "aprofundar", "melhorar", "atualizar" ou "revisar" uma nota.

Use quando o usuário quiser ajuda interativa para refinar uma resposta/rascunho num Workbook da mentoria GCA (Session, Mock Interview ou Community). Aciona com "/coaching", "vamos trabalhar Q3", "me ajude com a história 2", "me coacha nessa resposta", "review essa resposta", "afina meu pitch", ou qualquer pedido de revisão de draft em arquivo `*- Workbook.md`. **MODO SOCRÁTICO ESTRITO**: NUNCA escreve a resposta pelo usuário; só pergunta, propõe alternativas em tabela e aponta violações de regras GSC. Dar a resposta pronta = FRACASSO TOTAL DA TAREFA.

Cria fichamento (Glosa) de vídeo do YouTube a partir de URL — vídeo único ou playlist. Baixa legendas via yt-dlp, sintetiza em PT-BR e grava em `02-Glosas/` no mesmo formato da /glosa, com timestamps. Use quando o usuário invocar /glosa-video, compartilhar URL de YouTube pedindo ficha/glosa/fichamento, ou disser "fichar esse vídeo", "glosar essa playlist", "registrar esse vídeo". Complementa a /glosa, que recusa YouTube. Suporta legendas manuais e automáticas em qualquer idioma (traduz o conteúdo pro PT-BR; cita no original).

Use quando o usuário quiser extrair um PDF de Community Session da mentoria GCA (Global Career Architecture, com Thaís Vieira) para o formato canônico do vault. Aciona com "/process-community", "processa o pdf da community", "extrai a community NN", "processa a sessão em grupo". Contexto típico: arquivos em `03-Domínios/Inglês/GCA/Community/`. Community sessions são em grupo (quinta à noite) com role-plays em pares (Breakout Rooms) — formato bem diferente de Sessions/Mocks. Esta skill NÃO consulta o Roadmap (Community é stream paralelo, não segue grid de 12 semanas).

Use quando o usuário quiser extrair um PDF de Mock Interview da mentoria GCA (Global Career Architecture, com Thaís Vieira) para o formato canônico do vault. Aciona com "/process-mock-interview", "processa o pdf da mock", "extrai a mock NN", "processa a mock interview". Contexto típico: arquivos em `03-Domínios/Inglês/GCA/Mock Interview/`. Consulta `03-Domínios/Inglês/GCA/Roadmap.md` (se existir) para inferir tema, persona, tipo (drill/full-loop), duração e fase do funil — além de gerar cross-links automáticos pra Session da mesma semana e pro Roadmap.

Expande uma semente de pergunta do backlog `03-Dominios/Inglês/Entrevistas/Database/Backlog de Perguntas.md` em dois Q-files completos (EN + PT) seguindo o template canônico (Q008-Q010). Aciona com `/process-question Q032`, "processa a pergunta Q022", "expande a semente Q014", "transforma Q026 em Q-file". Lê a inspiração GCA pra contexto de domínio, lê o dossiê do usuário (Roadmap.md) pra voz e posicionamento, gera draft sênior com anchor phrases, e move o card de Pendentes pra Processadas no backlog.

Verify Clean Architecture layer boundaries — domain and application must not import infrastructure. Use when the user says 'check boundaries', 'verify architecture', 'run boundary check', 'validate layers', or after any code change that touches domain or application layers. Don't use for writing new code — use the appropriate create-usecase or add-endpoint skill.

Write an Architecture Decision Record (ADR) capturing a significant technical decision. Use when the user says 'document this decision', 'write an ADR', 'record why we chose X', 'add a technical decision'. Don't use for user stories — use write-spec. Don't use for general documentation — use write-readme.

Create or update a README.md for a module, feature, or the project root. Use when the user says 'write a README', 'update the docs', 'document this module', 'add a getting started guide'. Don't use for architecture decisions — use write-adr. Don't use for user stories — use write-spec.

Create or update a user story with acceptance criteria following the As-a/I-want/So-that format. Use when the user says 'write a user story', 'create a spec', 'define requirements for X', 'add acceptance criteria'. Don't use for architecture decisions — use write-adr. Don't use for README files — use write-readme.

Add a new Gin HTTP endpoint wired to a Use Case following Clean Architecture in a Go project. Use when the user says 'add endpoint', 'create route', 'new API', 'expose X via HTTP', 'add a GET/POST/PUT/DELETE'. Don't use for business logic — use create-usecase-go. Don't use for tests — use write-unit-test-go.

Scaffold a new Use Case following Clean Architecture with TDD in a Go project. Use when the user says 'create use case', 'new service', 'new business operation', 'add X logic', 'implement Y feature'. Don't use for HTTP endpoints — use add-endpoint-gin. Don't use for frontend components — use create-component-mantine or create-component-mui.

Write a unit test for a Use Case or domain entity using Go's standard testing package with table-driven tests. Use when the user says 'write test', 'add tests', 'test this', 'TDD', 'cover X with tests'. Don't use for HTTP handler tests — use add-endpoint-gin for the handler, then test the use case. Don't use for integration tests with real databases.

Add a new Spring Boot REST endpoint wired to a Use Case following Clean Architecture. Use when the user says 'add endpoint', 'create route', 'new API', 'expose X via HTTP', 'add a GET/POST/PUT/DELETE'. Don't use for business logic — use create-usecase-spring. Don't use for tests — use write-unit-test-junit.

Preservação de voz autoral em textos de blog durante estruturação e revisão. Use quando o usuário quiser manter tom pessoal, coloquialismo e imperfeições intencionais sem perder clareza, coesão e qualidade editorial.

Inicializando repositórios sem contexto de IA com AGENTS.md, CLAUDE.md, camada do GitHub Copilot, docs lazy-loaded, memória de projeto e starter pack de skills. Use quando o usuário quiser preparar um repo para Claude Code e GitHub Copilot, ou revisar/normalizar um setup inicial já existente.

Pesquisa e solidificação de ideias para artigos (blog/ensaios técnicos) com linha de argumentação clara. Use esta skill quando o usuário pedir para pesquisar um tema, organizar fontes, mapear argumentos/contra-argumentos, produzir um research brief, ou transformar dúvidas vagas em uma tese defensável.

Revisão de artigos em Markdown (clareza, argumentação, precisão técnica, estilo e “voz humana”). Use esta skill quando o usuário pedir para revisar um artigo/rascunho, melhorar coesão, cortar gordura, fortalecer argumentos, ajustar tom e garantir consistência de frontmatter para o site.

Planejamento de séries de posts para blog com divisão de tema, progressão entre partes e autonomia de cada capítulo. Use quando o usuário quiser dividir um tema longo em múltiplos posts sem perder coesão, ritmo e identidade autoral.

Estruturação de artigos (blog/ensaio/técnico) com tese, narrativa e progressão de ideias. Use esta skill quando o usuário pedir para criar outline, estruturar seções, definir introdução/conclusão, calibrar tamanho, ou transformar notas/pesquisa em um artigo com argumento claro.

Authoring and maintenance workflow for this repo's Contentlayer2 content (content/*). Use when adding/editing Markdown pages, blog posts, projects, experiences, courses, testimonials, or skills; when frontmatter is missing/broken; or when Contentlayer build fails.

Build, troubleshoot, and modernize this repository's Next.js static export pipeline (output: 'export') and GitHub Pages deploy workflow. Use when the user mentions GitHub Pages, static export, the out/ folder, next build/export errors, basePath/assetPrefix issues, or CI workflow fixes.

Pesquisa e solidificação de ideias para artigos (blog/ensaios técnicos) com linha de argumentação clara. Use esta skill quando o usuário pedir para pesquisar um tema, organizar fontes, mapear argumentos/contra-argumentos, produzir um research brief, ou transformar dúvidas vagas em uma tese defensável.

Build, troubleshoot, and modernize this repository's Next.js build pipeline (Next.js + Contentlayer + next-sitemap + next-pwa). Use when the user mentions build errors, dependency upgrades, env vars (NEXT_PUBLIC_SITE_URL), sitemap/robots generation, PWA issues, or deployment mismatches.

Upgrade Next.js to the latest version following official migration guides and codemods

Authoring and maintenance workflow for this repo's Contentlayer content (content/*). Use when adding/editing blog posts or chapters; when frontmatter is missing/broken; or when Contentlayer build fails.

Maintain SEO metadata and sitemap/robots generation for this Next.js site. Use when changing titles/descriptions/OG images, canonical URLs, NEXT_PUBLIC_SITE_URL, next-seo configuration, or when adding sitemap.xml/robots.txt via next-sitemap.

React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.

Revisão de artigos em Markdown (clareza, argumentação, precisão técnica, estilo e “voz humana”). Use esta skill quando o usuário pedir para revisar um artigo/rascunho, melhorar coesão, cortar gordura, fortalecer argumentos, ajustar tom e garantir consistência de frontmatter para o site.

Revisão e atualização de conteúdo antigo (blog e capítulos do livro) com foco em clareza, consistência e manutenção do site (Next.js + Contentlayer). Use esta skill quando o usuário pedir para revisar peças antigas, padronizar textos, ajustar títulos/descrições, melhorar navegação e rodar validações do build.

Criando perfil de ambiente Linux/desktop (EnvironmentProfile) para nova distro ou DE. Use para adicionar suporte a Ubuntu 24, Fedora, Mint, KDE etc. Não use para criar ações de recovery (use create-recovery-action) nem para orquestrar execução (use create-use-case).

Criando ação de recuperação de subsistema Linux (audio, network, bluetooth, GNOME). Use para adicionar nova ação de fix, definir seus passos e registrá-la no profile de ambiente. Não use para criar o Use Case que orquestra a ação (use create-use-case) nem para criar um novo profile de distro (use create-environment-profile).

Criando componente de UI (Controller JavaFX ou componente TUI). Use para adicionar tela, botão, painel ou view de log na GUI ou TUI. Não use para criar lógica de negócio (use create-use-case) nem para definir ação de recovery (use create-recovery-action).

Criando Use Case na camada application para orquestrar ações de recovery. Use para criar novo orquestrador de execução, coordenar RecoveryActions e portas de infraestrutura. Não use para criar a ação em si (use create-recovery-action) nem para componente de UI (use create-ui-component).

Constraint-skill: valida fronteiras de Clean Architecture no fixkitty. Use SEMPRE como último passo ao criar ou alterar qualquer artefato, por camada ou por feature. Detecta importações proibidas, responsabilidades vazadas e acoplamentos indevidos. Não gera código — apenas valida.

Meta-skill para implementar uma feature ponta a ponta sem acoplar camadas. Use quando a tarefa exigir atravessar domain, application, infrastructure e interfaces em sequência controlada. Não use para mudanças isoladas a uma única camada — use a skill de camada correspondente diretamente.

Orquestrando a camada application. Use quando criar ou alterar use cases, fluxos de execução, políticas de orquestração e coordenação entre domain e ports. Não use para modelagem pura de domínio (use layer-domain), adapters concretos (use layer-infrastructure) ou telas (use layer-interface).

Modelando a camada domain/core. Use quando criar ou alterar entidades, value objects, enums, resultados de execução ou ports centrais do problema. Não use para orquestração de use cases (use layer-application), adapters concretos (use layer-infrastructure) ou componentes de UI (use layer-interface).

Exports flashcards from an EstudeMe vault into a neutral JSON file (suitable for Anki import). Use when the user asks 'export my cards', 'export cards to Anki', 'give me a card export', or wants to take cards out of the vault. Don't use to list cards in place — use list-cards.

Gives a complete state overview of an EstudeMe vault by orchestrating validation, trail listing, and metrics into a single coherent report. Use when the user asks 'how is my vault', 'give me an overview', 'state of my study system', 'review my vault'. Don't use for a single trail — use inspect-trail.

A test skill that should be ignored by the vault parser.

Reports vault-wide metrics in an EstudeMe vault: trail count, module count, notes per trail, cards per trail, overall structure summary. Use when the user asks 'show vault metrics', 'how is my progress overall', 'give me numbers on my vault'. Don't use to inspect a single trail — use inspect-trail.

Validates an EstudeMe vault: checks frontmatter against the schema for each document type and reports broken wikilinks. Use when the user asks 'validate my vault', 'check my vault', 'any broken links', 'is my vault healthy'. Don't use to inspect a specific trail's progress — use inspect-trail.

Lists all flashcards in an EstudeMe vault. Use when the user asks 'list my cards', 'what flashcards do I have', 'show me my cards', or wants a card inventory. Don't use to export cards to an external format — use export-cards.

Shows detailed progress and status for a specific trail in an EstudeMe vault: modules covered, notes per module, completion percentage. Use when the user asks 'how is my trail X', 'status of trail X', 'progress on the Java trail'. Don't use to list multiple trails — use list-trails.

Lists all trails (learning tracks) in an EstudeMe vault. Use when the user asks 'what trails do I have', 'list my trails', 'show me my trails', or wants an overview of their learning tracks. Don't use for progress detail on a specific trail — use inspect-trail.

Generate cover images for blog posts, projects, pages, and other site content. Use when the user asks to generate, create, or update cover/OG images for content. Saves images near the content file (colocation) or in public/images/{type}/.

Authoring and maintenance workflow for this repo's Contentlayer2 content (content/*). Use when adding/editing Markdown content (blog, projects, experiences, skills, courses, testimonials, services, presentations, publications); when frontmatter is missing/broken; or when Contentlayer build fails.

Internationalization (i18n) with next-intl and App Router static export. Use when adding/editing translations, adding a new locale, configuring locale routing, or fixing missing translation keys. This site supports pt (default) and en.

Build, troubleshoot, and modernize this repository's Next.js static export pipeline (output: 'export') and GitHub Pages deploy workflow. Use when the user mentions GitHub Pages, static export, the out/ folder, next build errors, basePath/assetPrefix issues, CI workflow fixes, or Contentlayer integration.

Maintain SEO metadata and sitemap/robots generation for this Next.js static site. Use when changing titles/descriptions/OG images, canonical URLs, NEXT_PUBLIC_SITE_URL, next-seo configuration, or when adding sitemap.xml/robots.txt via next-sitemap.

React composition patterns that scale. Use when refactoring components with boolean prop proliferation, building flexible component libraries, or designing reusable APIs. Triggers on tasks involving compound components, render props, context providers, or component architecture. Includes React 19 API changes.

React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.

Expande uma semente de pergunta do backlog `03-Dominios/Inglês/Entrevistas/Database/Backlog de Perguntas.md` em dois Q-files completos (EN + PT) seguindo o template canônico (Q008-Q010). Aciona com `/process-question Q032`, "processa a pergunta Q022", "expande a semente Q014", "transforma Q026 em Q-file". Lê a inspiração GCA pra contexto de domínio, lê o dossiê do usuário (Roadmap.md) pra voz e posicionamento, gera draft sênior com anchor phrases, e move o card de Pendentes pra Processadas no backlog.

Processa uma vaga de emprego a partir de URL pública em nota canônica em `03-Dominios/Inglês/Entrevistas/Vagas/` com 10 seções: BLUF, briefing da empresa, briefing da vaga, match analysis, pitch adaptado, prováveis perguntas em 6 fases, histórias do banco mapeadas, cheat sheet de vocabulário, logística/checklist, próximas ações, histórico. Aciona com "/processar-vaga <url>", "processa essa vaga", "ficha essa vaga", "vaga: <url>", "registra essa vaga", ou colando uma URL com pedido de processamento. Lê dossiê do candidato (Narrativa Profissional + Roadmap GCA) pra compor Match Analysis, pitch e mapeamento de histórias. Cross-linka com Sessions GCA (01-05) sistematicamente. NÃO inventa dados da empresa — onde faltar informação, marca explicitamente "(a confirmar no Recruiter Call)" ou "(a pesquisar)".

Use quando o usuário quiser extrair um PDF de Community Session da mentoria GCA (Global Career Architecture, com Thaís Vieira) para o formato canônico do vault. Aciona com "/process-community", "processa o pdf da community", "extrai a community NN", "processa a sessão em grupo". Contexto típico: arquivos em `03-Domínios/Inglês/GCA/Community/`. Community sessions são em grupo (quinta à noite) com role-plays em pares (Breakout Rooms) — formato bem diferente de Sessions/Mocks. Esta skill NÃO consulta o Roadmap (Community é stream paralelo, não segue grid de 12 semanas).