Skip to content

docs(economics): opt-in usage-data sharing + K/M number formatting#750

Open
potiuk wants to merge 1 commit into
apache:mainfrom
potiuk:economics-usage-data-sharing
Open

docs(economics): opt-in usage-data sharing + K/M number formatting#750
potiuk wants to merge 1 commit into
apache:mainfrom
potiuk:economics-usage-data-sharing

Conversation

@potiuk

@potiuk potiuk commented Jul 5, 2026

Copy link
Copy Markdown
Member

What & why

Adds a voluntary, opt-in program for adopters to contribute anonymised
token-economics data, and makes the economics page easier to read.

Usage-data sharing (opt-in)

  • docs/mode-economics.md — new "Sharing your usage data (opt-in)"
    section: how to opt in, the session-end question, submission as a PR to
    apache/magpie-economics,
    what the payload contains, and the privacy exclusions. Wired into the
    ASF-inference-endpoint section and cross-references.
  • AGENTS.md — new cross-cutting rule "Voluntary usage-data sharing
    (opt-in)": when — and only when — the adopter has opted in, a skill
    session ends by asking whether to submit; never auto-submits; hard rule
    that the payload carries no PII and no subscription/billing data.
  • projects/_template/project.md — new economics_data_sharing key
    (default off).

Privacy contract. The data payload is anonymous — per-skill token
counts, model/model-class, public repo name, and a theoretical cost figure;
no personal information, no subscription/plan/seat/quota/billing data. The
one honest caveat, stated in all three files: the submission is a PR opened
from the maintainer's own GitHub account, so their account is attached
as author (inherent to any PR) — their own identity, disclosed voluntarily,
never third-party data.

Readability

  • Reformatted every token count on mode-economics.md to K/M notation
    (30 00030K, 1 500 0001.5M), with a one-line key.

The submission PR template lives in the now-bootstrapped
apache/magpie-economics repo.

Validation

  • doctoc TOCs regenerated; markdownlint, typos, lychee, check-placeholders all pass (pre-commit)
  • spec-validate OK; skill-and-tool-validate clean (one pre-existing unrelated warning)
  • lychee --offline --include-fragments: 0 errors across all new cross-file anchors

Generated-by: Claude Code (Opus 4.8)

@potiuk potiuk force-pushed the economics-usage-data-sharing branch from d2efb73 to 2f63e3a Compare July 5, 2026 18:17
Adds a voluntary, opt-in program for adopters to contribute anonymised
token-economics data that improves docs/mode-economics.md and the
long-term ASF inference-endpoint capacity model.

- docs/mode-economics.md: new 'Sharing your usage data (opt-in)' section
  (submission via PR to apache/magpie-economics, session-end question,
  payload contents, privacy exclusions, GitHub-account caveat); wired into
  the ASF-endpoint section and cross-references. Also reformats all token
  counts to human-readable K/M notation.
- AGENTS.md: new cross-cutting 'Voluntary usage-data sharing (opt-in)'
  rule — when opted in, a session ends by asking whether to submit; never
  auto-submits; hard rule on no PII / no subscription data, with the
  submitter's own account as the one inherent disclosure.
- projects/_template/project.md: economics_data_sharing opt-in key (off
  by default).

Generated-by: Claude Code (Opus 4.8)
@potiuk potiuk force-pushed the economics-usage-data-sharing branch from 2f63e3a to 2f428f0 Compare July 5, 2026 21:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants