# INNOVAISSI: Master Specification & Autonomous Agentic Blueprint

> **Official Blueprint & Master Prompt for Innovaissi Agency**  
> *Autonomous AI Systems • Custom MCP Servers • Cloud Architecture • Founding Engineer Velocity*

---

## 1. Executive Summary & Brand Positioning

**Innovaissi** is an elite agency and founding engineering consultancy delivering cutting-edge **Agentic AI systems**, **Model Context Protocol (MCP) server engineering**, and **cloud-scale automation**.

### Mission Statement
To compress time-to-market for ambitious founders and high-growth e-commerce brands by deploying autonomous, self-healing agentic workflows, tailored MCP tools, and scalable cloud architectures — transforming ideas into resilient production systems in days rather than quarters.

### Core Value Proposition
- **Founding Engineer Velocity**: Direct pairing with high-caliber founding engineers who build, ship, and iterate at breakneck speed.
- **Agentic Multi-Step Autonomy**: Moving beyond simple chat wrappers to reliable, deterministic agent loops equipped with feedback loops, tools, and error correction.
- **Model Context Protocol (MCP) Native**: Connecting frontier LLMs directly to proprietary databases, legacy ERPs, payment gateways, and custom internal APIs.
- **E-Commerce & Remarketing Automation**: Autonomous remarketing engines that monitor cart abandonment, synthesize dynamic personalized creative copy, and trigger multi-channel re-engagement pipelines.
- **Enterprise-Grade Cloud Infrastructure**: Cloud Run, serverless microservices, and zero-trust sandboxed tool execution.

---

## 2. Target Personas & Use Cases

### Persona A: The Seed/Series A Startup Founder
- **Pain Point**: Engineering bottlenecks, slow product iteration, high burn rate, and a 6-month product backlog.
- **Innovaissi Solution**: Acts as the interim Founding Engineer. Architect, prototype, and ship scalable MVPs or AI-native core features in under 2 weeks.

### Persona B: The High-Volume E-Commerce Brand Operator
- **Pain Point**: Rising customer acquisition costs (CAC), cart abandonment, generic remarketing campaigns, manual customer support operations.
- **Innovaissi Solution**: Deploys autonomous remarketing agents that analyze user browsing sessions in real-time, generate personalized dynamic incentives, and automatically orchestrate email/SMS/ad retargeting loops with 3x higher ROAS.

### Persona C: The CTO / Head of Engineering
- **Pain Point**: LLMs hallucinating, lack of secure enterprise database connectivity, inability to safely run tools in production.
- **Innovaissi Solution**: Designs and deploys enterprise-grade custom MCP servers with strict input schema validation, rate-limiting, audit logging, and least-privilege cloud IAM.

---

## 3. Core Capability Pillars

| Pillar | Focus Area | Technologies & Standards | Deliverable |
| :--- | :--- | :--- | :--- |
| **1. Agentic AI & Workflows** | Autonomous task execution, self-correction, DAG workflows | LangGraph, CrewAI, AutoGen, Antigravity SDK | Production-ready multi-agent systems with deterministic guarantees |
| **2. Custom MCP Servers** | Tool registration, secure database/API bridging | Model Context Protocol, WebMCP, JSON Schema | Secure, standardized MCP servers for Claude, ChatGPT, Cursor, and IDEs |
| **3. E-Commerce Automation** | Remarketing, cart recovery, dynamic pricing, churn reduction | Webhooks, Shopify/Stripe API, BigQuery, Vector DBs | Automated revenue-recovery pipelines operating 24/7 |
| **4. Founding Engineer as a Service** | 0 to 1 product development, architecture design, rapid MVP | Node.js, TypeScript, Python, Docker, Cloud Run | Production-grade software delivered with extreme velocity |
| **5. Cloud Architecture & DevOps** | Containerization, CI/CD, security hardening, monitoring | Google Cloud Run, Artifact Registry, GitHub Actions | Zero-downtime serverless infrastructure with auto-scaling |

---

## 4. Antigravity Multi-Agent Orchestration Workflow

