The AI Native Architecture Advisor

The creative process of reimagining an SAP use case for the AI-native era
Install
PROJECT BYSAP · OPEN SOURCE
Active ingredients
Claude CodeHost
CodexHost
Chapters
01 About↓
02 Design + Dev↓

Describe the problem, explore the options, build a visual solution brief.

Chapter 01:About

Initial high-level solution design, grounded in SAP's AI-native North Star

Chapter:01
Why an architecture advisor?↓

This project is dedicated to initial high-level solution design for architects and business teams. The Advisor asks only the questions that materially affect the architecture, separates confirmed facts from assumptions, and explains the value and trade-offs of each change. Keeping a suitable existing design is a valid recommendation.

Chapter 02:Design + Development

From a described problem
to a reviewed proposal

Chapter:02
2.1 — The workflow↓
2.1: The workflowDescribe → Review
01
Describe

Start with the business problem

Bring the actors, the desired outcome and any constraints you already know. You do not need a complete technical design.

02
Explore

Explore the options together

The Advisor maps the scenario to SAP reference architectures and explains each option, strongest fit first.

03
Decide

Weigh the trade-offs

Confirmed facts stay separate from assumptions. Keeping a suitable existing design is a valid call.

04
Build

Build the solution brief

Generate a visual HTML report, the brief, and a reasoning log. Continue the conversation to revise.

05
Review

Human architect validation

Validate the draft against current SAP documentation, your landscape, entitlements and security requirements before you use it.

2.2: In actionSupplier confirmation
Describe → Explore → Decide → Build → ReviewWalkthrough · ~full workflow
Chapter 03:Output

Each scenario gets its own
folder with three files

Chapter:03
3.1 — The deliverables↓

<slug>-solution-brief.html

Visual report

Opens directly in a browser. No web server; loads no remote fonts, scripts or images. The artifact you share.

<slug>-solution-brief.md

Solution brief

Use case, AI-native direction, proposed architecture, capability progression, solution stack and reference architectures.

<slug>-reasoning-log.md

Reasoning log

Facts, assumptions, decisions, source checks and open questions, kept separate from the proposal.

3.2: Proposed architectureDraft
Layers4 · North Star
StatusDraft · for review
ProgressionStep 1 → Step 4
User Experience
Engagement & experiences
JouleFiori apps
Process
Applications, workflows & agents
AgentMCPS/4HANA APIs
Foundation
AI, data & business context
SAP AI CoreGen AI Hub
Platform
Runtime, identity & operations
SAP BTPKymaLogging
Chapter 04:Grounded in SAP

Built on SAP's own
architectural guidance

Chapter:04
4.1 — The sources↓
01

AI-native North Star architecture

The architectural vision and the User Experience, Process, Foundation and Platform layers.

02

AI Golden Path

AI and development approaches for the scenario, as a commit-pinned text snapshot.

03

Architecture Center reference architectures

Implementation patterns, selected and explained by the agent according to their fit.

4.2: Honest by designAssist, not replace

A draft for human review, not an approved design.

This is initial high-level solution design for solution and enterprise architects and business teams. It is not a PRD, a functional specification or a detailed technical design. Field-level requirements and configuration are left for later design.

AI can hallucinate services, capabilities, integrations and references. Check recommendations against current SAP documentation and your actual landscape, availability, entitlements and security requirements before you use the proposal.

Chapter 05:Install

Install and use

Chapter:05
One skill, two hosts↓

Claude Code

/plugin marketplace add https://github.com/SAP/ai-native-architecture-advisor.git /plugin install ai-native-architecture-advisor@sap-ai-native-architecture-advisor

Run these inside Claude Code, then reload plugins or start a new session.

Codex

codex plugin marketplace add https://github.com/SAP/ai-native-architecture-advisor.git codex plugin add ai-native-architecture-advisor@sap-ai-native-architecture-advisor

Run these in your terminal, then start a new Codex thread.