# Contributing to the Agile Prompt Library

Thank you for considering a contribution! This is a community resource and grows better with every practitioner who adds to it.

---

## Ways to Contribute

- **Add a new prompt** — a prompt for a ceremony, format, or use case not yet covered
- **Improve an existing prompt** — better context, clearer instructions, improved format
- **Share a variation** — a version of an existing prompt tailored for remote teams, SAFe, Kanban, etc.
- **Report an issue** — a prompt that produces poor output, is unclear, or needs updating
- **Improve the docs** — better explanations, examples, or tool-specific guidance

---

## Before You Submit

1. **Test your prompt** — run it at least once in a real AI tool with realistic inputs
2. **Follow the structure** — use the [Prompt Anatomy](./docs/prompt-anatomy.md) format (ROLE / CONTEXT / TASK / FORMAT / TONE)
3. **Use `[brackets]`** for all team-specific inputs
4. **Include follow-up prompts** where helpful
5. **Note which AI tools you tested it with**

---

## How to Submit a PR

1. Fork this repository
2. Create a branch: `feature/your-prompt-name`
3. Add your prompt to the relevant folder under `/prompts/`
4. Update the `README.md` table in that folder with your new prompt
5. Submit a Pull Request with a brief description of what the prompt does and where you've used it

---

## Prompt File Format

Each prompt file should follow this structure:

```markdown
# Prompt Name

**Use when:** [Brief description of the scenario]

PROMPT:
\```
[Your full prompt here]
\```

**Follow-up prompts:**
- [Optional: 2–3 follow-up prompts to iterate on the output]

**Tested with:** ChatGPT / Claude / Copilot
**Contributed by:** [Your name or handle, optional]
```

---

## Code of Conduct

- Be constructive — improvements and additions, not criticism
- Keep it practitioner-focused — prompts should be grounded in real Agile delivery
- Respect intellectual property — only contribute prompts you've written yourself
- Be inclusive — prompts should work across Scrum, SAFe, Kanban, and hybrid approaches where possible

---

## Questions?

Open an issue or start a discussion. Happy to help.