[20260312_DOCS] Added stable internal anchors for templates and troubleshooting references.

Team Quickstart (10-Person Team) ⚡¶

Goal: Roll out Code Scalpel to your entire team in under 1 hour.

Result: 40%+ team AI cost reduction, standardized tooling, measurable ROI.

Target Audience: Engineering Managers, Team Leads, VPs of Engineering for teams of 8-15 developers.

Prerequisites (5 minutes)¶

Before you start, make sure you have:

• ✅ Budget authority for team tools (<$25K/year for Pro tier)
• ✅ Team using Claude Desktop, GitHub Copilot, or Cursor
• ✅ Slack/Teams channel for announcements and support
• ✅ 1 hour of team time for rollout kickoff

Ready? Let's go! ⏱️

Phase 1: Evaluate (Week -1)¶

Step 1: Calculate Current Team AI Costs (10 minutes)¶

Ask your team: 1. How many developers are using AI assistants? 2. What's each developer's monthly AI bill? 3. What's the total team AI spend?

Example calculation:

10 developers × $300/developer/month = $3,000/month
Annual team AI cost: $36,000/year

Track this number—it's your baseline for ROI.

Step 2: Run Pilot with 2-3 Developers (1 week)¶

Pick your pilot team: - 1 senior dev (champion/advocate) - 1 mid-level dev (represents majority) - 1 skeptic (addresses concerns early)

Pilot goals: - ✅ Validate installation process - ✅ Measure actual savings - ✅ Identify adoption barriers - ✅ Get developer feedback

Pilot metrics to track: - Installation time per developer - First-week cost reduction % - Developer satisfaction (1-10 scale) - Issues encountered

Pilot Template →

Step 3: Get Buy-In from Leadership (30 minutes)¶

Prepare your ROI pitch:

For CFO/Finance: - Current spend: $3,000/month - Code Scalpel savings: 40% = $1,200/month - Annual savings: $14,400/year - Payback period: Immediate (free tier or <1 month with Pro)

For VP Engineering: - Faster AI responses = higher developer productivity - Standardized tooling across team - Security scanning included (saves $8K/year on other tools) - No workflow disruption

For CTO: - Open source (auditability) - Runs locally (no data exfiltration) - MCP standard (vendor-neutral) - Enterprise roadmap available

ROI Presentation Template →

Phase 2: Rollout (Day 1 - 1 Hour)¶

Step 1: Team Kickoff Meeting (15 minutes)¶

Agenda:

1. Announce the tool (2 minutes)
2. "We're rolling out Code Scalpel today"
3. "It will reduce our team AI costs by 40%"

4. "Installation takes 2 minutes per person"

5. Show the demo (5 minutes)

6. Live demo of token reduction (10,000 → 250 tokens)
7. Show time savings (10 seconds → 2 seconds)

8. Demonstrate first extraction

9. Share pilot results (3 minutes)

10. "Sarah saved 95% in the first week"
11. "Alex's queries went from $0.03 to $0.001"

12. "Jordan said it's the best tool we've adopted this year"

13. Installation walkthrough (5 minutes)

14. Screen share: step-by-step installation
15. Show configuration file location
16. Verify tools are available

Kickoff Slide Deck Template →

Step 2: Parallel Installation (20 minutes)¶

Have everyone install simultaneously:

1. Open installation guide together:

   https://docs.codescalpel.dev/getting-started/claude-desktop-2min
   

2. Step through together:

3. Install: pip install codescalpel (30 seconds)
4. Configure Claude Desktop (2 minutes)
5. Restart Claude (10 seconds)

6. Verify tools available (20 seconds)

7. Troubleshoot as a group:

8. Slack channel: #codescalpel-setup
9. Other devs can help each other
10. You handle edge cases

Common issues and fixes: - "Module not found" → Use full Python path - "Config not loading" → Check JSON syntax - "Tools not showing" → Restart Claude completely

Installation Troubleshooting →

Step 3: First Team Query (10 minutes)¶

Everyone does their first extraction together:

Ask team to try:

Use Code Scalpel to extract the main function from your current project

Expected results: - ✅ 8-10 successful extractions - ❓ 1-2 questions about specific edge cases - ❌ 0-1 installation errors (fix immediately)

Celebrate successes in Slack!

Step 4: Share Cheat Sheet (5 minutes)¶

