Skip to content

Instantly share code, notes, and snippets.

@RupertBarrow
Created March 16, 2026 06:22
Show Gist options
  • Select an option

  • Save RupertBarrow/55d4a06f5243aefcf8a064079ea0a10b to your computer and use it in GitHub Desktop.

Select an option

Save RupertBarrow/55d4a06f5243aefcf8a064079ea0a10b to your computer and use it in GitHub Desktop.
Rapido FAB — Strategic Requirements (Paperclip Market Analysis, 2026-03-16)

Rapido FAB — Strategic Requirements Document

Date: 2026-03-16 Author: Claudia (Operations Director) For: Rupert Barrow, President of the Board Classification: Internal — Strategic Version: 1.0


Executive Summary

The AI agent orchestration market is real and growing fast. Paperclip's launch (25k+ GitHub stars in 14 days) confirms what we've been building: businesses want structured, governed agent teams — not isolated chatbots. This market signal validates our FAB architecture.

This document does not ask "what should we copy from Paperclip?" It asks: "What capabilities create the most value for Rapido, and in what order should we invest?"

Each requirement below stands on its own economic merits. Paperclip serves as market evidence — proof that demand exists — but our roadmap is driven by client value, operational efficiency, and competitive moat. We implement what creates returns, not what creates parity.

Six strategic requirements are identified, representing an estimated combined annual value of €180k–€420k through new revenue, cost savings, client retention, and market positioning. Each requires a focused research phase before implementation begins.


Market Context

What Paperclip Tells Us About Demand

Paperclip's explosive adoption reveals three market truths:

  1. Org-structured agent teams are the next layer. Individual AI agents are commoditizing. The value is shifting to orchestration — how agents collaborate, delegate, and maintain quality. This is exactly what FAB does.

  2. Cost governance is a hard requirement. Paperclip built per-agent budgets with auto-pause as a core feature, not an add-on. Enterprises won't adopt agent teams without spend control. Our current batch simulation mode is a cost tracker, not a cost governor.

  3. Visibility sells. Paperclip's polished React dashboard with live streaming and mobile PWA is a major driver of adoption. Decision-makers need to see their agent team working, not trust a read-only status page.

What Paperclip Does NOT Tell Us

  • Whether their users deploy to production (the project is 14 days old)
  • Whether ticket-only communication scales for real client work
  • Whether "zero-human companies" is a viable model or a marketing hook
  • Whether the template marketplace (ClipMart) will generate revenue

Our Structural Advantages (Already Built)

These are competitive moats that no open-source project can replicate quickly:

Advantage Why It Matters
CMMI L2 process gates Enforced quality: every project has a plan, test strategy, and post-mortem
Agent identity system (SOUL.md, memory, team genetics) Agents accumulate knowledge and maintain consistent behavior across sessions
Orchestrator validation loop Completed work is reviewed before delivery — not just "agent said done"
Native communication (Telegram + Slack) Agents participate in real conversations, not just consume tickets
Production track record Real Salesforce migrations, real content, real client deliverables
Spec-driven development Every change follows spec → branch → implement → test → validate → merge

Strategic Requirements

REQ-1: Agent Cost Governance

Requirement: Implement per-agent and per-project budget enforcement with automatic throttling, real-time spend visibility, and configurable alert thresholds.

Business Case

Today, API costs are tracked but not governed. Any agent can consume unlimited tokens without constraint. As we scale from 6 agents to 10+ and take on more client work, uncontrolled spend is a direct margin risk.

This isn't about what Paperclip has. It's about what every client will ask before signing a contract: "How do you control costs?" Without a concrete answer, we lose deals.

Economic Value

Value Driver Estimate Basis
Cost reduction €500–€2,000/month Budget caps prevent runaway API consumption (estimated 15–30% waste reduction on projected €3k–€7k/month API spend at scale)
Client acquisition 2–3 additional clients/year Cost governance is a gating requirement for enterprise buyers; without it, we can't credibly propose managed agent services
Revenue per client €2,000–€5,000/month Managed agent services with transparent cost reporting command premium pricing
Annual impact €54k–€132k Combined cost savings + new revenue from credible cost governance story

ROI Indicator

Implementation cost: ~40h engineering (Devdas). At €150/h loaded cost = €6,000. Payback period: 1–2 months.

