# pi-coder Beispielprojekte

Sechs kleine, eigenständige Projekte als Demonstrationsgrundlage für die pi-coder-Features.
Jedes Projekt startet bewusst unvollständig — genau der Ausgangspunkt, für den pi-coder gebaut ist.

## Übersicht

| Verzeichnis | Sprache | Demonstriert |
|---|---|---|
| `python-calculator/` | Python | `/optimize` mit `--test-cmd pytest` |
| `rust-wordcount/` | Rust | `/optimize` mit `--test-cmd "cargo test"` + `/version` |
| `go-fibonacci/` | Go | `/optimize --interactive` + `/continue` + `/shipit` |
| `c-linkedlist/` | C | `/quick_check` + `/fix` + `/patch` |
| `bash-sysreport/` | Bash | `/coder` von Null (kein Startcode) + `/quick_check` |
| `html-quote-ticker/` | HTML/CSS/JS | `/optimize --no-tests` + `/patch` + Tailwind-Redesign |

## Demo-Workflow

### Schritt 1 — Vorbereitung: Sub-Repos anlegen

Jedes Example braucht ein eigenes git-Repo, damit pi-coder commit-basierte
Features nutzen kann (Loop-Erkennung, Diff-Anzeige, `/version`):

```bash
for dir in python-calculator rust-wordcount go-fibonacci c-linkedlist bash-sysreport html-quote-ticker; do
  cd examples/$dir
  git init -b main && git add -A && git commit -m "feat: initial $dir"
  cd ../..
done
```

Für `/version` im rust-wordcount-Beispiel zusätzlich:

```bash
cd examples/rust-wordcount && git tag v0.1.0
```

### Schritt 2 — Demo ausführen

In pi das jeweilige Unterverzeichnis als Arbeitsverzeichnis öffnen.
Die genauen Befehle stehen im README.md des jeweiligen Examples.
Zeitmessung: Systemuhr notieren oder Terminal-Kommando `time` nutzen.

### Schritt 3 — Protokoll ausfüllen

Jedes Example enthält eine `PROTOKOLL.md`.
Startzeit, Endzeit, Rundenanzahl und Endergebnis eintragen.

### Schritt 4 — Ausgangszustand wiederherstellen

```bash
bash examples/restore-all.sh
```

Das Skript löscht Sub-Repos, restauriert alle Quelldateien aus dem Haupt-Repo
und bereinigt Build-Artefakte (`target/`, `__pycache__` etc.).

---

## Empfohlene Demo-Reihenfolge

| # | Beispiel | Geschätzte Dauer | Highlights |
|---|---|---|---|
| 1 | `python-calculator` | ~5–10 min | Einstieg, Test-Loop |
| 2 | `c-linkedlist` | ~5 min | `/quick_check` + `/fix`, kein Loop |
| 3 | `bash-sysreport` | ~5–8 min | `/coder` von Null, kein Startcode |
| 4 | `html-quote-ticker` | ~8–12 min | `/optimize --no-tests`, Frontend |
| 5 | `rust-wordcount` | ~10–15 min | Loop + `/version` |
| 6 | `go-fibonacci` | ~15–20 min | `--interactive` + `/shipit` |

---

## Weitere Details

[python-calculator](python-calculator/README.md) ·
[rust-wordcount](rust-wordcount/README.md) ·
[go-fibonacci](go-fibonacci/README.md) ·
[c-linkedlist](c-linkedlist/README.md) ·
[bash-sysreport](bash-sysreport/README.md) ·
[html-quote-ticker](html-quote-ticker/README.md)