~ / rigs / bernardTavares / bevox-blueprint

bernardTavares/bevox-blueprint

The blueprint of an AI-first company: 63 Claude Code agents across 9 departments, with org chart, RACI, OKRs and processes. FSL-1.1-MIT.

↗ GitHub ★ 0 NOASSERTION updated 11d ago project Claude Code
stack: JavaScript
share on X
ARCHETYPE
MCP Hoarder
Six or more MCP servers wired in. Every tool, always in context.
CONTEXT TAX · EVERY TURN
up to ~30.8k tokens
Claude Code loads MCP tools on demand, so the real cost is usually lower.
Context hog · median rig: 2.3k · breakdown
GUARDRAILS
1/5
No YOLO mode · details
Quality 20/100 Guardrails v2

Copy this rig

# review before running: this installs third-party code
$ claude mcp add stripe -e STRIPE_SECRET_KEY=YOUR_STRIPE_SECRET_KEY -- npx -y @stripe/mcp-server
$ claude mcp add google-calendar -e GOOGLE_SERVICE_ACCOUNT_KEY=YOUR_GOOGLE_SERVICE_ACCOUNT_KEY -- npx -y @google/mcp-server-calendar
$ claude mcp add clerk -e CLERK_SECRET_KEY=YOUR_CLERK_SECRET_KEY -- npx -y @clerk/mcp-server
$ claude mcp add serpapi -e SERP<redacted> -- npx -y serpapi-mcp
$ claude mcp add reddit -e REDDIT_CLIENT_ID=YOUR_REDDIT_CLIENT_ID -e REDDIT_CLIENT_<redacted> -- npx -y mcp-server-reddit
$ claude mcp add openai -e OPENAI_<redacted> -- npx -y mcp-server-openai
$ claude mcp add perplexity -e PERPLEXITY_<redacted> -- npx -y perplexity-mcp
$ npx degit bernardTavares/bevox-blueprint/.claude ./rig-bevox-blueprint  # inspect, then merge into .claude/

MCP servers are added to Claude Code at local scope; env vars are shown as YOUR_… placeholders — we never store values. Files are fetched with degit into a separate folder so you can review before merging.

$ claude mcp add stripe -e STRIPE_SECRET_KEY=YOUR_STRIPE_SECRET_KEY -- npx -y @stripe/mcp-server
$ claude mcp add google-calendar -e GOOGLE_SERVICE_ACCOUNT_KEY=YOUR_GOOGLE_SERVICE_ACCOUNT_KEY -- npx -y @google/mcp-server-calendar
$ claude mcp add clerk -e CLERK_SECRET_KEY=YOUR_CLERK_SECRET_KEY -- npx -y @clerk/mcp-server
$ claude mcp add serpapi -e SERP<redacted> -- npx -y serpapi-mcp
$ claude mcp add reddit -e REDDIT_CLIENT_ID=YOUR_REDDIT_CLIENT_ID -e REDDIT_CLIENT_<redacted> -- npx -y mcp-server-reddit
$ claude mcp add openai -e OPENAI_<redacted> -- npx -y mcp-server-openai
$ claude mcp add perplexity -e PERPLEXITY_<redacted> -- npx -y perplexity-mcp
$ npx degit bernardTavares/bevox-blueprint/.claude/skills/bevox-knowledge-read .claude/skills/bevox-knowledge-read
$ npx degit bernardTavares/bevox-blueprint/.claude/skills/cost-monitor .claude/skills/cost-monitor
$ npx degit bernardTavares/bevox-blueprint/.claude/skills/format-board-report .claude/skills/format-board-report
$ npx degit bernardTavares/bevox-blueprint/.claude/skills/gh-issue-from-feedback .claude/skills/gh-issue-from-feedback
$ npx degit bernardTavares/bevox-blueprint/.claude/skills/okr-rollup .claude/skills/okr-rollup
$ npx degit bernardTavares/bevox-blueprint/.claude/skills/stripe-reconciler .claude/skills/stripe-reconciler
$ npx degit bernardTavares/bevox-blueprint/.claude/skills/whatsapp-health-probe .claude/skills/whatsapp-health-probe
$ curl -fsSL --create-dirs -o .claude/agents/account-executive.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/account-executive.md
$ curl -fsSL --create-dirs -o .claude/agents/bdr.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/bdr.md
$ curl -fsSL --create-dirs -o .claude/agents/billing-analyst.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/billing-analyst.md
$ curl -fsSL --create-dirs -o .claude/agents/ceo.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/ceo.md
$ curl -fsSL --create-dirs -o .claude/agents/cfo.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/cfo.md
$ curl -fsSL --create-dirs -o .claude/agents/chro.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/chro.md
$ curl -fsSL --create-dirs -o .claude/agents/cmo.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/cmo.md
$ curl -fsSL --create-dirs -o .claude/agents/company-os-liaison.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/company-os-liaison.md
$ curl -fsSL --create-dirs -o .claude/agents/coo.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/coo.md
$ curl -fsSL --create-dirs -o .claude/agents/cpo.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/cpo.md
$ curl -fsSL --create-dirs -o .claude/agents/cto.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/cto.md
$ curl -fsSL --create-dirs -o .claude/agents/data-analyst.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/data-analyst.md
$ curl -fsSL --create-dirs -o .claude/agents/design-brand-guardian.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/design-brand-guardian.md
$ curl -fsSL --create-dirs -o .claude/agents/design-image-prompt-engineer.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/design-image-prompt-engineer.md
$ curl -fsSL --create-dirs -o .claude/agents/design-inclusive-visuals.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/design-inclusive-visuals.md
$ curl -fsSL --create-dirs -o .claude/agents/design-persona-walkthrough.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/design-persona-walkthrough.md
$ curl -fsSL --create-dirs -o .claude/agents/design-ui-designer.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/design-ui-designer.md
$ curl -fsSL --create-dirs -o .claude/agents/design-ux-architect.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/design-ux-architect.md
$ curl -fsSL --create-dirs -o .claude/agents/design-ux-researcher.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/design-ux-researcher.md
$ curl -fsSL --create-dirs -o .claude/agents/design-visual-storyteller.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/design-visual-storyteller.md
$ curl -fsSL --create-dirs -o .claude/agents/digester-okr.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/digester-okr.md
$ curl -fsSL --create-dirs -o .claude/agents/eng-autonomous-optimization-architect.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/eng-autonomous-optimization-architect.md
$ curl -fsSL --create-dirs -o .claude/agents/eng-code-reviewer.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/eng-code-reviewer.md
$ curl -fsSL --create-dirs -o .claude/agents/eng-devops-automator.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/eng-devops-automator.md
$ curl -fsSL --create-dirs -o .claude/agents/eng-frontend-developer.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/eng-frontend-developer.md
$ curl -fsSL --create-dirs -o .claude/agents/eng-incident-response-commander.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/eng-incident-response-commander.md
$ curl -fsSL --create-dirs -o .claude/agents/eng-multi-agent-systems-architect.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/eng-multi-agent-systems-architect.md
$ curl -fsSL --create-dirs -o .claude/agents/eng-prompt-engineer.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/eng-prompt-engineer.md
$ curl -fsSL --create-dirs -o .claude/agents/eng-security-engineer.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/eng-security-engineer.md
$ curl -fsSL --create-dirs -o .claude/agents/eng-software-architect.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/eng-software-architect.md
$ curl -fsSL --create-dirs -o .claude/agents/fin-accounts-payable-manager.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/fin-accounts-payable-manager.md
$ curl -fsSL --create-dirs -o .claude/agents/fin-accounts-receivable-manager.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/fin-accounts-receivable-manager.md
$ curl -fsSL --create-dirs -o .claude/agents/fin-financial-analyst.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/fin-financial-analyst.md
$ curl -fsSL --create-dirs -o .claude/agents/fin-financial-controller.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/fin-financial-controller.md
$ curl -fsSL --create-dirs -o .claude/agents/fin-fp-and-a-manager.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/fin-fp-and-a-manager.md
$ curl -fsSL --create-dirs -o .claude/agents/fin-tax-strategist.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/fin-tax-strategist.md
$ curl -fsSL --create-dirs -o .claude/agents/fin-treasury-manager.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/fin-treasury-manager.md
$ curl -fsSL --create-dirs -o .claude/agents/head-of-customer-success.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/head-of-customer-success.md
$ curl -fsSL --create-dirs -o .claude/agents/head-of-engineering.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/head-of-engineering.md
$ curl -fsSL --create-dirs -o .claude/agents/head-of-finance.md https://raw.githubusercontent.com/bernardTavares/bevox-blueprint/main/.claude/agents/head-of-finance.md

