---
title: Provide Feedback
description: Help us improve specs.md with your valuable feedback
---

## Your Feedback Matters

specs.md is an open-source project built for the community, and **your feedback is essential** to making it better. Whether you've encountered a bug, have a feature idea, or simply want to share your experience, we want to hear from you.

:::info
As an early-stage project, your input directly shapes the direction of specs.md. Every piece of feedback helps us understand real-world use cases and prioritize what matters most.
:::

## How You Can Help

<CardGroup cols={2}>
  <Card title="Report Issues" icon="bug" href="https://github.com/fabriqaai/specsmd/issues/new?template=bug_report.md">
    Found a bug? Let us know so we can fix it quickly.
  </Card>
  <Card title="Request Features" icon="lightbulb" href="https://github.com/fabriqaai/specsmd/issues/new?template=feature_request.md">
    Have an idea that would make specs.md better? We'd love to hear it.
  </Card>
  <Card title="Ask Questions" icon="circle-question-mark" href="https://github.com/fabriqaai/specsmd/issues/new">
    Confused about something? Open an issue and we'll help clarify.
  </Card>
  <Card title="Share Experience" icon="message-square" href="https://github.com/fabriqaai/specsmd/issues/new">
    Tell us how you're using specs.md and what's working (or not).
  </Card>
</CardGroup>

## What Makes Great Feedback

When sharing feedback, consider including:

- **Context**: What were you trying to accomplish?
- **Steps**: What did you do? (Be specific)
- **Expected vs Actual**: What did you expect to happen? What actually happened?
- **Environment**: Which AI tool are you using? (Claude Code, Cursor, Copilot)
- **Ideas**: Any thoughts on how it could be improved?

## Submit Feedback

<Card
  title="Open a GitHub Issue"
  icon="git-branch"
  href="https://github.com/fabriqaai/specsmd/issues"
>
  Visit our GitHub Issues page to submit feedback, report bugs, or request features. We review every submission and respond as quickly as possible.
</Card>

---

:::note
We genuinely appreciate every piece of feedback. It takes time to write up issues and suggestions, and we don't take that for granted. Thank you for helping make specs.md better for everyone.
:::