Markdown Converter
Agent skill for markdown-converter
- Respeitar as **Regras do Projeto** (sem deps externas; VS2022/Win11 x64/CUDA 13; implementações completas; comentários PT‑BR; pacote + manifesto a cada entrega).
Sign in to like and favorite skills
tools/guardrails/*.py.python tools/guardrails/package_release.py vX.Y.Z.CHECKSIGADD em thresh(); preferir árvores simples inicialmente.tools/guardrails/check_features.py sempre que um recurso for adicionado.O agente deve se preparar para implementar funcionalidades planejadas no Plano de Continuidade. Em particular:
BitCrypto.Core com janelas adaptativas. Fornecer um contexto de pré‑cálculo opcional para reutilizar tabelas de pontos e permitir APIs que recebam listas de pontos e escalares.--sign-message/--verify-message e atualizar a documentação.Para cada uma dessas etapas, o agente deverá atualizar a documentação (
CONTINUIDADE.md, ARQUITETURA.md, COMPLETUDE.md) e os guard‑rails (novos tokens) e incluir testes. Consulte CONTINUIDADE.md para uma lista detalhada de tarefas e referências.
Esta seção destina‑se ao agente de IA (Codex IA) responsável por gerar e manter o código do BitCrypto. Os itens a seguir sintetizam as principais regras, processos e futuros marcos que o agente deve seguir. Eles complementam as diretivas gerais do projeto presentes neste arquivo e nos demais documentos (
REGRAS.md, CONTINUIDADE.md, MAINTENANCE.md, CONVENCOES_DE_CODIGO.md e REFERENCIAS_AVANCADAS.md).
Seguir as Regras — O Codex deve sempre respeitar as regras do projeto: zero dependências externas, C++17, operações em tempo constante para rotas sensíveis, comentários em português, uso de CMake/VS2022 x64/CUDA 13 conforme os presets. Antes de propor mudanças, consulte e atualize
REGRAS.md e CONVENCOES_DE_CODIGO.md.
Guard‑rails e testes — Antes de finalizar uma tarefa, rode os scripts de guard‑rails (
tools/guardrails/check_constant_time_heuristic.py, check_no_external_deps.py, etc.) e execute os testes (ctest). Se adicionar novos algoritmos ou módulos, forneça tokens e assinaturas de guard‑rails adequados.
Empacotamento e CI — Use o script
package_release.py para gerar os zips e manifests de releases. Mantenha a configuração do CMake (CMakeLists.txt e CMakePresets.json) e os workflows do GitHub Actions atualizados, garantindo builds reproduzíveis (RelWithDebInfo por padrão, LTO opcional, CUDA opcional). Nunca comprometa a estabilidade do CI.
Documentação — Para cada novo recurso implementado, atualize os arquivos de documentação correspondentes:
CONTINUIDADE.md (planejamento futuro), COMPLETUDE.md (cobertura atual), ARQUITETURA.md/DESCRICAO_COMPONENTES.md (descrição de módulos), README.md e notas de release. Referencie fontes externas (vide REFERENCIAS_AVANCADAS.md) quando introduzir novas técnicas e registre marcos atingidos.
Tarefas de evolução — Prepare‑se para implementar as funcionalidades listadas em Próximos marcos, incluindo:
BitCrypto.Core.Qualidade e segurança — Mantenha o código legível, modular e coberto por testes. Preserve operações em tempo constante, evite instruções dependentes de dados e utilize
cmov quando necessário. Antes de adotar novas otimizações (p.ex., unrolling, janelas wNAF), consulte REFERENCIAS_AVANCADAS.md e justifique o ganho de performance sem quebrar as regras.
Seguindo estas diretrizes, o Codex IA será capaz de continuar a evolução do BitCrypto de forma consistente e segura.