@djm204/agent-skills 1.0.0

package/templates/business/marketing-expert/CLAUDE.md

@@ -0,0 +1,567 @@
+# Marketing Expert Development Guide
+
+Principal-level guidelines for developing brand strategy, planning multi-channel campaigns, analyzing market segments, crafting positioning, executing go-to-market plans, measuring marketing performance, and scaling growth through systematic frameworks.
+
+---
+
+## Overview
+
+This guide applies to:
+
+- Brand strategy, positioning, and competitive differentiation
+- Market segmentation, persona development, and sizing
+- Campaign planning, creative strategy, and channel mix optimization
+- Go-to-market execution, launch planning, and sales enablement
+- Marketing analytics, attribution modeling, and performance measurement
+- Growth frameworks, retention strategy, and scaling loops
+
+### Key Principles
+
+1. **Customer Obsession** - Every strategy starts and ends with a deep understanding of the customer
+2. **Positioning Clarity** - If you cannot articulate differentiation in one sentence, you have not found it yet
+3. **Measurable Outcomes** - Marketing without measurement is guessing with a budget
+4. **Full-Funnel Thinking** - Optimize for the journey, not a single touchpoint
+5. **Compounding Returns** - Build assets and loops that increase in value over time
+6. **Intellectual Honesty** - Kill campaigns that do not work; double down on those that do
+
+### Core Frameworks
+
+| Framework | Purpose |
+|-----------|---------|
+| STP (Segmentation, Targeting, Positioning) | Foundation for all strategic marketing decisions |
+| AARRR (Pirate Metrics) | Acquisition, Activation, Retention, Revenue, Referral funnel |
+| Brand Pyramid | Build brand meaning from attributes to emotional benefits |
+| Jobs To Be Done (JTBD) | Understand why customers hire your product |
+| 4Ps / 7Ps Marketing Mix | Product, Price, Place, Promotion (+ People, Process, Physical Evidence) |
+| RACE Framework | Reach, Act, Convert, Engage digital marketing planning |
+| ICE Scoring | Impact, Confidence, Ease prioritization for experiments |
+| Porter's Generic Strategies | Cost leadership, differentiation, focus positioning |
+
+---
+
+## Brand Strategy
+
+### Brand Architecture
+
+| Model | Description | Example | Trade-off |
+|-------|-----------|---------|-----------|
+| Branded House | Single master brand across all products | Google | Equity transfers, but risk spreads |
+| House of Brands | Independent brands under parent | P&G (Tide, Pampers) | Segment targeting, but higher cost |
+| Endorsed Brand | Sub-brands with parent endorsement | Marriott | Balance of trust and independence |
+| Hybrid | Mix of approaches per business unit | Microsoft | Flexibility, but complexity |
+
+### Brand Positioning Canvas
+
+| Element | Definition | Example |
+|---------|-----------|---------|
+| Target Audience | Who are you for? | "Growth-stage B2B SaaS companies" |
+| Category | What space do you compete in? | "Revenue intelligence platform" |
+| Key Benefit | What is the primary value? | "Close deals 40% faster" |
+| Reason to Believe | Why should they trust you? | "AI trained on 10M+ sales calls" |
+| Brand Personality | What human traits describe you? | "Bold, data-driven, approachable" |
+| Competitive Alternative | What would they use instead? | "Manual CRM logging and gut instinct" |
+
+### Messaging Hierarchy
+
+```text
+Messaging Hierarchy
+├── Brand Promise (1 sentence)
+│   └── The single most important thing you want people to remember
+├── Value Propositions (3-5 pillars)
+│   ├── Pillar 1: [Functional benefit]
+│   ├── Pillar 2: [Emotional benefit]
+│   ├── Pillar 3: [Differentiator]
+│   └── Pillar 4: [Social proof / trust]
+├── Proof Points (per pillar)
+│   ├── Customer stories, case studies
+│   ├── Data, benchmarks, third-party validation
+│   └── Product features and capabilities
+└── Audience-Specific Messaging
+    ├── Decision Maker: Business outcomes, ROI
+    ├── Influencer: Technical depth, integration
+    ├── End User: Ease of use, daily value
+    └── Champion: Career advancement, peer recognition
+```
+
+### Positioning Statement Template
+
+```markdown
+## Positioning Statement
+
+For **[target audience]**
+who **[statement of need or opportunity]**,
+**[product name]** is a **[product category]**
+that **[key benefit / reason to buy]**.
+Unlike **[competitive alternative]**,
+our product **[primary differentiation]**.
+
+### Proof Points
+- [Data point or customer evidence 1]
+- [Data point or customer evidence 2]
+- [Data point or customer evidence 3]
+```
+
+### Competitive Differentiation Matrix
+
+| Dimension | Your Brand | Competitor A | Competitor B | Competitor C |
+|-----------|-----------|-------------|-------------|-------------|
+| Price point | | | | |
+| Primary audience | | | | |
+| Core capability | | | | |
+| Key weakness | | | | |
+| Market perception | | | | |
+| Distribution model | | | | |
+
+---
+
+## Market Segmentation
+
+### Segmentation Approaches
+
+| Approach | Variables | Best For |
+|----------|----------|----------|
+| Demographic | Age, income, education, occupation | B2C mass market |
+| Firmographic | Industry, company size, revenue, location | B2B targeting |
+| Psychographic | Values, attitudes, interests, lifestyle | Brand positioning |
+| Behavioral | Usage patterns, purchase history, loyalty | Retention and upsell |
+| Needs-Based | Problems to solve, outcomes desired | Product-market fit |
+| Technographic | Tech stack, adoption patterns, maturity | SaaS and developer tools |
+
+### Market Sizing Framework
+
+```text
+Market Sizing Funnel
+├── TAM (Total Addressable Market)
+│   ├── Everyone who could theoretically buy
+│   ├── Method: Top-down from industry reports
+│   └── Purpose: Investor storytelling, ceiling check
+├── SAM (Serviceable Addressable Market)
+│   ├── Subset you can reach with current model
+│   ├── Method: Filter by geography, segment, channel
+│   └── Purpose: Strategic planning horizon
+├── SOM (Serviceable Obtainable Market)
+│   ├── Realistic share you can capture in 1-3 years
+│   ├── Method: Bottom-up from pipeline and capacity
+│   └── Purpose: Revenue forecasting, resource allocation
+└── Beachhead Market
+    ├── The first niche you dominate completely
+    ├── Method: Identify highest urgency + lowest competition
+    └── Purpose: Establish credibility before expanding
+```
+
+### Persona Development Template
+
+```markdown
+## Persona: [Name]
+
+**Role**: [Job title / function]
+**Company**: [Size, industry, stage]
+
+### Goals and Pain Points
+| Goals | Pain Points |
+|-------|------------|
+| [Primary professional goal] | [What keeps them up at night] |
+| [Goal related to your product] | [Daily frustration in your category] |
+
+### Buying Behavior
+| Factor | Detail |
+|--------|--------|
+| Research sources | [Where they learn] |
+| Decision criteria | [Top 3 purchase factors] |
+| Buying process | [Solo / committee / procurement] |
+| Budget authority | [Approver / influencer / user] |
+| Typical sales cycle | [Days / weeks / months] |
+```
+
+### ICP (Ideal Customer Profile) Scoring
+
+| Attribute | Weight | Score (1-5) | Weighted Score |
+|-----------|--------|-------------|---------------|
+| Industry fit | 20% | | |
+| Company size | 15% | | |
+| Budget availability | 20% | | |
+| Pain severity | 25% | | |
+| Technology readiness | 10% | | |
+| Champion presence | 10% | | |
+| **Total** | **100%** | | **__ / 5.0** |
+
+---
+
+## Campaign Strategy
+
+### Campaign Planning Framework
+
+```text
+Campaign Lifecycle
+├── Strategy
+│   ├── Define objective (awareness / consideration / conversion)
+│   ├── Identify target segments and personas
+│   ├── Set KPIs and success criteria
+│   └── Determine budget and timeline
+├── Creative
+│   ├── Develop core concept and messaging
+│   ├── Create asset matrix (formats x channels)
+│   ├── Build landing pages and conversion paths
+│   └── Prepare A/B test variants
+├── Execution
+│   ├── Launch across channels per media plan
+│   ├── Monitor pacing and delivery daily
+│   ├── Optimize bids, targeting, and creative in-flight
+│   └── Coordinate cross-channel sequencing
+├── Measurement
+│   ├── Track against KPIs daily/weekly
+│   ├── Run attribution analysis
+│   ├── Conduct post-campaign analysis
+│   └── Document learnings for next cycle
+└── Iteration
+    ├── Scale winning combinations
+    ├── Kill underperformers quickly
+    ├── Feed learnings into next campaign
+    └── Update persona and channel insights
+```
+
+### Channel Mix Matrix
+
+| Channel | Funnel Stage | Cost Model | Strengths | Weaknesses |
+|---------|-------------|-----------|-----------|------------|
+| Paid Search | Consideration / Conversion | CPC | High intent, measurable | Expensive, competitive |
+| Paid Social | Awareness / Consideration | CPM / CPC | Targeting precision, scale | Ad fatigue, privacy changes |
+| Content Marketing | All stages | Fixed cost | Compounding value, SEO | Slow to build, hard to measure |
+| Email Marketing | Consideration / Retention | Fixed cost | High ROI, owned channel | List decay, deliverability |
+| Events / Webinars | Consideration / Conversion | Fixed cost | Relationship building | High cost per lead, logistics |
+| SEO / Organic | Awareness / Consideration | Fixed cost | Sustainable traffic | 6-12 month ramp, algorithm risk |
+| Partnerships | All stages | Revenue share | Trust transfer, new audiences | Less control, alignment issues |
+| Direct Mail | Consideration / Conversion | Per piece | Cuts through digital noise | Cost, targeting accuracy |
+
+### Budget Allocation Model
+
+| Category | Early Stage (%) | Growth Stage (%) | Mature Stage (%) |
+|----------|----------------|-----------------|-----------------|
+| Paid acquisition | 40-50 | 30-40 | 20-30 |
+| Content and SEO | 20-25 | 20-25 | 15-20 |
+| Brand and creative | 10-15 | 15-20 | 20-25 |
+| Events and sponsorships | 5-10 | 10-15 | 15-20 |
+| Marketing operations | 10-15 | 10-15 | 10-15 |
+| Experimentation reserve | 5-10 | 5-10 | 5-10 |
+
+### Campaign Brief Template
+
+```markdown
+## Campaign Brief: [Campaign Name]
+
+**Objective**: [Awareness / Lead Gen / Conversion / Retention]
+**Target Segment**: [Primary persona and ICP]
+**Timeline**: [Start date] - [End date]
+**Budget**: [Total budget, breakdown by channel]
+
+### Core Message
+[One sentence summarizing the campaign value proposition]
+
+### Success Metrics
+| KPI | Target | Measurement Method |
+|-----|--------|-------------------|
+| [Metric 1] | [Target value] | [How measured] |
+| [Metric 2] | [Target value] | [How measured] |
+| [Metric 3] | [Target value] | [How measured] |
+
+### Channel Plan
+| Channel | Budget | Goal | Timeline |
+|---------|--------|------|----------|
+| [Channel 1] | [$X] | [Channel-specific goal] | [Dates] |
+| [Channel 2] | [$X] | [Channel-specific goal] | [Dates] |
+
+### Creative Requirements
+- [Asset 1: Format, dimensions, copy length]
+- [Asset 2: Format, dimensions, copy length]
+
+### Approval Process
+| Milestone | Approver | Date |
+|-----------|----------|------|
+| Brief sign-off | [Name] | [Date] |
+| Creative approval | [Name] | [Date] |
+| Launch approval | [Name] | [Date] |
+```
+
+---
+
+## Go-to-Market Execution
+
+### GTM Strategy Components
+
+```text
+Go-to-Market Architecture
+├── Market Definition
+│   ├── Target segment and ICP
+│   ├── Beachhead vs expansion markets
+│   ├── Market timing and readiness
+│   └── Competitive landscape
+├── Value Proposition
+│   ├── Positioning statement
+│   ├── Messaging by persona
+│   ├── Proof points and social proof
+│   └── Pricing and packaging
+├── Distribution Strategy
+│   ├── Direct sales (enterprise)
+│   ├── Self-serve (PLG)
+│   ├── Channel partners (resellers, integrators)
+│   └── Marketplace (app stores, directories)
+├── Demand Generation
+│   ├── Inbound (content, SEO, community)
+│   ├── Outbound (sales, ABM, events)
+│   ├── Product-led (freemium, trials, viral)
+│   └── Partner-led (co-marketing, referrals)
+└── Sales Enablement
+    ├── Battle cards and competitive intel
+    ├── Demo scripts and talk tracks
+    ├── Objection handling guides
+    └── ROI calculators and business cases
+```
+
+### Launch Readiness Checklist
+
+| Area | Item | Owner | Status |
+|------|------|-------|--------|
+| Product | Feature complete and QA passed | PM | |
+| Pricing | Pricing page and billing tested | RevOps | |
+| Messaging | Positioning and copy finalized | Marketing | |
+| Content | Blog, landing page, one-pager ready | Content | |
+| Sales | Team trained, materials distributed | Enablement | |
+| Support | Knowledge base and FAQs published | Support | |
+| PR | Press release and media outreach planned | Comms | |
+| Analytics | Tracking, dashboards, and alerts live | Analytics | |
+| Legal | Terms, privacy, compliance reviewed | Legal | |
+| Executive | Internal announcement and alignment | Leadership | |
+
+### Pricing Strategy Matrix
+
+| Strategy | Description | Best For |
+|----------|-----------|----------|
+| Value-Based | Price reflects customer value received | Strong differentiation, measurable ROI |
+| Competitive | Price relative to alternatives | Commoditized markets, price-sensitive buyers |
+| Cost-Plus | Price = cost + margin | Physical products, services with clear COGS |
+| Penetration | Low initial price to capture share | New market entry, network effects |
+| Skimming | High initial price, lower over time | Innovation-driven, early adopter segments |
+| Freemium | Free tier + paid upgrades | PLG, high volume, low marginal cost |
+| Usage-Based | Pay per unit consumed | Infrastructure, API, platform businesses |
+
+---
+
+## Marketing Analytics
+
+### Measurement Framework
+
+```text
+Analytics Hierarchy
+├── Business Metrics (Board Level)
+│   ├── Revenue attributed to marketing
+│   ├── Customer acquisition cost (CAC)
+│   ├── CAC payback period
+│   ├── Marketing-sourced pipeline
+│   └── Brand awareness (aided/unaided)
+├── Program Metrics (VP Level)
+│   ├── Pipeline generated by channel
+│   ├── Conversion rates by funnel stage
+│   ├── Cost per lead / cost per MQL / cost per SQL
+│   ├── Content engagement rates
+│   └── Channel ROI
+├── Campaign Metrics (Manager Level)
+│   ├── Impressions, clicks, CTR
+│   ├── Landing page conversion rate
+│   ├── Email open rate, click rate
+│   ├── Social engagement rate
+│   └── A/B test results
+└── Operational Metrics (Team Level)
+    ├── Content production velocity
+    ├── Campaign launch on-time rate
+    ├── SLA adherence (lead response time)
+    ├── Database health (bounce, unsubscribe)
+    └── Tool utilization and adoption
+```
+
+### Attribution Models
+
+| Model | Description | Strengths | Weaknesses |
+|-------|-----------|-----------|------------|
+| First Touch | 100% credit to first interaction | Simple, shows awareness drivers | Ignores nurture and conversion |
+| Last Touch | 100% credit to last interaction | Simple, shows conversion drivers | Ignores awareness and middle |
+| Linear | Equal credit to all touchpoints | Fair distribution | No signal on what matters most |
+| Time Decay | More credit to recent touches | Reflects recency value | Undervalues brand and content |
+| U-Shaped | 40% first, 40% last, 20% middle | Balances awareness and conversion | Somewhat arbitrary weights |
+| W-Shaped | 30% first, 30% lead create, 30% opportunity, 10% rest | Full-funnel visibility | Complex to implement |
+| Data-Driven | Algorithmic based on actual paths | Most accurate | Requires volume, black box |
+
+### A/B Testing Protocol
+
+| Phase | Activity | Detail |
+|-------|----------|--------|
+| Hypothesis | State what you expect to happen | "Changing CTA from 'Learn More' to 'See Demo' will increase CTR by 15%" |
+| Design | Define test parameters | Variable, control, sample size, duration |
+| Execution | Run the test | Ensure random assignment, no contamination |
+| Analysis | Evaluate results | Statistical significance (p < 0.05), effect size |
+| Decision | Act on findings | Implement winner, document learning |
+| Archive | Record for institutional memory | Test ID, hypothesis, result, next action |
+
+### KPI Dashboard Structure
+
+| Dashboard | Audience | Refresh | Key Metrics |
+|-----------|----------|---------|-------------|
+| Executive | C-suite, Board | Monthly | Revenue, CAC, brand awareness, pipeline |
+| Demand Gen | VP Marketing | Weekly | Pipeline by channel, conversion rates, spend efficiency |
+| Content | Content Team | Weekly | Traffic, engagement, SEO rankings, content pipeline |
+| Campaign | Campaign Managers | Daily | Impressions, clicks, conversions, pacing |
+| Product Marketing | PMM | Monthly | Win/loss rates, feature adoption, competitive landscape |
+
+---
+
+## Growth Frameworks
+
+### Growth Loop Architecture
+
+```text
+Growth Loop Types
+├── Viral Loop
+│   ├── User invites others as part of core experience
+│   ├── Metric: Viral coefficient (K-factor)
+│   ├── Example: Dropbox referral, Slack workspace invites
+│   └── Lever: Reduce friction in sharing, increase incentive
+├── Content Loop
+│   ├── Users create content that attracts new users via search
+│   ├── Metric: User-generated content volume, SEO impressions
+│   ├── Example: Pinterest pins, Stack Overflow answers
+│   └── Lever: Make creation easy, optimize for discoverability
+├── Paid Loop
+│   ├── Revenue funds acquisition spend that generates more revenue
+│   ├── Metric: LTV:CAC ratio, payback period
+│   ├── Example: Performance marketing reinvestment
+│   └── Lever: Improve LTV, reduce CAC, shorten payback
+├── Sales Loop
+│   ├── Customer success generates referrals and case studies
+│   ├── Metric: Net revenue retention, referral pipeline
+│   ├── Example: Enterprise land-and-expand
+│   └── Lever: Drive adoption, capture advocates, enable referrals
+└── Product Loop
+    ├── Product usage generates data/network effects that improve value
+    ├── Metric: Engagement depth, network density
+    ├── Example: Waze traffic data, marketplace liquidity
+    └── Lever: Increase usage frequency, expand use cases
+```
+
+### AARRR Funnel Optimization
+
+| Stage | Question | Key Metrics | Tactics |
+|-------|----------|------------|---------|
+| Acquisition | How do users find us? | Traffic sources, CAC, signup rate | SEO, paid, content, partnerships |
+| Activation | Do users experience core value quickly? | Time to value, onboarding completion | Onboarding flows, guided setup, quick wins |
+| Retention | Do users come back? | DAU/MAU, churn rate, cohort curves | Engagement loops, notifications, habit formation |
+| Revenue | Do users pay? | Conversion to paid, ARPU, expansion | Pricing experiments, upsell, packaging |
+| Referral | Do users tell others? | K-factor, NPS, referral conversion | Referral programs, sharing features, advocacy |
+
+### Experimentation Framework
+
+```text
+Experiment Lifecycle
+├── Ideation
+│   ├── Collect ideas from all teams
+│   ├── Categorize by funnel stage
+│   └── Estimate potential impact
+├── Prioritization (ICE Scoring)
+│   ├── Impact: How big is the potential win? (1-10)
+│   ├── Confidence: How sure are we it will work? (1-10)
+│   ├── Ease: How quick and cheap to test? (1-10)
+│   └── Score = (I + C + E) / 3
+├── Design
+│   ├── Write hypothesis statement
+│   ├── Define success metric and threshold
+│   ├── Calculate minimum sample size
+│   └── Set test duration
+├── Execution
+│   ├── Build minimum viable test
+│   ├── QA and launch
+│   ├── Monitor for data quality issues
+│   └── Do not peek at results early
+└── Learning
+    ├── Analyze with statistical rigor
+    ├── Document win, loss, or inconclusive
+    ├── Share learnings across teams
+    └── Feed into next experiment cycle
+```
+
+### Retention Strategy Framework
+
+| Strategy | Mechanism | Application |
+|----------|----------|-------------|
+| Habit Formation | Trigger-action-reward loops | Daily/weekly engagement hooks |
+| Switching Costs | Data, integrations, workflows invested | Deep product integration, data moats |
+| Community | Peer connections and shared identity | Forums, events, user groups |
+| Content | Ongoing education and value delivery | Courses, newsletters, product tips |
+| Personalization | Increasingly relevant experience | ML-driven recommendations, custom dashboards |
+| Expansion | New features and use cases over time | Product roadmap aligned to user maturity |
+
+### Product-Led Growth Stages
+
+| Stage | Key Tactics | Primary Metric |
+|-------|-----------|---------------|
+| Acquisition | Free tier, SEO templates, developer ecosystem | Signups, organic traffic |
+| Activation | Self-serve onboarding, time-to-value under 5 min | Onboarding completion, first value event |
+| Monetization | Usage-based triggers, in-product upgrade prompts, PQL scoring | Conversion to paid, ARPU |
+| Retention | Engagement scoring, re-engagement campaigns, feature launches | DAU/MAU, churn rate |
+| Expansion | Team invitations, cross-department discovery, enterprise tier | Net revenue retention, seats per account |
+
+---
+
+## Common Pitfalls
+
+### 1. Building Without Positioning
+
+Wrong: Jump straight into campaigns without a clear positioning statement. Run ads that describe features rather than customer outcomes.
+
+Right: Invest the time to define a sharp positioning statement. Validate it with customer interviews before spending a dollar on campaigns.
+
+### 2. Vanity Metrics Obsession
+
+Wrong: Celebrate impressions, followers, and page views. Report metrics that feel good but do not connect to revenue.
+
+Right: Tie every metric to a business outcome. If you cannot draw a line from the metric to revenue, it does not belong on the executive dashboard.
+
+### 3. Channel Loyalty Over Performance
+
+Wrong: Keep spending on a channel because "it has always worked" or because the team is comfortable with it.
+
+Right: Evaluate every channel quarterly by cost per pipeline dollar generated. Reallocate budget ruthlessly based on performance data.
+
+### 4. Ignoring Retention for Acquisition
+
+Wrong: Pour 90% of budget into top-of-funnel acquisition while churn silently erodes the customer base.
+
+Right: Balance acquisition and retention investment. A 5% improvement in retention often outperforms a 25% increase in lead volume.
+
+### 5. One-Size-Fits-All Messaging
+
+Wrong: Use the same pitch deck, email template, and ad copy for every segment and persona.
+
+Right: Develop persona-specific messaging that speaks to each audience's unique pain points, language, and buying criteria.
+
+### 6. Premature Scaling
+
+Wrong: Increase budget 10x on a campaign that showed early promise with a small sample before reaching statistical significance.
+
+Right: Validate performance with statistically significant data. Scale incrementally (2-3x at a time) and monitor for diminishing returns.
+
+### 7. Neglecting Brand for Performance
+
+Wrong: Invest exclusively in performance marketing. Build no brand equity. Become entirely dependent on paid channels.
+
+Right: Allocate 15-25% of budget to brand building. Brand creates demand that lowers long-term acquisition costs and increases conversion rates across all channels.
+
+---
+
+## Resources
+
+- [Positioning: The Battle for Your Mind - Al Ries and Jack Trout](https://www.goodreads.com/book/show/760025.Positioning)
+- [Obviously Awesome - April Dunford](https://www.goodreads.com/book/show/45166665-obviously-awesome)
+- [Hacking Growth - Sean Ellis and Morgan Brown](https://www.goodreads.com/book/show/31625935-hacking-growth)
+- [Building a StoryBrand - Donald Miller](https://www.goodreads.com/book/show/34460583-building-a-storybrand)
+- [Reforge Growth Series](https://www.reforge.com/)
+- [HubSpot Marketing Blog](https://blog.hubspot.com/marketing)
+- [Marketing Metrics - Farris, Bendle, Pfeifer, Reibstein](https://www.goodreads.com/book/show/99609.Marketing_Metrics)
+- [AARRR Pirate Metrics - Dave McClure](https://500hats.typepad.com/500blogs/2007/09/startup-metrics.html)

package/templates/business/predictive-maintenance/.cursor/rules/alerting.mdc

@@ -0,0 +1,56 @@
+---
+description: Alert Management
+alwaysApply: false
+---
+
+# Alert Management
+
+Guidelines for configuring, routing, and managing predictive maintenance alerts.
+
+## Alert Severity Levels
+
+| Level | Condition | Response Time | Action |
+|-------|-----------|--------------|--------|
+| P1 - Critical | Imminent failure (RUL < 48h) or safety risk | < 1 hour | Stop asset, emergency maintenance |
+| P2 - High | Significant degradation (RUL < 2 weeks) | < 8 hours | Schedule urgent maintenance |
+| P3 - Medium | Moderate degradation detected | < 48 hours | Plan maintenance in next window |
+| P4 - Low | Early degradation signal, trend emerging | Next review | Monitor, add to watchlist |
+| P5 - Info | Anomaly detected, no confirmed degradation | Log only | Record for pattern analysis |
+
+## Alert Routing
+
+| Severity | Primary Recipient | Channel |
+|----------|------------------|---------|
+| P1 | On-shift operator + maintenance lead | SMS + phone + dashboard |
+| P2 | Maintenance planner + shift supervisor | Email + dashboard + push |
+| P3 | Maintenance planner + asset engineer | Dashboard + email |
+| P4 | Asset engineer | Dashboard |
+| P5 | Analytics team | Log only |
+
+## Threshold Types
+
+- **Static**: Absolute limits from manufacturer specs (e.g., vibration > 18.0 mm/s = P1)
+- **Dynamic**: Adjusted for load, ambient temperature; alert when reading > mean + N std dev
+- **Model-based**: RUL drops below threshold, anomaly score exceeds confidence limit, or degradation rate accelerates
+
+## Alert Quality Metrics
+
+| Metric | Target |
+|--------|--------|
+| True positive rate | > 80% |
+| False alarm rate | < 15% |
+| Missed detection rate | < 5% |
+| Alert-to-action time | < SLA per severity |
+
+## Alert Fatigue Prevention
+
+- **Suppress duplicates**: Same asset, same condition, within suppression window
+- **Aggregate related**: Multiple sensors on one asset = one alert with details
+- **Escalate, don't repeat**: Unacknowledged P4 for 48h escalates to P3
+- **Tune continuously**: Review false alarms monthly, adjust thresholds quarterly
+- **Snooze with accountability**: Temporary suppression requires reason and expiration
+
+## Common Pitfalls
+
+- **Too many P1s**: Tight thresholds to "catch everything" produces 50 daily P1s, all ignored. Reserve P1 for imminent failure or safety risk.
+- **Static thresholds on variable assets**: Same vibration limit at 50% and 100% load. Normalize against operating conditions.

package/templates/business/predictive-maintenance/.cursor/rules/asset-lifecycle.mdc

@@ -0,0 +1,71 @@
+---
+description: Asset Lifecycle Management
+alwaysApply: false
+---
+
+# Asset Lifecycle Management
+
+Guidelines for tracking assets from commissioning through retirement.
+
+## Lifecycle Stages
+
+```text
+Procurement → Installation → Commissioning → Operation → Degradation → Overhaul/Replacement → Retirement
+```
+
+## Asset Registry Requirements
+
+Every monitored asset must have:
+
+| Field | Description |
+|-------|-------------|
+| Asset ID | Unique identifier (e.g., PUMP-WH3-042) |
+| Asset class | Equipment category |
+| Criticality | Safety/production/standard/non-critical |
+| Location | Physical location hierarchy |
+| Install date | Commissioning date |
+| Expected life | Design life or fleet average |
+| Current hours | Operating hours accumulated |
+| Maintenance/failure history | Linked records with root cause analysis |
+| Sensor mapping | Which sensors monitor this asset |
+
+## Health Index Scoring
+
+| Health Index | Condition | Action |
+|-------------|-----------|--------|
+| 90-100 | Excellent | Monitor at standard frequency |
+| 70-89 | Good | Monitor, no action needed |
+| 50-69 | Fair | Increase monitoring, plan maintenance |
+| 30-49 | Poor | Schedule maintenance in next window |
+| 0-29 | Critical | Immediate intervention required |
+
+## Fleet Analytics
+
+- **Survival analysis**: Weibull distribution of time-to-failure across fleet
+- **Bad actor identification**: Units with failure rates > 2x fleet average
+- **Aging curve analysis**: Health index degradation rate by age cohort
+- **Total cost of ownership**: Acquisition + maintenance + downtime + energy
+
+## Replacement Decision Framework
+
+```text
+Replace when:
+├── Repair cost > 50% of replacement AND asset > 60% of expected life
+├── Failure frequency > 3x in 12 months despite maintenance
+├── Spare parts becoming obsolete or unavailable
+├── Newer technology offers > 20% efficiency gain
+└── Safety risk exceeds acceptable threshold
+```
+
+## Cost Tracking Per Asset
+
+- **Capital cost**: Purchase and installation
+- **Cumulative maintenance**: All preventive and corrective actions
+- **Downtime cost**: Lost production attributed to this asset
+- **Energy cost**: Operating consumption trends
+- **Book value**: Current depreciated value
+
+## Common Pitfalls
+
+- **Treating all assets equally**: Segment by criticality. Safety-critical gets PdM; non-critical can run to failure.
+- **Ignoring fleet patterns**: Compare against fleet baselines. Faster-than-peer degradation signals a unique problem.