Distribute quick reference:

# Code Scalpel Quick Reference

## Most Useful Tools (Use These Daily)

1. Extract function:
   "Use Code Scalpel to extract [function_name] from [file.py]"

2. Find usage:
   "Use get_symbol_references to find where [function_name] is used"

3. Security scan:
   "Use security_scan to check [file.py] for vulnerabilities"

4. Project map:
   "Use get_project_map to show me the project structure"

## Cost-Saving Tips

- ✅ Always use tools instead of pasting files
- ✅ Extract functions by name (not line numbers)
- ✅ Use project_map before diving deep
- ❌ Don't paste entire files and then ask to extract

## Support

- Slack: #codescalpel-support
- Docs: https://docs.codescalpel.dev
- Your team champion: @sarah

Full Cheat Sheet PDF →

Step 5: Set Team Goals (10 minutes)¶

Announce team targets:

Week 1 Goals: - ✅ 100% team installation - ✅ 50% use Code Scalpel at least 3 times - ✅ 25% use Code Scalpel daily

Month 1 Goals: - ✅ 80% weekly active users - ✅ 40% cost reduction achieved - ✅ <5 support requests per week

Month 3 Goals: - ✅ 90% daily active users - ✅ 40%+ sustained cost reduction - ✅ Developers prefer Code Scalpel to manual methods

Track progress in #codescalpel-metrics channel

Phase 3: Adoption (Week 1-4)¶

Week 1: Awareness & Usage¶

Daily Slack reminders:

Monday: "💡 Instead of pasting that file, try: 'Use Code Scalpel to extract...'"
Tuesday: "📊 Team saved $247 yesterday using Code Scalpel!"
Wednesday: "🎯 Pro tip: Use get_project_map before diving into unfamiliar code"
Thursday: "⚡ Sarah just saved 15 minutes with one Code Scalpel query!"
Friday: "🎉 Week 1 complete! 7/10 team members using Code Scalpel daily"

Week 2: Habit Formation¶

Introduce advanced features: - Monday: Security scanning tutorial - Wednesday: Cross-file dependency extraction - Friday: Symbolic execution demo

Share internal use cases:

"Jordan used cross_file_security_scan and found 3 SQL injection bugs we didn't know about!"

"Alex used get_call_graph to understand our auth flow in 30 seconds instead of 30 minutes"

"Sarah's Claude bill went from $320 last month to $67 this month. 🔥"

Week 3-4: Optimization¶

Host office hours (30 minutes/week): - Show advanced techniques - Answer questions - Share success stories - Gather feedback

Track and share metrics:

Team AI Cost Reduction (Month 1)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Week 1: -15% ($2,550/month)
Week 2: -28% ($2,160/month)
Week 3: -35% ($1,950/month)
Week 4: -42% ($1,740/month)

Total Savings: $1,260/month ($15,120/year)
ROI: ♾️ (free tier)

Measuring Team ROI¶

Metrics Dashboard¶

Track these weekly:

Generate automatically:

codescalpel usage-report --team --period week

ROI Presentation for Leadership¶

Month 1 Results:

# Code Scalpel ROI Report - Month 1

## Executive Summary
✅ **Goal:** Reduce team AI costs by 40%
✅ **Result:** Reduced costs by 42% ($1,260/month saved)
✅ **Adoption:** 90% of team using daily (9/10 developers)
✅ **Satisfaction:** Net Promoter Score: +8.5/10

## Financial Impact
- **Before:** $3,000/month ($36,000/year)
- **After:** $1,740/month ($20,880/year)
- **Savings:** $1,260/month ($15,120/year)
- **ROI:** ♾️ (free tier, no investment required)

## Productivity Impact
- **Avg query time:** 10s → 2s (80% faster)
- **Queries/day:** +45% (developers asking more questions)
- **Developer satisfaction:** 85% say "significantly better"

## Security Benefits
- 12 vulnerabilities found via security_scan
- Replaced $8K/year third-party security tool
- <10% false positive rate (vs 70% with previous tool)

## Next Steps
- Continue monitoring adoption
- Expand to adjacent teams (mobile, DevOps)
- Evaluate Pro tier for advanced team features

Full ROI Template →

Team Success Stories¶

Team A: 10-Person SaaS Startup¶

