kaizen-agentic/wiki/ForwardDeployedAgencyBusinessModel.md
tegwick 97d0739537
Some checks failed
CI Smoke / host-smoke (push) Successful in 1s
CI Smoke / container-smoke (push) Successful in 1m12s
ci / test (push) Has been cancelled
docs: ADR-007 and FDA playbook; finish WP-0009 (T11)
Absorb railiance01 pilot supplier notes into the forward-deployed engagement
playbook, accept ADR-007 elevating DEC-FDA-001, promote architecture and
business model to v1.0, and mark KAIZEN-WP-0009 finished.
2026-07-16 12:44:56 +02:00

384 lines
16 KiB
Markdown
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Forward-Deployed Agency Business Model
**Status:** v1.0 accepted (ADR-007; pilot railiance01 complete)
**Date:** 2026-07-16
**Audience:** product owners, coulomb ecosystem operators, early client sponsors
**Companion tech spec:** [docs/forward-deployed-engagement-architecture.md](../docs/forward-deployed-engagement-architecture.md)
**Canon ADR:** [docs/adr/ADR-007-forward-deployed-engagement-convention.md](../docs/adr/ADR-007-forward-deployed-engagement-convention.md)
**Playbook:** [docs/integrations/forward-deployed-engagement-playbook.md](../docs/integrations/forward-deployed-engagement-playbook.md)
**Decisions:** [docs/decisions/DEC-FDA-001-working-defaults.md](../docs/decisions/DEC-FDA-001-working-defaults.md)
**Builds on:** [PricingModel.md](PricingModel.md), [RevenueModel.md](RevenueModel.md), [KaizenAgenticMission.md](KaizenAgenticMission.md), ADR-006
---
## 1. Positioning
**Kaizen-agentic is an agentic consulting practice** — a digital talent agency that
**forward-deploys specialized agents** into client environments (companies on the
coulomb ecosystem, and coulomb-operated infrastructure itself).
Unlike a library of one-shot prompts, engagements are **staffed roles**:
| Dimension | Meaning |
|-----------|---------|
| **Role competency** | The agent is good at its job (sysadmin, coach, TDD lead, release manager) |
| **Domain competency** | The agent learns *this* client's systems, jargon, constraints, and history |
| **Confidential custody** | Operational knowledge gained on engagement **belongs to the client** |
| **Reusable craft** | Role patterns, playbooks, and non-secret refinements improve the agency fleet |
Clients do not rent anonymous token burn. They engage a **named digital colleague**
with a ramp-up, steady-state duty, and orderly ramp-down — analogous to a
forward-deployed engineer, with measurement and continuous improvement baked in.
### Who is the customer?
1. **Coulomb internal** — ecosystem ops (e.g. railiance01 host operator, loop coaches)
2. **Coulomb-ecosystem companies** — product teams using railiance, state-hub, activity-core, etc.
3. **Later: external companies** — same model once trial currency proves unit economics
---
## 2. Value proposition
### For the client
- A competent agent **on their problem**, not a generic chatbot
- Knowledge that **stays in their custody** (engagement vault; see tech spec)
- Explicit lifecycle: request → staff → ramp-up → operate → ramp-down → handoff
- Transparent cost model that starts in trial currency and can convert to money
- Measurable duty: schedules, health reviews, SLAs stated in the engagement contract
### For the agency (kaizen-agentic)
- Recurring engagement revenue (or trial-currency demand signal) beyond one-off installs
- Dual learning loops:
- **Role craft** compounds in supplier IP (prompts, protocols, coach patterns)
- **Domain craft** compounds only where the client allows (engagement memory)
- Reference deployments inside coulomb that prove the model before external sales
- Natural upsell path: more roles, higher cadence, premium tiers (capability multipliers)
### What is *not* sold
- Client secrets, host fingerprints, incident narratives, or tenant topology as
kaizen training data
- Unbounded autonomous change rights on production systems
- Transfer of client operational IP into the public agent catalog without scrubbing
and explicit license
---
## 3. Engagement product units
### 3.1 Role (catalog product)
A **Role** is a supplier-owned agent definition family (e.g. `host-operator`,
`sys-medic`, `coach`, `tdd-workflow`). Roles have:
- Capability tier (1×5× per [PricingModel.md](PricingModel.md))
- Standard protocols and metrics
- Default cadences (on-demand, daily, weekly)
- Required access classes (read-only shell, cert-bound SSH, no secrets, etc.)
### 3.2 Engagement (sold instance)
An **Engagement** is a time-bounded (or open-ended) staffing of one or more Roles
for a **Client** against named **Targets** (repos, hosts, clusters, product areas).
| Field | Example (pilot) |
|-------|-----------------|
| Client | coulomb / railiance ops |
| Role | `host-operator` (specialization of infrastructure / sys-medic craft) |
| Target | host `railiance01` (k3s production node) |
| Duty | keep OS current, security posture, load & workload review |
| Cadence | daily health review; weekly OS/security pass; on-demand incident assist |
| Knowledge plane | client-owned engagement vault on client infrastructure |
| Billing plane | trial Kai ledger → later EUR settlement |
### 3.3 Seat vs. duty
- **Seat** — right to run a role for a client (subscription-like)
- **Duty unit** — a scheduled or on-demand work session (usage-like)
Pricing can combine both (seat for continuity + duty units for heavy weeks).
---
## 4. Dual knowledge planes (commercial rule)
This is the commercial expression of the technical confidentiality design.
| Plane | Owner | Contents | May feed supplier IP? |
|-------|-------|----------|------------------------|
| **Client operational knowledge** | Client | Host baselines, incident history, topology, credentials pointers, “how we run X here” | **No** — unless client explicitly contributes a scrubbed lesson |
| **Role craft (agency IP)** | kaizen-agentic | Prompts, protocols, assessment methods, generic playbooks | Yes — always |
| **Shared anonymized metrics** | Negotiated | Aggregate success rates, quality scores, cadence stats | Opt-in only |
| **Engagement artifacts** | Client | Session reports, run logs, recommendations | Client; supplier may retain *billing* metadata only |
**Default contract language:** *“All operational knowledge acquired during the
engagement is Client Confidential Information. Supplier retains ownership of
generic Role definitions and non-identifying process improvements.”*
Violation of this plane split is a product defect, not a negotiation detail.
---
## 5. In-game currency: **Kai**
### 5.1 Purpose
**Kai** is a **trial and internal settlement unit** used while the agency model is
proven inside coulomb and with friendly clients. It:
- Creates real scarcity and budget discipline without invoicing friction
- Makes role tiers and duty costs *felt* before EUR conversion
- Produces ledger data to calibrate real prices
- Can later map 1:1 (or with a published FX) to currency
Kai is **not** a cryptocurrency, not publicly traded, and not legal tender.
It is a **ledger balance** in the coulomb / kaizen settlement system.
### 5.2 Units and denominations
| Symbol | Name | Typical use |
|--------|------|-------------|
| **Kai** | base unit | All ledger entries |
| **kKai** | 1000 Kai | Monthly seat packages |
| **MKai** | 1000000 Kai | Portfolio budgets (optional) |
### 5.3 Minting (trial phase)
| Source | Amount (illustrative) | Notes |
|--------|----------------------|--------|
| **Bootstrap grant** | 50000 Kai per new client | One-time, expires in 90 days if unused |
| **Internal coulomb ops grant** | 200000 Kai / quarter | Ecosystem self-service (railiance, loop, etc.) |
| **Top-up voucher** | Operator-issued | For pilots and demos |
| **Earned credit** | Variable | Completing engagement feedback, contributing scrubbed lessons |
No automatic infinite mint. Empty balance **pauses new duty starts** (ramp-down of
in-flight work is always allowed without charge).
### 5.4 Spend catalog (trial price list)
Prices are in Kai and intentionally round for mental math. Capability multipliers
from [PricingModel.md](PricingModel.md) apply as **tier weights** on duty units.
**Seats (monthly, auto-renew while funded):**
| Product | Tier weight | Seat / month |
|---------|-------------|--------------|
| Baseline role seat (1×) | 1 | 2000 Kai |
| Professional role seat (3×) | 3 | 6000 Kai |
| Expert / host-operator seat (4×) | 4 | 10000 Kai |
| Premium meta / coach fleet seat (5×) | 5 | 15000 Kai |
**Duty units (per executed session, in addition to seat):**
| Duty | Base cost | After tier weight *M* |
|------|-----------|------------------------|
| On-demand short assist (≤30 min wall) | 100 Kai | 100 × *M* |
| Standard review session (scheduled) | 400 Kai | 400 × *M* |
| Deep assessment / change window | 1200 Kai | 1200 × *M* |
| Ramp-up package (fixed, once) | 5000 Kai | 5000 × *M* / 2 (half weight) |
| Ramp-down package (fixed, once) | 3000 Kai | 3000 × *M* / 2 |
**Access class surcharges (per session):**
| Access class | Surcharge |
|--------------|-----------|
| Read-only / docs-only | +0 |
| Host observe (non-root shell / metrics) | +100 Kai |
| Privileged ops (root, package upgrade, firewall) | +400 Kai + human approval gate |
| Multi-host or cluster-wide | +200 Kai per additional host |
**LLM token pass-through (optional, trial):**
Recorded as `token_kai = ceil(actual_vendor_cost_EUR * kai_per_eur_fx)` for
transparency; may be waived in pure internal coulomb trials.
### 5.5 Example: railiance01 host-operator pilot
| Line item | Calc | Kai |
|-----------|------|------|
| Expert seat (4×), 1 month | 10000 | 10000 |
| Ramp-up package | 5000 × 4 / 2 | 10000 |
| Daily standard review × 20 business days | 20 × 400 × 4 | 32000 |
| Weekly deep OS/security pass × 4 | 4 × 1200 × 4 | 19200 |
| Privileged surcharges (est. 4 sessions) | 4 × 400 | 1600 |
| **Month-1 total** | | **~72800 Kai** |
Internal coulomb quarterly grant (200000 Kai) covers ~23 such seats with
headroom — enough to run the pilot and still force prioritization.
### 5.6 Conversion to real payments
When trial ends (client or product decision), **Kai balances convert**:
```
EUR_due = remaining_committed_work_EUR
+ (optional) unused_Kai_forfeit or credit_at_FX
```
**Published FX (initial, revisable):**
| Mode | Rule |
|------|------|
| **Trial learning FX** | 1000 Kai ≈ 1 EUR of agency list price *for calibration only* |
| **Commercial FX** | Seat and duty price lists republished in EUR; Kai ledger frozen or becomes loyalty credit |
| **Grandfathering** | Active engagements keep trial Kai rates for one more full billing cycle after conversion notice |
**Transition states:**
1. `trial_kai` — only Kai ledger
2. `hybrid` — seats invoiced in EUR; duty still in Kai (or reverse)
3. `commercial_eur` — full EUR; Kai optional loyalty only
Settlement systems (invoice, SEPA, etc.) are **out of repo**; this model only
defines the commercial units and conversion rules.
### 5.7 What Kai deliberately does *not* buy
- Secrets or elevated access without ops-warden / OpenBao routing
- Guaranteed zero-incident outcomes
- Ownership of supplier Role IP
- Training the public catalog on client confidential data
---
## 6. Competency model (what improves over time)
### 6.1 Role competency (agency asset)
Improved via:
- Metrics (success, quality, time) across *many* engagements
- Coach + optimizer loops (existing agency framework)
- Protocol runbooks refined after generalized lessons
- Capability tier promotion of Role products
**Commercial effect:** higher tier weight → higher Kai/EUR price, justified by
lower client risk and better outcomes.
### 6.2 Domain competency (client asset)
Improved via:
- Engagement memory and node/host profiles
- Client runbooks and decisions in the engagement vault
- Session logs and cleared-issue history
**Commercial effect:** longer engagements get more efficient (fewer duty units for
the same outcome). Discounts for multi-quarter renewals reflect reduced ramp cost,
not ownership transfer of client knowledge.
### 6.3 Learning tax and learning credit
| Event | Effect |
|-------|--------|
| First engagement of a new Role for a client | Ramp-up package mandatory |
| Client contributes scrubbed “lesson learned” accepted into Role craft | Kai credit (e.g. 10005000) |
| Supplier extracts confidential detail into public Role without approval | Contract breach; engagement freeze |
---
## 7. Lifecycle commercial view
```
Request → Quote (Kai) → Fund → Staff → Ramp-up → Operate → (Renew | Ramp-down) → Close
```
| Phase | Client pays | Client receives | Agency obligation |
|-------|-------------|-----------------|-------------------|
| **Request / quote** | 0 | Scope options, tier recommendation | Respond with Role fit + Kai estimate |
| **Staff** | Seat (pro-rate) | Named engagement + agent definition bound to targets | Provision definition + access plan |
| **Ramp-up** | Ramp package | Orientation, baselines, coach brief, first metrics | Achieve “operationally aware” exit criteria |
| **Operate** | Seat + duty | Scheduled work, reports, continuous memory | Meet cadence & safety policy |
| **Renew** | Next seat period | Continuity; optional tier change | No re-ramp if knowledge vault intact |
| **Ramp-down** | Ramp-down package | Handoff pack, knowledge export, revoke access | Clean exit; no residual client secrets at supplier |
| **Close** | Settlement | Final ledger + EUR conversion if any | Archive billing metadata only |
---
## 8. Go-to-market inside coulomb
### Phase A — Internal dogfood (now)
- Clients: coulomb projects and railiance ops
- Currency: Kai only
- First Role: **host-operator** on **railiance01**
- Success: 30 days of reviews, OS/security pass documented, load findings actionable
### Phase B — Ecosystem companies
- Same Kai ledger; bootstrap grants
- Roles: host-operator, coach/optimizer loop, release manager, TDD
- Playbook reuse from coulomb-loop (ADR-006) + this model
### Phase C — External commercial
- EUR price list derived from Kai consumption data
- Hybrid then commercial_eur
- Optional professional services (custom Role design) as separate line items
(see [RevenueModel.md](RevenueModel.md) §4)
---
## 9. Relationship to existing pricing docs
| Document | Role after this model |
|----------|----------------------|
| [PricingModel.md](PricingModel.md) | **Capability multipliers** remain the tier engine (*M*) |
| [RevenueModel.md](RevenueModel.md) | **Margin story** for EUR phase; Kai is pre-revenue instrumentation |
| This document | **Engagement packaging**, confidential knowledge, trial currency, lifecycle |
Token markup formula `Price = C × M` still applies when vendor tokens are
pass-through. Engagement pricing adds **seat + duty + access class** so that
value is not *only* token volume (a careful weekly review can be high value with
modest tokens).
---
## 10. Risks and mitigations
| Risk | Mitigation |
|------|------------|
| Kai inflation (infinite grants) | Quarterly mint caps; empty balance pauses duty |
| Client confuses trial with free forever | Expiry on grants; conversion notice period |
| Knowledge leak into public agents | Dual planes; automated redaction gates (tech spec); legal default |
| Over-autonomous privileged ops | Access class + human approval; safety-first Role principles |
| Underpriced expert seats | Recalibrate FX after 23 pilots using actual duty mix |
| Scope creep on “operator” Role | Engagement contract lists hosts, cadences, change windows |
---
## 11. Success metrics (business)
1. **Pilot completion** — railiance01 host-operator engagement runs full lifecycle once
2. **Ledger fidelity** — ≥95% of duty sessions post a Kai charge event
3. **Knowledge boundary audit** — zero confidential client artifacts in supplier `agents/` without scrub + license
4. **Renewal signal** — client chooses renew or ramp-down with documented handoff
5. **Price calibration** — published EUR draft list within ±30% of Kai-implied spend after conversion FX
---
## 12. Open decisions (for sponsor)
**Phase 1 locked** in DEC-FDA-001: file JSONL ledger; pilot path under
`engagements/pilots/`; one engagement × N targets; metrics opt-in default off.
Still open for later:
1. Is internal coulomb billed only in Kai forever, or eventually soft EUR for cost visibility?
2. Multi-tenant companies: one client account or one per product line?
3. Can unused Kai transfer between sister projects in the same company?
4. When to introduce a shared settlement service beyond JSONL?
---
## Related
- Canon ADR: [ADR-007](../docs/adr/ADR-007-forward-deployed-engagement-convention.md)
- Playbook: [forward-deployed-engagement-playbook.md](../docs/integrations/forward-deployed-engagement-playbook.md)
- Technical architecture: [docs/forward-deployed-engagement-architecture.md](../docs/forward-deployed-engagement-architecture.md)
- Customer loop convention: [ADR-006](../docs/adr/ADR-006-customer-engagement-convention.md)
- Agency framework: [docs/agency-framework.md](../docs/agency-framework.md)
- Mission: [KaizenAgenticMission.md](KaizenAgenticMission.md)
- Pilot: `engagements/pilots/eng-coulomb-railiance01-ho-001/`