P0: Clearer MCP context layer for local LLM agents

.github/CODEOWNERS

@@ -0,0 +1,8 @@
+* @thunderdew-dawn
+
+.github/ @thunderdew-dawn
+docs/ @thunderdew-dawn
+knowledgebase/ @thunderdew-dawn
+fl_controller/ @thunderdew-dawn
+src/fls_pilot/safety.py @thunderdew-dawn
+src/fls_pilot/protocol.py @thunderdew-dawn

.github/ISSUE_TEMPLATE/api_probe.yml

@@ -0,0 +1,39 @@
+name: API Probe
+description: Request or document a focused FL Studio API probe.
+title: "[API PROBE] "
+labels:
+  - area:api
+  - api-dependent
+  - status:needs-triage
+body:
+  - type: textarea
+    id: question
+    attributes:
+      label: Probe question
+      description: What exact API behavior needs evidence?
+    validations:
+      required: true
+  - type: textarea
+    id: scope
+    attributes:
+      label: Target modules/functions
+      placeholder: channels.*, mixer.*, patterns.*, playlist.*, plugins.*, arrangement.*, general.*
+    validations:
+      required: true
+  - type: dropdown
+    id: safety
+    attributes:
+      label: Probe safety mode
+      options:
+        - read-only
+        - rollback-safe temporary write
+        - probe-only design needed
+    validations:
+      required: true
+  - type: textarea
+    id: evidence
+    attributes:
+      label: Evidence to capture
+      description: Include target selection, indexing, readback timing, rollback result, FL build, and controller marker.
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,80 @@
+name: Bug Report
+description: Report a reproducible problem with the FL Studio Pilot server.
+title: "[BUG] "
+labels:
+  - type:fix
+  - status:needs-triage
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Include the smallest reproduction you can. For live FL issues, start with `fl_transport(action="ping")` and the controller build marker.
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: What happened, and what did you expect?
+    validations:
+      required: true
+  - type: input
+    id: os
+    attributes:
+      label: Operating system
+      placeholder: macOS 15.5 / Windows 11
+    validations:
+      required: true
+  - type: input
+    id: fl-version
+    attributes:
+      label: FL Studio version and build
+      placeholder: FL Studio Producer Edition v25.2.5 build 5055
+    validations:
+      required: true
+  - type: input
+    id: python
+    attributes:
+      label: Python version
+      placeholder: "3.12.4"
+    validations:
+      required: true
+  - type: input
+    id: controller-marker
+    attributes:
+      label: Controller build marker
+      placeholder: channels-v39
+    validations:
+      required: false
+  - type: dropdown
+    id: bridge
+    attributes:
+      label: Bridge connection type
+      options:
+        - TCP daemon
+        - Direct MIDI/SysEx
+        - Unknown
+    validations:
+      required: true
+  - type: textarea
+    id: ping
+    attributes:
+      label: Ping/status evidence
+      description: Paste `fl_transport(action="ping")`, `fl://status`, or daemon output.
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      placeholder: |
+        1. Start daemon...
+        2. Open FL Studio...
+        3. Call...
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs and output
+      description: Paste relevant terminal, daemon, MCP, or FL script-output logs.
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Roadmap snapshot
+    url: https://github.com/thunderdew-dawn/fls-pilot/blob/main/docs/project/ROADMAP.github.md
+    about: Review the generated public roadmap snapshot before opening broad planning issues. The GitHub project board remains the source of truth.
+  - name: User guide
+    url: https://github.com/thunderdew-dawn/fls-pilot/blob/main/docs/USER_GUIDE.md
+    about: Review supported workflows, safety classes, and API limits.

.github/ISSUE_TEMPLATE/documentation_problem.yml

@@ -0,0 +1,39 @@
+name: Documentation Problem
+description: Report unclear, outdated, or incorrect project documentation.
+title: "[DOCS] "
+labels:
+  - area:docs
+  - type:maintenance
+  - status:needs-triage
+body:
+  - type: textarea
+    id: location
+    attributes:
+      label: Documentation location
+      description: Link or name the file, section, heading, command, or example.
+    validations:
+      required: true
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What is unclear, stale, factually wrong, or semantically misleading?
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Suggested correction
+      description: Include the expected behavior, accurate command, or safer wording if known.
+    validations:
+      required: false
+  - type: dropdown
+    id: safety
+    attributes:
+      label: Does this affect FL Studio safety claims?
+      options:
+        - No
+        - Yes, safety or rollback wording may be wrong
+        - Unknown
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,48 @@
+name: Feature Request
+description: Propose a safe product or workflow improvement.
+title: "[FEATURE] "
+labels:
+  - type:feature
+  - status:needs-triage
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What repeated user pain does this solve?
+    validations:
+      required: true
+  - type: textarea
+    id: outcome
+    attributes:
+      label: Desired outcome
+      description: What should a user be able to ask in plain language?
+    validations:
+      required: true
+  - type: dropdown
+    id: safety
+    attributes:
+      label: Safety class
+      options:
+        - read-only
+        - transient
+        - write-safe-required
+        - dry-run-only
+        - api-dependent
+        - unknown
+    validations:
+      required: true
+  - type: textarea
+    id: api
+    attributes:
+      label: FL Studio API evidence
+      description: Existing tool, docs, live probe, or known limitation.
+    validations:
+      required: false
+  - type: textarea
+    id: risks
+    attributes:
+      label: Risks and unsupported boundaries
+      description: Mention plugin loading, render/save/open automation, playlist clip editing, or rollback limits if relevant.
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/fl_build_compatibility.yml

@@ -0,0 +1,50 @@
+name: FL Build Compatibility
+description: Report behavior tied to a specific FL Studio/controller build.
+title: "[COMPAT] "
+labels:
+  - area:api
+  - api-dependent
+  - status:needs-triage
+body:
+  - type: input
+    id: fl-version
+    attributes:
+      label: FL Studio version and build
+      placeholder: FL Studio Producer Edition v25.2.5 build 5055
+    validations:
+      required: true
+  - type: input
+    id: controller-marker
+    attributes:
+      label: Controller build marker
+      placeholder: channels-v39
+    validations:
+      required: true
+  - type: input
+    id: os
+    attributes:
+      label: Operating system
+      placeholder: macOS 15.5 / Windows 11
+    validations:
+      required: true
+  - type: textarea
+    id: issue
+    attributes:
+      label: Compatibility issue
+      description: Which feature changed, failed, or behaved differently?
+    validations:
+      required: true
+  - type: textarea
+    id: evidence
+    attributes:
+      label: Evidence
+      description: Include ping, readback, rollback result, and logs if available.
+    validations:
+      required: true
+  - type: textarea
+    id: previous
+    attributes:
+      label: Previous working version
+      description: If known, include FL build and controller marker.
+    validations:
+      required: false