software-effort-estimation

Estimate software development effort from git history and code metrics.

Updated Nov 18, 2025
One-click install
npx skills add https://github.com/cajias/claude-skills --skill software-effort-estimation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: software-effort-estimation
Source: https://github.com/cajias/claude-skills/tree/main/skills/software-effort-estimation
Command: npx skills add https://github.com/cajias/claude-skills --skill software-effort-estimation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires cloc, git, bc, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you estimate the true effort required to build or maintain a software system by combining codebase analysis, git history, and infrastructure inventory into a reproducible report. It is especially useful when you need to value a repository, plan a project budget, or compare traditional engineering effort against AI-assisted development.

Core Features & Use Cases

  • Codebase sizing: Measures production, test, generated, and documentation code to build a realistic effort baseline.
  • Multi-model estimation: Applies five estimation approaches, including COCOMO II, benchmark productivity rates, infrastructure premiums, blended hybrid rates, and team-sizing analysis.
  • Productivity comparison: Compares estimated traditional effort with actual delivery patterns derived from git activity to quantify speedup.
  • Verification workflow: Encourages cross-checking with repeated counts, spot checks, and model convergence to reduce false precision.
  • Use case: A product or engineering lead can analyze a repository before planning a roadmap, then present a defensible range for cost, timeline, and staffing.

Quick Start

Ask the Skill to analyze a local repository and produce a full software effort estimation report with metrics, validation, and a final person-month range.

Frequently Asked Questions about software-effort-estimation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I estimate software development effort from a git repository?

To estimate software development effort, the Skill analyzes git history and cloc line counts to calculate reproducible person-month estimates. It combines codebase sizing with multi-model approaches like COCOMO II to generate a defensible cost and timeline range.

What is the best way to value a codebase for project planning?

The best way to value a codebase is by combining infrastructure inventory parsing, test code measurement, and multi-model estimation. This produces a realistic effort baseline that quantifies traditional engineering costs versus AI-assisted delivery patterns.

Can I compare traditional engineering effort against AI-assisted development?

Yes, you can compare traditional engineering effort against AI-assisted development. The Skill compares estimated baseline effort with actual git delivery patterns to quantify productivity gains and calculate speedup across the analyzed history.

Do I need cloc and git installed to calculate person-months for a project?

Yes, you need cloc, git, and bc installed to calculate person-months. These dependencies are required to perform cloc-based line counting, parse git history, and execute multi-model calculations for the final estimation report.

Does software effort estimation work for infrastructure-heavy systems?

Software effort estimation works for infrastructure-heavy systems by applying infrastructure premiums and parsing infrastructure inventory. It adjusts multi-model calculations to accurately reflect the effort baseline of complex infrastructure-heavy codebases.

What are the limitations of using COCOMO II for codebase valuation?

A limitation of using COCOMO II for codebase valuation is false precision. To mitigate this, the Skill applies five estimation approaches and encourages cross-checking with repeated counts, spot checks, and model convergence for a reliable range.