Skip to content
View subhamviky's full-sized avatar

Block or report subhamviky

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
subhamviky/README.md

Hi, I'm Subham Gupta πŸ‘‹

Staff Architect Β· I make AI agents safe to write to financial systems of record.
13+ years building ledger-grade distributed systems at SAP scale.
Now applying the same core invariants β€” idempotency, sagas, transactional outbox, scoped credentials, and evaluation gates β€” to agentic AI.

Start here

Thesis. An LLM cannot safely navigate tightly coupled legacy state machines. It requires clean, deterministic boundaries β€” so agentic AI makes application-level modernization structurally mandatory. E2A, A2C, P0, and G2C enforce those boundaries in code, not in prompts.


The Tripartite Architecture

Rather than replacing cloud-native platforms, this architecture acts as an Enterprise Bridge connecting frontier intelligence to mission-critical ledgers:

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ 1. PLUGGABLE COGNITIVE LAYER (Claude, GPT-4o, Gemini, Open-Weights)     β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                                    β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ 2. ENTERPRISE CONTROL PLANE & GOVERNANCE BRIDGE (E2A / A2C / P0 / G2C) β”‚
β”‚    β€’ AST Workspace Scaffolding (P0)    β€’ Typed Contract Synthesis (G2C)β”‚
β”‚    β€’ Pre-Commit Eval Gates (A2C)       β€’ Transactional Outbox & Saga   β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                                    β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ 3. HYPERSCALER RUNTIMES & SYSTEMS OF RECORD (AWS, GCP, Azure, SAP Core)β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Multi-Stakeholder Value Realization

Stakeholder Lens Enterprise Operational Risk Architecture Solution
Chief Architect & VP Eng Proprietary AI vendor lock-in Hexagonal Architecture: Cognitive models sit behind standardized, pluggable interfaces.
CISO & Chief Risk Officer Non-deterministic write drift Deterministic Gates: Programmatic AST validation and RAGAS faithfulness ($\ge 0.85$) before commit.
FinOps & Cloud Economics Runaway agentic token burn AST Context Pruning (P0): Strips syntactic noise to optimize context window utilization.
SRE & Operations Partial writes & state corruption Saga Orchestration: $\text{HMAC-SHA256}$ deduplication with automated compensating rollback actions.

The Mental Model

Same pattern set, different runtime. OData β†’ FastAPI Β· BDEF β†’ BaseAgent Β· CDS entity β†’ AgentState.

SAP RAP to Python agentic stack

Correct by Design

Financial integrity at enterprise scale stems from making invalid states architecturally impossible, not from defensive prompt engineering. Idempotency, lineage, and reconciliation are business features.

Enterprise Mechanism What It Enforces Cloud-Native / Agentic Equivalent
Deterministic charge-to-settlement key Revisions are updates, never duplicates Redis SETNX fast path + DB unique constraint Β· DynamoDB conditional write
"Completely invoiced" business gate No ledger posting before status confirmed SettlementState.COMPLETED as the only pre-condition for a ledger write
Dispute workflow Charge-delta mediation as a business process Policy-grounded reasoning agent + critic groundedness gate
Write-once finance ledger Immutable source of truth Double-entry unique index; reversal-only corrections

The Framework Family

A cohesive architectural methodology designed to translate high-level enterprise governance, security, and NFRs into deterministic code boundaries:

Framework Architecture Scope Core Invariant Enforced Repository
E2A (Enterprise-to-Agentic) Runtime Governance Invariant lifecycle execution via single entry point; pre-compute validation gates e2a-framework
A2C (Architecture-to-Code) Modernization Engine Injects operational NFRs, schemas, and CI/CD policies directly at code generation a2c-framework
P0 (Phase Zero) Ingress & Scaffolding Zero-drift workspace bootstrap with pre-wired telemetry, auth, and contract harnesses in a2c-framework
G2C (Generate-to-Class) Model Compiler Compiles declarative architecture specifications into typed, contract-bound classes in a2c-framework

