Give each planning step one name and make the guides easier to follow

- Rename prompt-templates/ to planning-prompts/ with numbered step folders, so GitHub lists them in workflow order. Folder, prompt file and skill now share one name per step (2-prd/prd.md is /prd). - Merge the full and ultra-lean MVP plan prompts into 5-mvp-plan/, as the /mvp-plan skill already did. - Rename the /mvp skill to /mvp-scope; the installer removes an earlier mvp install and tells the owner about the new name. - Rename agent-configs/claude-code-desktop/ to agent-configs/claude-code/, since the rules apply to the terminal too. - Rewrite each prompt guide in one short layout with previous and next links, drop outdated model and temperature advice, and fix the copied "final PRD draft" lines and the claimed v0.dev section. - Point to GitHub's Copy raw content button for copying a prompt. - Move the AI App Starter details from the root README into the starter guide, add the skills to the top table, and align the test plan wording with what the prompt produces. - Add issue forms, a Discussions link and a short contributing guide. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-20 08:39:44 +02:00 · 2026-10-12 14:57:27 +02:00
parent 1d3e2ca3f1
commit 30b9b8cf55
47 changed files with 526 additions and 528 deletions
@@ -0,0 +1,21 @@
+# Contributing
+
+Thanks for helping improve the toolkit. The most useful contribution is a report of a step that was unclear or didn't work.
+
+## Report a problem or suggest an idea
+
+[Open an issue](https://github.com/TechNomadCode/AI-Product-Development-Toolkit/issues/new/choose) and pick a form. For questions, use [Discussions](https://github.com/TechNomadCode/AI-Product-Development-Toolkit/discussions). Share only small, non-sensitive examples: no private data, keys or client details.
+
+## Pull requests
+
+For anything bigger than a typo, open an issue first, so the change is agreed before you spend time on it.
+
+Keep to how the toolkit works:
+
+- **Prompts interview first.** They ask a few questions at a time, state their assumptions, and draft only after the person agrees.
+- **Plain language.** Short sentences and no jargon, written for someone new to the topic.
+- **Same guide layout.** Each prompt folder has a README with what you get, what to bring, how to use it, good to know, and the next step.
+- **Prompt paths are used by the installers.** The [skills installer](../agent-skills/INSTALL.md), the [starter setup](../starters/nextjs-supabase-vercel/SETUP.md) and the starter's [planning stage](../starters/nextjs-supabase-vercel/project/.kit/stages/1-plan.md) copy prompt files by name. If you rename or move a prompt, update those files and the README links in the same pull request.
+- **Edit prompts in `planning-prompts/`.** The skills and the starter run those files unchanged, so one edit reaches all of them.
+
+Contributions are released under the repository's [MIT license](../LICENSE).
@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Ask a question
+    url: https://github.com/TechNomadCode/AI-Product-Development-Toolkit/discussions
+    about: Questions about using the prompts, the skills or the AI App Starter.
@@ -0,0 +1,37 @@
+name: Suggest an improvement
+description: An idea for a prompt, a skill, the AI App Starter or the docs.
+labels: ["enhancement"]
+body:
+  - type: dropdown
+    id: part
+    attributes:
+      label: Which part?
+      options:
+        - "User research (prompt or /user-research)"
+        - "PRD (prompt or /prd)"
+        - "UX and user flow (prompt or /ux)"
+        - "MVP scope (prompt or /mvp-scope)"
+        - "MVP build plan, full or ultra-lean (prompt or /mvp-plan)"
+        - "Test plan (prompt or /test-plan)"
+        - "AI App Starter"
+        - "Video skill (/remotion-video)"
+        - "Installing the skills"
+        - "Agent configurations (CLAUDE.md)"
+        - "README or other docs"
+        - "Something new"
+    validations:
+      required: true
+  - type: textarea
+    id: idea
+    attributes:
+      label: What would you like?
+      description: The change, and the problem it solves for you.
+    validations:
+      required: true
+  - type: textarea
+    id: context
+    attributes:
+      label: Anything else?
+      description: Links, examples or alternatives you've considered. Remove anything private.
+    validations:
+      required: false
@@ -0,0 +1,54 @@
+name: Report a problem
+description: A step was unclear, or a prompt, skill or the AI App Starter didn't work as described.
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting. Share only small, non-sensitive examples: no private data, keys or client details.
+  - type: dropdown
+    id: part
+    attributes:
+      label: Which part?
+      options:
+        - "User research (prompt or /user-research)"
+        - "PRD (prompt or /prd)"
+        - "UX and user flow (prompt or /ux)"
+        - "MVP scope (prompt or /mvp-scope)"
+        - "MVP build plan, full or ultra-lean (prompt or /mvp-plan)"
+        - "Test plan (prompt or /test-plan)"
+        - "AI App Starter"
+        - "Video skill (/remotion-video)"
+        - "Installing the skills"
+        - "Agent configurations (CLAUDE.md)"
+        - "README or other docs"
+        - "Other"
+    validations:
+      required: true
+  - type: input
+    id: tool
+    attributes:
+      label: AI tool and model
+      placeholder: "For example: Claude Code desktop with Opus 5.5, Codex, or an AI chat"
+    validations:
+      required: true
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened?
+      description: What you did, what the AI did, and where it went wrong or what was unclear.
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: What did you expect?
+    validations:
+      required: false
+  - type: textarea
+    id: example
+    attributes:
+      label: Small example
+      description: A short excerpt of the conversation or output that shows the problem. Remove anything private.
+    validations:
+      required: false