---
name: proposaltemplate
description: Generate professional consulting proposal templates with pricing calculation
disable-model-invocation: true
---

## Configuration

Read `.jobops/config.json`. If missing, stop with:

> JOBOPS NOT CONFIGURED
> Run /jobops:setup (then /jobops-ic:setup) to initialize your workspace.

Use `config.directories.contractor_root` for output paths in this skill.
Use `config.preferences.default_currency` for pricing if applicable.

## Arguments

Generate McKinsey/BCG-style proposal with transparent pricing calculations.

- `--client=name`: Client name (default: "Generic")
- `--service=name`: Service from definition (default: primary service)
- `--type=TYPE`: `project|retainer|staff-aug|workshop` (default: project)
- `--value=amount`: Target pricing (default: calculated from rate card)

---

## Phase 1: Prerequisites & Input Loading

### 1.1 Load Service Definition

Find most recent: `find {config.directories.contractor_root}/services/ -name "service_definition_*.md" -type f | sort -r | head -1`

**If missing:** Stop execution. Guide user to run `/defineservices` first.

**Parse required sections:**
- Consultant: name, credentials, years_experience, contact info
- Services: name, deliverables, pricing range, typical_duration, success_metrics, case_studies
- Rate Card: hourly/daily/retainer rates, payment_terms, expenses
- Engagement Models: preferred/acceptable types, minimum_engagement
- Differentiation: unique_value, competitive_advantages, proof_points

**Validate:** Require rate_card with hourly/daily rates, consultant credentials, >=1 service, payment_terms.

### 1.2 Parse Arguments

- `--client`: Extract name, sanitize, default "Generic"
- `--service`: Fuzzy match against services, default to primary service, error if no match
- `--type`: Validate against [project|retainer|staff-aug|workshop], default "project"
- `--value`: Parse numeric, default null (calculate from rate card)

### 1.3 Load Optional Context

**Pitch Deck** (if client != "Generic"):
- Find: `{config.directories.contractor_root}/pitches/*${client}*.md` (most recent)
- Extract: prospect_research (pain_points, strategic_priorities, decision_makers, research_date)
- Set `prospect_context.has_prior_research = true/false`

**Candidate Credentials** (read directly from resume source):
For proposal-relevant credentials, read:
- `WorkHistory/*.md` — relevant role history, achievements with metrics
- `Projects/*.md` — case studies with outcomes
- `Technology/Certifications.md` — Active certifications relevant to the proposal scope
- `CareerHighlights/*.md` if present — quantified accomplishments
- `Preferences/Vision.md` — engagement and pricing preferences

Do NOT load `candidate_profile.json` — removed in v2.2.0.

---

## Phase 2: Pricing Calculation

**CRITICAL: Transparent, defensible pricing with full traceability**

### 2.1 Calculate by Engagement Type

**PROJECT**: `estimated_hours x hourly.target x volume_discount`
- Hours from: typical_duration (weeks x 25 hrs/week) OR --value/hourly.target OR target_price/hourly.target
- Volume discounts: >$100K: 10%, >$50K: 5%, >$25K: 2.5%

**RETAINER**: `monthly_hours x effective_rate`
- Effective rates: Full-time (160h): minimum rate, Half (80h): target x 0.85, Quarter (40h): target x 0.90, Part (<40h): target x 0.95

**STAFF-AUG**: `20_days x daily.target x duration_discount`
- Duration discounts: >=6mo: 10%, >=3mo: 5%

**WORKSHOP**: `(workshop_days x daily.premium) + (prep_days x daily.target) + materials + followup`
- Prep days: max(1, workshop_days x 0.5)
- Materials: $500/participant, Followup: 10 hours x hourly.target

### 2.2 Validation

**Range Check**: Compare to service pricing.range (allow 20% buffer), warn if outside
**Minimum Check**: Enforce minimums (project: $5K, retainer: $2K/mo, staff-aug: $8K/mo, workshop: $3K)

Generate pricing_calculation YAML metadata for frontmatter with method, rates, hours/days, discounts, final price.

---

## Phase 3: Generate 10-Section McKinsey/BCG Proposal

**Structure**: Cover -> Executive Summary -> Understanding Challenge -> Proposed Approach -> Deliverables/Timeline -> Team/Qualifications -> Investment -> Terms -> Next Steps -> Appendix

**Generation Rules**:
- Use prospect_context for client-specific content (if has_prior_research=true), otherwise generic
- Include pricing_calculation YAML frontmatter
- Add evidence citations: `[Evidence: source_file -> section]`
- Customize by engagement type (project/retainer/staff-aug/workshop)

### Section Templates (Adapt by Engagement Type)

