From 660761fc71e5e8bc08bb310d5a3a77ad1241a327 Mon Sep 17 00:00:00 2001 From: tegwick Date: Thu, 30 Jul 2026 12:58:53 +0200 Subject: [PATCH] Accept Candidate A for WP-0010-T01: labor-cost-anchored calculator formula Maintainer (Bernd) accepted 2026-07-30: estimated_effort_days/daily_rate driven directly by commit-clustered human interaction time; approved_direct_costs from real metered AI token cost (get_token_summary); workplan/task-volume and file/line-size metrics serve only as a sanity check on the human-time estimate, never their own dollar figure; Target Multiple remains a human classification. Candidate B recorded as the considered, not-adopted alternative. --- README.md | 2 +- specs/DevelopmentEffortCalculatorConcept.md | 12 +++++++----- .../TREV-WP-0010-development-effort-calculator.md | 14 +++++++++++++- 3 files changed, 21 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 73b32be..3c0b06a 100644 --- a/README.md +++ b/README.md @@ -82,7 +82,7 @@ The concept's §13 now defines a **Global Contingency Share Determination Rule** | [TREV-WP-0007](workplans/TREV-WP-0007-degeneration-policy-and-canonical-profiles.md) | Degeneration policy + canonical monetization profile catalog — **finished**, all 4 tasks done. `trsl:policy:linear-longstop-v0` confirmed 2026-07-29 as the v1 norm for the first pilot cohort; `progress-paused-longstop-v1` named as the next iteration, not yet adopted | | [TREV-WP-0008](workplans/TREV-WP-0008-governance-and-pilot-rollout.md) | Governance formalization + pilot rollout — active; T01–T04 done. `info-tech-canon` dry-run onboarding routine exercised end-to-end 2026-07-29. **Org-wide TRSL license adoption executed 2026-07-30** across ~90 `coulomb`-org repos (`history/260730-TRSL-OrgWideLicenseRollout.md`) — a license-text adoption, not a Phase declaration. T05 (real Phase go-live gate) remains `todo` by design; no Phase exists yet for any repo | | [TREV-WP-0009](workplans/TREV-WP-0009-target-revenue-control-plane.md) | Target Revenue Control Plane — interactive UI for the `binky` tenant, incl. interactive Development Credit entry creation (`specs/TargetRevenueControlPlaneConcept.md`) — active, concept only so far; T01 (rights-model human gate) not yet decided | -| [TREV-WP-0010](workplans/TREV-WP-0010-development-effort-calculator.md) | Development Effort Calculator — turns human time/workplan-task volume/repo size/AI token cost into `target_basis` values feeding the framework's existing Initial Target formula (`specs/DevelopmentEffortCalculatorConcept.md`) — active, concept only so far; T01 (formula human gate) not yet decided. Split from TREV-WP-0009 2026-07-30 | +| [TREV-WP-0010](workplans/TREV-WP-0010-development-effort-calculator.md) | Development Effort Calculator — turns human time/workplan-task volume/repo size/AI token cost into `target_basis` values feeding the framework's existing Initial Target formula (`specs/DevelopmentEffortCalculatorConcept.md`) — active; **T01 accepted 2026-07-30 (Candidate A, labor-cost-anchored)**; T02 (implementation) next. Split from TREV-WP-0009 2026-07-30 | Hub index: [`WORK-RECORDS.md`](WORK-RECORDS.md) · brief: [`.custodian-brief.md`](.custodian-brief.md) diff --git a/specs/DevelopmentEffortCalculatorConcept.md b/specs/DevelopmentEffortCalculatorConcept.md index 4e5e2b4..e3ace62 100644 --- a/specs/DevelopmentEffortCalculatorConcept.md +++ b/specs/DevelopmentEffortCalculatorConcept.md @@ -152,11 +152,13 @@ Candidate A might undervalue it), but introduces a second calibration constant ($-per-complexity-unit) with even less grounding than `daily_rate` has. -**This document does not choose between A and B** — that is exactly the -kind of working default a future task (see workplan T02) should propose -and a maintainer should confirm, the same way -`specs/TargetDegenerationPolicyResearch.md` handled the degeneration -formula fork. +**Adopted 2026-07-30** (`workplans/TREV-WP-0010-development-effort-calculator.md` +T01, maintainer-accepted): **Candidate A is the confirmed v0 formula.** +Candidate B remains recorded here as the considered alternative, not +adopted — revisit only if Candidate A's labor-cost anchor proves +systematically wrong once real repos produce real data, the same +provisional-but-decided treatment `specs/TargetDegenerationPolicyResearch.md` +gave the degeneration formula fork. ## 4. Target Multiple classification (the Nx factor) diff --git a/workplans/TREV-WP-0010-development-effort-calculator.md b/workplans/TREV-WP-0010-development-effort-calculator.md index 3b52166..c9ac89f 100644 --- a/workplans/TREV-WP-0010-development-effort-calculator.md +++ b/workplans/TREV-WP-0010-development-effort-calculator.md @@ -41,9 +41,11 @@ Concept: `specs/DevelopmentEffortCalculatorConcept.md`. ```task id: TREV-WP-0010-T01 -status: todo +status: done priority: high human_accept_required: true +human_accepted_by: Bernd +human_accepted_at: "2026-07-30" state_hub_task_id: "a3e1acbf-8659-4745-b595-ba8c2728f3b5" ``` @@ -64,6 +66,16 @@ same human-gate pattern already used for the degeneration policy formula (`workplans/TREV-WP-0007-degeneration-policy-and-canonical-profiles.md` T02). Agents may prepare a recommendation and leave this `todo`. +**Accepted 2026-07-30 by the maintainer (Bernd): Candidate A +(labor-cost-anchored) confirmed as the adopted v0 formula.** +`estimated_effort_days` and `daily_rate` are driven directly by +commit-clustered human interaction time; AI token cost +(`get_token_summary`) becomes `approved_direct_costs`; workplan/task- +volume and file/line-size metrics serve only as a sanity check/adjustment +on the human-time estimate, never their own dollar figure; the Target +Multiple remains a human classification, not computed. T02 implements +this formula, not Candidate B or a hybrid. + ## Implement the calculator ```task