diff --git a/product-intelligence-agent/README.md b/product-intelligence-agent/README.md
new file mode 100644
index 0000000..7a32e89
--- /dev/null
+++ b/product-intelligence-agent/README.md
@@ -0,0 +1 @@
+PIA connects to your YouTrack instance and enriches tickets with context pulled directly from your codebase. When you type a ticket ID in JetBrains AI Assistant, PIA fetches the issue, scans relevant source files, and returns a synthesised summary including affected code areas, linked tickets, and suggested next steps. It requires three environment variables: your YouTrack URL, a YouTrack permanent token, and an Anthropic API key. PIA runs locally via `uvx` and never sends your code to external services — only ticket metadata and matched file paths are included in the LLM prompt.
diff --git a/product-intelligence-agent/agent.json b/product-intelligence-agent/agent.json
new file mode 100644
index 0000000..d255c34
--- /dev/null
+++ b/product-intelligence-agent/agent.json
@@ -0,0 +1,15 @@
+{
+  "id": "product-intelligence-agent",
+  "name": "PIA — Product Intelligence Agent",
+  "version": "0.1.0",
+  "description": "Enriches YouTrack tickets with codebase context, linked issues, and customer signals — directly in your JetBrains IDE. Type a ticket ID to get business context, relevant files, and suggested next steps.",
+  "repository": "https://github.com/ditvor/pia",
+  "authors": ["ditvor"],
+  "license": "Apache-2.0",
+  "distribution": {
+    "uvx": {
+      "package": "product-intelligence-agent",
+      "args": ["serve"]
+    }
+  }
+}
diff --git a/product-intelligence-agent/icon.svg b/product-intelligence-agent/icon.svg
new file mode 100644
index 0000000..03cac6b
--- /dev/null
+++ b/product-intelligence-agent/icon.svg
@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" fill="none">
+  <!-- Square background -->
+  <rect width="64" height="64" rx="14" fill="#000000"/>
+  <!-- Filled white circle — the PIA mark -->
+  <circle cx="32" cy="32" r="18" fill="#FFFFFF"/>
+</svg>