diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..cca9329 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,307 @@ +# Universal AI Coding Agent Workflow (Codex / Gemini / Claude) + +## Workflow Orchestration + +### 1. Plan Mode Default +- Enter planning mode for ANY non-trivial task (3+ steps or architecture decisions) +- Analyze the codebase before making changes +- Break problems into clear subtasks +- Produce an implementation plan before writing code +- If assumptions are uncertain, inspect files or run tools first +- Prefer incremental progress over large rewrites + +Plan format: + +PLAN +1. Understand the task +2. Identify affected files +3. Design the implementation +4. Implement step-by-step +5. Verify results + + +--- + +# Multi-Agent Strategy + +### 2. Agent Decomposition + +Use specialized agents for complex work. + +Core roles: + +- Orchestrator Agent +- Research Agent +- Implementation Agent +- Test Agent +- Code Review Agent +- Debug Agent +- Documentation Agent + +Rules: +- One responsibility per agent +- Prefer parallel execution +- Agents should operate on independent files when possible +- The orchestrator coordinates execution + + +--- + +# Agent Responsibilities + +### Orchestrator Agent +- analyzes the user request +- creates task list +- assigns tasks to agents +- merges results + +### Research Agent +- scans repository +- searches dependencies +- analyzes architecture +- produces context summary + +### Implementation Agent +- writes code +- edits files +- follows project conventions +- implements features + +### Test Agent +- writes tests +- verifies functionality +- checks edge cases + +### Code Review Agent +- reviews diffs +- checks maintainability +- suggests improvements + +### Debug Agent +- analyzes logs +- identifies root causes +- implements fixes + +### Documentation Agent +- updates docs +- writes README sections +- explains new features + + +--- + +# Execution Pipeline + +### 3. Execution Phases + +PHASE 1 — Discovery +- explore repository +- load relevant files +- understand architecture + +PHASE 2 — Planning +- generate implementation plan +- break plan into tasks + +PHASE 3 — Task Creation + +Create tasks like: + +[ ] analyze codebase +[ ] implement feature +[ ] add tests +[ ] review code +[ ] update documentation + +PHASE 4 — Implementation +- execute tasks sequentially or in parallel +- commit progress + +PHASE 5 — Verification +- run tests +- check logs +- verify feature works + +PHASE 6 — Review +- review code quality +- refactor if necessary + +PHASE 7 — Documentation +- document changes + + +--- + +# Verification System + +### 4. Verification Before Done + +Never mark a task complete without proof. + +Checks: +- code compiles +- feature works +- tests pass +- no new errors introduced + +Ask: + +"Would a senior engineer approve this implementation?" + + +--- + +# Autonomous Debugging + +### 5. Autonomous Bug Fixing + +When encountering a bug: + +1. analyze error message +2. inspect stack trace +3. identify root cause +4. implement fix +5. verify with tests + +Rules: +- Never apply random fixes +- Always understand the root cause first + + +--- + +# Context Management + +### 6. Context Awareness + +Before implementing anything: + +- load relevant files +- inspect dependencies +- understand architecture +- read configuration files + +Always maintain awareness of: + +- system architecture +- data flow +- dependencies + + +--- + +# Memory System + +### 7. Persistent Memory + +Store long-term knowledge in: + +memory/ +- project_summary.md +- architecture.md +- lessons.md +- coding_standards.md + +This prevents repeated mistakes. + + +--- + +# Learning Loop + +### 8. Self-Improvement + +After errors or corrections: + +Update: + +tasks/lessons.md + +Include: +- mistake pattern +- root cause +- prevention rule + +Example: + +Lesson: +Always validate API responses before processing them. + + +--- + +# Safety Rules + +### 9. Safety + +Never perform dangerous actions automatically. + +Rules: + +- never delete files without confirmation +- avoid modifying production configuration automatically +- create backups before large refactors +- avoid irreversible operations + + +--- + +# Iteration Control + +### 10. Infinite Loop Protection + +If the same error happens more than 3 times: + +STOP + +- re-evaluate the strategy +- re-plan the solution +- choose a different debugging approach + + +--- + +# Core Engineering Principles + +### Simplicity First +Prefer the simplest solution that works. + +### Root Cause Fixes +Always fix the underlying problem, not symptoms. + +### Minimal Impact +Touch the smallest amount of code possible. + +### Maintainability +Code should remain readable and maintainable. + + +--- + +# Final Rule + +Before delivering a solution ask: + +Is this solution correct, maintainable, and verifiable? + +If not: + +Refine it before presenting it. + + +--- + +# Recommended File Usage + +You can place this workflow in one of the following files: + +AGENT_WORKFLOW.md +CLAUDE.md +AGENTS.md + +This allows it to be used by: + +- Claude Code Agent Teams +- Codex CLI +- Gemini Code Assist +- Cursor Agents \ No newline at end of file diff --git a/email.md b/email.md new file mode 100644 index 0000000..ded637f --- /dev/null +++ b/email.md @@ -0,0 +1,239 @@ +# InnungsApp Outreach Emails + +## Allgemeine Verband-Varianten + +### Variante 1: Standardisierung / Kontrolle + +**Betreff:** Ihre Innungen digital einheitlich organisieren +**Betreff:** Digitale Infrastruktur fuer Ihre angeschlossenen Innungen + +Hallo Herr/Frau [Nachname], + +viele Kreishandwerksverbaende koordinieren heute 20 oder mehr Innungen, ohne ein gemeinsames System fuer Kommunikation, Termine und Mitgliedsinfos. + +Das Ergebnis ist meist: +- Excel-Listen +- Rundmails ohne Rueckmeldung +- WhatsApp als inoffizieller Kanal +- kein einheitlicher Standard ueber alle Innungen hinweg + +Genau dafuer haben wir `InnungsApp` gebaut: eine Verbandsloesung, mit der Sie Kommunikation und Organisation ueber angeschlossene Innungen hinweg standardisieren koennen. + +Der Einstieg ist einfach: +- Verband-Setup +- Start mit 3 Pilot-Innungen +- danach schrittweiser Rollout auf weitere Innungen + +Haetten Sie naechste Woche 20 Minuten fuer einen kurzen Austausch? + +Viele Gruesse +[Name] + +### Variante 2: DSGVO / WhatsApp-Risiko + +**Betreff:** WhatsApp und Excel sind kein System fuer einen Verband +**Betreff:** DSGVO-sichere Kommunikation fuer Ihre Innungen + +Hallo Herr/Frau [Nachname], + +bei vielen Kreishandwerksverbaenden laeuft die Kommunikation mit angeschlossenen Innungen noch ueber Rundmails, Excel und teils WhatsApp-Strukturen. + +Fuer einzelne Faelle funktioniert das irgendwie. Auf Verbandsebene ist es meist: +- schwer steuerbar +- nicht einheitlich +- kaum auswertbar +- DSGVO-seitig unnoetig riskant + +`InnungsApp` hilft Kreishandwerksverbaenden, genau das zentraler und professioneller aufzusetzen, ohne jede Innung einzeln mit Inselloesungen arbeiten zu lassen. + +Unser Modell: +- Setup auf Verbandsebene +- Einfuehrung mit 3 Innungen +- danach Rollout im Verband + +Wenn das grundsaetzlich relevant klingt, zeige ich Ihnen das gern in 20 Minuten. + +Beste Gruesse +[Name] + +### Variante 3: Geschaeftsfuehrer-Hook / Fuehrungsaufgabe + +**Betreff:** Wie steuern Sie heute die Digitalisierung Ihrer Innungen? +**Betreff:** Ein Standard statt 20 Einzelloesungen + +Hallo Herr/Frau [Nachname], + +eine Frage aus echtem Interesse: + +Wie stellen Sie heute sicher, dass Ihre angeschlossenen Innungen bei Kommunikation, Terminen und Mitgliederorganisation nicht alle unterschiedlich arbeiten? + +Genau dort sehen wir bei vielen Kreishandwerksverbaenden einen Engpass: +kein gemeinsamer Standard, hoher Koordinationsaufwand und wenig Transparenz. + +`InnungsApp` ist dafuer als Verbandsloesung gedacht: +- zentral aufgesetzt +- fuer erste 3 Innungen eingefuehrt +- dann auf weitere Innungen ausrollbar + +Wenn das Thema bei Ihnen aktuell oder perspektivisch relevant ist, schicke ich gern eine kurze Uebersicht oder zeige es in einer 20-Minuten-Demo. + +Viele Gruesse +[Name] + +### Variante 4: Rollout mit wenig Risiko + +**Betreff:** Verbandsweite Digitalisierung ohne Big-Bang-Einfuehrung +**Betreff:** Erst 3 Innungen, dann Verbands-Rollout + +Hallo Herr/Frau [Nachname], + +oft ist nicht die Idee das Problem, sondern das Einfuehrungsrisiko: +"Nutzen die Innungen das wirklich?" +"Muss das erst durch Vorstand und Gremien?" +"Wie startet man so etwas praktisch?" + +Deshalb haben wir den Einstieg fuer Kreishandwerksverbaende bewusst schlank gedacht: +- Verband-Setup +- Start mit 3 Innungen +- klarer Rollout-Plan fuer weitere Innungen + +`InnungsApp` buendelt Kommunikation, Termine und Mitgliederinfos in einer gemeinsamen Struktur statt in vielen Einzelprozessen. + +Waere ein kurzer Termin sinnvoll, damit ich Ihnen den Ablauf einmal kompakt zeige? + +Beste Gruesse +[Name] + +### Variante 5: Outcome / Entlastung + +**Betreff:** Weniger Koordinationsaufwand fuer Ihre Innungen +**Betreff:** Kommunikation und Termine nicht mehr ueber Excel + Rundmail + +Hallo Herr/Frau [Nachname], + +wir sprechen gerade mit Kreishandwerksverbaenden, die ihre angeschlossenen Innungen organisatorisch entlasten wollen. + +Das Muster ist oft gleich: +- Mitgliederinfos liegen verteilt +- Rundschreiben werden verschickt, aber nicht sauber nachverfolgt +- Termine und Rueckmeldungen laufen uneinheitlich + +Mit `InnungsApp` koennen Verbaende dafuer einen gemeinsamen digitalen Standard schaffen, statt jede Innung einzeln improvisieren zu lassen. + +Der Einstieg erfolgt nicht als harter Komplett-Rollout, sondern strukturiert: +- Setup auf Verbandsebene +- Einfuehrung in 3 Innungen +- anschliessende Ausweitung + +Falls das bei Ihnen in den naechsten Monaten ein Thema ist, koennen wir gern 20 Minuten sprechen. + +Viele Gruesse +[Name] + +### Variante 6: Sehr kurz / direkt + +**Betreff:** Loesung fuer Kreishandwerksverbaende +**Betreff:** 20 Minuten zu einem Verbands-Rollout? + +Hallo Herr/Frau [Nachname], + +wir bauen `InnungsApp` fuer Kreishandwerksverbaende, die Kommunikation und Organisation ueber mehrere Innungen hinweg einheitlicher aufsetzen wollen. + +Statt Excel, Rundmail und Inselloesungen: +- Verband-Setup +- Start mit 3 Innungen +- danach Rollout + +Ist das ein Thema, das bei Ihnen aktuell relevant ist? + +Viele Gruesse +[Name] + +## HGF / Geschaeftsfuehrer-Versionen + +### HGF Version 1: Haerter / direkter + +**Betreff:** Viele Verbaende arbeiten noch ohne gemeinsamen digitalen Standard +**Betreff:** Excel, Rundmail, WhatsApp: kein belastbares System fuer einen Verband + +Hallo Herr/Frau [Nachname], + +viele Kreishandwerksverbaende steuern ihre angeschlossenen Innungen noch ohne einheitliches digitales System. + +Das fuehrt fast immer zu denselben Problemen: +- jede Innung arbeitet anders +- Kommunikation laeuft ueber Rundmails statt ueber einen steuerbaren Kanal +- Informationen sind verteilt statt zentral +- der Verband hat wenig Transparenz und wenig Standardisierung + +Genau dafuer haben wir `InnungsApp` entwickelt. + +Nicht als Einzelloesung fuer eine Innung, sondern als Struktur auf Verbandsebene: +- ein gemeinsamer Rahmen fuer Kommunikation, Termine und Mitgliederinformationen +- Start mit 3 Innungen +- danach geordneter Rollout auf weitere Innungen + +Wenn das Thema bei Ihnen relevant ist, lohnt sich ein kurzer Austausch. + +Haetten Sie naechste oder uebernaechste Woche 20 Minuten? + +Viele Gruesse +[Name] + +### HGF Version 2: Waermer / eleganter + +**Betreff:** Digitale Struktur fuer Ihre angeschlossenen Innungen +**Betreff:** Ein einheitlicher Rahmen fuer Kommunikation und Organisation im Verband + +Hallo Herr/Frau [Nachname], + +ich beschaeftige mich aktuell intensiv mit der Frage, wie Kreishandwerksverbaende ihre angeschlossenen Innungen digital besser unterstuetzen und gleichzeitig organisatorisch entlasten koennen. + +In vielen Gespraechen zeigt sich ein aehnliches Bild: +- Kommunikation laeuft ueber verschiedene Kanaele nebeneinander +- Ablaeufe unterscheiden sich stark zwischen den Innungen +- es fehlt ein gemeinsamer, professioneller Standard auf Verbandsebene + +Mit `InnungsApp` haben wir eine Loesung entwickelt, die genau an diesem Punkt ansetzt: +- Kommunikation, Termine und Mitgliederinformationen in einer gemeinsamen Struktur +- Einfuehrung nicht als grosser Komplettwechsel, sondern kontrolliert +- Start mit 3 Innungen, danach schrittweise Ausweitung + +Fuer Geschaeftsfuehrer ist vor allem interessant, dass dadurch nicht nur Prozesse digitaler werden, sondern auch Steuerbarkeit und Aussenwirkung des Verbands verbessert werden. + +Wenn Sie moechten, zeige ich Ihnen das gern in einem kompakten Termin. + +Viele Gruesse +[Name] + +### HGF Version 3: Sehr kurz unter 120 Woertern + +**Betreff:** Digitaler Standard fuer Ihre Innungen +**Betreff:** 20 Minuten zu einem Verbands-Rollout? + +Hallo Herr/Frau [Nachname], + +viele Kreishandwerksverbaende arbeiten bei Kommunikation und Organisation ihrer Innungen noch mit einem Mix aus Rundmail, Excel und Einzelloesungen. + +`InnungsApp` ist dafuer als Verbandsloesung gedacht: +- gemeinsamer Standard fuer Kommunikation, Termine und Mitgliederinfos +- Start mit 3 Innungen +- danach Rollout auf weitere angeschlossene Innungen + +Der Nutzen fuer den Verband: +- mehr Standardisierung +- mehr Steuerbarkeit +- weniger Inselloesungen + +Falls das grundsaetzlich relevant ist, zeige ich Ihnen das gern in 20 Minuten. + +Viele Gruesse +[Name] + +## Einsatzempfehlung + +- Erstkontakt: `Variante 6` oder `HGF Version 3` +- Etwas haerterer Erstkontakt: `HGF Version 1` +- Konservativer oder waermerer Ton: `HGF Version 2` +- Wenn DSGVO im Fokus steht: `Variante 2` +- Wenn Einfuehrungsangst dominiert: `Variante 4`