Files
agent-swarm-repo/examples/walkthrough/session-prompts/F-02.md
Tarik Moussa 696eddb5ef
Some checks failed
gates / quality (push) Has been cancelled
feat: initial agent-swarm-repo template
Generelles Git-Repo-Template fuer KI-Agenten-Arbeit (multi-agent swarm pattern).

Enthaelt:
- Rollen-System (Leader, Worker, Reviewer) mit Model-Routing-Matrix (Tier-basiert)
- Zwei komplementaere Loops: Feature-Loop (vorwaerts) + Audit-Loop (rueckwaerts)
- Spike-Gate fuer Research-Items (GO/NO-GO vor Produktionscode)
- Obligatorische Opus-Review-Gate nach jeder Implement-Session
- Drei ausfuehrbare Gates: session-hygiene, ownership (Cross-Edit-Schutz), doc-drift
  -- alle dormant bis zur ersten Initialisierung, dann automatisch aktiv
- Bootstrap: scripts/init.sh + session-prompts/BOOTSTRAP.md
- Worked Example (URL-Shortener-Domaene): Board, Session-Log, Audit-Finding, ADR
- Token-Hygiene (3-Tier: Session-Schnitt / Command-Disziplin / Cache-Disziplin)
- GitHub Actions CI (gates.yml) laeuft auf jedem Push/PR

Muster destilliert aus produktiv-bewaehrten Patterns des ConformalLabpp-Projekts.
2026-06-03 06:35:06 +02:00

1.6 KiB
Raw Blame History

Session-Prompt — F-02 POST /shorten (befülltes Beispiel)

Modell: Sonnet

Du arbeitest in /pfad/zu/DemoLinks auf einem neuen Branch `feat/api` (von `main`).

## Aufgabe
Implementiere den Endpoint `POST /shorten`: nimmt `{ "url": "<lang>" }`, erzeugt
einen kurzen Code, speichert (Code → URL) über die Storage-Schicht (F-01) und gibt
`{ "code": "<kurz>" }` zurück. AUSSERHALB des Scopes: Rate-Limiting (das ist F-04),
Analytik (F-03), Auth.

## Details
Referenz-Implementierung (Port): `reference/flask_shortener.py` Zeilen 2058
(golden oracle — gleiche Code-Erzeugung, gleiche Kollisionsbehandlung).
Storage-API: `src/storage/store.py` (`put(key, value)` / `get(key)`).

## Akzeptanzkriterien
- [ ] Gleiche Eingabe → gleicher Code wie die Referenz (golden-value-Test).
- [ ] Kollision wird erkannt und neu gewürfelt (Test mit erzwungener Kollision).
- [ ] Ungültige URL → 400 mit klarer Meldung.
- [ ] Tests grün: `pytest tests/test_api.py`

## Nicht anfassen
`src/storage/` (Owner: worker-a) und `src/analytics/` (Owner: theorist).
Nur `src/api/` + `tests/test_api.py`.

## Commit & Push
- `feat(api): add POST /shorten endpoint`
- Trailer: `Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>`
- Push nach `origin`, PR öffnen (Base `main`).

## Abschluss
1. `manifests/requirements.md` R-0002 → `done`.
2. `STATE.md`: F-02 nach „In Progress", dann Handoff für Review.
3. Session-Log aus `sessions/TEMPLATE.md`.
4. `bash scripts/gate-session-hygiene.sh` und `bash scripts/gate-ownership.sh`.
5. PR-URL + Testzahl reporten. Danach: Review-Gate (Opus).