Skip to main content

Blog

Practical thinking on architecture, AI, and building software that lasts.

·8 min read·By Emanuele Pugliese

Traditional SDLC vs the AI-Native Development Lifecycle — and Where SystemDox Fits

The software development lifecycle is being rewritten. Requirements, design, and build no longer happen in sequence — they evolve together, driven by AI agents. Here is how the AI-DLC differs from traditional SDLC, and how SystemDox fills the gap.

aiarchitecturedevops
Read article
·12 min read·By Emanuele Pugliese

State-of-the-Art Multi-Tenant API Authorization with AWS Cognito

How to build a stateless, cache-safe multi-tenant API authorizer using Cognito Pre Token Generation v2 — eliminating per-request database lookups and fixing tenant-scoped caching.

architectureaws
Read article
·6 min read·By Emanuele Pugliese

RFC 7807: Why Your API Should Return Structured Error Details

How application/problem+json gives API clients predictable, machine-readable error responses — and why it belongs in your Lambda handlers, not API Gateway.

architectureaws
Read article
·10 min read·By Emanuele Pugliese

GitHub-Hosted Websites: How It Works — Own Your Content Forever

A complete guide to how PuglieseWeb builds websites that live in your GitHub repository. Edit with SystemDox, auto-publish via GitHub Pages — zero hosting costs, full revision history, no vendor lock-in.

architectureai
Read article
·11 min read·By Emanuele Pugliese

Ad-Hoc SQL and Client Debugging with Athena: The Queries You Didn't Plan For

Predefined dashboards answer yesterday's questions. Ad-hoc SQL on your event lake answers tomorrow's. Here's how to use Athena for exploratory analysis, user timeline reconstruction, and deep client debugging — without blowing your AWS bill.

architectureawsdata
Read article
·12 min read·By Emanuele Pugliese

Data Lineage vs Business Flow Analytics: What Small Teams Actually Need

Enterprise data governance tools promise visibility into your data. But most small teams need to understand user behaviour, not Parquet file provenance. Here's how to tell the difference — and build what matters first.

architectureawsdata
Read article
·8 min read·By Emanuele Pugliese

From Exodus to Opportunity: Careers and Investments in European Digital Sovereignty

How Europeans can build careers and investment portfolios around the continent's accelerating shift away from US Big Tech toward open-source and European-controlled alternatives.

modernisationcompliance
Read article
·21 min read·By Emanuele Pugliese

Building Data Products from Well-Defined Event Schemas on AWS

Build governed, discoverable data products by publishing CloudEvents-compliant business events through EventBridge to an S3 data lake — without coupling analytics to your operational database.

architectureaws
Read article
·6 min read·By Emanuele Pugliese

Ema Admin Assistant: Manage Your Website by Talking to It

How we built Ema Admin Assistant — an AI chatbot that lets business owners update their website content through conversation. No CMS forms, no waiting for developers.

aiproduct
Read article
·6 min read·By Emanuele Pugliese

Understanding the Three Layers of Modern AI Systems

A clear breakdown of how foundation models, skills, and retrieval-augmented generation work together to power modern AI applications.

aiarchitecture
Read article
·14 min read·By Emanuele Pugliese

Embedding Models: The Translation Layer Between Human Language and Machine Search

How embedding models turn words into numbers that machines can compare, why that matters for search and AI, and what to consider when choosing one.

aiarchitecture
Read article
·10 min read·By Emanuele Pugliese

RAG and Vector Databases: What Actually Happens When AI Answers Your Question

A practical explanation of how retrieval-augmented generation works, why vector databases matter, and when you should (and shouldn't) reach for them.

aiarchitecture
Read article
·9 min read·By Emanuele Pugliese

AI Agents: Orchestrator-Specialist Architecture

A practical guide to designing scalable, accurate, and maintainable AI agent systems using the Orchestrator-Specialist pattern for complex, multi-step task automation.

aiarchitecture
Read article
·10 min read·By Emanuele Pugliese

Lambda Lessons from Production: The Bugs Nobody Warns You About

Hard-won lessons from deploying AWS Lambda in production — layer path mistakes, silent auth failures, cold start surprises, and the IAM traps that cost hours to debug.

architectureaws
Read article
·6 min read·By Emanuele Pugliese

European Alternatives for Building AI-Powered Apps and Websites in 2026

A practical guide to the European software stack for building modern AI-powered applications — covering LLM inference, vector search, serverless compute, and storage alternatives that offer better data sovereignty, lower costs, and easier EU compliance.

aiarchitecture
Read article
·7 min read·By Emanuele Pugliese

The Multi-Tenancy Decision You Can't Take Back

Why tenancy is the one architectural choice that's genuinely painful to reverse — and the practical path from agency project to multi-tenant product.

architecture
Read article
·11 min read·By Emanuele Pugliese

My AI-Assisted Development Workflow with Claude Code in 2026

A practical, step-by-step walkthrough of how I use Claude Code to ship features faster — from identifying problems to planning epics, implementing, and testing. Includes 2026 best practices for AI-assisted development.

aidevops
Read article
·7 min read·By Emanuele Pugliese

The Recommended Tech Stack for an AI-Powered Service Website in 2026 (Reality Check)

A practical, battle-tested tech stack for building a modern website with AI chatbot, RAG, booking system, feedback, and admin dashboard. Built for speed, maintainability, and real-world costs in 2026.

aiarchitecture
Read article
·4 min read·By Emanuele Pugliese

Living ADRs: How to Keep Architecture Decisions Up to Date

Architecture Decision Records only work if they stay current. Learn how to make ADRs a living part of your development workflow — not another stale wiki page.

architecturedevops
Read article
·5 min read·By Emanuele Pugliese

Architecture Guardrails: Automating Compliance in Your CI/CD Pipeline

Stop relying on manual code reviews to catch architecture violations. Learn how to automate guardrails with fitness tests that run on every pull request.

architecturedevopscompliance
Read article
·5 min read·By Emanuele Pugliese

Event-Driven Architecture on AWS: 5 Patterns That Actually Work

Practical event-driven architecture patterns using SQS, SNS, EventBridge, and DynamoDB Streams — with real-world trade-offs and when to use each.

architectureaws
Read article
·5 min read·By Emanuele Pugliese

The State of Documentation in 2025

Key insights from 444 documentation experts — technical writers, product managers, engineers, and leaders — on how teams build, measure, and evolve their documentation. Industry report sourced from GitBook.

architectureai
Read article

RSS feed

Stay in the loop

Get architecture insights, product updates, and practical engineering tips.

Basket is empty

Stay in the loop

Get architecture insights, product updates, and practical engineering tips.

PuglieseWeb LTD is registered in England and Wales. Company No. 17078772.