Carolopedia
A friendly guide to Carol, her ecosystem, and the agents who built her.
📖 Carolopedia › Services › Blueprint › Architecture
🎯Key functional considerations
Blueprint is an external, revenue-bearing service — a real product at WIP stage — so its architecture is shaped by what it must guarantee end-to-end:
- A clean sales-and-intake lane. Carol's job on this service is strictly to sell Blueprint to a curious user, file the subscription request when they say yes, and register their project. The requirements walk, the roadmap, and any initiative filing are explicitly NOT carried here — they belong to Leo.
- Check before you pitch. Subscription state changes everything, so the lane verifies a user's status before responding to project intent rather than guessing.
- Consent-gated subscription. A subscription request is only filed on an explicit affirmative — never speculatively, never silently.
- A clean handoff to the owner. Once registered, the user is handed to Leo's lane to run the actual delivery; the two lanes stay separate by design.
- Pay-per-activity visibility. The user gets live visibility of the work and the cost, billed per agent per activity, so the architecture must keep the cost trail accountable.
🧰Technologies used
- Python 3 service on FastAPI / Flask, served behind nginx.
- SQLite (WAL) datastores for subscription and project-registration state.
- Claude (Sonnet/Opus) drives the conversational sales + intake steps.
- The registry and the design store are the binding sources of truth for service identity, ownership, and the cost-center mapping (
CC-005). - systemd keeps the service lane available behind the shared Carolverse gateway.
🏗Solution architecture
Blueprint is a two-lane managed-delivery service wired into Carolverse's agent-centric modular architecture: a thin sales + intake lane that Carol owns, and the delivery lane that Leo owns.
- Carol's lane (this service) is a conversational front door: it qualifies interest, checks subscription status, files the subscription on a clear yes, and registers the project.
- Leo's lane picks up from registration — ideation, the requirements walk, the roadmap, and the standing-up of the user's private agent team. That work lives with Leo, not here.
- Obi-Wan (agt_036) provides online support across the engagement.
- The team a user gets is incremental — it grows agent by agent as their ambition grows, each agent carrying a specific activity, mirroring the org-wide modular pattern.
📐Design principles followed
- One lane, one responsibility. Carol's lane does sales and intake only; delivery is Leo's. The lanes do not blur.
- Consent before commitment. No subscription is filed without an explicit affirmative.
- Check, don't guess. Subscription status is verified before responding to project intent.
- Single source of truth. Service identity, ownership, audience, and cost center come from the live registry, never hand-copied.
- Agent-centric modular architecture. Every activity is owned by a named agent; the user's delivered team is built the same way — one agent per activity.
- Honest about WIP. Early users get a real say in how the product lands; the lane sells it as a real product still under construction, not a finished brochure.
✅Success criteria
- A curious user is qualified and, on a clear yes, has a subscription request filed in the same turn — no guessing, no premature filing.
- The user's project is registered and handed off to Leo cleanly, with delivery never leaking back into the sales lane.
- The user has live visibility of the work and its cost, billed per agent per activity.
- Support requests reach Obi-Wan.
- The service's identity, owner, and cost center always match the registry.
🛡Service-specific policies
- Sales + intake only. Per CAROL-INI-727, Blueprint is Leo's service; Carol's lane carries only the sell, the subscription filing, and the project registration. Requirements, roadmap, and initiative filing live with Leo.
- Never file a subscription without explicit consent. A pitch is one warm sentence plus one direct ask; the tool runs only on the affirmative.
- Check subscription status before responding to project intent — never assume it.
- External-audience, revenue service under cost center
CC-005; cost is tracked per agent per activity. - Agent-boundary respected — Carol's lane hands off to Leo rather than doing Leo's work.
📦End-user deliverables
Current
- Sell Blueprint to a curious user — a warm, honest WIP-stage pitch — driven by Leo as service owner.
- File a subscription request on a clear yes, using the user's stated reason.
- Register the project and hand the user off to Leo's delivery lane.
- Live visibility of the work and the cost, billed per agent per activity in the user's private sandbox.
- Online support via Obi-Wan.
Future (on demand)
- A fuller ideation and requirements walk in Leo's lane, with the roadmap and initiative filing wired straight through from registration.
- Incremental team growth surfaced to the user — adding an agent per new activity as ambition grows — with the cost trail shown live.
- Self-serve subscription management (status, upgrades) from the user's sandbox.
📘End-user run book
Agent-facing tools (Carol's sales + intake lane)
get_my_subscription_status— check whether the user is already subscribed to Blueprint; call this BEFORE responding to any project intent, since the answer changes the reply.request_blueprint_subscription— file the user's subscription request once they give a clear affirmative; pass their one-line reason.relay_to_leo— hand the registered user off to Leo for the requirements walk, roadmap, and delivery, which do not live in this lane.
The flow
- User shows project intent → call
get_my_subscription_status. - Not subscribed → one warm sentence pitch + one direct ask; wait for a yes.
- Clear yes → call
request_blueprint_subscriptionon the same turn. - Registered →
relay_to_leoto start delivery.