Intrepid/prometeu-runtime
Intrepid/prometeu-runtime
3
0
Fork 0
Code Pull Requests Activity
prometeu-runtime/docs/debugger/README.md

2.9 KiB
Raw Blame History

Especificação — Ciclo de Desenvolvimento Prometeu

Versão: 0.1
Status: Conceitual / Filosófico

1. Princípio Central

O Prometeu é uma plataforma didática de desenvolvimento de software interativo.
Seu ciclo de desenvolvimento é projetado para separar claramente:

  • Criação de código
  • Compilação
  • Execução
  • Observação e explicação

Cada etapa possui uma ferramenta própria, especializada e não sobreposta.

2. Ferramentas do Ciclo

O ciclo utiliza quatro pilares:

  1. Editor de Código
    Ambiente livre (ex: WebStorm) onde o desenvolvedor escreve em TypeScript.

  2. Compilador Prometeu
    Converte código fonte em bytecode executável pela runtime Prometeu.

  3. Runtime Prometeu
    Executa jogos e aplicações em seu próprio ambiente gráfico.

  4. Prometeu Debugger
    Ferramenta didática de observação, análise e explicação do comportamento interno do sistema.

Nenhuma dessas ferramentas tenta substituir a outra.
Elas cooperam através de contratos claros.

3. Fluxo Geral

O ciclo segue sempre a mesma sequência conceitual:

  1. O desenvolvedor escreve código em TypeScript.
  2. O código é compilado para bytecode Prometeu.
  3. O bytecode é empacotado como cartucho.
  4. O cartucho é executado pela runtime.
  5. O comportamento interno pode ser observado pelo Prometeu Debugger.

4. Modos de Execução

O Prometeu possui dois modos conceituais de execução:

Execução Normal (Run)

  • O cartucho é empacotado e executado.
  • A runtime funciona de forma autônoma.
  • O Debugger atua apenas como observador.

Execução Assistida (Debug)

  • O cartucho é empacotado e executado.
  • A runtime aguarda conexão do Prometeu Debugger.
  • O Debugger passa a controlar e observar a execução.

5. Separação de Papéis

Cada parte do ciclo tem responsabilidade única:

Etapa Papel principal
Editor Criar código
Compilador Transformar código em bytecode
Runtime Executar
Debugger Observar, explicar e ensinar

Essa separação é intencional e parte da filosofia do Prometeu.

6. Filosofia Didática

O Prometeu não é apenas uma engine.
Ele é uma plataforma para aprender como software interativo funciona por dentro.

O ciclo de desenvolvimento é pensado para:

  • Tornar a execução visível
  • Tornar decisões técnicas observáveis
  • Tornar erros explicáveis
  • Tornar desempenho mensurável

O Debugger não é apenas uma ferramenta de correção, mas um instrumento pedagógico.

7. Síntese

O Ciclo de Desenvolvimento Prometeu é:

  • Modular
  • Observável
  • Didático
  • Não acoplado a uma IDE específica
  • Orientado a aprendizado e compreensão profunda

Ele existe para que o desenvolvedor não apenas escreva programas, mas entenda como eles vivem dentro da máquina.