Skip to content

README.md

Latest commit

 

History

History
93 lines (64 loc) · 3.53 KB

README.md

File metadata and controls

93 lines (64 loc) · 3.53 KB
Raw

GT-1 Tone Maker

GT-1 Tone Maker e uma ferramenta em Node.js para transformar uma referencia musical em um patch/liveset importavel no BOSS Tone Studio para a pedaleira BOSS GT-1.

O projeto resolve um problema simples: muitas pessoas conseguem descrever o timbre que querem, mas nao sabem traduzir essa ideia para parametros da GT-1 ou para um arquivo .tsl. A ferramenta pretende fazer essa ponte de forma guiada, usando IA para preencher um formulario de texto controlado.

O resultado gerado deve ser uma base musical util para ajuste fino, nao uma copia oficial ou perfeita de timbres existentes.

Fluxo Planejado

  1. O usuario abre o app.
  2. O usuario escolhe "Criar distorcao/efeito".
  3. O usuario digita artista, banda, musica, album ou estilo.
  4. O sistema injeta essa referencia no prompt interno em {{USER_REFERENCE}}.
  5. A IA responde diretamente com um formulario GT1_TONE_FORM_V0_1.
  6. O formulario e salvo em input/.
  7. O parser le o formulario e gera um objeto interno.
  8. O normalizador aplica defaults e conversoes seguras.
  9. O validador confere campos obrigatorios, enums e ranges.
  10. O JSON interno normalizado e salvo em internal/.
  11. O gerador cria o arquivo .tsl.
  12. O patch final e salvo em output/.

Decisao Central

A IA nao deve gerar JSON.

A IA deve gerar apenas formularios GT1_TONE_FORM_V0_1.

JSON sera usado apenas como formato interno da ferramenta, depois que o formulario for lido, normalizado e validado.

Essa separacao existe para deixar o projeto mais robusto contra respostas imperfeitas da IA e mais simples para usuarios leigos.

Prompt Interno

O prompt usado pelo sistema fica em:

prompts/ai-tone-form-prompt-v0.1.md

Esse arquivo funciona como um template interno. O app substitui {{USER_REFERENCE}} pela referencia digitada pelo usuario antes de enviar o prompt para a IA.

O modo manual com copiar e colar formulario deve continuar existindo como fallback.

Estrutura Atual

  • input/: formularios .form.txt gerados pela IA ou colados pelo usuario.
  • internal/: JSONs internos normalizados gerados pela ferramenta.
  • output/: arquivos .tsl gerados.
  • base/: .tsl base oficial exportado pelo BOSS Tone Studio.
  • prompts/: prompts usados pelo sistema.
  • docs/: contratos, arquitetura e backlog.
  • src/form/: contrato em codigo, parser, normalizador e validador iniciais do formulario.
  • src/internal/: escrita do JSON interno normalizado.
  • tests/fixtures/: fixtures usadas nos testes manuais.
  • scripts/: scripts auxiliares de validacao manual.

Estado Atual

Ja existem:

  • contrato documental inicial do formulario;
  • prompt interno com {{USER_REFERENCE}};
  • overview de arquitetura;
  • parser inicial do bloco GT1_TONE_FORM_V0_1;
  • normalizador inicial com defaults seguros e conversoes tolerantes;
  • validador inicial de campos obrigatorios, enums e ranges;
  • escrita de JSON interno normalizado em internal/;
  • fixtures e scripts manuais de teste do formulario e do JSON interno.

Ainda faltam:

  • pesquisa e estrategia de manipulacao segura de .tsl;
  • gerador .tsl;
  • fluxo principal de usuario.

Teste Manual Disponivel

O projeto ainda nao tem package.json nem dependencias externas.

Os testes manuais atuais podem ser executados com Node.js:

node scripts/test-parser.js
node scripts/test-internal-json.js

Documentacao Principal

  • docs/backlog.md: controle de progresso.
  • docs/architecture-overview-v0.1.md: visao geral da arquitetura.
  • docs/gt1-tone-form-v0.1.md: contrato do formulario.

Antes de iniciar novas tarefas, consulte docs/backlog.md.