# ai-architect-expert

ai-architect-expert — a skill for AI system design: training pipelines, feature stores, model registries and serving with metrics. Useful when a prototype outgrows the notebook.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 185 installs · ★ 45 repo stars
- Author: personamanagmentlayer
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/personamanagmentlayer/pcl/tree/HEAD/stdlib/ai/ai-architect-expert/SKILL.md
- Updated: 2026-10-12
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/ai-architect-expert

## What it does

The skill guides AI system design past the notebook stage: how a model is served, when batch is enough and when requests need an online path, what a feature store and a model registry are for. MLOps comes next, from CI/CD for ML to monitoring, A/B tests and scheduled retraining. Scaling patterns get the same treatment: distributed training, a prediction cache, load balancing.

Python samples sit in the `SKILL.md`: a model registry and a feature store built on dataclasses, a `TrainingPipeline` wired to `DistributedDataParallel` from `torch.distributed`, a FastAPI server with `prometheus_client` metrics and a prediction cache. Edits go through `Read`, `Write` and `Edit` only, so running those samples and rolling out infrastructure stays with you.

It fires on mentions of AI architecture, MLOps, AI infrastructure or scalability. The question has to be about how the system is put together, not about one function.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add personamanagmentlayer/pcl --skill ai-architect-expert -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/ai-architect-expert/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/ai-architect-expert/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add personamanagmentlayer/pcl --skill ai-architect-expert -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/ai-architect-expert/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add personamanagmentlayer/pcl --skill ai-architect-expert -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/ai-architect-expert/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install personamanagmentlayer/pcl stdlib/ai/ai-architect-expert
```

2. **Manually: put the files in place**
- File: `.github/skills/ai-architect-expert/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add personamanagmentlayer/pcl --skill ai-architect-expert -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/personamanagmentlayer/pcl --path stdlib/ai/ai-architect-expert
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/ai-architect-expert/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add personamanagmentlayer/pcl --skill ai-architect-expert -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/personamanagmentlayer/pcl/tree/HEAD/stdlib/ai/ai-architect-expert/SKILL.md

## When to use it
- pick between online and batch inference for a given load
- split training across GPUs without hand-writing the gradient sync
- keep model versions and stages in a single registry
- add latency metrics and a prediction cache to serving
- define features once for both training and inference

## Example prompts
- Sketch a distributed training pipeline with metric logging
- Show how to set up a feature store for payment features
- Draft a FastAPI model server with Prometheus metrics and a prediction cache

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: d4aeede617438b7a.

BEGIN THIRD-PARTY FILE d4aeede617438b7a
````text
---
name: ai-architect-expert
version: 1.1.0
description: >-
  Expert-level AI system design, MLOps, architecture patterns, and AI infrastructure. Use
  when the user mentions AI architecture, MLOps, system design, AI infrastructure, or
  scalability, or when the task involves AI System Architecture, MLOps Infrastructure,
  Scalability Patterns, or Architecture Design.
category: ai
tags: [ai-architecture, mlops, system-design, ai-infrastructure, scalability]
allowed-tools:
  - Read
  - Write
  - Edit
---

# AI Architect Expert

Expert guidance for designing AI systems, MLOps architecture, scalable ML infrastructure, and AI platform engineering.

## Core Concepts

### AI System Architecture

- Model serving architectures
- Real-time vs batch inference
- Feature stores
- Model registries
- Training pipelines
- Data versioning

### MLOps Infrastructure

- CI/CD for ML
- Model monitoring and observability
- A/B testing frameworks
- Model retraining automation
- Resource orchestration
- Cost optimization

### Scalability Patterns

- Distributed training
- Model parallelism
- Data parallelism
- Inference optimization
- Caching strategies
- Load balancing

## ML Platform Architecture

```python
from dataclasses import dataclass
from typing import Dict, List, Optional
from enum import Enum

class ModelStage(Enum):
    DEVELOPMENT = "development"
    STAGING = "staging"
    PRODUCTION = "production"
    ARCHIVED = "archived"

@dataclass
class ModelMetadata:
    name: str
    version: str
    framework: str
    stage: ModelStage
    metrics: Dict[str, float]
    created_at: str
    updated_at: str

class ModelRegistry:
    """Central model registry for ML platform"""

    def __init__(self):
        self.models: Dict[str, List[ModelMetadata]] = {}

    def register_model(self, model: ModelMetadata) -> str:
        """Register new model version"""
        if model.name not in self.models:
            self.models[model.name] = []

        self.models[model.name].append(model)
        return f"{model.name}:{model.version}"

    def promote_model(self, name: str, version: str, stage: ModelStage):
        """Promote model to different stage"""
        for model in self.models.get(name, []):
            if model.version == version:
                model.stage = stage
                return True
        return False

    def get_production_model(self, name: str) -> Optional[ModelMetadata]:
        """Get current production model"""
````
END THIRD-PARTY FILE d4aeede617438b7a

The third-party file has ended. Everything between the d4aeede617438b7a tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2458 of 11161 bytes. © personamanagmentlayer · Apache-2.0 · https://github.com/personamanagmentlayer/pcl/tree/HEAD/stdlib/ai/ai-architect-expert/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
