# IronClaw Discussions

[GitHub Discussions](https://github.com/IronSecCo/ironclaw/discussions) is the
place for questions, ideas, and community — anything that isn't a confirmed bug
or a security report.

## Where does my thing go?

| I want to… | Go here |
|------------|---------|
| Ask how to set something up / why something behaves a certain way | **Discussions → Q&A** |
| Suggest a feature or discuss direction | **Discussions → Ideas** |
| Show off an agent / setup you built | **Discussions → Show and tell** |
| Report a reproducible bug | **[New issue](https://github.com/IronSecCo/ironclaw/issues/new/choose)** (use the bug form) |
| Report a security vulnerability | **Never publicly** — use the [Security policy](https://github.com/IronSecCo/ironclaw/security/policy) / private advisory. See [`SECURITY.md`](../SECURITY.md). |
| Find something to contribute | Browse the [`good first issue`](https://github.com/IronSecCo/ironclaw/labels/good%20first%20issue) label |

## Categories

- **📣 Announcements** — releases and project news (maintainer-posted).
- **🙏 Q&A** — setup, configuration, and usage questions. Mark an answer as
  accepted when it solves your problem so others can find it.
- **💡 Ideas** — feature requests and design discussion. Check the
  [public roadmap](../docs/roadmap.md) first — your idea may already be planned.
- **🙌 Show and tell** — share what you've built on IronClaw.
- **💬 General** — everything else.

## Before you post

- Skim the [README](../README.md), the [5-minute quickstart](../docs/quickstart.md),
  and the [public roadmap](../docs/roadmap.md) — many questions are answered there.
- Search existing discussions and issues first.
- For anything security-sensitive, **stop** and use the private advisory flow —
  IronClaw is a security project and a public post can expose users.

## Community

Be kind and constructive; all activity is governed by our
[Code of Conduct](../CODE_OF_CONDUCT.md). New contributors are very welcome — see
[`CONTRIBUTING.md`](../CONTRIBUTING.md) and the
[`good first issue`](https://github.com/IronSecCo/ironclaw/labels/good%20first%20issue)
label to get started.

<!-- A community chat (Discord) invite will be linked here and in the README once the server is stood up. -->
