diff --git a/README.md b/README.md
index 0a584da..a2805a1 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,19 @@
-# Introduction
+# Harness IDP Workshop
 
-Starter kit for a Harness IDP Workshop
+A starter repository for hands-on [Harness Internal Developer Portal](https://developer.harness.io/docs/internal-developer-portal) workshops. Participants use this repo to learn how to model software components, systems, and create self-service workflows in Harness IDP.
+
+## What You'll Learn
+
+- **Software Catalog** — Model services and systems using `catalog-info.yaml` descriptors and understand entity relationships (`dependsOn`, `system`).
+- **Self-Service Workflows** — Build IDP Workflow templates that trigger Harness pipelines to scaffold new repositories and onboard applications.
+- **Scorecards** — Define and track service maturity scorecards to measure production readiness, security posture, and documentation coverage across your catalog.
+
+## Getting Started
+
+1. **Fork or import** this repository into your Harness project.
+2. **Customize** the placeholder values (`yournamehere`, `change-value`) with your own identifiers.
+3. **Set up a Workflow** using `onboard-new-app.yaml` as an IDP Workflow template.
+
+## Resources
+
+- [Harness IDP Documentation](https://developer.harness.io/docs/internal-developer-portal)