target-revenue/workplans/TREV-WP-0008-governance-and-pilot-rollout.md
tegwick dd7f7d2181 Set up practical implementation workplans (WP-0006/0007/0008)
With WP-0001/0002/0003 finished, PRD Phase 4b (hosted Trust Service) is
unblocked per SCOPE.md's own sequencing rule, and the midterm goal shifts
from framework design to practical application: governing and monetizing
repos across the coulomb Forgejo org's product lines (coulomb-loop,
net-kingdom, helix-forge, the railiance-* family).

- TREV-WP-0006: Trust Service reference implementation (PRD Phase 4b).
  Eight tasks from PRD to conformance-tested hosted service, explicit that
  it builds infrastructure only - no real payments or Phase tracking.
- TREV-WP-0007: Degeneration policy finalization (PRD Phase 5) and the
  full canonical monetization profile catalog (remainder of Phase 3) -
  pilot Phases can't responsibly launch on the placeholder pilot policy
  and one-line profile defaults alone.
- TREV-WP-0008: Governance formalization (PRD Phase 7) and pilot rollout
  preparation. Forces a real design decision the framework never had to
  answer while single-repo-hypothetical: who is "the Licensor" across four
  independent product lines. Produces draft, non-binding Phase Manifests
  as worked examples for one repo per product line, and a CLA draft.

All three explicitly preserve SCOPE.md's existing "no production Phases
until legal review" guardrail rather than overriding it under pressure to
monetize real repos: WP-0008-T05 is a dedicated, human-gated go-live
decision, and no other task in any of the three workplans is permitted to
authorize a real Phase, real Commercial Entitlement sale, or real
Development Credit tracking.

Updates SCOPE.md (new Stage 0/Stage 1 maturity table, revised out-of-scope
table distinguishing "infrastructure in scope" from "going live still
gated"), PRD roadmap (Phase 4b/5/7 now active, pointing at the new
workplans), and README's active-work table accordingly.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-29 20:27:29 +02:00

6.3 KiB
Raw Blame History

id type title domain repo status owner topic_slug created updated
TREV-WP-0008 workplan Governance formalization and pilot rollout (coulomb / net-kingdom / helix-forge / railiance) infotech target-revenue active claude infotech 2026-07-29 2026-07-29

Governance formalization and pilot rollout

The midterm goal: govern and monetize the evolution of repos across the coulomb Forgejo org's product lines — coulomb-loop, net-kingdom, helix-forge, and the railiance-* family (railiance-apps, railiance-bootstrap, railiance-cluster, railiance-enablement, railiance-fabric, railiance-forge, railiance-hosts, railiance-infra, railiance-master, railiance-platform). This workplan formalizes the governance the framework has been designed around but never actually written down, and prepares (but does not itself execute) the first real Phase declarations.

Hard gate, stated up front: SCOPE.md §3 lists "governing third-party product Phases in production" as out of scope "after legal + Stage 0 package ready" — i.e., not yet. This workplan's rollout tasks (T03–T04) produce draft, non-binding Phase Manifests as worked examples, exactly like examples/phase-001/ already is. No real Commercial Entitlement may be sold, no real Development Credit tracked, and no repo's actual License header changed to TRSL, until T05 (the go-live gate) is explicitly accepted — after TRSL/CUA specialist legal review (workplans/TREV-WP-0004-global-jurisdiction-research.md / workplans/TREV-WP-0005-enforcement-network-research.md T10 syntheses feed this) and T01 (Licensor governance) are both resolved. Moving fast on T01–T04 must not create pressure to skip T05.

Governance document: TRSL-Governance.md

id: TREV-WP-0008-T01
status: todo
priority: high

Produce specs/TRSL-Governance.md, per spec/TargetRevenueLicenseConcept.md §20 (complexity budget, versioning, extension governance, operator governance). Must resolve one question this rollout makes concretely unavoidable for the first time: who is "the Licensor" across four different product lines under one Forgejo org — a single shared Licensor entity for all four (simplest, but conflates genuinely different products' commercial decisions), or a per-product-line Licensor (each of coulomb-loop, net-kingdom, helix-forge, railiance declaring its own Phases independently under a shared TRSL/CUA template)? This was never forced while the framework was single-repo-hypothetical; it is now. Also define: change process for the License/CUA templates themselves once multiple product lines depend on them, extension canonicalization review (coordinate with workplans/TREV-WP-0007-degeneration-policy-and-canonical-profiles.md T04's narrower checklist), and dispute/conflict-of-interest handling per concept §20.3–§20.4.

Repo inventory and Phase-candidate survey

id: TREV-WP-0008-T02
status: todo
priority: high

For each of coulomb-loop, net-kingdom, helix-forge, and the railiance-* family: survey current repo goals and status (via the state hub's get_domain_summary/list_domain_repos/repo-goal tools, or direct repo inspection where hub data is thin) to identify one plausible first Milestone Release candidate per product line — a bounded, recently- or soon-to-be-completed piece of work with a defensible Target Multiple classification (specs/TargetRevenueFrameworkCore.md §1.4), not an arbitrary pick. Document why each candidate was chosen and what was passed over.

Draft pilot Phase Manifests (non-binding worked examples)

id: TREV-WP-0008-T03
status: todo
priority: high

Using T02's candidates, draft one Phase Manifest per product line following specs/PhaseManifestSpecification.md and schemas/phase_manifest.schema.json exactly — structurally valid, conformance-tested the same way examples/phase-001/ is, but explicitly marked draft / not yet declared (no real Commercial Use restriction takes effect from these). Choose an applicable Monetization Extension per Phase from workplans/TREV-WP-0007-degeneration-policy-and-canonical-profiles.md T03's catalog.

Contributor rights instrument (CLA)

id: TREV-WP-0008-T04
status: todo
priority: medium

CONTRIBUTING.md currently blocks external contributions into any governed Milestone Release until a contributor-rights instrument exists (per history/260729-TRSL-ContributorRights-Research.md). If any pilot candidate from T02 has, or expects, external contributors before its Conversion Event, this is now practically blocking, not theoretical. Produce specs/TRSL-ContributorLicenseAgreement-Draft.md: a CLA scoped narrowly to the current Phase's TRSL terms plus its already-declared Future License, per the T04 research's recommendation. Same preliminary- candidate treatment as the License/CUA V1C1 documents (status banner, Appendix A-style candidate notes) — this is a new legal document, not exempt from that pattern.

Go-live gate (human decision)

id: TREV-WP-0008-T05
status: todo
priority: high
human_accept_required: true

Do not mark this task done to authorize real Phase declarations. It exists to make the go-live decision a single, explicit, recorded moment rather than something that happens by accretion once enough pilot infrastructure exists. Before acceptance, confirm:

  • workplans/TREV-WP-0004-global-jurisdiction-research.md T10 and workplans/TREV-WP-0005-enforcement-network-research.md T10 syntheses are complete, or their absence is an explicitly accepted risk;
  • specialist legal review of specs/TargetRevenueSourceLicense-V1C1.md and specs/TargetRevenueCommercialUseAgreement-V1C1.md (condition 1 in each document's status banner) has occurred, or is explicitly waived for a defined pilot scope;
  • T01's Licensor-identity question is resolved for whichever product line goes first;
  • workplans/TREV-WP-0006-trust-service-implementation.md has a working hosted Trust Service, or an explicit interim manual/git-based ledger process is accepted for the pilot instead.

Once accepted, this task's Result should name which specific repo and Phase go live first — "governance and rollout infrastructure exists" is not the same event as "a real Phase is declared," and this workplan should not blur that line even after everything above is ready.