Husqvarna-440/ISSUE_TEMPLATE.md

Chainsaw Issue Template - Husqvarna 440

Use this template for all issue tracking on the Husqvarna 440 chainsaw

---

📋 Quick Summary

Issue: [Brief description of problem]
Date Reported: YYYY-MM-DD
Hours on Saw: [Current hour meter reading or estimate]
Severity: [Low/Medium/High/Critical]
Status: [Investigation/Parts Needed/In Progress/Complete]

---

🪵 Chainsaw Details

• Year/Make/Model: Husqvarna 440 CH (X-TORQ)
• Engine: 50.9cc 2-cycle single cylinder
• Serial Number: [Enter serial number]
• Current Hours: [TBD - estimate based on use]

---

🔍 Problem Description

Symptoms:

• [Describe what's happening]
• [When does it occur?]
• [How often does it occur?]
• [Any conditions that make it worse/better?]

When it Occurred:

• [Date/time]
• [What was the saw doing when issue started?]
• [Any recent maintenance or modifications?]
• [Fuel/oil condition - fresh or old?]

---

📊 Diagnostic Findings

Initial Inspection Results

• Visual inspection complete
• Spark plug condition checked
• Air filter condition checked
• Fuel system inspected
• Carburetor adjustment checked
• Chain tension checked
• Spark arrestor screen checked
• [Other relevant checks]

Test Results

Test	Expected	Actual	Status	Tested At (YYYY-MM-DD HH:MM)
[Test 1]	[Expected]	[Actual]	[Status]	[Date/Time]
[Test 2]	[Expected]	[Actual]	[Status]	[Date/Time]
[Test 3]	[Expected]	[Actual]	[Status]	[Date/Time]

Diagnostic Data Collected

• Spark plug removed and inspected
• Carburetor screws checked (L, H, T positions)
• Fuel mixture verified (50:1 ratio)
• Air filter cleaned/inspected
• Spark arrestor screen checked
• Compression checked (if applicable)
• [Other data points]

---

🎯 Theories & Root Cause Analysis

Most Likely Causes (ranked by probability)

1. [Cause 1]

   • Why: [Explanation]
   • Evidence: [Supporting data]
   • How to confirm: [Test/procedure]

2. [Cause 2]

   • Why: [Explanation]
   • Evidence: [Supporting data]
   • How to confirm: [Test/procedure]

3. [Cause 3]

   • Why: [Explanation]
   • Evidence: [Supporting data]
   • How to confirm: [Test/procedure]

Common Failure Points for Husqvarna 440

1. Carburetor adjustment - Most common issue
2. Spark arrestor clogging
3. Air filter restriction
4. Old fuel/fuel system issues
5. Spark plug fouling
6. Chain tension issues

Historical Context

• [Previous issues on this chainsaw]
• [Known patterns or recurring problems]
• [Maintenance history]

---

🔧 Tools Needed

Basic Tools

• Spark plug socket (21mm)
• Carburetor adjustment tool (screwdriver)
• Air filter cleaning supplies
• Multimeter (optional)
• Tachometer (optional, for carb tuning)
• Basic hand tools

Safety Equipment

• Safety glasses
• Chainsaw gloves
• Hearing protection

---

📦 Parts & Materials

Parts Needed

Part	Part Number	Cost	Status
[Part 1]	[Number]	$XX-XX	[Status]
[Part 2]	[Number]	$XX-XX	[Status]

Materials

• Fresh fuel mix (50:1)
• Chain oil
• Carburetor cleaner
• Air filter cleaning solution
• Dielectric grease
• [Other materials]

---

📚 Resources

Video Resources

• 📺 [YouTube: Relevant repair guide]
• 📺 [YouTube: Related issue solution]

Written Guides

• 📖 [Service manual section]
• 📖 [Forum thread or article]

Parts Sourcing

• 🔗 [Husqvarna parts catalog]
• 🔗 [Third-party supplier]

---

🔧 Repair Procedure

Step 1: [First step]

1. [Detailed step 1]
2. [Detailed step 2]
3. [Detailed step 3]

Step 2: [Second step]

1. [Detailed step 1]
2. [Detailed step 2]
3. [Detailed step 3]

Step 3: [Verification]

1. [Test step 1]
2. [Test step 2]
3. [Confirm fix]

---

📋 Next Steps

• [Next action item]
• [Next action item]
• [Next action item]

---

📅 Session Log

IMPORTANT: All entries MUST include full timestamps (YYYY-MM-DD HH:MM) to track issue progress across multiple days.

• [YYYY-MM-DD HH:MM]: [Event description]
• [YYYY-MM-DD HH:MM]: [Event description]
• [YYYY-MM-DD HH:MM]: [Event description]

Session Log Guidelines:

• Use full timestamp format: YYYY-MM-DD HH:MM (24-hour format)
• Include timestamp for EVERY action, test, and decision
• Track when parts were ordered, received, and installed
• Note when tests were performed and results observed
• Record when saw was tested after repair

---

📝 Notes

• [Important notes about the issue]
• [Lessons learned]
• [Tips for future reference]
• [Warnings or cautions]
• Carburetor settings: L: __ turns, H: __ turns, T: __ turns

---

📊 Success Criteria

Before Starting

• Problem clearly defined
• Diagnostic data collected
• Parts decision made
• Parts available

After Repair

• Issue resolved
• Saw runs smoothly
• Proper idle and throttle response
• No chain rotation at idle
• Test cutting confirms proper performance

Verification Steps

1. [Test step 1]
2. [Test step 2]
3. [Test step 3]

---

🧪 Revision History

Date	Change
YYYY-MM-DD	Initial creation

---

🔗 See Also

• Link to main chainsaw project README
• [Link to related issues]