First Research Step

Item Detail
What to research Current actual API spend per agent per month; identify top 3 cost drivers; benchmark against Paperclip's budget model; survey 5 prospective clients on cost governance requirements
Data to gather 30 days of API cost data (from OpenClaw gateway logs), broken down by agent, task type, and model; Paperclip's budget enforcement architecture (source code review of their budget module)
Success looks like A cost baseline document showing spend per agent, a draft budget policy (default caps per agent role), and a technical design for enforcement hooks in the FAB plugin
Time estimate 1 week (research) + 2 weeks (implementation)
Owner Claudia (research) → Devdas (implementation)

Market Validation

Paperclip ships this as a core feature. Their per-agent monthly budget with auto-pause at 100% and warning at 80% is the baseline expectation. We need to meet or exceed this.


REQ-2: Interactive Operations Dashboard

Requirement: Upgrade the FAB dashboard from read-only monitoring to an interactive operations console with live agent output streaming, task management, and mobile access.

Business Case

Our current Vercel dashboard shows state — it doesn't enable action. When Rupert or a client wants to see what agents are doing, they get a static snapshot. When a task needs intervention, they switch to Slack or Telegram.

The real value isn't a pretty UI. It's operational efficiency: fewer context switches, faster intervention, and a client-facing demo that sells managed services without a slide deck.

Economic Value

Value Driver Estimate Basis
Operational efficiency 5–8h/week saved Reduced context-switching between dashboard, Slack, and Telegram for task management; faster incident response
Client demos & sales €30k–€60k/year A polished, interactive dashboard is the #1 sales tool for managed agent services. It replaces PowerPoint with live proof. Estimated 1–2 additional client conversions/year at €2k–€5k/month
Client self-service €10k–€20k/year Clients who can see their agent work in real-time require less hand-holding (reduced support load: ~5h/week at scale)
Annual impact €55k–€110k Combined efficiency + revenue + support reduction

ROI Indicator

Implementation cost: ~80h engineering (Devdas) = €12,000. Significant investment, but the sales impact alone justifies it within Q2.

First Research Step

