Skip to content

Latest commit

 

History

History
192 lines (130 loc) · 4.34 KB

File metadata and controls

192 lines (130 loc) · 4.34 KB

Contributing to PromptTracker

Contribuir a PromptTracker


🇺🇸 English

Thank you for your interest.

PromptTracker is an exploratory and open project.
Not everything is decided. Good ideas are welcome, even when they require major changes.


Philosophy

  • PromptTracker works with symbolic patterns, not final audio.
  • Sound is a mathematical consequence of the pattern.
  • Meaning and intention remain human.
  • This project prioritizes honest exploration over premature stability.

Freedom to change

This project allows breaking changes when the improvement justifies it.

  • If an idea clearly improves the mental model, the workflow, or expressiveness:
    • it may change the format
    • it may break compatibility
    • it may propose a new SPEC

There is no dogma of “eternal compatibility”.


The only thing we ask

Before proposing a major change, please explain:

  1. What problem it solves
  2. Why it is better than the current approach
  3. What breaks and why it is worth it
  4. A concrete example (.pt, pseudocode, or output)

Clarity matters more than perfection.


Determinism (a principle, not a religion)

Determinism is a goal, not a dogma.

  • If a proposal introduces variation:
    • it must be explicit
    • controllable
    • documented

Acceptable examples:

  • visible seeds
  • optional modes
  • clear flags (MODE: experimental)

Nothing hidden.


Pull Requests

  • One main idea per PR
  • It does not need to be “perfect”
  • Experimental work is welcome
  • Draft PRs are fine

If something breaks, say it clearly in the description.


Large proposals (informal RFC)

For ideas that change direction:

  • Open an issue
  • Explain the idea as if talking to another person
  • No academic language required
  • It does not need to be fully solved

This repository is a laboratory, not a finished product.


Community

  • Be respectful
  • No artificial hype
  • No magical claims

Here we test, break things, and learn.


In one sentence

PromptTracker is a space to think about music as data.
If a good idea breaks the mold, it is welcome.


🇪🇸 Español

Gracias por tu interés.

PromptTracker es un proyecto exploratorio y abierto.
No todo está decidido. Las buenas ideas son bienvenidas, incluso si implican cambios grandes.


Filosofía

  • PromptTracker trabaja con patrones simbólicos, no con audio final.
  • El sonido es una consecuencia matemática del patrón.
  • El significado y la intención siguen siendo humanas.
  • Este proyecto prioriza la exploración honesta sobre la estabilidad prematura.

Libertad para cambiar

Este proyecto permite cambios que rompan compatibilidad si la mejora lo justifica.

  • Si una idea mejora claramente el modelo mental, el flujo o la expresividad:
    • puede cambiar el formato
    • puede romper compatibilidad
    • puede proponer una nueva SPEC

No hay dogma de “compatibilidad eterna”.


Lo único que pedimos

Antes de proponer un cambio grande, explica:

  1. Qué problema resuelve
  2. Por qué es mejor que el enfoque actual
  3. Qué se rompe y por qué vale la pena
  4. Un ejemplo concreto (.pt, pseudocódigo o salida)

La claridad es más importante que la perfección.


Determinismo (principio, no religión)

El determinismo es un objetivo, no una religión.

  • Si una propuesta introduce variación:
    • debe ser explícita
    • controlable
    • documentada

Ejemplos aceptables:

  • seeds visibles
  • modos opcionales
  • flags claros (MODE: experimental)

Nada oculto.


Pull Requests

  • Una idea principal por PR
  • No tiene que estar “perfecta”
  • El trabajo experimental es bienvenido
  • Los PRs en estado draft son válidos

Si algo se rompe, dilo claramente en la descripción.


Propuestas grandes (RFC informal)

Para ideas que cambian el rumbo:

  • Abre un issue
  • Explica la idea como si se la contaras a otra persona
  • No hace falta lenguaje académico
  • No tiene que estar completamente resuelta

Este repositorio es un laboratorio, no un producto terminado.


Comunidad

  • Sé respetuoso
  • Sin hype artificial
  • Sin afirmaciones mágicas

Aquí se prueba, se rompe y se aprende.


En una frase

PromptTracker es un espacio para pensar la música como datos.
Si una buena idea rompe el molde, es bienvenida.