Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions .mcp.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
{
"servers": {
"workiq": {
"command": "npx",
"args": ["-y", "@microsoft/workiq", "mcp"],
"tools": ["*"]
},
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
}
}
}
}
264 changes: 264 additions & 0 deletions docs/prototype-marketplace-plan.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,264 @@
# Prototype Marketplace — Inner Loop / Outer Loop System Plan

> **Issue:** [#1 — Shyam's Crazy Idea](https://github.com/All-The-Vibes/atv-platform/issues/1)
> **Vision:** Idea-to-Prototype generator — curate ideas from ATV channels and build a catalog of prototypes (Prototype Marketplace)
> **Insight from @sachaa:** Focus on identifying **problems** that need solving, not just ideas. Inspired by [ideabrowser.com/database](https://www.ideabrowser.com/database).

---

## 1. Overview

This document describes a comprehensive plan for the **Prototype Marketplace** — a system that discovers problems and ideas across All-The-Vibes (ATV) channels, curates them into a structured catalog, and enables rapid prototyping through an **inner loop / outer loop** workflow powered by [WorkIQ](https://learn.microsoft.com/en-us/azure/devops/mcp-server/mcp-server-overview).

### Core Concept

```
ATV Channels ──► Problem/Idea Curation ──► Prototype Catalog ──► Marketplace
│ │
(Outer Loop) (Inner Loop)
Discovery & Rapid Build &
Prioritization Iteration
```

---

## 2. Inner Loop / Outer Loop Model

### 2.1 Inner Loop — Rapid Prototyping

The **inner loop** is where individual developers or small teams take a curated problem/idea and rapidly build a working prototype. This loop is optimized for speed, creativity, and immediate feedback.

| Stage | Activity | Tools |
|-------|----------|-------|
| **Pick** | Select a problem/idea from the catalog | Prototype Catalog, GitHub Issues |
| **Scaffold** | Generate project structure from templates | Copilot, VS Code, project templates |
| **Build** | Write code with AI assistance | GitHub Copilot, VS Code, MCP servers |
| **Test** | Validate locally with fast feedback | Local dev environment, hot reload |
| **Demo** | Show working prototype | Local preview, screenshots, recordings |

**Key characteristics:**
- Individual or pair development
- Minutes-to-hours cycle time
- Local environment with AI assistance
- Immediate feedback through hot reload and local testing
- Low friction — pick a problem, start building

### 2.2 Outer Loop — Discovery, Curation & Delivery

The **outer loop** manages the broader lifecycle: discovering problems, curating the catalog, reviewing prototypes, and publishing to the marketplace.

| Stage | Activity | Tools |
|-------|----------|-------|
| **Discover** | Monitor ATV channels for problems/ideas | WorkIQ MCP, channel integrations |
| **Curate** | Structure, deduplicate, and categorize | WorkIQ MCP, AI-assisted triage |
| **Prioritize** | Community voting, problem scoring | GitHub Reactions, discussions |
| **Review** | Code review, prototype evaluation | GitHub PRs, peer review |
| **Publish** | Add to marketplace catalog | GitHub Actions, catalog automation |
| **Promote** | Share with community, gather feedback | ATV channels, discussions |

**Key characteristics:**
- Community-driven and collaborative
- Hours-to-days cycle time
- Automated pipelines for consistency
- Quality gates and peer review
- Continuous feedback from the community

### 2.3 How the Loops Connect

```
┌─────────────────────────────────────────────────────────────────┐
│ OUTER LOOP │
│ │
│ ┌──────────┐ ┌──────────┐ ┌─────────────┐ ┌──────────┐ │
│ │ Discover │──►│ Curate │──►│ Prioritize │──►│ Review │ │
│ │ Problems │ │ Catalog │ │ & Vote │ │ & Merge │ │
│ └──────────┘ └────┬─────┘ └─────────────┘ └─────┬────┘ │
│ │ │ │
│ ▼ │ │
│ ┌───────────────┐ │ │
│ │ PROTOTYPE │ │ │
│ │ CATALOG │◄─────────────────────────┘ │
│ └───────┬───────┘ │
│ │ │
│ ┌───────────────────┼───────────────────────────────────────┐ │
│ │ ▼ INNER LOOP │ │
│ │ ┌──────┐ ┌──────────┐ ┌───────┐ ┌──────┐ ┌──────┐ │ │
│ │ │ Pick │─►│ Scaffold │─►│ Build │─►│ Test │─►│ Demo │ │ │
│ │ └──────┘ └──────────┘ └───────┘ └──────┘ └──┬───┘ │ │
│ │ │ │ │
│ └───────────────────────────────────────────────────┼──────┘ │
│ │ │
│ ┌──────────┐ │ │
│ │ Publish │◄───────────────────┘ │
│ │ to Mktpl │ │
│ └──────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
```

---

## 3. WorkIQ Integration

[WorkIQ](https://learn.microsoft.com/en-us/azure/devops/mcp-server/mcp-server-overview) is Microsoft's MCP server for workplace intelligence. It gives AI agents secure access to M365 and Azure DevOps data.

### 3.1 Role in the Outer Loop

WorkIQ powers the **discovery** and **curation** stages of the outer loop:

- **Channel Monitoring:** WorkIQ connects to Teams channels, emails, and documents where ATV community members discuss problems and ideas. It surfaces relevant conversations for curation.
- **Content Extraction:** Using WorkIQ's document intelligence, raw discussions are parsed into structured problem/idea entries with title, description, source, and context.
- **Deduplication:** WorkIQ helps identify when a newly surfaced problem overlaps with an existing catalog entry, preventing duplicates.
- **Backlog Sync:** Through integration with Azure DevOps (see [Issue #4 — ADO Flow](https://github.com/All-The-Vibes/atv-platform/issues/4)), curated problems can be synchronized to ADO work items for tracking.

### 3.2 Role in the Inner Loop

WorkIQ enhances the **build** stage of the inner loop:

- **Context Retrieval:** When a developer picks a problem from the catalog, WorkIQ can pull related documents, past discussions, and prior art from M365 to provide rich context.
- **Collaboration Discovery:** WorkIQ can identify who in the ATV community has relevant expertise or has discussed the problem before.
- **Progress Tracking:** As prototypes are built, WorkIQ helps track progress against the original problem statement.

### 3.3 MCP Configuration

```json
{
"servers": {
"workiq": {
"command": "npx",
"args": ["-y", "@microsoft/workiq", "mcp"],
"tools": ["*"]
},
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
}
}
}
}
```

---

## 4. Prototype Catalog — Data Model

Each entry in the catalog represents a **problem** (per @sachaa's suggestion) that can be prototyped.

### 4.1 Catalog Entry Schema

```yaml
id: "unique-identifier"
title: "Short descriptive title"
type: "problem" # problem | idea | enhancement
status: "open" # open | in-progress | prototyped | archived
description: "Detailed description of the problem"
source:
channel: "ATV channel name"
author: "GitHub username or display name"
url: "Link to original discussion"
date: "ISO 8601 date"
tags: ["category", "technology", "domain"]
votes: 0
prototypes: [] # List of prototype references
related_issues: [] # Links to GitHub issues
created_at: "ISO 8601"
updated_at: "ISO 8601"
```

### 4.2 Prototype Reference Schema

```yaml
id: "prototype-identifier"
catalog_entry_id: "parent-catalog-entry-id"
title: "Prototype name"
description: "What this prototype demonstrates"
author: "GitHub username"
repo_url: "Link to prototype repository"
demo_url: "Link to live demo (if available)"
tech_stack: ["python", "react", "azure"]
status: "draft" # draft | demo-ready | published
created_at: "ISO 8601"
updated_at: "ISO 8601"
```

---

## 5. Implementation Phases

### Phase 1: Foundation (Current)
- [x] Define inner loop / outer loop model
- [x] Design catalog data model (YAML-based for simplicity)
- [x] Create initial directory structure
- [ ] Create sample catalog entries from existing ATV issues
- [ ] Set up MCP configuration for WorkIQ and GitHub

### Phase 2: Catalog & Discovery
- [ ] Build script to extract problems/ideas from GitHub issues
- [ ] Implement catalog validation (schema enforcement)
- [ ] Create catalog index/summary generator
- [ ] Integrate WorkIQ for M365 channel monitoring
- [ ] Set up automated PR creation for new catalog entries

### Phase 3: Inner Loop Tooling
- [ ] Create project scaffolding templates for common prototype types
- [ ] Build VS Code extension or MCP tool for browsing the catalog
- [ ] Integrate Copilot for AI-assisted prototyping from catalog entries
- [ ] Add prototype submission workflow (PR-based)

### Phase 4: Marketplace & Outer Loop
- [ ] Build web-based prototype marketplace UI
- [ ] Implement community voting and feedback
- [ ] Add automated prototype evaluation (tests, demos)
- [ ] Connect to ADO Flow for enterprise backlog integration
- [ ] Set up continuous discovery pipeline from ATV channels

---

## 6. Integration with Other ATV Projects

| Project | Integration Point |
|---------|------------------|
| [ADO Flow (#4)](https://github.com/All-The-Vibes/atv-platform/issues/4) | Sync catalog entries to ADO work items; use WorkIQ MCP for backlog management |
| [Natural Language Compiler (#2)](https://github.com/All-The-Vibes/atv-platform/issues/2) | Use requirement-to-code generation for rapid prototyping in the inner loop |
| [Consumer MCP App Harness (#3)](https://github.com/All-The-Vibes/atv-platform/issues/3) | Marketplace as a consumer MCP app; prototype catalog as an extension point |
| [shai-hulud](https://github.com/All-The-Vibes/shai-hulud) | Vibe-coding starter kit as default scaffold for prototypes |
| [skills-catalog](https://github.com/All-The-Vibes/skills-catalog) | Reusable agent skills for catalog automation and discovery |
| [Agent-Harness](https://github.com/All-The-Vibes/Agent-Harness) | Orchestrate multi-agent workflows for outer loop automation |

---

## 7. Success Metrics

| Metric | Target | Loop |
|--------|--------|------|
| Time from problem discovery to catalog entry | < 1 day | Outer |
| Time from catalog entry to first prototype | < 1 week | Inner |
| Catalog entries per month | 10+ | Outer |
| Prototypes published per month | 5+ | Inner |
| Community votes per catalog entry | 3+ average | Outer |
| Duplicate detection accuracy | > 80% | Outer |

---

## 8. Getting Started

### Prerequisites
- Node.js 18+
- VS Code with GitHub Copilot
- GitHub account with access to All-The-Vibes org
- (Optional) M365 account for WorkIQ integration

### Quick Start
1. Clone the repository
2. Browse the catalog: `prototype-catalog/catalog/`
3. Pick a problem to prototype
4. Create a new branch: `git checkout -b prototype/<problem-id>`
5. Build your prototype
6. Submit a PR linking to the catalog entry

### Adding a New Problem/Idea
1. Create a YAML file in `prototype-catalog/catalog/`
2. Follow the schema in `prototype-catalog/schemas/catalog-entry.schema.json`
3. Submit a PR for community review
62 changes: 62 additions & 0 deletions prototype-catalog/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
# Prototype Catalog

The **Prototype Catalog** is the structured registry of problems and ideas curated from ATV community channels. Each entry represents a real problem that can be prototyped.

## Directory Structure

```
prototype-catalog/
├── catalog/ # YAML files — one per problem/idea
├── schemas/ # JSON Schema for validation
└── scripts/ # Automation scripts
```

## How It Works

### Browse Problems
Look through the `catalog/` directory. Each `.yaml` file describes a problem with its context, source, and current status.

### Pick a Problem to Prototype
1. Find an entry with `status: open`
2. Create a branch: `git checkout -b prototype/<entry-id>`
3. Build your prototype with AI assistance
4. Submit a PR linking to the catalog entry

### Add a New Problem/Idea
1. Create a new `.yaml` file in `catalog/` following the schema
2. Use the entry ID as the filename (e.g., `my-problem.yaml`)
3. Validate: `python prototype-catalog/scripts/validate_catalog.py`
4. Submit a PR for community review

### Validate Entries
```bash
pip install pyyaml jsonschema
python prototype-catalog/scripts/validate_catalog.py
```

## Schema

See [`schemas/catalog-entry.schema.json`](schemas/catalog-entry.schema.json) for the full schema definition.

### Required Fields
- `id` — Unique identifier (lowercase, hyphens)
- `title` — Short descriptive title
- `type` — `problem`, `idea`, or `enhancement`
- `status` — `open`, `in-progress`, `prototyped`, or `archived`
- `description` — Detailed description
- `source` — Where this was discovered (channel, author, date)
- `tags` — Categories and technology tags
- `created_at` / `updated_at` — Timestamps

## Current Catalog

| Entry | Type | Status | Source |
|-------|------|--------|--------|
| [Idea to Prototype Generator](catalog/idea-to-prototype-generator.yaml) | problem | open | Issue #1 |
| [Natural Language Compiler](catalog/natural-language-compiler.yaml) | problem | open | Issue #2 |
| [Consumer MCP App Harness](catalog/consumer-mcp-app-harness.yaml) | idea | open | Issue #3 |
| [ADO Flow](catalog/ado-flow.yaml) | problem | open | Issue #4 |

## Related Documentation

- [Prototype Marketplace Plan](../docs/prototype-marketplace-plan.md) — Full inner loop / outer loop system design
29 changes: 29 additions & 0 deletions prototype-catalog/catalog/ado-flow.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
id: ado-flow
title: "ADO Flow — AI-Powered Azure DevOps Backlog Generator"
type: problem
status: open
description: >
Converting documentation, transcripts, SoWs, and other sources into a
structured Azure DevOps backlog (epics, features, user stories, tasks) is
a manual, time-consuming process. There is no MCP app that orchestrates
this digestion, supports custom ADO template fields, and maintains
synchronization between ADO and local markdown files. We need an MCP app
for VS Code that automates backlog creation from unstructured sources and
keeps ADO and local project files in sync.
source:
channel: "GitHub Issues"
author: "softwaresalt"
url: "https://github.com/All-The-Vibes/atv-platform/issues/4"
date: "2026-03-02"
tags:
- mcp
- azure-devops
- backlog
- workiq
- automation
votes: 0
prototypes: []
related_issues:
- "https://github.com/All-The-Vibes/atv-platform/issues/4"
created_at: "2026-03-02T05:13:09Z"
updated_at: "2026-03-09T20:00:00Z"
Loading