スキル一覧に戻る
mguttmann

decision-framework

by mguttmann

Autonomous Organization Framework - A complete system for AI-assisted software development with Claude Code

0🍴 0📅 2026年1月25日
GitHubで見るManusで実行

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

BereichBeispieleBedingungen
Code ImplementationWie Code strukturieren, welche PatternsInnerhalb definierter Architektur
Bug FixesWie Bug fixen, welcher AnsatzKeine Architektur-Änderung
RefactoringCode-VerbesserungenTests vorhanden, Verhalten bleibt
File OrganizationWo Dateien ablegenProjekt-Konventionen folgen
Test WritingTest-Struktur, AssertionsCoverage-Ziele erreichen
FormattingCode-FormatierungLinter/Formatter Config folgen
DocumentationCode-Kommentare, README-UpdatesBestehenden Stil folgen
Simple ErrorsLinter-Fehler, Import-FehlerAuto-fix möglich

AI Empfiehlt, Mensch Entscheidet

BereichBeispieleWarum
New DependenciesNeue npm/pip PackagesSecurity, License, Maintenance
Architecture ChangesNeue Patterns, Struktur-ÄnderungenLangzeit-Impact
Database SchemaNeue Tables, Schema-MigrationDaten-Integrität
API ContractsBreaking ChangesExternal Dependencies
Performance Trade-offsGeschwindigkeit vs. LesbarkeitBusiness-Kontext
Technical DebtJetzt fixen vs. späterPrioritäten

Mensch Entscheidet

BereichBeispieleWarum
Feature ScopeWas bauen, was nichtBusiness-Entscheidung
Budget/ResourcesKosten, Team-AllokationFinanzielle Verantwortung
Strategic DirectionProdukt-RichtungBusiness-Strategie
DeadlinesRelease-TermineStakeholder-Commitments
Team DecisionsHiring, RollenPeople-Management
Legal/ComplianceDatenschutz, LizenzenRechtliche Verantwortung

Escalation Rules

IMMER Eskalieren

SituationSeverityAktion
Security VulnerabilityCriticalSOFORT STOPPEN, eskalieren
Data Loss RiskCriticalSTOPPEN, keine weiteren Änderungen
Production ImpactCriticalSTOPPEN, Mensch informieren
Customer-facing ChangesHighVor Deployment eskalieren
Budget > $1000HighApproval einholen
Legal/ComplianceHighRechtliche Prüfung
Irreversible ActionsHighConfirmation einholen
External API ChangesMediumVor Implementation eskalieren
Persistent Test FailuresMediumNach 3 Versuchen eskalieren
Ambiguous RequirementsMediumKlärung einholen
Out of Scope DiscoveryLowDokumentieren, fragen

NIE Ohne Approval

  • git push --force auf main/master
  • --no-verify bei 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

SeverityDefinitionResponse Time
CriticalSystem down, data loss, security breachSofort stoppen
HighFeature broken, significant impactInnerhalb Stunden
MediumDegraded experience, workaround existsInnerhalb eines Tages
LowMinor issue, no immediate impactDiese Woche

スコア

総合スコア

70/100

リポジトリの品質指標に基づく評価

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

レビュー

💬

レビュー機能は近日公開予定です