Merge into .claude/settings.json (project) or ~/.claude/settings.json (user). Hook commands reference scripts in the source repo — copy those too.

{
  "permissions": {
    "deny": [
      "Bash(schtasks:*)",
      "Bash(crontab:*)"
    ]
  }
}

MCP servers (9)

serversourceest. tokens
Stripe
env: STRIPE_SECRET_KEY
npm 6.0k
@google/mcp-server-calendar · "google-calendar"
env: GOOGLE_SERVICE_ACCOUNT_KEY
npm 2.5k
@clerk/mcp-server · "clerk"
env: CLERK_SECRET_KEY
npm 2.5k
meta-ads
env: META_ADS_ACCESS_TOKEN, META_ADS_ACCOUNT_ID
local / custom 2.5k
serpapi-mcp · "serpapi"
env: SERPAPI_KEY
npm 2.5k
mcp-server-reddit · "reddit"
env: REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET
npm 2.5k
cms-site
env: CMS_API_KEY, CMS_SITE_ID
local / custom 2.5k
mcp-server-openai · "openai"
env: OPENAI_API_KEY
npm 2.5k
Perplexity
env: PERPLEXITY_API_KEY
npm 1.0k

Skills (7)

Subagents (63)

account-executive
model: claude-sonnet-4-5
Bevox Account Executive — owns SQL-to-closed-won pipeline for Brazilian SMB ICP. Invoked for: deal qualification, demo prep, objection handling, pricing questions, CRM hygiene, pipeline review.
bdr
model: claude-sonnet-4-5
Bevox BDR — owns outbound prospecting and qualification for Brazilian SMB appointment businesses. Invoked for: prospect list building, WhatsApp outreach drafting, qualification scoring, CRM updates, p
billing-analyst
model: claude-sonnet-4-5
Bevox Billing Analyst — owns Stripe Connect reconciliation, Pix/card payout verification, chargeback handling, and BR fiscal compliance checks. Invoked for: payment anomalies, reconciliation runs, inv
ceo
model: claude-opus-4-5
Use PROACTIVELY for company-level strategy, capital/attention allocation, and final-call decisions when two C-suite agents disagree. Maintains the single source of truth for Bevox priorities.
cfo
model: claude-opus-4-5
Use for budget questions, runway/burn analysis, pricing economics, scenario modelling, and Stripe Connect revenue flows for Bevox. Owns the financial model.
chro
model: claude-opus-4-5
Use for hiring-plan trade-offs, comp/levelling, performance management, and policy interpretation at Bevox. Owns the people playbook and the hiring process.
cmo
model: claude-opus-4-5
Use for positioning calls, channel-mix trade-offs, launch readiness, and brand-vs-performance budget for Bevox. Owns the messaging house and brand voice.
company-os-liaison
model: claude-sonnet-4-5
Bevox Company OS Liaison — read-only bridge between the blueprint's management personas and the real Company OS / OpenClaw operating layer. Invoked for: reporting real project status/progress from the
coo
model: claude-opus-4-5
Use for cross-functional execution, SLA breaches, process design, and "who owns this?" disputes at Bevox. Owns the operating cadence and customer lifecycle ops.
cpo
model: claude-opus-4-5
Use for "should we build this?", roadmap trade-offs, prioritization disputes, PMF analysis, and pricing model decisions for Bevox. Owns the roadmap.
cto
model: claude-opus-4-5
Use for architectural trade-offs, "is this safe to ship" calls, security/compliance posture, and senior eng decisions across the Bevox codebase. Owns ADRs.
data-analyst
model: claude-sonnet-4-5
Bevox Data Analyst — owns product analytics (activation, TTV, WAU/MAU, cohort retention), OKR KR measurement, and GTM funnel metrics on Postgres + pgvector. Invoked for: usage reports, cohort analysis
design-brand-guardian
model: claude-sonnet-4-5
Bevox Brand Guardian — guardian of the Bevox identity: palette, typography, voice and tone (Portuguese-first; the tone of a competent, human secretary — never a robot). Continuously audits the output
design-image-prompt-engineer
model: claude-sonnet-4-5
Bevox Image Prompt Engineer — writes structured prompts for AI image generation, holding visual consistency across all assets in a single campaign. Every prompt containing human representation passes
design-inclusive-visuals
model: claude-sonnet-4-5
Bevox Inclusive Visuals — mandatory review of any image containing human representation before final approval, countering the bias of generative models. Brazilian context: authentic representation of
design-persona-walkthrough
model: claude-sonnet-4-5
Bevox Persona Walkthrough — simulates the four real Bevox personas navigating the interfaces to surface friction that analytics cannot capture. Complementary to design-ux-researcher: the researcher co
design-ui-designer
model: claude-sonnet-4-5
Bevox UI Designer — turns the UX Architect's foundation and the Brand Guardian's identity into concrete components with development-ready specs (shadcn/ui on web, React Native on mobile). Accessibilit
design-ux-architect
model: claude-sonnet-4-5
Bevox UX Architect — defines the technical design foundation for every Bevox surface: design system, tokens, grid, component patterns, and information architecture (bevox-web / bevox-console / bevox-s
design-ux-researcher
model: claude-sonnet-4-5
Bevox UX Researcher — runs user research against the four Bevox personas (owner/manager, attending professional, human operator/receptionist, and the AI secretary itself as a persona). Delivers person
design-visual-storyteller
model: claude-sonnet-4-5
Bevox Visual Storyteller — turns Bevox features and customer results into visual narratives for Bevox's own channels (Instagram Reels/posts, LinkedIn, bevox-site). Primary interface between design and
digester-okr
model: claude-sonnet-4-5
OKR Digester (CEO weekly duty) — reads okrs/q4-corporate.md and department KR files every Monday, computes per-KR progress against targets, classifies each KR as on-track / at-risk / off-track, emits
eng-autonomous-optimization-architect
model: claude-opus-4-5
Bevox Autonomous Optimization Architect — governs Claude API model routing inside bevox-harness: selects the right Claude model per pipeline step, runs shadow A/B tests on new models, enforces cost ci
eng-code-reviewer
model: claude-opus-4-5
Use to review any code change before it reaches production — correctness, security, LGPD compliance, performance, and test coverage. Invoke on PRs touching bevox-backend, bevox-harness, bevox-meta-api
eng-devops-automator
model: claude-opus-4-5
Bevox DevOps Automator — owns CI/CD pipelines for all 8 Bevox modules, Docker-based deployments, zero-downtime Fastify releases, Expo EAS mobile builds, Postgres migration safety, and secrets hygiene
eng-frontend-developer
model: claude-opus-4-5
Use for all frontend work on bevox-web (Next.js 14 customer portal), bevox-console (internal backoffice), and bevox-site (marketing site). Invoke for UI implementation, component development, Clerk au
eng-incident-response-commander
model: claude-opus-4-5
Use during active production incidents or to build incident readiness — severity classification, real-time coordination, post-mortem facilitation, runbook design, SLO/error-budget frameworks. Invoke w
eng-multi-agent-systems-architect
model: claude-opus-4-5
Use for designing, stress-testing, and governing Bevox's multi-agent AI pipelines — harness topology, context budget, failure modes, HITL gate placement, and observability. Invoke when deciding how ag
eng-prompt-engineer
model: claude-opus-4-5
Use for designing, versioning, testing, and optimizing prompts for bevox-harness agents. Invoke when writing or reviewing system prompts for any harness agent, building prompt eval suites, debugging o
eng-security-engineer
model: claude-opus-4-5
Bevox Security Engineer — owns application security across all 8 modules: LGPD enforcement in code, multi-tenant Postgres isolation, Stripe/Pix secrets hygiene, prompt injection defense in bevox-harne
eng-software-architect
model: claude-opus-4-5
Bevox Software Architect — owns ADR authorship, module boundary design across the 8 Bevox modules, domain modeling for the appointment scheduling domain, and API contract governance between services.
fin-accounts-payable-manager
model: claude-sonnet-4-5
Bevox Accounts Payable Manager — validates vendor invoices against approved requests, executes payments already cleared by the CFO/FP&A/Treasury pipeline, and optimizes payment timing within agreed te
fin-accounts-receivable-manager
model: claude-sonnet-4-5
Bevox Accounts Receivable Manager — issues invoices for approved billing events, runs the escalating collections cadence on overdue accounts, and produces credit-risk assessments on new or higher-expo
fin-financial-analyst
model: claude-sonnet-4-5
Bevox Financial Analyst — produces impact analysis and scenario modelling for financial requests before the CFO decides. Invoked for: new-spend evaluation, investment/ROI research, scenario modelling
fin-financial-controller
model: claude-sonnet-4-5
Bevox Financial Controller — books each transaction (AP payments, AR invoices) into the ledger at the moment it occurs, keeping the book audit-ready between monthly closes, and flags anomalies as they
fin-fp-and-a-manager
model: claude-sonnet-4-5
Bevox FP&A Manager — builds and maintains the annual financial plan, runs the budget-availability checkpoint on flagged requests, and owns variance analysis (the why, not just the how much). Invoked f
fin-tax-strategist
model: claude-sonnet-4-5
Bevox Tax Strategist — produces the tax-implication parecer for financial requests flagged by the Financial Analyst, and owns the company's structural tax position (regime, entity structure, fiscal cr
fin-treasury-manager
model: claude-sonnet-4-5
Bevox Treasury Manager — monitors daily cash position, maintains the rolling 13-week cash projection, calculates burn rate and runway continuously, and confirms cash availability for specific approved
head-of-customer-success
model: claude-sonnet-4-5
Bevox Head of Customer Success — owns NRR/GRR, churn prevention, health scoring, onboarding TTV, and the churn-risk-scan cron duty. Invoked for: at-risk account triage, onboarding checklist execution,
head-of-engineering
model: claude-opus-4-5
Bevox Head of Engineering — owns delivery throughput, Fastify/Postgres/BullMQ stack health, and the first engineering hires. Invoked for: architecture review, PR triage, incident response, sprint plan
head-of-finance
model: claude-sonnet-4-5
Bevox Head of Finance — owns monthly close, Stripe Connect reconciliation, runway monitoring, payroll, and Brazilian tax compliance. Invoke for: Stripe settlement questions, runway status, accounts pa

Hooks (1)

eventmatcherruns
SessionStart*bash .claude/hooks/SessionStart.sh

Slash commands (4)

/okr-review/onboard-customer/standup/status

Permissions

deny (2)
Bash(schtasks:*)
Bash(crontab:*)
ask (0)
—
allow (9)
Read(docs/**)
Read(.claude/agents/**)
Read(.claude/rules/**)
Read(.loop/missions/**)
Read(.loop/decisions.md)
Read(.loop/strategy.md)
Bash(git log:*)
Bash(git status:*)
Bash(git diff:*)

Similar rigs

copied ✓