**Cover Page**: YAML frontmatter with pricing_calculation metadata + title/client/consultant/date/validity (14 days)/reference (PROP-YYYYMMDD-ClientInit-ServiceInit)

**Executive Summary**:
- Client-specific: Use pain_points from prospect_context + strategic_priorities
- Generic: Use ideal_client.pain_points from service definition
- Include: problem statement, solution approach, expected outcomes (success_metrics), investment summary, payment terms, next steps timeline

**Understanding Your Challenge**:
- Client-specific: Current situation, pain points with business impact, urgency drivers from research, desired future state
- Generic: Common challenges in industry, typical business impact, why organizations seek service, success outcomes

**Proposed Approach** (varies by type):
- PROJECT: 3-4 phases with duration/objective/activities/deliverables/client involvement per phase + methodology notes
- RETAINER: Monthly hour allocation, services covered (strategic advisory + tactical support), hour tracking, overage policy, typical monthly cadence
- STAFF-AUG: Role definition, responsibilities, skills, working arrangement (reporting/schedule/location/tools), integration timeline, success metrics
- WORKSHOP: Overview, agenda (day-by-day sessions), materials, post-workshop support, preparation requirements, expected outcomes

**Deliverables & Timeline**:
- Complete deliverables list with format/delivery date/acceptance criteria
- Timeline table (Gantt-style for project, recurring for retainer, continuous for staff-aug, milestone-based for workshop)
- Key milestones with gates, regular check-in cadence

**Team & Qualifications**:
- If candidate credentials loaded from source files: Credentials, domain expertise, technical capabilities, relevant achievements (top 3-5 with evidence from WorkHistory/Projects), certifications from Technology/Certifications.md, thought leadership
- If source files missing or sparse: Use differentiation section (competitive_advantages, proof_points, unique_value)

**Investment**:
- Pricing table by type (project phases, retainer tiers, staff-aug breakdown, workshop components)
- Payment terms (deposit %, progress/recurring payments, invoice terms, late fees, accepted methods)
- Expenses (included vs. billable)
- Pricing transparency (calculation method, validation, value justification with ROI)

**Terms & Conditions**:
- Scope (included/excluded deliverables)
- Assumptions (client access, timeline, environment)
- Change management process
- IP ownership (work product -> client, pre-existing -> consultant with license, confidentiality)
- Warranties & limitations
- Termination (for convenience vs. cause, notice periods by type)
- Engagement period & renewal
- Governing law & disputes

**Next Steps**:
- Review process, discussion scheduling, approval deadline (7-14 days), contract signing, kickoff timeline
- Client preparation checklist (administrative, access/resources, information)
- Contact info and customization options

**Appendix**:
- Detailed credentials (certifications from Technology/Certifications.md, education, thought leadership, technical proficiencies from WorkHistory/*.md)
- Case studies (from service_definition or Projects/*.md)
- References (available upon request)
- Terms/definitions, proposal metadata (generated date, reference, sources)

---

## Phase 4: Save & Report

### 4.1 File Output

**Filename**: `{config.directories.contractor_root}/proposals/[ClientCompany]_[YYYYMMDD].md`
- Sanitize ClientCompany: PascalCase, no special chars

### 4.2 Summary Report

Display:
- Output file path
- Proposal details (client, service, type, investment, duration)
- Pricing calculation (method, rates, discounts, validation status)
- Proposal contents (sections, deliverables count, customization level)
- Prospect research integration status
- Sources used
- Next steps: review, customize, convert (formatresume/convert), send, handle changes
- Best practices: respond quickly (24-48h), personalize, be specific, show expertise, price transparently

**Warnings**:
- Below minimum viable engagement: Flag for review with options
- Price outside service range: Explain and recommend
- Stale prospect research (>30 days): Suggest refresh

---

## Error Handling

**Stop Execution Errors**:
1. No service definition found -> Guide to `/defineservices`
2. Service not found -> List available services
3. Incomplete service definition (missing required sections) -> Guide to `/defineservices --update`
4. Pricing calculation failed -> Provide --value or update service definition

**Continue with Default**:
- Invalid engagement type -> Default to "project", warn user

---

## Usage Examples

1. **Generic project** (default): `/proposaltemplate`
2. **Client-specific**: `/proposaltemplate --client="Hatch" --service="AI Agent Development"`
3. **Retainer**: `/proposaltemplate --client="OxfordProperties" --service="Portfolio Advisory" --type=retainer`
4. **Workshop with budget**: `/proposaltemplate --service="AI Training" --type=workshop --value=15000`
5. **Staff augmentation**: `/proposaltemplate --client="TechStartup" --service="Senior AI Engineer" --type=staff-aug`

---

**Now execute proposal generation following all phases above...**