Merge pull request #41 from agents-oss/docs/slack-community-link

docs: add Slack community link to README, CONTRIBUTING, and docs

Author: skokaina

CONTRIBUTING.md

@@ -4,6 +4,22 @@ Thank you for your interest in contributing to AgentSpec!
 
 ---
 
+## Community
+
+Real-time discussion happens on **[Slack](https://join.slack.com/t/agent-spec/shared_invite/zt-3v1zn1fck-p_futvhg32iCTI5rwTD_MQ)**. Channels:
+
+| Channel | For |
+|---------|-----|
+| `#general` | Announcements and general discussion |
+| `#help` | "How do I...?" questions about the CLI, SDK, or manifest |
+| `#show-and-tell` | Agents you've built with AgentSpec |
+| `#contributing` | Design discussions, RFCs, and PR coordination |
+| `#bugs` | Quick triage before opening a GitHub issue |
+
+For deeper async threads, use [GitHub Discussions](https://github.com/agents-oss/agentspec/discussions).
+
+---
+
 ## Development Setup
 
 ### Prerequisites
@@ -158,4 +174,6 @@ Commit the updated `schemas/v1/agent.schema.json`.
 
 ## Questions?
 
-Open a [GitHub Discussion](https://github.com/agents-oss/agentspec/discussions) or file an issue.
+- 💬 [Slack](https://join.slack.com/t/agent-spec/shared_invite/zt-3v1zn1fck-p_futvhg32iCTI5rwTD_MQ) — fastest, best for quick "how do I..." questions
+- 🧵 [GitHub Discussions](https://github.com/agents-oss/agentspec/discussions) — for longer-lived async threads
+- 🐞 [GitHub Issues](https://github.com/agents-oss/agentspec/issues) — for confirmed bugs and feature requests

README.md

@@ -5,6 +5,7 @@
 [![npm](https://img.shields.io/npm/v/@agentspec/sdk)](https://www.npmjs.com/package/@agentspec/sdk)
 [![CI](https://github.com/agents-oss/agentspec/actions/workflows/ci.yml/badge.svg)](https://github.com/agents-oss/agentspec/actions/workflows/ci.yml)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+[![Slack](https://img.shields.io/badge/Slack-Join%20community-4A154B?logo=slack&logoColor=white)](https://join.slack.com/t/agent-spec/shared_invite/zt-3v1zn1fck-p_futvhg32iCTI5rwTD_MQ)
 
 **One `agent.yaml`. Validate, health-check, audit, and generate any AI agent.**
 
@@ -203,3 +204,5 @@ Apache 2.0
 ## Contributing
 
 Issues and PRs welcome at [github.com/agents-oss/agentspec](https://github.com/agents-oss/agentspec).
+
+Join the conversation on **[Slack](https://join.slack.com/t/agent-spec/shared_invite/zt-3v1zn1fck-p_futvhg32iCTI5rwTD_MQ)** — ask questions in `#help`, share what you're building in `#show-and-tell`, or hack on the project in `#contributing`.

docs/index.md

@@ -13,7 +13,7 @@ agentspec audit    agent.yaml   # OWASP LLM Top 10 score
 agentspec generate agent.yaml   # agentic code generation (LLM-driven)
 ```
 
-[Quick Start](/quick-start) · [Manifest Schema](/reference/manifest-schema) · [GitHub](https://github.com/agentspec/agentspec)
+[Quick Start](/quick-start) · [Manifest Schema](/reference/manifest-schema) · [GitHub](https://github.com/agentspec/agentspec) · [Slack community](https://join.slack.com/t/agent-spec/shared_invite/zt-3v1zn1fck-p_futvhg32iCTI5rwTD_MQ)
 
 ---