osovv/grace-marketplace

Contexto do Repositório

Este repositório é o pacote do marketplace GRACE, não uma aplicação para usuário final.

GRACE significa Graph-RAG Anchored Code Engineering (Engenharia de Código Ancorada em Graph-RAG): uma metodologia de engenharia orientada a contratos, construída em torno de marcação semântica, artefatos de planejamento XML, navegação em grafos de conhecimento e execução baseada em verificação e logs.

O Que Este Repositório Contém

• skills/grace/* contém as fontes canônicas das skills.
• plugins/grace/skills/grace/* contém o espelho empacotado usado para distribuição no marketplace/plugin do Claude.
• .claude-plugin/marketplace.json define a entrada do marketplace.
• plugins/grace/.claude-plugin/plugin.json define o manifesto do plugin empacotado.
• openpackage.yml define os metadados do OpenPackage.
• README.md é a visão geral e guia de instalação voltado ao usuário.
• package.json, src/grace.ts e src/grace-lint.ts definem o pacote CLI publicado em Bun @osovv/grace-cli e o comando grace lint.
• scripts/validate-marketplace.ts valida empacotamento, segurança de caminhos, sincronização de versões e desvios entre versões empacotadas e canônicas.

Propósito Principal

O repositório empacota e distribui skills GRACE para que agentes de codificação possam:

• inicializar artefatos de projeto GRACE
• planejar arquitetura de módulos e contratos
• projetar verificação e evidências de log
• executar planos sequencialmente ou em ondas paralelas seguras
• inspecionar saúde do projeto, atualizar desvios, revisar integridade, explicar GRACE e responder perguntas sobre o projeto

Este repositório trata principalmente de conteúdo metodológico, instruções de skills e empacotamento para marketplace.

Regras Importantes de Trabalho

• Trate skills/grace/* como a fonte principal da verdade, a menos que a tarefa seja explicitamente sobre a saída empacotada.
• Mantenha plugins/grace/skills/grace/* sincronizado com as cópias canônicas em skills/grace/* quando as skills publicadas forem alteradas.
• Mantenha as versões sincronizadas entre README.md, openpackage.yml, .claude-plugin/marketplace.json e plugins/grace/.claude-plugin/plugin.json.
• Valide a integridade do repositório com bun run ./scripts/validate-marketplace.ts após alterações de empacotamento ou metadados.
• Para alterações no CLI ou ao verificar o fluxo de lint público, utilize também bun run grace lint --path . --allow-missing-docs.
• Não presuma que todo diretório em skills/grace/ é publicado; o conjunto realmente enviado é declarado em .claude-plugin/marketplace.json.

Como Pensar Sobre Mudanças

• Alterações no texto das skills são mudanças de produto.
• Alterações em empacotamento/manifestos/metadados são mudanças na superfície de release.
• Alterações de validação protegem contra desvios entre skills canônicas e cópias empacotadas.
• Atualizações no README e changelog fazem parte da higiene de release, não são polimento opcional.

Modelo Mental Padrão Para Sessões Futuras

Se uma solicitação for ambígua, presuma que o usuário está trabalhando em uma destas áreas:

• refinamento das instruções da metodologia GRACE
• adição ou atualização de uma skill
• correção de empacotamento/instalação no marketplace
• manutenção do CLI grace publicado e seu fluxo de lint
• manutenção da sincronização entre as árvores de skills canônicas e empacotadas
• aperto da validação em torno de releases