diff --git a/.github/ISSUE_TEMPLATE/adapter_request.yml b/.github/ISSUE_TEMPLATE/adapter_request.yml new file mode 100644 index 00000000..ace3ca9f --- /dev/null +++ b/.github/ISSUE_TEMPLATE/adapter_request.yml @@ -0,0 +1,42 @@ +name: New agent adapter +description: Request or propose support for a new AI agent or model provider +labels: [adapter] +body: + - type: markdown + attributes: + value: | + New agent adapters are welcome without prior discussion. If you plan to implement, prefer extending Paperclip via the [plugin system](https://github.com/paperclipai/paperclip/blob/master/doc/plugins/PLUGIN_SPEC.md) when possible. + - type: input + id: agent + attributes: + label: Agent or provider + description: Name of the agent, model, or CLI tool. + placeholder: e.g. Gemini CLI, LM Studio, Mistral + validations: + required: true + - type: textarea + id: why + attributes: + label: Why this adapter is useful + description: What use cases does this unlock? Who would benefit? + validations: + required: true + - type: textarea + id: how-invoked + attributes: + label: How the agent is invoked + description: CLI command, API endpoint, SDK — whatever is relevant. Link docs if available. + validations: + required: true + - type: checkboxes + id: willing + attributes: + label: Are you willing to implement it? + options: + - label: Yes, I plan to open a PR + - label: No, requesting for someone else to pick up + - type: textarea + id: context + attributes: + label: Additional context + description: Links, examples from existing adapters, configuration quirks, etc. diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml new file mode 100644 index 00000000..6109c8de --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -0,0 +1,75 @@ +name: Bug report +description: Something is broken or behaving unexpectedly +labels: [bug] +body: + - type: markdown + attributes: + value: | + Thanks for taking the time to file a bug. Please fill out the sections below so we can reproduce and triage quickly. + - type: textarea + id: what-happened + attributes: + label: What happened? + description: A clear description of the bug. + placeholder: When I do X, Y happens instead of Z. + validations: + required: true + - type: textarea + id: expected + attributes: + label: Expected behavior + description: What should have happened instead. + validations: + required: true + - type: textarea + id: repro + attributes: + label: Steps to reproduce + description: Numbered steps a maintainer can follow to reproduce the bug. + value: | + 1. + 2. + 3. + validations: + required: true + - type: input + id: paperclip-version + attributes: + label: Paperclip version or commit + description: Output of `paperclipai --version` or the commit SHA you are running. + placeholder: e.g. 0.42.0 or 78dc3625ac + validations: + required: true + - type: dropdown + id: deployment + attributes: + label: Deployment mode + options: + - Local dev (pnpm dev) + - Docker + - Self-hosted server + - Other + validations: + required: true + - type: input + id: node-version + attributes: + label: Node.js version + description: Output of `node --version`. + placeholder: e.g. v20.18.0 + - type: input + id: os + attributes: + label: Operating system + placeholder: e.g. macOS 14.5 (Apple Silicon), Ubuntu 22.04 + - type: textarea + id: logs + attributes: + label: Relevant logs or output + description: Paste error messages, stack traces, or API responses. Will be rendered as a code block. + render: shell + - type: textarea + id: context + attributes: + label: Additional context + description: Screenshots, related issues, or anything else that might help. diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 00000000..c0c9d902 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,8 @@ +blank_issues_enabled: false +contact_links: + - name: Discord (#dev) + url: https://discord.gg/paperclipai + about: Design discussions, questions, and feature coordination before opening a PR + - name: Roadmap + url: https://github.com/paperclipai/paperclip/blob/master/ROADMAP.md + about: Check the roadmap before requesting a feature diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml new file mode 100644 index 00000000..39d0a067 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_request.yml @@ -0,0 +1,37 @@ +name: Feature request +description: Propose a new capability or improvement +labels: [enhancement] +body: + - type: markdown + attributes: + value: | + Feature work on core Paperclip is coordinated against `ROADMAP.md` and Discord `#dev`. Please skim those before filing — see [CONTRIBUTING.md](https://github.com/paperclipai/paperclip/blob/master/CONTRIBUTING.md) for the full guidance. + - type: textarea + id: problem + attributes: + label: Problem or motivation + description: What are you trying to do that is currently difficult or impossible? + validations: + required: true + - type: textarea + id: solution + attributes: + label: Proposed solution + description: Describe the feature you'd like. How should it work? + validations: + required: true + - type: textarea + id: alternatives + attributes: + label: Alternatives considered + description: Other approaches you thought about and why you ruled them out. + - type: textarea + id: roadmap + attributes: + label: Roadmap alignment + description: Does this relate to anything in `ROADMAP.md`? Link the relevant section if so. + - type: textarea + id: context + attributes: + label: Additional context + description: Mockups, examples from other tools, related issues, etc.