SPRINT.

SPRINT. HOW TO MEASURE EFFORT

“CORE: Development effort is more than just commits. It's the sum of code changes, focus areas, and team coordination.”

📊 EFFORT METRICS

Understanding effort requires measuring multiple dimensions:

Metric	Description	Weight
Commits	Base unit of work	1.0
Lines Added	New code contribution	0.1/line
Lines Deleted	Code cleanup/refactoring	0.05/line
Files Changed	Scope of change	0.5/file
Issue Reference	Connected work	2.0 bonus
PR Merge	Integration effort	3.0 bonus

MetricCommits

DescriptionBase unit of work

Weight1.0

MetricLines Added

DescriptionNew code contribution

Weight0.1/line

MetricLines Deleted

DescriptionCode cleanup/refactoring

Weight0.05/line

MetricFiles Changed

DescriptionScope of change

Weight0.5/file

MetricIssue Reference

DescriptionConnected work

Weight2.0 bonus

MetricPR Merge

DescriptionIntegration effort

Weight3.0 bonus

🎯 EFFORT SCORE

The Effort Score is a weighted calculation:

code

Effort = (Commits × 1) + (Lines Added × 0.1) + (Lines Deleted × 0.05) 
       + (Files Changed × 0.5) + Bonuses

This provides a normalized way to compare development effort across:

- Different time periods

- Different authors

- Different types of work

🏷️ COMMIT CATEGORIES

Commits are categorized by their prefix:

Prefix	Category	Focus
FEAT.	Feature	New functionality
FIX.	Bug Fix	Issue resolution
THINK.	Research	Investigation/planning
UX.	Design	User experience
DEBT.	Tech Debt	Maintenance
UNPARTY.	Platform	Core infrastructure
WORKFLOW.	Workflow	Automation
STAGE.	Staging	Deployment
STORY.	Story	Content/narrative
LLM.	AI	LLM integration
DEPEND.	Dependencies	Package updates
DOC.	Documentation	Writing
LEARN.	Learning	Education

PrefixFEAT.

CategoryFeature

FocusNew functionality

PrefixFIX.

CategoryBug Fix

FocusIssue resolution

PrefixTHINK.

CategoryResearch

FocusInvestigation/planning

PrefixUX.

CategoryDesign

FocusUser experience

PrefixDEBT.

CategoryTech Debt

FocusMaintenance

PrefixUNPARTY.

CategoryPlatform

FocusCore infrastructure

PrefixWORKFLOW.

CategoryWorkflow

FocusAutomation

PrefixSTAGE.

CategoryStaging

FocusDeployment

PrefixSTORY.

CategoryStory

FocusContent/narrative

PrefixLLM.

CategoryAI

FocusLLM integration

PrefixDEPEND.

CategoryDependencies

FocusPackage updates

PrefixDOC.

CategoryDocumentation

FocusWriting

PrefixLEARN.

CategoryLearning

FocusEducation

📁 FOCUS AREAS

File changes are categorized to understand where effort is directed:

Area	Pattern	Indicator
🧩 Components	`/components/`, `.tsx`	UI building
📄 Pages	`/pages/`, `/app/`	Routing
🔌 API	`/api/`	Backend
⚙️ Scripts	`/scripts/`, `.sh`	Automation
🧪 Tests	`.test.`, `.spec.`	Quality
🎨 Styles	`.css`, `.scss`	Design
⚡ Config	`config`, `.json`	Setup
📝 Docs	`.md`	Documentation

Area🧩 Components

Pattern/components/, .tsx

IndicatorUI building

Area📄 Pages

Pattern/pages/, /app/

IndicatorRouting

Area🔌 API

Pattern/api/

IndicatorBackend

Area⚙️ Scripts

Pattern/scripts/, .sh

IndicatorAutomation

Area🧪 Tests

Pattern.test., .spec.

IndicatorQuality

Area🎨 Styles

Pattern.css, .scss

IndicatorDesign

Area⚡ Config

Patternconfig, .json

IndicatorSetup

Area📝 Docs

Pattern.md

IndicatorDocumentation

📈 USAGE

CLI Commands

bash

# Analyze last 7 days (default)
npm run effort

# Analyze last week
npm run effort:weekly

# Analyze 2-week sprint
npm run effort:sprint

# Analyze full month
npm run effort:month

# JSON output for integration
npm run effort:json

Direct Script Usage

bash

# Custom period
node scripts/sprint-effort-analysis.js --days 14

# Filter by author
node scripts/sprint-effort-analysis.js --author "unparty"

# Help
node scripts/sprint-effort-analysis.js --help

🪩 WEEKLY SUMMARY ANALYSIS

This issue represents analysis of the weekly summary:

Period: 2026-03-30 to 2026-04-03

Metric	Value
Total Commits	88
Lines Added	13,976
Lines Deleted	3,359
Net Change	+10,617
Direction	Growth

MetricTotal Commits

Value88

MetricLines Added

Value13,976

MetricLines Deleted

Value3,359

MetricNet Change

Value+10,617

MetricDirection

ValueGrowth

Key Insights

1. High Growth Period - Net positive change of 10,617 lines indicates active feature development

2. Diverse Contributors - Mix of human (unparty, justin murry) and AI (copilot-swe-agent, claude) commits

3. Category Distribution - Mix of FEAT., FIX., THINK., UX. prefixes shows balanced development

4. New Files Created - 35 new files created, indicating expanding codebase

🔗 CONNECT

- Script: scripts/sprint-effort-analysis.js

- Related: story-029.md (runway features analysis)

- Data: Uses git log analysis

Created: 2026-04-04

SPRINT. Effort measurement for development focus and performance.