When building or updating websites and applications autonomously using Antigravity, apply this **parallel multi-agent workflow pattern**:

```
                              [USER PROMPT / TASK]
                                       │
                                       ▼
                       ┌───────────────────────────────┐
                       │  Lead Architect Agent (Orch)  │
                       │   - Deconstructs requirements │
                       │   - Formulates system spec    │
                       └───────────────┬───────────────┘
                                       │
        ┌──────────────────────────────┼──────────────────────────────┐
        ▼                              ▼                              ▼
┌──────────────────┐          ┌──────────────────┐          ┌──────────────────┐
│  UI/UX Subagent  │          │ 3D WebGL Subagent│          │ Backend/Cloud    │
│  - Semantic HTML │          │ - Three.js scene │          │   Subagent       │
│  - Glassmorphic  │          │ - Shaders/Mesh   │          │ - Dockerfile     │
│    CSS System    │          │ - 60 FPS loop    │          │ - Cloud Run CI/CD│
└────────┬─────────┘          └────────┬─────────┘          └────────┬─────────┘
         │                             │                             │
         └─────────────────────────────┼─────────────────────────────┘
                                       │
                                       ▼
                       ┌───────────────────────────────┐
                       │   QA & Verification Subagent  │
                       │   - Headless browser test     │
                       │   - Syntax & linter validation│
                       │   - Responsive inspection     │
                       └───────────────┬───────────────┘
                                       │
                                       ▼
                       ┌───────────────────────────────┐
                       │   Deployment Agent (Cloud)    │
                       │   - Build container image     │
                       │   - Deploy to Cloud Run       │
                       └───────────────────────────────┘
```

### Execution Directives for Subagents
1. **Parallel Execution**: Frontend layout and 3D graphics canvas logic can be engineered concurrently.
2. **Deterministic Verification**: Every stage must be verified with automated checks (`node --check`, headless browser visual inspection) before production deployment.
3. **No Placeholders**: Never use placeholder images or dummy copy; generate rich, domain-specific content.

---

## 5. Technical Stack & Deployment Blueprint

- **Frontend Core**: Semantic HTML5, Vanilla Modern CSS with Glassmorphism, CSS Custom Properties, and fluid typography (`clamp`).
- **3D Graphics**: Three.js WebGL rendering with custom cybernetic neural lattice, particle repulsion, and fallback for non-GPU environments.
- **Server Runtime**: Node.js (v18+) with native ES Modules, zero external runtime bloat, security headers, dynamic `$PORT` detection, and `/healthz` probe endpoint.
- **Containerization**: Hardened multi-stage Alpine Docker container (`node:22-alpine`) executed under unprivileged non-root user (`node`).
- **Cloud Infrastructure**: Google Cloud Run (Fully Managed Serverless), auto-scaling from 0 to 5 instances, SSL automated via Google-managed certificates.
- **CI/CD Pipeline**: GitHub Actions triggered on `main` push, utilizing Google Cloud Workload Identity Federation (WIF) and Artifact Registry.

---

## 6. Local Development & Run Guide

```bash
# 1. Clone repository
git clone https://github.com/Lasnami16/innovaissi-website.git
cd innovaissi-website

# 2. Environment Configuration
cp .env.example .env

# 3. Launch Local Development Server (Option A - Node.js)
npm run dev
# Server listening at http://localhost:8080

# Option B - Zero-dependency Python fallback
python3 -m http.server 8080

# 4. Build and Run via Docker
docker build -t innovaissi-website .
docker run -p 8080:8080 innovaissi-website
```

---

## 7. Cloud Run Deployment Command Reference

To deploy manually via Google Cloud CLI:

```bash
# Authenticate
gcloud auth login
gcloud config set project [YOUR_PROJECT_ID]

# Deploy directly from local directory
gcloud run deploy innovaissi-website \
  --source . \
  --region europe-west1 \
  --platform managed \
  --allow-unauthenticated \
  --port 8080 \
  --memory 512Mi \
  --cpu 1
```