Item Detail
What to research Audit current dashboard usage (who uses it, how often, what they look for); define the 5 critical interactions needed (not a full feature list); evaluate build-vs-integrate options (enhance current Vercel app, adopt open-source dashboard framework, or integrate Paperclip's UI components)
Data to gather Current dashboard access logs; interview Rupert on what he checks daily; review Paperclip's React dashboard architecture and component library; assess WebSocket relay capacity for live streaming
Success looks like A prioritized feature list (max 8 items for v1), a tech decision (build/buy/adapt), and a wireframe of the primary view
Time estimate 1 week (research + wireframes) + 4 weeks (implementation of v1)
Owner Claudia (requirements) → Devdas (implementation)

Market Validation

Paperclip's React PWA with live streaming and mobile support is a reference implementation. Their open-source code (MIT) can inform our architecture without requiring adoption.


REQ-3: Goal Hierarchy & Mission Alignment

Requirement: Extend the OTM task system with a 4-level goal cascade: Company Mission → Project Goal → Agent Goal → Task. Every task prompt must carry its full ancestry.

Business Case

Today, tasks reference projects but don't carry the why. An agent working on a Salesforce migration knows what to do but not how it connects to the client engagement goal or Rapido's quarterly revenue target. This creates two problems:

  1. Agents make suboptimal decisions when they lack strategic context (choosing speed over quality when the project requires quality, or vice versa).
  2. Reporting to clients and the board requires manual context-stitching — connecting tasks to goals to outcomes.

Economic Value

Value Driver Estimate Basis
Decision quality Hard to quantify directly Agents with mission context make better trade-offs; estimated 10–15% reduction in rework from misaligned decisions
Reporting efficiency 3–5h/week saved Automated goal→task traceability eliminates manual status report assembly
Client transparency Retention benefit Clients who see their goals tracked through to task completion renew contracts. Estimated 1 additional renewal/year = €24k–€60k
Annual impact €30k–€75k Combined efficiency + retention

ROI Indicator

Implementation cost: ~15h (prompt template updates + OTM spec revision) = €2,250. This is a high-leverage, low-cost change.

First Research Step

Item Detail
What to research Define the goal hierarchy schema (fields, relationships, storage); audit current OTM §6 prompt templates for context gaps; review 10 recent tasks and identify cases where goal context would have changed the outcome
Data to gather Current project goals (from PROJECT-PLAN.md files); Rapido's company mission statement; sample of task prompts with and without goal context (A/B quality comparison)
Success looks like A goal hierarchy schema, updated OTM §6 prompt templates with goal ancestry injection, and a before/after comparison on 5 sample tasks
Time estimate 3 days (schema + template updates)
Owner Claudia (schema + templates) → Devdas (OTM spec update)

Market Validation

Paperclip's 4-level cascade (Mission → Project → Agent → Task) is the standard model. Our implementation should match or exceed this depth while leveraging our existing project registry.


REQ-4: Immutable Audit Trail & Compliance Readiness

Requirement: Implement an append-only, queryable audit log covering all agent actions, tool calls, task state transitions, and configuration changes. Design for ISO 27001 compliance evidence requirements.

Business Case

Rapido targets enterprise clients, including those in regulated industries (HealthTech, MedTech — cf. our ISO 27001 skill). These clients require demonstrable audit trails. Currently, our task_log and JSON traces exist but are:

  • Mutable (can be overwritten)
  • Not queryable (flat files)
  • Not structured for compliance evidence

Building this now — before we need it for a client audit — is 10x cheaper than retrofitting under deadline.

Economic Value

Value Driver Estimate Basis
Market access €50k–€120k/year Opens regulated-industry client segments (HealthTech, finance, public sector) that require audit trail compliance
Compliance cost avoidance €10k–€20k Building audit infrastructure proactively vs. retrofitting under audit pressure (industry benchmark: 3–5x cost multiplier for reactive compliance)
Internal governance Reduced incident investigation time Queryable logs cut root-cause analysis from hours to minutes
Annual impact €60k–€140k Market access + cost avoidance

ROI Indicator

Implementation cost: ~30h engineering = €4,500. The regulated-market access alone justifies this investment if it enables even one HealthTech engagement.

First Research Step

Item Detail
What to research ISO 27001 Annex A requirements for logging and monitoring (A.12.4); evaluate storage options (append-only PostgreSQL table, write-once object storage, or blockchain-anchored hashing); define retention policy; review Paperclip's audit log architecture
Data to gather ISO 27001 audit evidence requirements (from our existing ISO 27001 skill documentation); current log volume and growth rate; client RFP requirements from 3 recent proposals
Success looks like An audit log schema, a storage architecture decision, a retention policy document, and a compliance mapping (log fields → ISO 27001 controls)
Time estimate 1 week (research + design) + 2 weeks (implementation)
Owner Claudia (compliance mapping) → Devdas (implementation)

Market Validation

Paperclip includes an append-only audit log with tool-call tracing and config versioning with rollback. This is becoming table-stakes for enterprise agent platforms.


REQ-5: Positioning & Sales Enablement

Requirement: Produce a client-facing positioning document, a competitive FAQ, and a standard demo script that articulate Rapido FAB's value proposition relative to the emerging agent orchestration market.

Business Case

Clients and prospects will ask about Paperclip and similar platforms. "Why should we hire Rapido when we could just deploy Paperclip ourselves?" Without prepared answers, we lose credibility — not because the answer is bad, but because fumbling it signals we haven't thought about it.

Our answer is strong: Paperclip is a platform; Rapido is a practice. A platform without expertise, process maturity, and domain knowledge is just infrastructure. We sell outcomes, not software. But this answer needs to be polished, rehearsed, and backed by evidence.

Economic Value

Value Driver Estimate Basis
Win rate improvement 10–20% increase Prepared competitive positioning prevents deal losses from "DIY with Paperclip" objections
Revenue protection €24k–€60k/year At current pipeline, preventing 1–2 lost deals/year through better positioning
Brand authority Hard to quantify Being articulate about the market landscape positions Rapido as a thought leader, not a follower
Annual impact €24k–€60k Revenue protection + brand positioning

ROI Indicator

Implementation cost: ~20h (Claudia + Archibald) = €3,000. Immediate payback if it saves even one deal.

First Research Step

Item Detail
What to research Compile the 5 most likely client objections about DIY orchestration; gather 3 case studies of Rapido FAB production work (Salesforce migration, content delivery, project management); identify our top 3 differentiators with quantifiable proof points
Data to gather Client conversation logs (what questions do prospects ask?); Rapido FAB production metrics (tasks completed, quality rates, delivery timelines); competitor landscape beyond Paperclip (CrewAI, AutoGen, LangGraph)
Success looks like A 2-page positioning document, a 1-page competitive FAQ, and a 15-minute demo script with live dashboard walkthrough
Time estimate 1 week
Owner Claudia (strategy + FAQ) → Archibald (document production + publication)

Market Validation

The existence of Paperclip (and CrewAI, AutoGen, etc.) means every client conversation will include "Why not open-source?" We need ready answers.


REQ-6: Platform Evaluation & Build-vs-Adopt Decision

Requirement: Conduct a structured technical evaluation of Paperclip's codebase to determine whether specific components (task management, dashboard, agent adapters) should be adopted, adapted, or ignored — and whether contributing Rapido's process maturity features upstream is strategically beneficial.

Business Case

Building everything ourselves is expensive. Adopting without evaluation is risky. The right answer is a deliberate build-vs-adopt decision per component, based on code quality, architectural fit, maintenance burden, and strategic alignment.

This is not about "should we switch to Paperclip." It's about whether specific open-source components can reduce our engineering costs while we focus investment on our differentiators (process maturity, identity system, communication, domain skills).

Economic Value

Value Driver Estimate Basis
Engineering cost reduction €10k–€30k/year If we can adopt 2–3 Paperclip components instead of building from scratch, we save ~100–200h of engineering annually
Community leverage Hard to quantify Open-source components improve through community contribution — bugs found faster, features added by others
Strategic positioning Thought leadership Contributing our CMMI gates and validation loop upstream establishes Rapido as the "enterprise governance" voice in the agent orchestration community
Annual impact €10k–€30k Direct engineering savings + strategic positioning

ROI Indicator

Research cost: ~20h = €3,000. If it prevents even one unnecessary build decision, it pays for itself.

First Research Step

Item Detail
What to research Clone the Paperclip repo; assess code quality (test coverage, architecture, documentation); evaluate 3 specific components: (1) ticket/task system, (2) dashboard React app, (3) agent adapter interface; identify integration points with OpenClaw
Data to gather Lines of code and test coverage per module; dependency tree and security audit (npm audit); architecture diagrams (or reverse-engineer from code); contribution guidelines and governance model
Success looks like A component-level evaluation matrix (adopt/adapt/ignore per component), a risk assessment for each adoption candidate, and a recommendation on upstream contribution
Time estimate 2 weeks (deep technical evaluation)
Owner Devdas (code review) → Claudia (strategic assessment)

Market Validation

Paperclip is MIT-licensed with 20+ contributors and active development. The codebase is 14 days old — early enough to evaluate architecture without legacy baggage, but too early to depend on for production.


Implementation Roadmap

Phase 1: Research & Foundation (Weeks 1–2)

Requirement Research Deliverable Owner
REQ-1 Cost Governance Cost baseline + budget policy draft Claudia
REQ-3 Goal Hierarchy Schema + updated prompt templates Claudia
REQ-5 Positioning Positioning doc + competitive FAQ Claudia + Archibald

Why these first: REQ-1 and REQ-5 are the highest-impact, lowest-cost items. REQ-3 is a quick win that improves agent decision quality immediately. All three research phases can run in parallel.

Phase 2: Core Build (Weeks 3–6)

Requirement Implementation Owner
REQ-1 Cost Governance Budget enforcement in FAB plugin Devdas
REQ-4 Audit Trail Append-only log infrastructure Devdas
REQ-6 Platform Evaluation Paperclip codebase review Devdas + Claudia

Why this order: REQ-1 is the highest economic priority. REQ-4 is foundational infrastructure that REQ-2 (dashboard) will build on. REQ-6 informs whether REQ-2 should build or adopt.

Phase 3: Visibility & Market (Weeks 7–10)

Requirement Implementation Owner
REQ-2 Dashboard Interactive dashboard v1 Devdas
REQ-5 Positioning Demo script + client-facing materials Archibald

Why last: The dashboard is the most expensive item and benefits from decisions made in Phase 2 (REQ-6 build-vs-adopt). The demo script is most effective when it can showcase the dashboard.


Risk Register

# Risk Likelihood Impact Mitigation
R1 Market commoditization — open-source platforms make orchestration free, eroding our value proposition Medium High Differentiate on process maturity, domain expertise, and production track record (REQ-5). Platform is infrastructure; we sell outcomes.
R2 Client "DIY" objection — prospects choose to deploy Paperclip themselves instead of hiring Rapido High Medium Prepared positioning (REQ-5) + demonstrate that platform ≠ practice. Our process gates, identity system, and domain skills are the moat.
R3 Engineering overload — attempting all 6 requirements simultaneously overwhelms the team Medium High Phased roadmap with clear sequencing. No more than 2 engineering-heavy items per phase.
R4 Paperclip instability — adopting components from a 14-day-old project introduces fragility Medium Medium REQ-6 evaluates before any adoption. No production dependency on Paperclip before v1.0+.
R5 Cost governance implementation gaps — budget enforcement that's too rigid disrupts agent productivity Low Medium Configurable thresholds, soft warnings before hard stops, board override capability. Test with internal agents before client deployment.
R6 Opportunity cost — investing in infrastructure delays client-revenue work Medium Medium Phase 1 items (REQ-1, REQ-3, REQ-5) are low-cost / high-leverage. Heavy engineering (REQ-2, REQ-4) is deferred to Phase 2–3, after revenue-generating positioning work is complete.

Summary of Economic Impact

Requirement Annual Value Estimate Implementation Cost Payback
REQ-1 Cost Governance €54k–€132k €6,000 1–2 months
REQ-2 Interactive Dashboard €55k–€110k €12,000 2–3 months
REQ-3 Goal Hierarchy €30k–€75k €2,250 < 1 month
REQ-4 Audit Trail €60k–€140k €4,500 1–2 months
REQ-5 Positioning €24k–€60k €3,000 Immediate
REQ-6 Platform Evaluation €10k–€30k €3,000 1–2 months
Total €233k–€547k €30,750 < 3 months avg

Note: Value estimates include overlap (e.g., the same client deal may be influenced by multiple requirements). Conservative de-duplicated range: €180k–€420k/year.


Appendix A: Paperclip Reference Facts

Paperclip is referenced as market evidence throughout this document. Key facts for context:

  • Repo: github.com/paperclipai/paperclip (MIT license)
  • Launch: 2026-03-02 (14 days old at time of this document)
  • Traction: 25,213 GitHub stars, 3,364 forks, 20+ contributors
  • Growth: ~2,100 stars/day — exceptional for any open-source project
  • Version: v0.3.1 (pre-1.0, rapid iteration)
  • Creator: Dotta (cryppadotta) — crypto/NFT background, CEO of Forgotten Runes
  • Tech: TypeScript, React dashboard, PostgreSQL, 8+ agent adapters
  • Key features: Org chart hierarchy, per-agent budgets with auto-pause, ticket system, immutable audit log, PWA dashboard, company templates
  • Revenue model: Open source + planned ClipMart marketplace (template trading)
  • Press: eWeek, TopAIProduct, trending on GitHub/ProductHunt

Appendix B: Rapido FAB Current Capabilities

For reference — what we've already built:

  • OTM Task System (v2.5): Dispatch → assignment → completion detection → orchestrator validation → done
  • CMMI L2 Gates (6 gates): Plan, Requirements, Design, Implementation, Verification, Post-Mortem
  • Agent Identity: SOUL.md, MEMORY.md, daily notes, team genetics, persistent personality
  • Communication: Native Telegram + Slack integration
  • Dashboard: Vercel-hosted, read-only, WebSocket state relay
  • Process Discipline: Spec-driven changes, decision records, timeline variance tracking
  • Production Record: Active client work (Salesforce, content, project management)
  • Team: 6 specialized agents (Claudia, Devdas, Archibald, Frédéric, Salvatore, Sylvain)

Appendix C: Sources

  1. Internal: Paperclip vs Rapido FAB Comparison Report (2026-03-16)
  2. https://paperclip.ing/ — Paperclip official site
  3. https://github.com/paperclipai/paperclip — Main repository
  4. Internal: OTM-SPEC-v2.5.md, FAB-CLI-SPEC.md
  5. Internal: Project registry (projects.json), agent registry
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment