← Back to list

decision-framework
by mguttmann
Autonomous Organization Framework - A complete system for AI-assisted software development with Claude Code
⭐ 0🍴 0📅 Jan 25, 2026
SKILL.md
name: decision-framework description: Complete autonomy matrix and escalation rules for decision-making
Decision Framework
Das Framework für autonome Entscheidungen: Wann selbst entscheiden, wann eskalieren.
Autonomy Matrix
AI Entscheidet Autonom
| Bereich | Beispiele | Bedingungen |
|---|---|---|
| Code Implementation | Wie Code strukturieren, welche Patterns | Innerhalb definierter Architektur |
| Bug Fixes | Wie Bug fixen, welcher Ansatz | Keine Architektur-Änderung |
| Refactoring | Code-Verbesserungen | Tests vorhanden, Verhalten bleibt |
| File Organization | Wo Dateien ablegen | Projekt-Konventionen folgen |
| Test Writing | Test-Struktur, Assertions | Coverage-Ziele erreichen |
| Formatting | Code-Formatierung | Linter/Formatter Config folgen |
| Documentation | Code-Kommentare, README-Updates | Bestehenden Stil folgen |
| Simple Errors | Linter-Fehler, Import-Fehler | Auto-fix möglich |
AI Empfiehlt, Mensch Entscheidet
| Bereich | Beispiele | Warum |
|---|---|---|
| New Dependencies | Neue npm/pip Packages | Security, License, Maintenance |
| Architecture Changes | Neue Patterns, Struktur-Änderungen | Langzeit-Impact |
| Database Schema | Neue Tables, Schema-Migration | Daten-Integrität |
| API Contracts | Breaking Changes | External Dependencies |
| Performance Trade-offs | Geschwindigkeit vs. Lesbarkeit | Business-Kontext |
| Technical Debt | Jetzt fixen vs. später | Prioritäten |
Mensch Entscheidet
| Bereich | Beispiele | Warum |
|---|---|---|
| Feature Scope | Was bauen, was nicht | Business-Entscheidung |
| Budget/Resources | Kosten, Team-Allokation | Finanzielle Verantwortung |
| Strategic Direction | Produkt-Richtung | Business-Strategie |
| Deadlines | Release-Termine | Stakeholder-Commitments |
| Team Decisions | Hiring, Rollen | People-Management |
| Legal/Compliance | Datenschutz, Lizenzen | Rechtliche Verantwortung |
Escalation Rules
IMMER Eskalieren
| Situation | Severity | Aktion |
|---|---|---|
| Security Vulnerability | Critical | SOFORT STOPPEN, eskalieren |
| Data Loss Risk | Critical | STOPPEN, keine weiteren Änderungen |
| Production Impact | Critical | STOPPEN, Mensch informieren |
| Customer-facing Changes | High | Vor Deployment eskalieren |
| Budget > $1000 | High | Approval einholen |
| Legal/Compliance | High | Rechtliche Prüfung |
| Irreversible Actions | High | Confirmation einholen |
| External API Changes | Medium | Vor Implementation eskalieren |
| Persistent Test Failures | Medium | Nach 3 Versuchen eskalieren |
| Ambiguous Requirements | Medium | Klärung einholen |
| Out of Scope Discovery | Low | Dokumentieren, fragen |
NIE Ohne Approval
git push --forceauf main/master--no-verifybei Commits- Datenbank-Löschungen in Production
- API-Keys oder Secrets committen
- Benutzer-Daten löschen
- Security-Features deaktivieren
Escalation Format
## ESCALATION: [Kurzer Titel]
**Type:** [Decision | Action | Blocker | Risk | Security]
**Severity:** [Critical | High | Medium | Low]
**Urgency:** [Immediate | Today | This Week | When Convenient]
### Context
[Was ist die Situation? Was wurde bereits versucht?]
### Problem
[Was genau ist das Problem oder die Frage?]
### Options (falls zutreffend)
| Option | Pros | Cons | Empfehlung |
|--------|------|------|------------|
| Option A | ... | ... | |
| Option B | ... | ... | Empfohlen |
### Recommendation
[Wenn du eine Empfehlung hast, was und warum]
### Action Needed
[Was genau brauchst du vom Menschen?]
- [ ] Entscheidung zwischen A und B
- [ ] Approval für X
- [ ] Klärung von Y
- [ ] Information über Z
### Impact of Delay
[Was passiert wenn wir warten?]
Decision Documentation
Alle wichtigen Entscheidungen dokumentieren:
## Decisions Log
| Date | Decision | Rationale | Made By | Impact |
|------|----------|-----------|---------|--------|
| 2025-01-21 | Use PostgreSQL | Better JSON support needed | @human | High |
| 2025-01-21 | Skip feature X | Out of scope for MVP | @ai | Medium |
Wann dokumentieren?
- Architektur-Entscheidungen → ADR erstellen
- Scope-Änderungen → In STATE.md
- Technologie-Wahlen → In DISCOVERY.md
- Abweichungen vom Plan → In SUMMARY.md
Auto-Fix vs Escalate Quick Reference
┌─────────────────────────────────────────────────────────────┐
│ Fehler aufgetreten │
└─────────────────────────────────────────────────────────────┘
│
▼
┌───────────────────┐
│ Sicherheitsrisiko? │
└───────────────────┘
│ │
Ja Nein
│ │
▼ ▼
┌─────────┐ ┌──────────────────┐
│ STOP │ │ Auto-fixbar? │
│Eskaliere│ │ (Lint/Format/ │
└─────────┘ │ Import) │
└──────────────────┘
│ │
Ja Nein
│ │
▼ ▼
┌─────────┐ ┌──────────────────┐
│Auto-Fix │ │ Bereits 3x │
│ Retry │ │ versucht? │
└─────────┘ └──────────────────┘
│ │
Ja Nein
│ │
▼ ▼
┌─────────┐ ┌─────────┐
│Eskaliere│ │Nochmal │
│ │ │versuchen│
└─────────┘ └─────────┘
Severity Definitions
| Severity | Definition | Response Time |
|---|---|---|
| Critical | System down, data loss, security breach | Sofort stoppen |
| High | Feature broken, significant impact | Innerhalb Stunden |
| Medium | Degraded experience, workaround exists | Innerhalb eines Tages |
| Low | Minor issue, no immediate impact | Diese Woche |
Score
Total Score
70/100
Based on repository quality metrics
✓SKILL.md
SKILL.mdファイルが含まれている
+20
✓LICENSE
ライセンスが設定されている
+10
✓説明文
100文字以上の説明がある
+10
○人気
GitHub Stars 100以上
0/15
○最近の活動
3ヶ月以内に更新がある
0/10
○フォーク
10回以上フォークされている
0/5
✓Issue管理
オープンIssueが50未満
+5
✓言語
プログラミング言語が設定されている
+5
○タグ
1つ以上のタグが設定されている
0/5
Reviews
💬
Reviews coming soon