Neural Core - Architecture

Claude Skills

60+

Lambda Functions

Step Functions

DynamoDB Tables

UI Pages

The Dual Failure Thesis

Legacy platforms provide tools without strategic guidance. Traditional agencies provide strategy without proprietary technology. Neural Partners breaks both ceilings. Neural Core automates low-value tasks (data, catalog, execution) while Neural Labs focuses on high-value strategy. The result: SaaS margins with agency relationships. Not a platform. Not an agency. The infrastructure for the Agentic Economy.

Bimodal Intelligence Architecture

Neural Core

→

A2H Automation

→

High-Volume Execution

Neural Labs

→

H2H Strategy

→

High-Value Guidance

Core automates low-value tasks → Labs focuses on high-value strategy → Self-reinforcing loop

Core Capabilities

PDF Processing Pipeline

Step Functions

Large PDF catalogs (up to 500MB) from lighting manufacturers. Validate → Chunk → Extract Markdown → Product Analyzer (Claude). Full orchestration via Step Functions.

Step Functions Python Lambdas Claude

FTP/SFTP Extraction

4 data types

Pull from OEM FTP servers: products (base catalog), images (matched to SKUs), pricing (NET wholesale), inventory (stock levels). Parent inheritance for credentials.

Products Images Pricing Inventory

Web Scraping Gap-Fill

7 categories

Fill missing product data by category: Basic, Dimensions, Electrical, Bulbs, Safety, Features, Additional. Additive merge strategy - never overwrites existing data.

CSS Selectors Puppeteer Additive Merge

AI Agent Framework

3 agents

Discovery Agent (lead gen), Research Agent (in dev), Showroom Agent (catalog processing). 3-stage pipeline: Seed → Apollo enrichment → AI scoring. JSON repair system (98.7% success).

Claude API Apollo Attio CRM

Multi-Channel Ingest

4 methods

API Push (REST), SFTP server ($7/mo Lightsail), S3 cross-account, Email CSV. Per-OEM isolation, automatic S3 sync, unified processor Lambda handles all sources.

REST API SFTP S3 Email

Claude Skills Library

17 skills

Reusable AI skills for development velocity. Agent Architect, Database Schema Designer, API Endpoint Generator, Integration Test Builder, Log Intelligence, and 12 more.

SKILL.md YAML Frontmatter Scripts

AI Agents & Orchestration (8 Step Functions)

PDF Processing Pipeline

Upload → Validate → Chunk
→ Extract Markdown
→ Product Analyzer (Claude)

Python 3.11 Claude Step Functions

FTP Extractor

OEM FTP/SFTP pull
Products, Images, Pricing, Inventory
Parent credential inheritance

Node.js 20 basic-ftp xlsx

npAI Product Analyzer

Claude-powered extraction
200+ field schema (v2.0.2)
98.7% JSON repair success

Claude Zod Schemas JSON Repair

Web Scraper

Gap-filling & enrichment
7 data categories
Additive merge strategy

Puppeteer CSS Selectors Playwright

Maya (Internal Agent)

Internal chat widget
MCP Server access
→ External via Showrooms (H1 2026)

Claude MCP Roadmap

E-commerce Extractors

Shopify, WooCommerce
Magento, WordPress
4 Step Functions pipelines

Step Functions GraphQL REST

Playground & Decommissioned (Build Fast, Kill Faster)

Discovery Agent

Internal sales prospecting
Apollo → AI Scoring → Attio
Status: Built, not in use

Paused Internal Only

Social Media Agent

Automated content generation
Multi-platform posting
Status: Built, not in use

Paused Internal Only

Research Agent

Deep research with Claude
Market intelligence
Status: DECOM - replaced by platforms

Decommissioned

Early experiments that proved the agent architecture. Discovery & Social remain available for future activation. Research superseded by Claude Desktop workflows.

OEM Data Lifecycle (The Hard Part)

Showroom Agent Dashboard

Manual launchpad for extraction jobs
6 categories: NP SFTP, SFTP Pull, APIs,
Web Parsers, PDF Extraction, S3 Sync

Manual Today 6 Ingest Methods

LAK History

State tracking per OEM, per data type
Product ≠ Pricing ≠ Inventory ≠ Media
100+ OEMs × unstructured × no shared schema

Production State Machine

OEM Pipeline View

Leadership dashboard into current state
Connected to LAK History
Real-time job status across all manufacturers

Production React Dashboard

Scheduled Jobs System

Async communication: humans ↔ AI
Built for solo founder, now multi-tenant
Foundation for automated orchestration

Production Critical Path

Roadmap: Production Hardening

Automation layer (EventBridge scheduling) — currently all human-triggered
Alerting infrastructure (CloudWatch → SNS → Slack) — currently Slack-only
Prompt management migration to AWS (Bedrock/DynamoDB)
Pipeline resilience and retry logic

Addressing these gaps is the priority for AWS Innovative Solutions partnership.

AWS

Lambda (60+) Step Functions (8) S3 (3 buckets) DynamoDB (5+) API Gateway Secrets Manager CloudWatch Lightsail

Stack

TypeScript (strict) Python 3.11 Turborepo Zod Schemas Jest

Database

DynamoDB Single-Table SQLite (dev) Adapter Pattern GSI for queries

Integrations

Claude API (Anthropic) Apollo.io Attio CRM Slack Webhooks Sentry

S3 Buckets

neural-partners-ingest-raw neural-partners-ingest-staging neural-partners-ingest-processed

DynamoDB

neural-partners-oems neural-partners-oem-state neural-partners-lak-history neural-partners-main

APIs

api.neuralpartners.ai sftp.neuralpartners.ai

Repository

github.com/neuralpartners/neural-partners-agents (private)