TokenPoints: Re-defining Software Workload Estimation with Dollars

Abstract: When AI agents become the main force in code creation, traditional time and story point estimation methods are outdated. The TokenPoints framework proposes using LLM reasoning cost (in dollars) as a new workload measurement standard, providing an honest and verifiable estimation method for AI-driven software development.

Core Insight: TokenPoints addresses the question of 'how much AI resources are needed for a task' by using dollar-denominated LLM token costs as an objective, verifiable metric, replacing time or story points which are subjective or irrelevant in the AI era.

Background: Paradigm Shift in Estimation

Software engineering workload estimation has long been a challenge. Traditional methods use time as a proxy, but it confuses time with complexity, ignores individual differences, and is easily distorted. Agile story points attempt to solve these issues but are abstract, unfalsifiable, and manipulable.

By 2026, as AI agents become the main code creators, the question 'how many hours to complete this task' loses meaning. The key question becomes: 'how much AI resources are needed?' TokenPoints was created to answer this.

Core Principles of TokenPoints

TokenPoints' core insight: In AI-driven development, workload cost is reflected in LLM token consumption, which translates to quantifiable dollars—an objective, verifiable, cross-team metric. It has six pillars:

1. Dollars are more honest than time: Time records human input, not actual workload. AI takes most coding work, so model cost reflects computational complexity.
2. Differences are information, not noise: Cost variations across teams/codebases signal real complexity distribution.
3. Results over output: Prioritize business value over code lines—less token cost for key issues is better than more for marginal improvements.
4. Local calibration is critical: Default scales are starting points; teams must calibrate based on their codebase, models, and tools.
5. Multi-dimensional thinking: Dollar cost is one dimension—consider technical debt, maintenance, learning curves.
6. Human time still matters: Humans are irreplaceable in需求理解, architecture, review, testing—separate AI cost from human time.

TokenPoints Scale System

The framework defines scales from XS to XL, each with cost ranges and scenarios:

Scale	Cost Range	Typical Scenarios	Human Time
XS	< $1	Precise edits, auto-completion	<30 mins
S	$1-$8	Single-file feature/fix,5-15 dialogues	30 mins-2h
M	$8-$40	Multi-file feature,15-40 dialogues	2-8h
L	$40-$160	Refactoring, deep debugging, cross-module changes	1-3 days
XL	$160-$400	Architecture changes, multi-system coordination	3+ days
??	Unknown	Need exploration (spike)	Time-boxed

Tasks over XL must be split; if not, it signals insufficient understanding. Scales are calibrated for 2026 AI dev sessions but teams should adjust for context (large codebases, complex dependencies, model choices).

Implementation Steps

TokenPoints advocates gradual adoption:

1. Read Manifesto: Spend ~5 mins understanding the six pillars. If you disagree with core principles, it may not fit your team.
2. Familiarize with Scales: ~10 mins to grasp XS-XL levels (no need to memorize).
3. Trial Template: Use the estimation template for 10 tasks (2 iterations) to collect data—don’t change workflows yet.
4. Team Calibration: After 2 iterations, adjust scale boundaries using actual data to build team-specific benchmarks.
5. Integrate into Workflows: Once calibrated, integrate into Scrum/Kanban using provided guides.

Data Collection for Calibration

Effective calibration requires tracking:

• Initial TokenPoints estimate
• Actual token count and dollar cost
• Model combinations (cost varies by model)
• Codebase size/complexity
• Task type (new feature, bug fix, refactoring)
• Delivered business value

Analyze data to identify estimation biases (e.g., which tasks are under/overestimated) and adjust scale definitions.

Common Mistakes & How to Avoid

1. Over-optimizing cost: Don’t sacrifice code quality/maintainability for lower costs—prioritize results over savings.
2. Ignoring human time: Track both AI cost and human time (需求澄清, architecture, review are critical).
3. Rigid scale application: Default scales are starting points—calibrate for your team’s context.
4. Ignoring context: Same task may cost differently across codebases—consider maturity, tech stack, team familiarity.

Conclusion

TokenPoints is an honest approach: it acknowledges estimation difficulties and uses AI-era tools for clearer metrics. It’s not a panacea but a data-driven starting point for planning.

For AI-transforming teams, TokenPoints offers a chance to re-think workload—embrace dollar-based honest metrics to focus on cost prediction and value.

Community Contribution

TokenPoints is v0.1—feedback on name, scales, principles is welcome. Most valuable contributions are anonymized calibration data (averages, models, codebase context). The project uses CC BY 4.0 license (free to use/fork with attribution).