Skip to content

docs(mode-economics): refresh stale token table - #1079

Open
dpol1 wants to merge 1 commit into
apache:mainfrom
dpol1:docs/881-mode-economics-token-table
Open

docs(mode-economics): refresh stale token table#1079
dpol1 wants to merge 1 commit into
apache:mainfrom
dpol1:docs/881-mode-economics-token-table

Conversation

@dpol1

@dpol1 dpol1 commented Aug 10, 2026

Copy link
Copy Markdown
Member

Summary

  • docs/mode-economics.md is the reference adopters use to estimate token
    costs, but its tables had drifted behind the shipped skill set: the Pairing
    table still listed the multi-agent review pipeline as a "future skill", and
    five shipped skills were missing rows entirely.
  • Rename the "Multi-agent review pipeline" row to pairing-multi-agent-review
    (shipped, experimental — range unchanged) and add the missing rows:
    pre-first-pr-check (Pairing) plus the four Mentoring-family skills the
    table omitted (mentoring-welcome, onboarding-concierge,
    contributor-to-committer, good-first-issue-sweep).
  • New ranges are marked Estimated, following the table's existing
    convention for experimental skills.

Type of change

  • Documentation (docs/, README.md, CONTRIBUTING.md)

Test plan

  • prek run --files docs/mode-economics.md passes (markdownlint, typos,
    lychee link check all green)
  • Docs-only change; no behaviour to test. Skill inventory cross-checked
    against docs/modes.md (Mentoring: 7 shipped, table had 3; Pairing: 3
    shipped, table had 1 + a "future" placeholder).

RFC-AI-0004 compliance

Docs-only; no principles touched.

Linked issues

Closes apache/magpie#881

Notes for reviewers

The four new Mentoring rows and pre-first-pr-check carry estimated ranges
anchored on analogous existing rows (newcomer-issue-explainer for the
single-thread drafters, issue-reassess for the backlog sweep). The two
worth sanity-checking are contributor-to-committer (15K–50K — activity
history read) and good-first-issue-sweep (20K–80K per 10-issue sweep).


Generated-by: Claude Code (Fable 5)
This pull request was prepared by an AI assistant.

pairing-multi-agent-review shipped, so drop its "future skill"
marker and list it under its real name. Add the rows missing from
the token table: pre-first-pr-check (Pairing) and the four
Mentoring-family skills the table omitted (mentoring-welcome,
onboarding-concierge, contributor-to-committer,
good-first-issue-sweep). New ranges are marked Estimated, in line
with the table's existing convention.
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.

docs/mode-economics.md: stale token table — lists future skills that exist, missing shipped skills

1 participant