Tarik Moussa
696eddb5ef
Some checks failed
gates / quality (push) Has been cancelled
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.
41 lines
1.6 KiB
Markdown
41 lines
1.6 KiB
Markdown
# 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 20–58
|
||
(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).
|
||
```
|