platform-design

Crafting Platforms — AI Artifacts

Build and train AI agents to architect internal developer platforms. This repository contains reusable skills, commands, agents, and configurations for major AI platforms (Claude Code, GitHub Copilot, Cursor). Closely related to the Crafting Platforms book — but open to any platform engineering or AI best practice.

What Is This?

Instead of manually architecting your platform, teach an AI agent to do it. This repository provides pre-built, production-ready artifacts that guide AI through platform engineering tasks: designing segmentation strategies, scaffolding infrastructure, auditing security, automating CI/CD, and more.

Many artifacts here relate to chapters in Crafting Platforms, bridging human guidance (the book) and machine execution (the code). Others are grounded in platform engineering or AI best practices — the repository grows with the community.

---

The Book: Crafting Platforms

By Ezequiel Foncubierta

A practical guide to building opinionated, made-to-measure internal developer platforms that fit your organization's unique DNA.

Platform craftsmanship, not platform manufacturing.

The book teaches humans the principles and patterns for building platforms. This repository teaches AI agents how to implement them. Together, they form a complete system: strategic guidance for people, executable instructions for machines.

Get the Book

• Website: craftingplatforms.com — project home, about the author, and links
• Early Access (digital): leanpub.com/crafting-platforms — get chapters as they're published
• Newsletter: newsletter.craftingplatforms.com — practical articles, platform engineering insights, and early announcements

Book Chapters

Chapter	Topic
0	Preface
1	Introduction
2	Internal Developer Platform
3	Platform Notation
4	Segmentation
5	Identity and Access Management
6	Infrastructure
7	CI/CD
8	Observability
9	Security and Compliance
10	Developer Experience

Artifacts tied to book chapters will be added as the book is completed. Community contributions grounded in platform engineering best practices are also welcome.

---

Artifact Inventory

Skills are distributed as Claude Code plugins, grouped by cloud provider and domain.

Plugin: platform-design

Platform strategy, segmentation, IAM design, and landing zone design.

Skill	Chapter	Status
define-platform-vision	Chapter 2	Published
design-segmentation	Chapter 4	Published
define-core-iam	Chapter 5	Published
define-tenant-iam	Chapter 5	Published
design-landing-zone	Chapter 6	Published
define-naming-convention	Chapter 6	Published
design-networking	Chapter 6	Published
design-compute	Chapter 6	Published

Plugin: aws

AWS platform engineering — IAM, landing zones, and networking management.

Skill	Chapter	Status
manage-aws-iam	Chapter 5	Published
manage-aws-landing-zone	Chapter 6	Published
manage-aws-networking	Chapter 6	Published

Plugin: azure

Azure platform engineering — IAM, landing zones, and networking management.

Skill	Chapter	Status
manage-azure-iam	Chapter 5	Published
manage-azure-landing-zone	Chapter 6	Published
manage-azure-networking	Chapter 6	Published

Plugin: gcp

GCP platform engineering — IAM, landing zones, and networking management.

Skill	Chapter	Status
manage-gcp-iam	Chapter 5	Published
manage-gcp-landing-zone	Chapter 6	Published
manage-gcp-networking	Chapter 6	Published

Plugin: kubernetes

Kubernetes platform engineering — IAM and namespace management.