1 · Vision
Phase 1: Vision & Scope Definition
0. BRANDING (user decision, 2026-09-07):
/assets/img/mascots/ (POSE 1–8, 10, 12, webp+png; per mascots/README.md). Mascot poses must be remapped during build: the old README assigns poses to removed service pages (seo/paid-ads/ai-content-seo/ai-analytics/branding) — those assignments die with the pages; remaining poses (7 hero, 10 inviting, 1 welcoming, 3 explaining, 4 building, 6 on-call, 8 confident, 12 launching) get re-assigned to the real v17 sections./assets/img/logo-styles/ (structured-badge, minimal-mark, dynamic-symbol, bold-wordmark) — pick one direction during M0.consultant.srv…, consultant-v16.js) stay as-is internally — they are not user-facing branding.1. Business Problem/Opportunity:
The consultant aims to solve inefficiencies and lack of integration within businesses by providing tailored AI and marketing solutions. The website's primary goal is to attract new clients by clearly showcasing these bespoke services, demonstrating value, and initiating conversations. The opportunity lies in positioning "Arnow Solutions" as a trusted partner that offers intelligent, customized solutions rather than generic, off-the-shelf products.
2. Target User Persona(s):
3. Key Functional Requirements:
/work page implied)./contact implied).4. Desired Emotional/Brand Impact ("expensive," "cinematic," "playful"):
The website should convey a sense of:
5. Specific Non-Functional Requirements:
2 · Architecture
ARCHITECTURE_BLUEPRINT.md — Arnow Solutions
Derived from PROJECT_VISION.md. Purpose: choose the technical direction and explicitly align each Premium Development Stack skill to the build.
1. Stack Decision
Decision: Multi-page static-first build (HTML/CSS/JS modules) — NOT a React SPA.
Rationale:
Resulting baseline (maps to premium-web-scaffolding rules):
Intersection Observer for all reveal-on-scroll. FORBIDDEN: AOS or similar.transform/opacity only. No layout thrashing.loading="lazy"), width/height set to avoid CLS.prefers-reduced-motion globally.2. Premium Motion Design Strategy (premium-motion-design)
Apply deliberately, sparingly — "expensive" pacing:
- --ease-out-expensive: cubic-bezier(0.25, 0.1, 0.25, 1.0) (long gentle deceleration)
- --ease-out-soft: cubic-bezier(0.22, 1, 0.36, 1) (ease-out-quint feel for reveals)
- --dur-fast: 400ms, --dur-base: 600ms, --dur-slow: 900ms
1. Hero load-in choreography (staggered: label → headline → sub → CTAs → mascot), one 600ms pass, no bounce.
2. Scroll reveals for section titles/cards via Intersection Observer, single fade+rise (8–16px), 600ms.
3. Nav: background tint on scroll (no transition below 400ms).
4. CTA hover micro-motion: translateY(-2px) + shadow, 400ms.
5. Theme toggle: respect 0.35s color transitions already present; animate knob with the expensive curve.
animation-play-state pause on hover or reduced-motion off.3. 3D / Interactive Framework (3d-interactive-framework)
- Mascot images get a slow, *very subtle* parallax drift tied to pointer position (transform-only, CSS/JS ~10 lines, capped displacement, disabled on touch).
- If a product-style interactive demo (e.g., animated pipeline) is needed later, implement it with GSAP + SVG, not a 3D engine.
3d-interactive-framework and choose PixiJS (2D particle/network) or BabylonJS (3D scene) with strict dispose/60fps rules.4. Page Map & Content Architecture
Pivot (user direction, 2026-09-07): showcase = real built projects; NO SEO/paid-ads/AI-content/AI-analytics offerings anywhere. Design heritage (past web/graphic design) gets its own honest thread.
/ Home — cinematic console experience whose proof sections are real projects (before/after ledgers where they fit), the four capability demos (agents, voice, automation, chat/knowledge), process, CTA./services/* — ONLY pages for real current offerings: agentic-ai, ai-voice-agents, ai-chatbots-rag (web-design/SEO/branding/paid-ads/ai-content-seo/ai-analytics pages are removed from IA; web-design lives under Design Heritage, not services)./work — the Showroom: screenshot-led project stories. No raw URL lists. Each project = real art-directed captures + layered case detail (problem → built → proves) + secondary live link; console-askable; optional sandboxed "try the real thing." Only curated, real, public-safe projects (see DEVELOPMENT_PLAN Module 3.5)./process — the 4-step engagement page (kept)./talk — intake page (kept, primary conversion)./contact, /voice-demo — kept.5. Performance & Quality Gates (mapped to premium-web-scaffolding + QA checklist)
3 · Development Plan
DEVELOPMENT_PLAN.md — Arnow Solutions: "The Experience" Flagship Home
Scope per user decision (b): home page first, as a flagship that abandons the conventional marketing flow. The visitor lands inside a cinematic, AI-driven console where the *experience itself* demonstrates the company's craft. All other pages roll out later.
Working title: index-preview-v17.html ("The Console / The Experience").
Ground Rules (inherited from project PHASES.md — DO NOT VIOLATE)
index.html; ship index-preview-v17.html + assets alongside./assets/js/consultant-v17.js. No-JS = full content still visible.MODULE 0 — Motion & Design Tokens (FOUNDATION — do first)
Skills: premium-motion-design · premium-web-scaffolding · premium-website-designer
Deliverable: _v17build/css/part0-tokens.css (imported by all parts).
#101418/ivory/indigo #4f46e5 — verify against v16 latest), radii, type scale.--ease-exp: cubic-bezier(0.25,0.1,0.25,1.0); --ease-soft: cubic-bezier(0.22,1,0.36,1); --dur-fast:400ms; --dur-base:600ms; --dur-slow:900ms.prefers-reduced-motion: reduce global kill-switch.Verification: grep part files — zero ease-in-out/linear/ease-in in animation-timing; only token vars used; tokens file ≤ 200 lines.
MODULE 1 — "The Arnow Line" hero (the X-ray brain) — flagship centerpiece
Skills: premium-motion-design · 3d-interactive-framework (render discipline) · premium-website-designer
Deliverable: Hero scene in _v17build/html/part1-hero.html + engine in consultant-v17.js.
.01 INTAKE → .02 SCAN → .03 FIX — echoing the real 4-step process (listen → ask → recommend → build). Heritage beats: "Allerton" and "Arnow" can appear as station names on the line (brand story, not a claim).mix-blend-mode: screen sweep (blue) revealing an inner "circuitry" layer, then a green/gold "fixed" pulse. GSAP only if path-motion complexity demands it. Fallback ladder: no-JS → static scene + copy fully visible; reduced-motion → static illustration, no sweep.Verification: 60fps mid-tier mobile; single pass + idle; reduced-motion static; no-JS full content; CLS 0; blue sweep uses blend-mode + mask only (no layout thrash).
MODULE 1B — THE SIGNATURE HERO: "The Arnow Line" + AI X-ray (user-approved 2026-09-07)
Working prototype (live, additive): index-preview-v17-hero.html → https://consultant.srv1738752.hstgr.cloud/index-preview-v17-hero.html (source /workspace/New-Arnow-Solutions/public/, deploys to /opt/consultant/public/ on the VPS).
The story: Arnow Ave sits beside Allerton Ave — a real Bronx train station. The train IS the brand: always moving, never stops, carries you where you need to go. The AI promise ("we find what's broken") is told as an X-ray inspection of the train itself — at the Allerton scanner, an X-ray looks INSIDE the cars.
CORRECTION (user, 2026-09-07): The X-ray is ON THE TRAIN — showing what's inside the cars (riders, benches, racks). It has NOTHING to do with a brain. The earlier "AI X-ray brain console" concept (v1 of this module) is DEAD — brain removed entirely.
Composition (v2, live):
Rules learned (HARD):
script-src 'self' → ALL hero JS MUST be an external same-origin file (/assets/js/consultant-v17-hero.js); inline scripts are silently blocked..hero must be flex-direction:column — a row default pushes the line band off-frame.visibilitychange hidden + prefers-reduced-motion (static train mid-line).#070a10; x-ray blues #3e7bff/#38bdf8/#67e8f9; vintage train red #a52f2f; silver roof #d8dadd; ivory text; Inter + JetBrains Mono labels.Iteration queue (user pending): scan cadence/intensity; train length & nose fidelity (reference = vintage red elevated, "661"); whether headlight/number cluster reads too much like a face; copy tone.
MODULE 2 — Console Frame (the stage)
Skills: premium-web-scaffolding · premium-website-designer
Deliverable: _v17build/css/part2-console.css + chrome markup.
tp-* ids) — reorganized around *the visitor's problem*, not the company.Verification: keyboard-only full flow; 320px no horizontal scroll; tab switch = 400ms token transition only.
MODULE 3 — The Conversation Core (static "demo conductor")
Skills: premium-motion-design · premium-web-scaffolding · (copy discipline from real site voice)
Deliverable: consultant-v17.js engine v1 + markup.
Verification: every leaf ends in a real funnel destination; zero fabricated client names/metrics; full flow works offline.
MODULE 4 — Live AI Wiring (make it real)
Skills: (backend) · security-and-hardening · source-driven-development
Deliverable: wire the static console to the existing Fastify backend:
server/routes/sessions.ts + server/agent/orchestrator.ts + provider.ts (Gemini/Anthropic already configured).Verification: end-to-end session → agent reply with citation/source styling; rate limit returns 429 gracefully (no crash); no key in client bundle.
MODULE 5 — Ambient Motion Layer (the "wow" that stays classy)
Skills: 3d-interactive-framework · premium-motion-design
Deliverable: optional ambient canvas in side-dock/background — subtle.
Verification: frame-time budget ≥ 10ms headroom on low-end; disposed on route change; invisible under reduced-motion.
MODULE 3.5 — Project Showroom (REAL work, screenshot-led — user-mandated pivot)
Skills: premium-web-scaffolding · premium-motion-design · (content honesty rules)
Deliverable: projects.json + Showroom section on home.
1. Art-directed real screenshot (cinematic capture, not a raw full-page thumbnail; multiple: desktop + mobile, light/dark where the app has themes).
2. Story in layers: glanceable case card (project name, one-line problem, "what it proves," tags) → click opens console-styled detail view with more captures, before/after ledger, stack.
3. Live URL exists as a secondary "visit site" affordance — never the primary element.
/opt/webcapture playwright tooling exists for this). NEVER mockups dressed as real captures. Where an app sits behind login (e.g., Big Reef player root), capture the public/landing view or a curated demo view.- Consumer/public: The Rec youth nonprofit site (therec), Trade Compass forex platform, Big Reef Chapter audiobook player, Jeopardy-style game, Arnow Solutions's own site.
- Enterprise/internal (healthcare ops — Montefiore Urology): Unified Platform (schedule/OR/reimbursement), Reimbursement platform, OR Schedule/portal, Interview Season platform, Qgenda sync. Real and impressive, but healthcare-adjacent — showcase only with user's explicit call on naming/anonymization.
- Internal tools (probably NOT portfolio): code-server, supabase studio, photos/immich, notebook, skillclaw, omniroute, vapi, launchpad, listening-room, repo vault, agentic-os, hermes-webui.
Verification: JSON schema-validated; every capture file exists + was produced by the capture pipeline (not hand-made); no SEO/paid-ads/AI-content references anywhere; keyboard-accessible detail view.
MODULE 6 — Funnel Integrity
Skills: premium-web-scaffolding
Deliverable: no dead ends. From any console state the visitor can reach: talk/intake, voice-demo, services (real ones only: agents/voice/chat — no SEO/paid-ads pages), work (real projects), design heritage, contact email. Footer = real links only.
Verification: crawl preview links; every href 200 or intentional mailto; nav present in no-JS.
MODULE 7 — QA & Preview Publish
Skills: (headless QA per PHASES.md rule 7) · web-quality-audit
Deliverable: index-preview-v17.html assembled, deployed additively to Hostinger root of consultant domain (SFTP/FTP per hostinger-deployment skill), QA report.
Verification (see QUALITY_ASSURANCE_CHECKLIST.md): Lighthouse ≥90 perf/a11y/SEO; headless render + vision pass; geometry probe (no overflow); all 8 no-slop animation checks green.
Agent delegation map (parallel-safe batches)
Rollout note (post-flagship)
After v17 home is approved: port the same chrome/tokens to the REAL service pages (agentic-ai, ai-voice-agents, ai-chatbots-rag only), /work (project grid), design heritage page, /talk, /process, /voice-demo. Removed from the project forever: seo, paid-ads, branding, ai-content-seo, ai-analytics pages. That is a separate DEVELOPMENT_PLAN cycle.
4 · QA Checklist
QUALITY_ASSURANCE_CHECKLIST.md — Arnow Solutions v17 Flagship Home
Run per-module during dev AND once fully before publish. Every item must be green or explicitly waived with a reason.
A. Animation discipline (premium-motion-design)
ease-in-out, ease-in, linear timing functions in shipped CSS/JS (grep-able).--ease-exp / --ease-soft referenced everywhere.transform/opacity only — no width/height/top/left animation, no layout thrash.:hover/hidden tab and dies under reduced-motion.prefers-reduced-motion: reduce → all motion off, content fully visible, no empty states.B. Interaction & console (premium-web-scaffolding)
aria-current, ESC closes overlays.C. Content honesty (project rule)
D. Performance & 3D/motion layer (3d-interactive-framework)
loading="lazy" below fold, dimensions set (no CLS), WebP/compressed mascots.font-display: swap, preconnect only to same-origin + Google Fonts as today.E. Security & backend (M4 only)
F. Funnel integrity
index.html production untouched; v17 is additive index-preview-v17.html.hero-mascot-main/page-mascot; decorative mascots alt=""+aria-hidden="true"; primary mascot has real alt.