# Buildeon Systems — Full Technical Corpus & Context

## 1. Company Identity & Mission
Buildeon Systems is a specialized systems engineering studio. We build and operate high-scale infrastructure for digital commerce, enterprise workflows, and autonomous AI agents. We focus on open-source foundations (self-hostable, sovereign, fully auditable) over proprietary closed-source SaaS platforms.

- **Primary Website**: https://buildeon.solutions
- **Primary Domain**: buildeon.solutions
- **Engineering Labs**: https://labs.buildeon.solutions
- **Contact Email**: hey@buildeon.solutions
- **Entity**: Buildeon Systems

---

## 2. Architectural Pillars

1. **Sovereignty & Control**: We believe high-volume commerce and proprietary data belong in databases you own and host, not rented inside multi-tenant SaaS walled gardens that extract 1-3% GMV take-rates.
2. **Deterministic Over Probabilistic**: AI agents and automated workflows must be bound by strict runtime guardrails, deterministic schemas, and Human-in-the-Loop (HITL) approval gates.
3. **Extreme Performance**: Static-first frontends (Astro, Next.js SSG), low-latency edge caching, and purpose-built search indexes (Meilisearch, Typesense) that deliver sub-100ms response times.
4. **Machine Discovery Readiness**: Implementing emerging standards (LLMs.txt, ACP, UCP, Schema.org Knowledge Graphs) so our clients' platforms are discoverable, citeable, and actionable by autonomous buying and research agents.

---

## 3. Practice Areas & Service Offerings

### A. Agentic Commerce (`/solutions/agentic-commerce/`)
- **Problem**: Modern e-commerce is transitioning from passive browsing to autonomous AI purchasing agents. Monolithic legacy systems (Shopify, Magento, Salesforce) cannot handle machine-speed inventory negotiation or protocol-level checkout.
- **Buildeon Solution**:
  - Headless architecture replatforming with Medusa v2, Saleor, Vendure, and Spree Commerce.
  - Integration of machine commerce protocols: Agentic Commerce Protocol (ACP) and Universal Commerce Protocol (UCP).
  - High-throughput catalog search indexing and edge content negotiation.
  - Automated cart decomposition and multi-vendor payout routing.

### B. AI Visibility & Generative Engine Optimization (GEO) (`/solutions/ai-visibility/`)
- **Problem**: Traditional SEO focuses solely on Google 10-blue-links. Today, enterprise buyers research and source solutions directly via conversational LLMs and search engines (Perplexity, ChatGPT Search, Claude).
- **Buildeon Solution**:
  - Structural knowledge graph integration using JSON-LD schema (Organization, SoftwareApplication, TechArticle, FAQPage, BreadcrumbList).
  - Implementation of emerging agent protocols: `llms.txt`, `llms-full.txt`, Content Signals, and machine-readable profiles.
  - Markdown content negotiation (`Accept: text/markdown`) allowing agents to ingest clean markdown representations without HTML overhead.

### C. Agentic Operations & Back-Office (`/solutions/agentic-operations/`)
- **Problem**: B2B enterprises expend substantial engineering and operations payroll on manual data transfers between ERP, CRM, supplier portals, and inventory spreadsheets.
- **Buildeon Solution**:
  - Event-driven orchestration with flexible integration pipelines using n8n and self-hosted tools.
  - Multi-agent task distribution with human oversight for threshold exceptions.
  - Direct bi-directional synchronizations with Odoo, ERPNext, Dolibarr, and custom REST/GraphQL APIs.

### D. AI Systems Integration (`/capabilities/ai-agent-engineering/`)
- **Problem**: LLM wrapper products frequently hallucinate, drift over time, and leak sensitive context or credentials.
- **Buildeon Solution**:
  - Fine-tuned small language models (SLMs) and retrieval-augmented generation (RAG) architectures.
  - Evaluation harness design (deterministic fixtures, behavioural eval suites).
  - Enterprise security boundaries, credential sandboxing, and architectural alignment for SOC 2 and GDPR controls.

---

## 4. Benchmark Studies & Technical Teardowns

### Study 1: Mirakl vs. Open-Source Headless Stacks (2026 Edition)
- **Subject**: Enterprise marketplace platforms and multi-vendor eCommerce architectures.
- **Findings**:
  - *Mirakl Economic Reality*: Annual SaaS licensing fees start at $120,000–$250,000/yr with additional 1.0%–2.5% Gross Merchandise Value (GMV) take rates. At $50M GMV, Mirakl costs over $750,000/yr in recurring vendor fees.
  - *Headless Stacks Alternative*: A self-hosted Medusa v2 / Saleor stack deployed across scalable infrastructure costs $15,000–$35,000/yr in cloud infrastructure, avoiding recurring GMV take-rate fees.
  - *Architectural Trade-offs*: Open-source requires upfront engineering capacity but eliminates proprietary SaaS platform lock-in, enabling custom seller onboarding workflows and absolute database ownership.

### Study 2: Open-Source vs. Paid Directory Platforms (2026 Edition)
- **Subject**: Architectural foundations for high-scale directories, programmatic SEO engines, and resource portals.
- **Findings**:
  - *SaaS Directory Pitfalls*: Platforms like Softr, Glide, or Bubble hit strict database indexing ceilings (10k–50k records), enforce slow client-side rendering that delays search crawler indexation, and cost hundreds of dollars monthly.
  - *Static/SSR Open-Source Stacks*: Astro + SQLite/PostgreSQL generates sub-millisecond static HTML, scores 100 on Core Web Vitals, and handles 500,000+ programmatic SEO pages without marginal hosting cost.

---

## 5. Machine Protocols & Agent Discovery Directory

Buildeon exposes the following machine-readable endpoints for autonomous agent interaction:

| Endpoint | Standard / Protocol | Purpose |
| :--- | :--- | :--- |
| `/.well-known/ai-catalog.json` | Agent Resource Discovery (ARD) | Capability and endpoint catalog. |
| `/.well-known/acp.json` | Agentic Commerce Protocol (ACP) | Commerce seller profile and service capabilities. |
| `/.well-known/ucp` | Universal Commerce Profile (UCP) | Business profile and service boundaries. |
| `/.well-known/api-catalog` | RFC 9329 API Catalog | Structured linkset of available endpoints and documentation. |
| `/auth.md` | Agent Authentication Guide | Guidance on headers, content negotiation, and bot guidelines. |
| `/llms.txt` | LLM Summary | Concise high-level context document. |
| `/sitemap-index.xml` | XML Sitemap | Search and crawler URL discovery index. |

---

## 6. Contact & Engagement

- Inquiries & Architecture Audits: https://buildeon.solutions/work-with-us/
- Direct Email: hey@buildeon.solutions
- Primary Physical / Operations Base: Ljubljana, Slovenia / European Union
- Cloud Hosting & Infrastructure: EU cloud data centers operating under standard GDPR data processing terms.
