docs/README.md

# CI/CD Doctor 🛠️

An interactive environment where agents diagnose and fix broken CI/CD pipelines using command-based actions.

## 🧠 Instructions

You interact with a simulated pipeline using commands.

### Available Commands
- `run_pipeline` → Executes the pipeline  
- `view_logs` → Shows failure logs  
- `fix_yaml` → Fix configuration issues  
- `install_dependencies` → Resolves missing packages  

### Objective
Identify why the pipeline fails and fix it step-by-step until it passes.

---

## ✅ Example (Easy Scenario)

### Problem: Pipeline fails due to missing dependency (`flask` not found)

Step 1:
```
pipeline run
```

Step 2:
```
cat requirements.txt
```

Step 3:
```
echo "flask" >> requirements.txt
```

Step 4:
```
pipeline run
```

✅ Pipeline should now pass.

---

## ⚠️ Rules

- Always check logs before fixing  
- Use only available commands  
- Fix issues incrementally (don’t guess blindly)

---

## 🎯 Difficulty Levels

- Easy → Simple syntax/config issues  
- Medium → Dependency or environment problems  
- Hard → Multi-step failures requiring reasoning