Merge pull request #7 from microsoft/readme-fix

Revise index.md to enhance onboarding guidance for AI-Assisted Coding…

Author: gregschunemann

goals/index.md

@@ -1,3 +1,68 @@
-{%
-   include-markdown "../README.md"
-%}
+---
+title: AI-Assisted Coding Challenges
+description: Central index of language-specific onboarding challenges and guidance for the AI-Assisted Coding framework.
+---
+
+# 🧭 Challenge Index
+
+Welcome! This hub lists the starting points for each language track in the AI-Assisted Coding framework.  
+Pick the tech stack you care about and begin with its Setup challenge. Each track follows the same progression:
+
+1. Setup & Framework Integration (`1-setup.md`)
+2. Writing Effective Requirements (`2-requirements.md`)
+3. Project Brief Customization (`projectBrief.md`)
+
+Need general improvement tips? Jump to the Tips section below.
+
+---
+
+## 🚀 Quick Start by Language
+
+| Language / Stack | Start Here | Spec Challenge |
+| ---------------- | ---------- | -------------- |
+| .NET / C#        | [Setup](./dotnet/1-setup.md) | [Requirements](./dotnet/2-requirements.md) |
+| Java             | [Setup](./java/1-setup.md) | [Requirements](./java/2-requirements.md) |
+| Python           | [Setup](./python/1-setup.md) | [Requirements](./python/2-requirements.md) |
+| TypeScript / JS  | [Setup](./typescript/1-setup.md) | [Requirements](./typescript/2-requirements.md) |
+
+---
+
+## ✨ Recommended Flow
+
+1. Open a language track’s `1-setup.md` and follow the framework integration steps.
+2. Generate or refine an Architecture Review (see setup instructions for guidance).
+3. Proceed to the `2-requirements.md` file to practice writing concise, AI-friendly requirements.
+4. Tailor the `projectBrief.md` to your actual project—this greatly improves AI recall and guidance.
+
+---
+
+## 💡 Tips & Techniques
+
+Looking for productivity boosters, prompt strategies, or refinement tactics?
+
+➡️ Read: [Three Tips to Level Up](./3-tips.md)
+
+---
+
+## 🧪 What the AI Is Learning
+
+As you move through the challenges, the AI-assisted workflow builds:
+- Persistent memory of architectural decisions
+- Rich project brief context
+- A knowledge graph (via memory mcp) for cross-file reasoning
+- Faster retrieval of documentation (via Context7 and Microsoft.Learn MCP)
+
+Use this to:
+- Iterate faster on specs before coding
+- Have the AI draft tests aligned with your requirements
+- Maintain consistent architectural direction
+
+---
+
+## 📬 Feedback
+
+If something feels unclear or you have ideas for new challenge tracks, open an issue or submit a PR in the main repository.
+
+---
+
+Happy building! Pick a track above and dive in. 🚀