Internal Knowledge Base · May 2026
MemberIntel, page by page.
A living spec for the AI advisor we're building on top of MemberPress. Pages are grouped by section — specs, architecture, phasing, governance, and role-specific docs. Click any role chip on a page to find others with the same focus.
Start here
A reading order across the spec — sections grouped, top to bottom.
spec16
01
MemberIntel V1 Specification
The V1 advisor-only spec for MemberPress operators: two-tier brain architecture, Free/Pro pricing model, and a data-flywheel moat built from product mechanics rather than pre-existing proprietary data.
02
MemberIntel V1.5 Specification
V1.5 extends MemberIntel with AI write-actions via the MemberPress MCP and a 5-minute 'Set up FOR ME' greenfield wizard backed by a 14-day Pro trial.
03
MemberIntel V2 Specification
V2 expands MemberIntel to BuddyBoss customers via a sister-company partnership — a low-engineering-risk cross-platform proof point since BB Memberships runs on MemberPress under the hood.
04
Architecture Overview & Tech Choices
Covers GCP vs Heroku vs DigitalOcean for hosting, then deep-dives per-tenant isolation strategy using shared-schema RLS as the V1 foundation.
05
Cross-Pollination & Brain Isolation
Details the three failure modes of the cross-pollination pipeline — re-identification, tenant leakage, and opt-out bypass — and the architectural mitigations for each, including k-anonymity floors, three-role isolation, and GCP project structure.
06
CI/CD & Code Flow
Defines the three separate promotion pipelines — code, Terraform, and database migrations — with GitHub Actions, Workload Identity Federation, manual prod gates, and the eval suite as a release-blocking check.
07
Observability & Incident Response
Describes the three-destination telemetry model — Cloud Logging for debugging, BigQuery for business analytics, locked-down BigQuery for audit — plus domain-specific metrics, on-call structure, and pre-written runbooks for the five highest-stakes failure modes.
08
LLM Cost-Control Architecture
Defines the four-layer cost-control stack — rate limiting, entitlement service, per-call token budgets, and continuous spend monitoring — with Redis-backed quota counters, server-side model routing enforcement, and a global daily circuit breaker.
09
Auth & Identity Layer
Covers the three signup paths converging into a unified user model, per-license MP OAuth signing keys, customer-OAuth-only Stripe (no Connect), Argon2id passwords with server-side sessions, account merge prevention, and the V1.5 trial state machine.
10
Data Sync Pipeline
Defines the three separate sync pipelines — MP (queue-based with per-customer concurrency controls), Stripe (webhooks for Pro, polling for Free), and site analysis (weekly-cached Claude calls) — with shared convergence layer and a platform-agnostic canonical schema designed for V2 expansion.
11
Secrets Management
Defines five distinct secret categories with separate lifecycles, a layered KMS key hierarchy per environment, Secret Manager naming conventions with path-prefix IAM, 5-minute TTL caching, and the hard rule that no human ever reads a production secret.
12
AI Eval Suite as Architecture
Treats the eval suite as versioned release-gate infrastructure rather than ad-hoc tests, with 150 structured scenarios across seven categories, a judge-model scoring layer, CI integration, a differentiation subset that proves advantage over baseline LLMs, and a production thumbs-down feedback loop.
13
Strategic Risk Landscape
Honestly assesses which SPEC risks the architecture handles well, which remain genuinely fragile (differentiation, content lead bottleneck), and names four risks the SPEC never flags — Anthropic dependency, ops time underbudget, per-customer brain as liability, and compliance as a moving target.
14
Synthesis
Phase-by-phase sequencing of all architectural commitments against the actual team ramp, surfacing five friction points where the phased plan and architectural reality diverge — content lead timing, Phase 2 scope calibration, differentiation eval ship date, privacy counsel engagement depth, and infra engineer hiring window.
15
Phased Plan
A 6-phase team ramp plan growing from 2 people in May to 7+ at launch, with hard milestone gates controlling when each new team member joins MemberIntel full-time.
16
Phased Plan — Rev 2
Rev 2 of the team ramp plan, updated after May architecture sessions: adds a dedicated brain-content lead recommendation, recalibrates Phase 2 milestone language for honesty, and moves the differentiation eval to a Phase 3 gate item.
reference15
17
Elevator Pitch — What MemberIntel Is
Plain-language descriptions of MemberIntel for different audiences — a one-liner, an elevator paragraph, and riffs tuned to designers, engineers, friendly outsiders, and curious customers. Use when explaining the project to someone new in under a minute.
18
Phase 1-2 Friction Points
A companion one-pager surfacing seven decisions where the May architectural commitments conflict with the v1 phased plan. All 7 decisions resolved in the Blair × Seth working session on 2026-05-11 (see /meeting-2026-05-11-blair); resolution summary at the top of this page.
19
Friction-Points Prep for Blair
Strategic prep document for Blair before the friction-points working session: three decisions that need real deliberation (brain content lead hire, differentiation eval cadence, infra-leaning hire on V1.5 roadmap), four confirmation items, predictable team disagreements, what to watch for in the meeting, and the asymmetric May-12 deadline on item 1.
20
Decisions Due — Monday 2026-05-11 (prep doc — historical)
PREP doc for the 2026-05-11 meeting. The actual outcomes are at /meeting-2026-05-11-blair. References to 'Product Lead' below are historical — the role was retired in this session; Santiago absorbed the duties.
21
Meeting Log — Blair × Seth, 2026-05-11
Full decision log from the Blair × Seth working session on 2026-05-11: friction-points resolutions, team structure changes (Product Lead retired → Santiago expanded; Russ added as Lead Designer), free-tier LLM strategy (local Ollama-class), GCP hosting confirmed, 14-day Pro trial for existing MP members, domain registrations, action items.
22
V1 Cost Discipline Review
AI Engineer persona's feasibility review of V1 unit economics: architecture as specified can hit $1.07 Free / $10.75 Pro targets if input-token ceilings are pinned, model routing is typed from the entitlement service, retrieval is pre-budgeted, and site analysis stays weekly-cached. The scariest finding is that Free breaks even AT the SPEC's floor conversion target — a Blair conversation about circuit-breaker authority, not an architecture fix.
23
Decision Rights Matrix
A binding contract defining who owns which decisions across engineering, product, compliance, and GTM — keeping Seth and Santiago unblocked as peers without escalating every disagreement to Blair. Updated 2026-05-11 to retire the dedicated Product Lead role (Santiago absorbed the duties) and add Russ as Lead Designer.
24
Quarterly Architecture Review Template
A 90-minute fixed-agenda template for quarterly architectural health reviews — covering differentiation gap, cost-per-cohort, reliability, cross-pollination health, compliance posture, and a standing 'one thing that worried me' round — starting Q4 2026 post-GA.
25
Cover Letter to Allen — Privacy Architecture Review
Cover letter from Seth and Santiago to Allen, MemberIntel's privacy counsel, introducing the privacy strategy memo and the late-May architecture review agenda. Sent ~5 business days before the session to give Allen context for the pre-read package.
26
Privacy Strategy for Counsel — Memo to Allen
Privacy strategy memo for Allen (Blair's privacy counsel) ahead of the late-May architecture review. Identifies the structural problem (the architecture treats member data as operator data throughout) and proposes seven preconditions before ToS drafting — four code-layer architectural preconditions and three policy items. Drafted 2026-05-12 through a Brandeis-counsel reasoning pass, McPhee-prose rewrite, panel review (Lessig + Sunstein + Rawls), and a Lessig/Rawls debate on permanent exclusion.
27
Privacy Counsel Architecture Review Agenda
A 4-hour late-May working agenda for outside privacy counsel to review MemberIntel's per-tenant isolation, cross-pollination boundary, secrets management, and data lifecycle decisions — grounding counsel's June ToS and Privacy Policy drafting in the actual architecture.
28
Design References
Living index of design artifacts for MemberIntel: the current Claude mockup, the Figma source-of-truth as it lands, and the visual-system conventions documented in docs/design/MemberIntel/CLAUDE.md.
29
Seth's Phase 1 Deliverable Checklist
Seth's operational working checklist for May 2026 — organized week-by-week with ADR drafts, GCP scaffolding, schema design, RLS prototype, hiring pipeline, and cross-functional coordination tasks required to unlock Phase 2 on June 1.
30
Phase 1 Deliverable Checklist (Santiago — formerly Product Lead)
Phase 1 operational working checklist for May 2026 — week-by-week milestones, PRD authoring, customer discovery, privacy counsel engagement, beta program scaffolding, cross-functional kickoffs, and the Phase 1 milestone gate criteria required to kick off Phase 2 on June 1. Originally authored for the Product Lead role; that role was retired 2026-05-11 and the checklist now belongs to Santiago (Product + Project Lead).
31
AI Engineer — Public Job Posting
External recruiting copy for the Senior AI Engineer hire — production LLM systems experience required, cost-discipline-as-engineering-surface posture, no LangChain. 30-min CEO screen → 60-90 min technical with Seth → paid week-long trial → offer in ~2-3 weeks.
role6
32
Seth — Lead Architect JD
Seth Shoultes's Lead Architect role definition: end-to-end technical ownership of the brain, data pipeline, AI/ML architecture, engineering team, and vendor decisions for MemberIntel.
33
Blair — CEO JD
Blair Williams's CEO role definition for MemberIntel: product owner, final decision-maker on strategy, pricing, and architecture material choices, executive sponsor across the company.
34
Senior AI Engineer JD
Senior AI Engineer role definition: owns the AI substrate end-to-end (inference pipeline, retrieval, prompt versioning, eval suite, cost discipline, feedback loop) under Seth's architectural direction. Reports to Seth Shoultes. Hire pending — target close mid-June 2026.
35
Product Lead JD (retired — folded into Santiago 2026-05-11)
RETIRED 2026-05-11. The dedicated Product Lead role was not backfilled after Cindy's departure; responsibilities folded into Santiago's expanded mandate. Retained as a historical reference for the duties Santiago now owns. See /santiago-jd for the current operational definition.
36
Santiago — Product + Project Lead JD
Santiago Perez Asis's expanded role definition: combined Product Lead + Project Manager for MemberIntel — PRD ownership, sprint cadence, dependency tracking, risk register, L10 scorecard, and cross-functional coordination. Expanded 2026-05-11 after Blair decided not to backfill the Product Lead role following Cindy's departure.
37
Russell — Lead Designer JD
Lead Designer role definition: owns the visual system, end-to-end product UX, and design-to-engineering hand-off for MemberIntel. Reports to Blair Williams. Decided 2026-05-11 in the Blair × Seth working session — initially part-time / contract through Phase 1 with potential move to full-time as product surfaces solidify.
standup5
·
Standup — 2026-05-13
**2026-05-13 — MemberIntel Standup** V1 Slice 1 shipped end-to-end overnight — spec, implementation plan, and all code landed in a single session.
·
Standup — 2026-05-12
**Slice 7 shipped: Resend email notifications.** Three flavors of internal email are live.
·
Weekly — week of 2026-05-12
Four slices shipped, five ADRs locked, one role posted, one CI bug caught and fixed same session.