Before Code Scalpel: - 10 developers, $300/dev/month = $3,000/month - No standardized AI tooling - Developers using personal ChatGPT/Claude accounts

After 3 Months: - Standardized on Code Scalpel + Claude Desktop - Costs reduced to $1,800/month (40% savings) - $14,400/year saved - Developers love it (NPS: +8/10)

"Installation took 45 minutes for the whole team. We saved $1,200 in the first month. The CFO stopped asking about AI costs because they stabilized. ROI was immediate."

— David Park, Engineering Manager

Team B: 15-Person Fintech Startup¶

Before Code Scalpel: - 15 developers, varying AI usage - Total spend: $4,500/month - Security team concerned about code exfiltration

After 6 Months: - 100% team adoption - Costs reduced to $2,700/month (40% savings) - Security team satisfied (local execution, no cloud upload) - Found 8 security vulnerabilities missed by previous tools

"Our security team was skeptical at first, but when they learned Code Scalpel runs locally and includes taint analysis, they became champions. We save money and improve security."

— Jennifer Kim, VP Engineering

Common Team Rollout Challenges¶

Challenge 1: "I don't have time to learn a new tool"¶

Solution: - Show 2-minute installation - Demo immediate value (first query saves 10 seconds + $0.03) - Share cheat sheet for quick reference - Emphasize: no workflow change, just faster results

Challenge 2: "I'm a Claude power user, I know what I'm doing"¶

Solution: - Challenge them to a token-saving contest - Show advanced features (symbolic execution, cross-file scanning) - Ask them to try for 1 week and compare bills - Power users usually become biggest champions after trying

Challenge 3: "My workflow is already optimized"¶

Solution: - Audit their current workflow with them - Show exact token counts before/after - Calculate their personal monthly savings - Offer to install and configure for them

Challenge 4: "The team won't adopt it"¶

Solution: - Start with pilot (2-3 devs) - Share pilot results publicly - Incentivize adoption (team contest for most savings) - Make it visible (Slack bot posting daily savings)

Advanced Team Features (Pro/Enterprise)¶

Team Management Dashboard¶

Features: - Real-time usage monitoring - Cost tracking per developer - Adoption trends over time - Security scan summary

Example Dashboard:

Team: Engineering (10 members)
Period: Last 30 days

┌─────────────────────────────────────────┐
│ Team Savings: $1,260/month ($15,120/yr) │
│ Adoption Rate: 90% (9/10 developers)     │
│ Avg Query Time: 2.1 seconds             │
│ Security Issues Found: 12                │
└─────────────────────────────────────────┘

Top Contributors:
1. sarah@company.com - 1,245 queries (95% savings)
2. alex@company.com - 987 queries (93% savings)
3. jordan@company.com - 823 queries (91% savings)

Low Adoption (needs help):
- chris@company.com - 12 queries (suggest 1:1 training)

Team Policy Enforcement¶

Enforce standards across team:

# .code-scalpel/limits.toml
[team.budget]
monthly_token_limit = 5000000     # 5M tokens/month team budget
per_user_daily_limit = 50000      # 50K tokens/day per user
alert_threshold = 0.8             # Alert at 80%

[team.governance]
require_security_scan = true      # All PRs must pass security scan
min_test_coverage = 0.85          # 85% coverage required
allow_dangerous_sinks = false     # Block SQL injection patterns

Team Governance Guide →

Centralized Reporting¶

Generate team reports automatically:

# Weekly team report
codescalpel team-report --period week --output team-report.pdf

# Includes:
# - Cost savings breakdown
# - Adoption metrics
# - Security findings
# - Top/bottom performers
# - Recommendations

Scaling Beyond 10 Developers¶

25-Person Team Rollout¶

Phase rollout: - Week 1: Team A (10 devs) - Week 2: Team B (10 devs)
- Week 3: Team C (5 devs)

Benefits: - Iron out issues with first team - Champions from Team A help Team B - Gradual support burden

50+ Developer Enterprise Rollout¶

Structured approach: 1. Executive sponsorship (CTO/VP Eng) 2. Pilot with 10 devs (Month 1) 3. Rollout to 50 devs in phases (Month 2-3) 4. Full deployment (Month 4) 5. Ongoing optimization

Enterprise Rollout Guide →

Team Support Structure¶

Support Tiers¶

