# Golden Failures — Guide

**Version:** 1.0  
**Datum:** 2026-07-01

---

## Vad är en Golden Failure?

En Golden Failure är ett **känt, dokumenterat fel** som:

1. Representerar ett verkligt problem
2. Är svårt att lösa
3. Används för att validera systemets stabilitet över tid

---

## Kriterier för nya Golden Failures

Ett test kvalificerar sig ENDAST om:

| Kriterium | Beskrivning |
|-----------|-------------|
| **Verkligt fel** | Det har inträffat i praktiken, inte teoretiskt |
| **Reproducerbart** | Felet har reproducerats minst två gånger |
| **Unikt** | Det kan inte upptäckas av befintliga tester |
| **Svårt** | Det kräver icke-triviala ändringar för att lösas |
| **Ersättbart** | När det löses ska det ersättas av ett svårare fall |

---

## Process

### 1. Identifiera felet

```bash
# Kör regressionssviten
node EOS/regression-suite.mjs manual

# Kontrollera om felet är nytt
node EOS/regression-suite.mjs check-new
```

### 2. Dokumentera felet

Skapa post i `golden-failures.json`:

```json
{
  "id": "GF-XXX",
  "name": "Beskrivande namn",
  "firstObserved": "2026-07-01",
  "status": "active",
  "testCase": {
    "id": "S-XXX",
    "description": "Testbeskrivning"
  },
  "expectedOperation": "EXPECTED",
  "actualOperation": "ACTUAL",
  "evidenceProfile": { /* evidens som samlades */ },
  "evidenceQuality": { /* kvalitetsmått */ },
  "whyDifficult": "Förklaring av varför felet är svårt",
  "resolutionCriteria": "När felet anses löst",
  "notes": "Eventuella anteckningar"
}
```

### 3. Uppdatera regressionssviten

Lägg till testet i `regression-suite.mjs`:

```javascript
{ 
  id: 'GF-XXX', 
  description: 'Testbeskrivning', 
  type: 'test', 
  expectedOperation: 'EXPECTED',
  isGoldenFailure: true 
}
```

### 4. Uppdatera Reasoning Gate

Lägg till i `REASONING-GATE.md`:

```markdown
| GF-XXX | Namn | 🟡 Aktiv | 2026-07-01 |
```

---

## När en Golden Failure löses

### 1. Verifiera lösningen

```bash
# Kör regressionssviten
node EOS/regression-suite.mjs manual

# Kontrollera att felet är löst
node EOS/regression-suite.mjs check-golden
```

### 2. Uppdatera status

```json
{
  "status": "resolved",
  "resolvedDate": "2026-07-01",
  "resolution": "Beskrivning av lösningen"
}
```

### 3. Ersätt med ny Golden Failure

**Princip:** Varje löst Golden Failure ska ersättas av ett nytt, svårare test.

```bash
# Identifiera nytt, svårare fall
node EOS/policy-falsification-suite-v6.mjs

# Dokumentera nya felet
# (följ processen ovan)
```

---

## Aktiva Golden Failures

| ID | Namn | Status | Sedan |
|----|------|--------|-------|
| GF-001 | README-felklassificering | 🟡 Aktiv | 2026-07-01 |

---

## Historik

| Datum | Händelse |
|-------|----------|
| 2026-07-01 | GF-001 dokumenterad |

---

*Detta dokument får inte ändras utan godkännande från EOS Team.*