coulomb/adaptive-pricing
2
0
Fork 0
generated from coulomb/repo-seed
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Refresh scope document to match implemented core

Browse Source
This commit is contained in:
codex
2026-07-03 01:50:14 +02:00
parent a9a55e19f1
commit b7eedb90e1
2 changed files with 73 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files

59
SCOPE.md
View File

@@ -12,33 +12,64 @@ adapting, and implementing pricing models across the product lifecycle. See
## In Scope
- Generic framework documentation (`INTENT.md`, `docs/`, `research/`, `registry/`).
- Pricing model vocabulary, lifecycle reasoning, and capability registry.
- Project-specific deployments under `projects/<slug>/`.
- Generic pricing core under `adaptive_pricing_core/`, including:
canonical pricing schema and validation, boundary evaluation, comparable
customer LTV, customer-tuning solver, provider-publication primitives, Stripe
mapping, and governance models.
- Generic framework documentation and research (`INTENT.md`, `docs/`,
`research/`, `registry/`).
- Project-specific proving grounds under `projects/<slug>/`, with Coulomb
Social as the first full adopter of the generic core.
- Local execution surfaces that keep internal pricing definitions as the source
of truth, including provider shadow publication, governed recommendations,
tuning contracts, health checks, and audit history.
- State Hub workplans under `workplans/` (ADR-001).
## Out of Scope
- Owning unrelated adjacent systems (Bubble.io, Stripe, OpenRouter runtimes).
- Making irreversible operational or pricing decisions without human approval.
- Project-specific MVP material in generic doc paths (use `projects/<slug>/`).
- Owning unrelated adjacent systems as the source of truth, including Bubble,
Stripe, and OpenRouter runtimes.
- Live payment-provider mutation as the default repo behavior. Current provider
execution stops at mapping, shadow-state publication, drift detection, and
rollback planning.
- Treating approximate provider mappings as fully enforced billing behavior when
they still require supplemental operational or contract logic.
- Autonomous customer-visible pricing rollouts or irreversible pricing changes
without human approval.
- Project-specific deployment material in generic doc paths (use
`projects/<slug>/`).
## Current State
- **Phase:** framework plus first project deployment — root docs/research remain
generic, while Coulomb Social provides the first concrete implementation.
- **Runtime:** project-specific runtime exists under
`projects/coulomb-pricing/observatory/`; the repo root remains documentation,
research, registry scaffolding, and workplan coordination.
- **Bootstrap:** State Hub integration (`ADAPTIVE-WP-0001`) wires agent orientation,
workplan tracking, and custodian brief sync.
- **Phase:** framework plus executable core. The repo is no longer just docs and
research around a single MVP; it now contains reusable pricing-core modules
and one concrete deployment.
- **Implemented milestones:** `ADAPTIVE-WP-0003` through `ADAPTIVE-WP-0008`
are finished. The repo now has canonical pricing models, explainable boundary
validation, comparable-customer LTV simulation, customer-tuning, provider
shadow publication, and governance workflows.
- **Generic runtime surface:** reusable implementation lives under
`adaptive_pricing_core/`.
- **Deployment surface:** Coulomb Social remains the first proving ground under
`projects/coulomb-pricing/observatory/`, including the dashboard/API, data
loaders, tuning pilot, Stripe shadow-publication flow, and governed
recommendation surfaces.
- **Execution boundary:** Stripe support is currently a provider abstraction and
local shadow-state publisher, not live Stripe API management.
- **Coordination:** State Hub integration (`ADAPTIVE-WP-0001`) remains the repo
workflow backbone for orientation, workplan tracking, and brief sync.
## Getting Oriented
- Start with: `INTENT.md`
- Product requirements (generic): `docs/ProductRequirementsDocument.md`
- Canonical pricing schema: `docs/PricingModelSchema.md`
- Customer tuning: `docs/CustomerTuningSolver.md`
- Provider publication: `docs/StripePublication.md`
- Governance workflow: `docs/GovernanceWorkflows.md`
- Implementation roadmap: `docs/ImplementationRoadmap.md`
- Agent instructions: `AGENTS.md`
- Workplans: `workplans/`
- Coulomb MVP artifacts: `projects/coulomb-pricing/`
- Generic code: `adaptive_pricing_core/`
- Coulomb deployment artifacts: `projects/coulomb-pricing/`
- Offline hub brief: `.custodian-brief.md`