jrmoulckers/.github

O que .github faz?

JRM Studio — identidade compartilhada, arquivos de saúde da comunidade, camada canônica de IA (agentes/skills/prompts), workflows reutilizáveis e a ferramenta de sincronização entre repositórios.

Visão Geral

O repositório .github funciona como o centro de comando para todos os repositórios da organização JRM Studio. Ele armazena:

• Identidade Compartilhada: Perfil da organização, badges e assets visuais.
• Arquivos de Saúde da Comunidade: Templates de issues, guias de contribuição, código de conduta e outros documentos de governança.
• Camada Canônica de IA: Definições de skills, prompts e configurações de agentes que podem ser referenciados por ferramentas de IA como Claude Code, Cursor e Codex.
• Workflows Reutilizáveis: Workflows do GitHub Actions que podem ser invocados por outros repositórios.
• Ferramenta de Sincronização: Um script ou workflow que garante que mudanças neste repositório sejam propagadas para todos os outros repositórios da organização.

Estrutura do Repositório

.github/
├── profile/
│   └── README.md        # Perfil da organização
├── ISSUE_TEMPLATE/       # Templates de issues
├── PULL_REQUEST_TEMPLATE.md
├── workflows/            # Workflows reutilizáveis do GitHub Actions
├── skills/               # Definições de skills para agentes de IA
├── prompts/              # Prompts canônicos para agentes
└── sync-tool/            # Ferramenta de sincronização entre repositórios

Como Usar

Para Agentes de IA

Agentes podem consultar este repositório para:

• Encontrar arquivos de saúde da comunidade apropriados ao criar issues ou PRs.
• Aplicar workflows reutilizáveis de acordo com as necessidades do projeto.
• Usar prompts canônicos para interações consistentes com agentes.
• Referenciar definições de skills para entender o comportamento esperado.

Para Desenvolvedores

Desenvolvedores interagem com este repositório através de:

1. Pull Requests: Contribuições para arquivos de saúde da comunidade ou workflows seguem o fluxo padrão de PR.
2. Ferramenta de Sincronização: Executada automaticamente ou manualmente para propagar mudanças.
3. GitHub Actions: Workflows reutilizáveis são invocados a partir de outros repositórios via uses: jrmoulckers/.github/.github/workflows/<workflow>.yml@<ref>.

Workflows Reutilizáveis

Workflow	Descrição
ci.yml	Pipeline de CI padrão com lint, teste e build
release.yml	Workflow de release automatizado
sync.yml	Sincroniza arquivos canônicos para todos os repositórios

Declaração de Skills

Arquivos de skills neste repositório definem capacidades específicas que agentes de IA podem carregar. Exemplo:

# skills/community-health.yaml
name: community-health
version: 1.0.0
description: Aplica templates de issues e guias de contribuição da organização
platforms: [claude-code, cursor, codex]

Manutenção

Para adicionar um novo arquivo de saúde da comunidade:

1. Crie o arquivo no diretório apropriado.
2. Atualize a ferramenta de sincronização se necessário.
3. Envie um PR para revisão.

Licença

Este repositório é mantido pela JRM Studio. Consulte o arquivo de licença no repositório para detalhes.