Tier 1: Peer Support (Slack #codescalpel-support) - Developers help each other - Champions answer common questions - Response time: <1 hour during business hours

Tier 2: Team Lead Support (Direct Messages) - You handle complex issues - Escalate configuration problems - Response time: <4 hours

Tier 3: Code Scalpel Support (GitHub/Email) - Bug reports - Feature requests - Enterprise support (Pro/Enterprise tier) - Response time: <24 hours (email), <1 week (GitHub)

Champion Program¶

Identify 2-3 champions: - Developers who adopt tools quickly - Natural mentors/teachers - Well-respected by team

Champion responsibilities: - Answer Slack questions - Share tips and tricks - Demo advanced features - Gather team feedback

Champion benefits: - Recognition (monthly "Champion of the Month") - Direct line to engineering manager - Early access to new features (Pro tier)

Month 1 Checklist¶

Week 1: Installation & Awareness¶

• Team kickoff meeting completed
• 100% team installation
• Slack support channel created
• Cheat sheet distributed
• First team query successful
• Usage tracking enabled

Week 2: Habit Formation¶

• Daily usage reminders sent
• 50% team using 3+ times/week
• First success stories shared
• Advanced features introduced
• Office hours scheduled

Week 3: Optimization¶

• Office hours conducted
• 70% team using daily
• Cost reduction measured
• Feedback gathered
• Champions identified

Week 4: ROI Presentation¶

• Month 1 metrics compiled
• ROI report created
• Leadership presentation delivered
• Month 2 goals set
• Team satisfaction surveyed

Templates¶

Pilot Phase Template¶

Week -1: Pilot Evaluation

Pilot Team: - Senior Dev: Sarah (@sarah) - Mid-Level Dev: Alex (@alex) - Skeptic: Jordan (@jordan)

Goals: - Validate installation process - Measure savings - Identify issues

Daily Check-ins: - Day 1: Installation complete? - Day 3: First impressions? - Day 5: Any blockers? - Day 7: Measured savings?

Results (Day 7): - Installation time: avg 3 minutes (target: <5 min) ✅ - Savings: Sarah 95%, Alex 92%, Jordan 89% ✅ - Issues: 2 minor (resolved in <10 min) ✅ - Satisfaction: 8.7/10 average ✅ - Recommendation: PROCEED WITH ROLLOUT

ROI Presentation Template¶

Slide 1: Executive Summary

Code Scalpel Team Rollout
ROI: $15,120/year saved
Implementation: 1 hour
Payback: Immediate

Slide 2: The Problem

Current State:
- 10 developers
- $3,000/month AI costs
- No standardization
- Security concerns

Slide 3: The Solution

Code Scalpel:
- Reduces AI costs 40%+
- Standardizes tooling
- Includes security scanning
- Runs locally (no data exfiltration)

Slide 4: Pilot Results

Pilot Team (3 developers, 1 week):
- 92% average cost reduction
- 2-minute installation
- 8.7/10 developer satisfaction
- Zero workflow disruption

Slide 5: Projected ROI

Investment: $0 (Community tier)
Monthly Savings: $1,200
Annual Savings: $14,400
Payback Period: Immediate

Slide 6: Rollout Plan

Week 1: Full team installation (1 hour)
Week 2-4: Adoption & optimization
Month 1: Measure results, present ROI

Slide 7: Next Steps

Decision: Approve Code Scalpel rollout
Timeline: Start this week
Success Criteria: 40% cost reduction in 30 days

Kickoff Slides Template¶

Slide 1: Title

Code Scalpel Rollout
Reduce AI Costs 40%+
Today, 3pm, 1 hour

Slide 2: Why

Team AI costs: $3,000/month
With Code Scalpel: $1,800/month
Savings: $1,200/month ($14,400/year)

Slide 3: What

Code Scalpel = Surgical code analysis for AI
Instead of pasting 10,000 tokens → extract 250 tokens
Result: 40x faster, 40x cheaper, same quality answers

Slide 4: Demo [Live demo]

Slide 5: Installation [Screen share step-by-step]

Slide 6: First Query [Everyone tries together]

Slide 7: Resources

Docs: https://docs.codescalpel.dev
Slack: #codescalpel-support
Champions: @sarah, @alex

Next Steps¶

Questions about team rollout? Open a discussion →

Need help with your rollout? Contact us →