pragmatic-service-modeling

pragmatic-service-modeling

AI-powered AWS architecture advisor — A collection of Claude skills that guide architects and developers through structured decision-making for AWS service selection.

Consultor de arquitetura AWS com IA — Uma coleção de skills para Claude que orientam arquitetos e desenvolvedores em decisões estruturadas de seleção de serviços AWS.

---

🇺🇸 English

Overview

pragmatic-service-modeling is a plugin for Claude (via Cowork or Claude Code) that provides three expert skills for AWS architecture decisions. Instead of returning a generic answer, each skill conducts a short conversational interview to understand your specific context, then delivers a direct, justified recommendation.

Skills

Skill	What it decides	Key services covered
pragmatic-compute-expert	Which compute model to use	Lambda, ECS, EKS, Fargate, EC2
pragmatic-db-expert	Which database to use	DynamoDB, DocumentDB, Aurora DSQL
pragmatic-messaging-expert	Which messaging service to use	SQS, SNS, EventBridge, Kinesis, MSK

How it works

Each skill follows the same pattern:

1. Interview — Claude asks 4–6 focused questions about your workload, team, and constraints
2. Analysis — Claude applies the decision framework from the references/ folder
3. Recommendation — A direct verdict with justification, tradeoffs, and next steps

Installation

Via Claude Code (recommended)

Run these two commands inside Claude Code:

/plugin marketplace add rvfvazquez/pragmatic-service-modeling
/plugin install pragmatic-service-modeling@pragmatic-service-modeling

That's it — all three experts are available immediately.

Via Cowork (desktop app)

1. Download pragmatic-service-modeling.skill from the releases page
2. Open the Cowork app and go to Plugins → Install from file
3. Select the .skill file — all three experts are installed at once

Manual (Claude Code)

# Clone the repository
git clone https://github.com/rvfvazquez/pragmatic-service-modeling.git

# Copy skills to your Claude skills directory
cp -r pragmatic-service-modeling/skills/* ~/.claude/skills/

Usage examples

Just talk to Claude naturally:

"Qual compute devo usar para o meu novo microserviço?"
"Should I use Lambda or ECS for this background job?"
"Which database makes sense for a high-throughput e-commerce catalog?"
"Precisamos de SQS ou EventBridge para desacoplar nossos serviços?"

See the examples/ folder for complete conversation walkthroughs.

Repository structure

pragmatic-service-modeling/
├── .claude-plugin/
│   ├── marketplace.json               ← Makes this repo a Claude Code marketplace
│   └── plugin.json                    ← Plugin manifest (name, version, author)
├── README.md
├── CONTRIBUTING.md
├── LICENSE
├── .github/
│   ├── ISSUE_TEMPLATE/
│   │   ├── bug_report.md
│   │   └── skill_proposal.md
│   └── PULL_REQUEST_TEMPLATE.md
├── skills/                            ← All sub-skills live here
│   ├── pragmatic-compute-expert/      ← Skill: compute model selection
│   │   ├── SKILL.md                   ← Skill prompt and decision logic
│   │   └── references/
│   │       └── aws-compute.md         ← Detailed reference for Lambda, ECS, EKS
│   ├── pragmatic-db-expert/           ← Skill: database selection
│   │   ├── SKILL.md
│   │   └── references/
│   │       └── aws-databases.md
│   └── pragmatic-messaging-expert/    ← Skill: messaging service selection
│       ├── SKILL.md
│       └── references/
│           └── aws-messaging.md
└── examples/
    ├── README.md
    ├── compute/
    │   └── startup-lambda-vs-ecs.md
    ├── database/
    │   └── ecommerce-dynamodb-vs-aurora.md
    └── messaging/
        └── microservices-sqs-vs-eventbridge.md

Contributing

We welcome new skills, improved decision logic, and updated references. See CONTRIBUTING.md for guidelines.

---

🇧🇷 Português

Visão Geral

pragmatic-service-modeling é um plugin para Claude (via Cowork ou Claude Code) que oferece três skills especializadas em decisões de arquitetura AWS. Em vez de retornar uma resposta genérica, cada skill conduz uma entrevista conversacional para entender seu contexto específico e entrega uma recomendação direta e justificada.

Skills disponíveis