docs(economics): opt-in usage-data sharing + K/M number formatting#750
Open
potiuk wants to merge 1 commit into
Open
docs(economics): opt-in usage-data sharing + K/M number formatting#750potiuk wants to merge 1 commit into
potiuk wants to merge 1 commit into
Conversation
johnslavik
approved these changes
Jul 5, 2026
d2efb73 to
2f63e3a
Compare
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)
2f63e3a to
2f428f0
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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— neweconomics_data_sharingkey(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
mode-economics.mdto K/M notation(
30 000→30K,1 500 000→1.5M), with a one-line key.The submission PR template lives in the now-bootstrapped
apache/magpie-economicsrepo.Validation
spec-validateOK;skill-and-tool-validateclean (one pre-existing unrelated warning)--offline --include-fragments: 0 errors across all new cross-file anchorsGenerated-by: Claude Code (Opus 4.8)