Cofoundy Systems Inventory

Cofoundy Systems Inventory

Last audited: 2026-04-06

External Services

Railway Deployments

cal-cofoundy

• Project ID: 6f0e6bc3-1f03-4226-bf6d-4d5b8cd940ee
• Production env: 10fadf9d-c98f-42d0-807c-6aa69429180e

Env vars (Meeting Hub): RECALL_API_KEY, RECALL_REGION, RECALL_WEBHOOK_SECRET, FIREFLIES_API_KEY, DISCORD_WEBHOOK_URL, WEBHOOK_SECRET, CALCOM_WEBHOOK_SECRET, CONSULTANT_DISCORD_MAP, WHATSAPP_API_KEY (not set), WHATSAPP_PHONE_NUMBER_ID (not set)

Vikunja

• Project ID: 0bf5c608-b259-48f6-876a-d0b8bff576be
• Vikunja service: 20f84f33-37e2-4f89-9e44-ffe2fe795efd
• Postgres service: 0be4cd2b-4150-46c2-8379-68f423b0aee8
• Production env: a9bc8090-3c89-4e49-8115-968a778ee3dc
• URL: vikunja.cofoundy.dev
• GitHub repo: cofoundy/vikunja-railway (custom Dockerfile — distroless multi-stage build)
• Teams: Delivery (id=1), Founders (id=2)
• Labels: payment(1), milestone(2), follow-up(3), phase-discovery(4), phase-dev(5), phase-qa(6), phase-deploy(7)

Vaultwarden

• Project ID: eafa5b1b-59a4-468f-ae73-c348b7960abe
• Service: 9ba2d3a5-e8c5-4c3f-aaaa-b0e88f0a7c28
• Production env: bd799d7d-a6fc-4ed9-83e6-596b4a11d701
• Volume: 7ded3e0f-41ba-4456-8c62-ecc619f78c27
• URL: vault.cofoundy.dev

Landing Page (cofoundy.dev)

• Project ID: b21a7320-9f11-470c-948c-bfb09d115499
• Service: c1781e29-862d-4ce6-b916-feb64484f72d
• Production env: 4c8d54e3-39ba-4098-8339-4b4b74f1117b
• URL: cofoundy.dev
• Staging: landing-stag.cofoundy.dev
• Deploy: GitHub Actions → GitHub Pages (.github/workflows/deploy.yaml)
• Env vars: NEXT_PUBLIC_INBOXAI_API_URL, NEXT_PUBLIC_INBOXAI_TENANT_ID, NEXT_PUBLIC_TIMELY_WS_URL

InboxAI

• Project ID: 555c7aa5-4661-4a8b-ab7b-093cd4957d9b
• Backend service: 90da9cee-f050-4d04-8cfc-06608065eef0 → backend-production-171e.up.railway.app
• Frontend service: 4e6f2160-4c2a-4c81-a84d-063a4fdf6904 → frontend-production-1634.up.railway.app
• Postgres: f0848a96-8d19-4472-8f3d-33da64b2771c
• Redis: 9f04fb2f-8b1d-4bef-a8c9-4b5f9bf0d802
• Production env: 05365ef0-a461-4a53-997a-fcde9f9b2cbd
• Tenant: ten_cofoundy

TimelyAI (renamed from Agenda AI)

• Project ID: 547db65a-05f8-4b56-ad1b-41888f108cb6
• Backend service: 53d91236-7ee0-4411-948e-40e81c0a595a → backend-timely-ai.up.railway.app
• Production env: fcfe96bb-5b3e-4114-8304-4481f0b890ea

Sift (START Hack 2026 — showcase)

• Frontend: sourcai-frontend-production.up.railway.app → sift.cofoundy.dev
• Backend: sourcai-backend-production.up.railway.app → sift-api.cofoundy.dev

Koopa Notaria (client project)

• URL: koopa-notaria-server-production.up.railway.app
• Webhook: koopa-notaria-server-production.up.railway.app/webhook (Kapso integration)
• Deploy: GitHub source connected → git push origin main triggers build

Other Railway projects (referenced)

• n8n (automation workflows)
• Bilio Landing / bilio front (legacy client)
• Journy (client project)

Cloudflare Infrastructure

DNS Zone: cofoundy.dev

• Zone ID: 2787baa6dbc79985dd0195dd8f1563e6
• Wildcard: *.cofoundy.dev → cofoundy.github.io (for portfolio subdomains via GitHub Pages)
• Email routing: info@cofoundy.dev → Gmail

Cloudflare Pages Projects

Custom Domains on Cloudflare (proxied to Railway)

• cofoundy.dev → Landing Page (Railway)
• cal.cofoundy.dev → Cal.com (Railway)
• vikunja.cofoundy.dev → Vikunja (Railway)
• vault.cofoundy.dev → Vaultwarden (Railway)
• sift.cofoundy.dev → Sift frontend (Railway)
• sift-api.cofoundy.dev → Sift backend (Railway)
• ui.cofoundy.dev → Cloudflare Pages (Storybook)
• docs.cofoundy.dev → Cloudflare Pages (DocsAI)

D1 Database

• docs-ai-analytics: cec6b0fb-c485-4d79-8546-5e6fccf1eb63 (bound to docs-ai)

Discord Infrastructure

Server: Cofoundy

Channels (name → ID):

Bot: Custom bot (token in ~/.claude/settings.json as DISCORD_TOKEN). Used by discord_send.py script for automated notifications.

Webhook (Meeting Hub): DISCORD_WEBHOOK_URL env var on Railway — posts booking notifications (created/cancelled/rescheduled) to #leads with consultant @mentions via CONSULTANT_DISCORD_MAP.

Team Member Discord IDs:

• Andre: 233699499938152448
• Melissa: 962179627579748402
• Alvaro: 604797534174707713
• Percy: 627677887952060416
• Freddy: 749069760871792682
• Juan: 635285576760950824

Automation / Triggers / Hooks

Claude Code Hooks (cofoundy-toolkit plugin)

Claude Code Hooks (cofoundy-founders plugin)

GitHub Actions Workflows

Claude Code Remote Triggers

⚠️ Duplicate scripts: deals/scripts/pipeline_health.py (Vikunja-aware, current) and plugins/cofoundy-toolkit/scripts/pipeline-report.py (brief.yaml only, older). Trigger currently points to the deals version. Reconciliation pending.

Pending Cron (not yet active)

• Meeting Hub /reminders/send — designed for external cron (WhatsApp reminders), blocked on WhatsApp credentials.

Scripts & Tools

deals/ scripts

cofoundy-toolkit skill scripts

cofoundy-toolkit standalone scripts

cofoundy-business skill scripts

cofoundy-founders skill scripts

Other scripts

Webhooks (incoming — external services POST to us)

Webhooks (outgoing — our services POST to external)

MCP Servers

Active in ~/.claude/settings.json

• Railway MCP — auto-available via Claude Code (Railway project management tools)
• Chrome MCP — browser automation (chrome_navigate, chrome_screenshot, etc.)
• Gmail — gmail_search_messages, gmail_read_message, etc.
• Google Calendar — authenticate (MCP-level, separate from gcal.py)

Per-repo .mcp.json configs

Legacy MCP servers (in core/mcp-servers/, mostly deprecated)

Plugin Inventory

cofoundy-toolkit (v1.18.8)

Access: Everyone. Repo: ~/cofoundy/plugins/cofoundy-toolkit/

Skills (19):

Commands (10):
gitcommit, options, test, visual-audit, whatsapp (WIP), setup (keys provisioning), workspace-setup, research-build, store-key, skill-audit, keys

Agents (4):
landing-reviewer, browser-agent, asset-finder, visual-designer

Hooks (4):
ensure-keys.sh (SessionStart), block-destructive.sh (PreToolUse/Bash), enforce-version-bump.sh (PreToolUse/Bash), guard-keys-json.sh (PreToolUse/Bash)

API Keys managed (auto-provisioned from Vaultwarden):
GEMINI_API_KEY, OPENAI_API_KEY, IMGUR_CLIENT_ID, DISCORD_TOKEN, VIKUNJA_TOKEN, GCALCLI_CLIENT_ID, GCALCLI_CLIENT_SECRET

