🎨 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.

🚀 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]

For extension details, see the Contributor Architecture Guide.

📚 Documentation

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

ai-primitives-hub

Links

README