Reference Implementations

Concrete runtimes proving the framework's deterministic boundaries and enterprise invariants across heterogeneous stacks:

  • order-to-cash-agentic-ai: Multi-agent coordination (Python, LangGraph, Bedrock, OpenSearch) featuring 5-agent bounded context isolation, hybrid RAG retrieval, and critic faithfulness verification.
  • aws-reconciliation-engine: Serverless reconciliation system (Python, Lambda, DynamoDB, SQS) enforcing two-layer idempotency gates, atomic state updates, and dead-letter queue escalation.
  • financial-settlement-platform: Distributed settlement engine (Java 21, Spring Boot 3, Kafka, PostgreSQL) validating Saga orchestration with reverse compensation, transactional outbox CDC, and double-entry immutable ledgers.

Framework abstractions are cloud-agnostic by design. Reference implementations demonstrate distributed patterns across serverless and open-source stacks, with Azure and GCP landing-zone equivalents documented in the pattern map.

Landing-Zone Isomorphism

Framework Concept Cloud Equivalent Enforced By
Abstract class Landing-zone account / VPC Control Tower account factory / Azure Landing Zone
_apply_policy() SCP + policy gate Runs before business logic execution
@abstractmethod NFR Required NFR contract Container task definition fails without /health
CriticAgent Evaluation gate in CI/CD + SLO alarm Deployment or completion blocked below threshold
Public entry point API Gateway + ALB Single ingress boundary
β†’ Full reference

What I've Delivered at Enterprise Scale

  • 35 β†’ 7 min month-end batch runtime (β‰ˆ80% reduction) across 10,000+ daily freight documents with zero business disruption.
  • Ledger-Grade Integrity: Designed exactly-once posting invariants and automated reconciliation engines across high-volume financial settlement batches.
  • Mission-Critical Production Ownership: Lead escalation architect for complex enterprise incidents, resolving tier-1 production blockers across global deployments.

Open To

Principal / Staff platform-architecture roles in agentic AI infrastructure, enterprise solutions architecture & strategic customer workloads β€” Anthropic, AWS, Microsoft Azure, Google Cloud.

LinkedIn Β· Email


Trademarks: AWS, GCP, Azure, Meta Llama, SAP belong to their owners; used for architectural reference only. Third-party technologies named here (LangGraph, Pinecone, Lakera) are non-affiliated open-source or commercial products.

Pinned Loading

  1. a2c-framework a2c-framework Public

    AI-governed developer platform extending E2A. Generates enterprise-grade code (A2C), project scaffolding (P0), and E2A/A2C framework classes (G2C) -- all via E2A-governed agents with NFRs enforced …

    Python

  2. e2a-framework e2a-framework Public

    Enterprise-to-Agentic (E2A) Architecture Framework β€” a vendor-neutral governance layer mapping enterprise architecture discipline (SAP RAP, Java EE) to agentic AI systems. Designed to be multi-clou…

    Python

  3. financial-settlement-platform financial-settlement-platform Public

    E2A Java reference spike β€” Spring Boot 3.x microservices validating SAP BOPF/RAP patterns (Saga, @Idempotent AOP, double-entry ledger, Spring AI RAG) are directly portable to cloud-native Java on A…

  4. order-to-cash-agentic-ai order-to-cash-agentic-ai Public

    E2A Python reference spike β€” 5-agent LangGraph system on AWS. Validates the E2A multi-agent pattern, hybrid RAG (OpenSearch BM25+KNN), RAGAS CI/CD gate, and NFR-First delivery sequence.

    Python

  5. aws-reconciliation-engine aws-reconciliation-engine Public

    E2A serverless reference spike. Two-layer DynamoDB idempotency, LangGraph multi-agent RAG over financial audit logs, SQS/DLQ event hardening at Lambda scale.

    Python