Infra keys (NOT in toolkit — founders only):
CLOUDFLARE_API_TOKEN, RAILWAY_API_TOKEN — in ~/.claude/settings.json

cofoundy-business (v0.4.4)

Access: Founders + closers + marketing. Repo: ~/cofoundy/plugins/cofoundy-business/

Skills (4):

No commands, agents, hooks, or MCP servers. Inherits all from toolkit.

cofoundy-founders (v0.1.1)

Access: Founders only. Repo: ~/cofoundy/plugins/cofoundy-founders/

Skills (2):

Hooks (1): enforce-version-bump.sh (PreToolUse/Bash)

Repo Inventory

deals/ (Deal Pipeline)

• Purpose: AI-first CRM. Git = database, YAML = schema, Claude Code = UI
• Key files: clients/*/brief.yaml (SSOT per deal), schema/brief.schema.json, Makefile, templates/*.tex
• Skills (11): lead-prep, lead-qualify, lead-close, kickoff, unit-economics, cronograma, brief-dev, project-status, project-close, meeting-report, deals-setup
• Connects to: Vikunja (project creation at kickoff), Discord (deal won notifications), Google Calendar (milestone events), LaTeX (PDF generation)
• Active clients: 47 folders in clients/

handbook/ (Company Handbook)

• Purpose: What we sell, how we talk, how we execute. SSOT for offers + brand
• Key files: offers/ (pricing tiers), positioning/BRAND/BRAND_BOOK_MVP.md, sales/, team.md
• No skills/scripts. Pure reference material read by other repos

core/ (Founder Vault)

• Purpose: Strategy, margins, legal, compensation, founder journal
• Skills (4): contabilidad, rt-coach, comms, onboarding
• Key files: strategy/MONEY_MODEL.md, operations/TEAM.md, pricing/rates.md, log/ (daily journal)
• Legacy MCP servers in: mcp-servers/ (discord, apollo, hubspot, transcriber, vexa-mcp)

leads/ (Lead Generation)

• Purpose: Marketing campaigns, outreach, content, lead qualification
• Skills (7): leads-setup, campaign-plan, campaign-report, lead-capture, lead-handoff, content-calendar, content-post
• Connects to: deals/ (lead handoff creates brief.yaml), handbook/ (reads offers)

products/meeting-hub/ (Meeting Hub)

• Purpose: Recall.ai RT transcripts + Cal.com webhook integration + Discord notifications
• Runtime: FastAPI (Python, uvicorn) on Railway
• Version: 0.7.3
• Key file: server.py (all endpoints)
• Connects to: Recall.ai API, Cal.com webhooks, Discord webhooks, (planned) WhatsApp Cloud API

products/cofoundy-platform/ (White-label AI Platform)

• Purpose: Container for InboxAI, AgendaAI, VoxAI, DocsAI sub-repos
• Sub-repos: inbox-ai, agenda-ai, vox-ai, docs-ai
• Cross-product triggers: intent detection → scheduling → voice call → inbox resume

products/cofoundy-platform/inbox-ai/

• Purpose: Omnichannel messaging hub (WhatsApp, Telegram, IG, Email, Web Chat)
• Stack: NestJS backend + Next.js frontend + Supabase auth + Socket.IO
• Deploy: Railway (backend + frontend + Postgres + Redis)

products/cofoundy-platform/agenda-ai/ (formerly TimelyAI)

• Purpose: Conversational scheduling (natural language → Google Calendar)
• Stack: Python + LangGraph + Google Calendar integration
• Deploy: Railway

products/cofoundy-platform/vox-ai/ (formerly PulseAI)

• Purpose: AI voice agent — calls leads, BANT qualification, live transfer
• Stack: Python + Docker
• Deploy: Railway (planned)

products/cofoundy-platform/docs-ai/

• Purpose: Publish markdown as branded web pages
• Stack: Astro 6 + Cloudflare Pages + D1 analytics database
• URL: docs.cofoundy.dev

packages/ui/ (@cofoundy/ui)

• Purpose: Shared component library (chat widgets, messaging, analytics, UI primitives)
• Stack: React 19, TypeScript, Tailwind, CVA, Zustand, Storybook
• Deploy: Storybook → ui.cofoundy.dev (Cloudflare Pages via GitHub Actions)
• Used by: InboxAI, TimelyAI, Landing Page, VoxAI dashboards

packages/icons/ (@cofoundy/icons)

• Purpose: 99+ curated SVG/PNG brand icons (tech, companies, payments, universities)
• Key file: manifest.json (SSOT), copy-icons.sh

projects/landing-page-v2/ (cofoundy.dev)

• Purpose: Main company website
• Stack: Next.js 16, React 19, Tailwind v4, GSAP, Lenis
• Deploy: GitHub Actions → GitHub Pages
• Integrations: InboxAI chat widget, TimelyAI scheduling, Formspree contact form

projects/landing-page-v3/ (next version)

• Purpose: Redesign of cofoundy.dev
• Status: In development

projects/pollada/ (Portfolio Factory)

• Purpose: Autonomous agent for producing 100+ client portfolio websites
• Stack: Astro, GitHub Pages, Cloudflare DNS
• Deploy: ./scripts/deploy.sh → GitHub Pages (subdomains: *.cofoundy.dev)
• Team: Alvaro (main dev), Melissa (dev + corrections), Freddy (sales), Andre (flows)

projects/client-koopa-notaria-agent/

• Purpose: WhatsApp agent for notary document generation (Koopa S.A.C.)
• Stack: FastAPI + python-docx, WhatsApp via Kapso
• Deploy: Railway (GitHub source, auto-deploy on push)

projects/client-enmancha/

• Purpose: Restaurant group meal offers platform (En Mancha)
• Stack: NestJS backend + Next.js frontend, PostgreSQL, Redis, MercadoPago, Firebase

projects/client-genera/

• Purpose: AI educational platform (GENERA — Startup Peru 12G winner)
• Stack: Next.js 15, Prisma, LangChain, multi-provider AI

projects/client-cinthiaarana/

• Purpose: Architecture portfolio (CAVP Arquitectos)
• Stack: Next.js 16, React 19, Tailwind 4
• Deploy: Vercel

projects/starthack-2026/

• Purpose: Sift — audit-ready autonomous sourcing agent (hackathon showcase)
• Stack: Next.js 14 frontend + FastAPI backend
• Deploy: Railway → sift.cofoundy.dev / sift-api.cofoundy.dev

projects/ralph-claude-code/

• Purpose: Autonomous AI development loop system (Ralph)
• Version: v0.9.1 (145 tests)

projects/demos/

• Purpose: Experimental landing pages and creative demos

tools/whatsapp-reader/

• Purpose: WhatsApp chat export reader (Node.js/TypeScript)

cotizations/vexa-selfhosted/

• Purpose: Vexa self-hosted transcription (legacy/experimental)

Secrets Management

Vaultwarden (vault.cofoundy.dev)

• Provisioner account: provisioner@cofoundy.dev — dedicated read-only service account
• “Toolkit Keys” collection: 7 low-risk keys (Gemini, OpenAI, Imgur, Discord, Vikunja, GCal)
• “Founders Keys” collection: High-risk keys (Railway, Cloudflare, Admin tokens) — founders only
• “AI Keys” collection: Namecheap API credentials

Bootstrap flow

keys.json (GitHub, private) → contains BW_SVC_CLIENT_ID + BW_SVC_CLIENT_SECRET
    → ensure-keys.sh reads on SessionStart
    → authenticates to Vaultwarden
    → provisions keys to ~/.claude/settings.json env block
    → cached in macOS Keychain for speed

Keys currently in ~/.claude/settings.json env block

GEMINI_API_KEY, OPENAI_API_KEY, PERPLEXITY_API_KEY, IMGUR_CLIENT_ID, IMGUR_CLIENT_SECRET, CLOUDFLARE_API_TOKEN, RAILWAY_API_TOKEN, DISCORD_TOKEN, GCALCLI_CLIENT_ID, GCALCLI_CLIENT_SECRET, VIKUNJA_TOKEN, ENABLE_EXPERIMENTAL_MCP_CLI

Data Flows

Lead → Deal → Kickoff → Delivery → Close

1. Lead captured in leads/ (campaign.yaml + lead.yaml)
2. MQL >= 60 → /lead-handoff creates deals/clients/{Name}/brief.yaml (estado: lead)
3. Discovery call booked via Cal.com → Recall.ai bot auto-joins → transcript stored
4. /lead-prep researches the lead, prepares discovery script
5. /lead-qualify evaluates BANT, creates cotizacion.tex or propuesta.html
6. Presentation gate: deal >= $3,000 → schedule live presentation first
7. /lead-close on payment confirmation → BITACORA update, Discord #leads announcement
8. /kickoff → creates Vikunja projects (Delivery + Founders), calendar events, estado → activo
9. Dev builds project, tasks tracked in Vikunja
10. /project-status checks task + payment progress
11. /project-close verifies completion, calculates real margin, generates case study, estado → completado
12. 30-day follow-up task + calendar event created

Cal.com Booking → Recall.ai Bot → Transcript → Discord

1. Client books via cal.cofoundy.dev (event types with consultant round-robin)
2. Cal.com fires BOOKING_CREATED webhook → Meeting Hub /calcom endpoint
3. Meeting Hub schedules Recall.ai bot via POST /api/v1/bot/ (V2 recording_config)
4. Meeting Hub posts Discord notification to #leads with consultant @mention
5. At meeting time, bot joins Google Meet, streams RT transcript
6. RT transcript stored in-memory at Meeting Hub, queryable via GET /recall/transcript/{bot_id}
7. BOOKING_CANCELLED/RESCHEDULED → Discord update

Pipeline Health Check → Discord

1. pipeline_health.py scans all deals/clients/*/brief.yaml where estado = activo
2. Queries Vikunja for overdue tasks per project
3. Checks payment hitos status
4. Posts summary to Discord #clientes-activos (or #leads with --channel flag)

