🎨 AI Primitives Hub

A monorepo for the AI Primitives Hub: a VS Code marketplace and a shared set of ports-and-adapters packages for discovering, installing, and managing GitHub Copilot prompt libraries.

AI Primitives Hub lets users discover and manage GitHub Copilot prompts through a VS Code extension, while providing reusable domain libraries, adapters, and a CLI for building, installing, and transforming prompt collections across multiple targets.

ℹ️ Note: This project was formerly known as Prompt Registry. The VS Code extension ID (AmadeusITGroup.prompt-registry) and lockfile names remain unchanged for compatibility — seeing prompt-registry in paths is expected.

📑 Table of Contents

• Quick Start
• Repository Structure
• Architecture
• Documentation
• Contributing
• License

🚀 Quick Start

As a VS Code user: Search "AI Primitives Hub" in the Extensions panel, or build from source using apps/vscode-extension/README.md.

As a collection author: See the Author Guide.

As a contributor:

Requires Node.js 24 or newer and pnpm 11 or newer. See CONTRIBUTING.md for the complete development setup.

git clone https://github.com/AmadeusITGroup/ai-primitives-hub.git
cd ai-primitives-hub
pnpm install
pnpm build        # build all workspace packages
pnpm test         # run all workspace tests
pnpm lint

📁 Repository Structure

Path	Purpose
apps/vscode-extension/	VS Code extension: UI, commands, services, adapters
packages/core/	Domain types and port interfaces
packages/infra/	Adapter implementations: sources, stores, writers, scaffolding
packages/app/	Use-case orchestration: install, registry, discovery, transforms
packages/cli/	Terminal interface calling app
lib/	Legacy collection scripts (deprecated in place)
github-actions/validate-collections/	Reusable GitHub Action for validating collections in CI
docs/	User, author, and contributor documentation
website/	Docusaurus documentation site
packages/infra/src/hub/	Shared Hub resolution, validation, and default-Hub definitions

🏗️ Architecture

The monorepo is organized around a shared core domain, with infra adapters, an app orchestration layer, and thin delivery layers for the VS Code extension and the CLI.

flowchart TD
    subgraph "Delivery"
        VSC[VS Code extension<br/>apps/vscode-extension]
        CLI[CLI<br/>packages/cli]
    end
    VSC --> APP[packages/app]
    CLI --> APP
    APP --> CORE[packages/core]
    APP --> INF[packages/infra]
    INF --> CORE
    INF --> AD[Adapters<br/>GitHub / Local / APM / Skills / Awesome Copilot / Azure DevOps]

Loading

For extension details, see the Contributor Architecture Guide.

📚 Documentation

• User Guide
• Author Guide
• Contributor Guide
• Architecture
• Reference

See the full index: docs/README.md.

🤝 Contributing

See CONTRIBUTING.md and CODE_OF_CONDUCT.md. For security, see SECURITY.md.

📄 License

Apache 2.0