docs: CONTRIBUTING.md + issue templates — the musician contribution path (task H-02)

'Add a style without deep coding' centerpiece: KB data contract, mirror gospel pack,
register, run validator; explains why the validator exists; /kb-expand assisted path;
PR checklist. add-style/bug_report/feature_request templates + config.yml. License flagged
unsettled, not decided. Critic PASS (all links/commands verified, schema-faithful).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
vadimwit
2026-06-15 08:34:21 +01:00
parent e737e0c0b2
commit 8a7f932170
5 changed files with 274 additions and 0 deletions
+46
View File
@@ -0,0 +1,46 @@
---
name: Propose or contribute a style
about: Suggest a genre for the knowledgebase, or offer to author one
title: "[Style] "
labels: ["style", "content"]
---
<!--
Style packs are data, not code — see CONTRIBUTING.md ("Add a music style without
deep coding") and src/data/kb/SCHEMA.md. You can propose a style for someone else
to build, or claim it yourself.
-->
## Which style / genre?
<!-- e.g. Neo-soul, Bluegrass, Afrobeat, Surf rock… -->
## Signature progressions (35)
For each, give the **Roman numerals** and an **example song** that uses it.
<!--
Example:
1. iiVI (e.g. "Misty")
2. IviiiV (1950s turnaround, e.g. "Stand By Me")
3. i7IV7 Dorian vamp (e.g. "Chameleon")
-->
1.
2.
3.
## What makes it sound like itself?
<!-- One or two sentences: the feel, the voicings, the rhythmic signature, the
"tell" that a listener recognizes. -->
## Will you author the voicings, or want help?
- [ ] I'll author the pack myself (guitar voicings / comping / improv) and open a PR
- [ ] I can supply the progressions and theory, but want help turning them into the data files
- [ ] I'm proposing the style for someone else to build
## Anything else?
<!-- Instrument focus (guitar/piano/bass), sources, reference recordings, etc. -->
+31
View File
@@ -0,0 +1,31 @@
---
name: Bug report
about: Something isn't working as expected
title: "[Bug] "
labels: ["bug"]
---
## What happened?
<!-- A clear, short description of the bug. -->
## Steps to reproduce
1.
2.
3.
## What you expected instead
## Environment
- OS:
- How you ran it: <!-- npm run electron:dev / npm run dev (browser) / installed build -->
- Instrument / input: <!-- e.g. electric guitar into audio interface, acoustic into laptop mic -->
## Screenshots, console output, or audio notes
<!-- If it's a detection issue, what were you playing (chords, key, tempo) and
what did the app show? -->
+8
View File
@@ -0,0 +1,8 @@
blank_issues_enabled: true
contact_links:
- name: The roadmap & vision (GOAL.md)
url: https://github.com/whattheflat/whattheflat/blob/main/GOAL.md
about: Where JamBuddy is headed — read this before proposing a big feature.
- name: How to contribute a style (CONTRIBUTING.md)
url: https://github.com/whattheflat/whattheflat/blob/main/CONTRIBUTING.md
about: Add a genre to the knowledgebase without deep coding.
+26
View File
@@ -0,0 +1,26 @@
---
name: Feature request
about: Suggest an idea or improvement
title: "[Feature] "
labels: ["enhancement"]
---
<!-- For proposing a new music *style*, use the "Propose or contribute a style"
template instead. -->
## The problem / the jam moment
<!-- What are you trying to do, and where does the app fall short today? -->
## What you'd like to see
## How it fits the roadmap
<!-- Optional: does this relate to something in GOAL.md (detection, the Jam Guide,
the Progression Builder, the Learn drills)? -->
## Alternatives or references
<!-- Other tools that do this well, or workarounds you've tried. -->