Portfolio Factory (Pollada)

1. Client pays via voucher verification
2. F0: Take client → update TRACKER
3. F1-F6: Research → design → build Astro site
4. F7: Deploy via ./scripts/deploy.sh → GitHub Pages (subdomain.cofoundy.dev)
5. QA: Playwright screenshots (desktop + mobile) → review
6. F8: Deliver → WhatsApp message + link → update TRACKER

Secrets Provisioning

1. Claude Code session starts (any repo)
2. cofoundy-toolkit SessionStart hook fires ensure-keys.sh
3. Script checks macOS Keychain → ~/.claude/settings.json → keys.json bootstrap
4. Authenticates to Vaultwarden as service account
5. Fetches toolkit keys from "Toolkit Keys" collection
6. Writes to ~/.claude/settings.json env block
7. All skills/scripts can now read keys from environment

Storybook / UI Components Deployment

1. Push to packages/ui main branch
2. GitHub Actions deploy.yml: build Storybook → wrangler pages deploy → ui.cofoundy.dev
3. GitHub Actions chromatic.yml: Chromatic visual regression test

Document Publishing (DocsAI)

1. /publish skill copies .md file to docs-ai repo under src/content/docs/
2. Git push to main
3. Cloudflare Pages auto-deploys Astro build
4. Live at docs.cofoundy.dev/{project}/{slug}

Team Systems Mapping

Known Gaps / Blocked Items

1. WhatsApp Reminders (Meeting Hub): /reminders/send endpoint exists but WHATSAPP_API_KEY + WHATSAPP_PHONE_NUMBER_ID not configured. Needs Cofoundy WhatsApp Business number.
2. Billing skill (cofoundy-founders): Skeleton only. Alegra API integration not built. BCP/Shinkansen payment execution not built.
3. gcalcli cleanup: gcal.py replaces gcalcli but some skills still reference gcalcli (kickoff Step 9, project-close Step 10).
4. In-memory transcript store (Meeting Hub): RT transcripts reset on every Railway deploy. No persistent storage.
5. n8n Railway project: Referenced but status unclear.
6. Duplicate pipeline scripts: deals/scripts/pipeline_health.py and toolkit/scripts/pipeline-report.py do overlapping work. Need to merge into one.

Generated by Claude Code systems audit. Review quarterly.