omgkit 2.10.1 → 2.12.0

package/plugin/templates/autonomous/decision-framework.yaml

@@ -0,0 +1,337 @@
+# Decision Framework for Autonomous Development
+# Defines how decisions are classified and handled
+
+version: 1
+
+# Autonomy levels
+autonomy_levels:
+  - level: 0
+    name: "Auto-execute"
+    description: "Execute automatically without any notification"
+    action: "execute_silently"
+    examples:
+      - Code formatting
+      - Import organization
+      - Whitespace cleanup
+      - Simple variable renames
+
+  - level: 1
+    name: "Execute with Notification"
+    description: "Execute and inform user what was done"
+    action: "execute_notify"
+    examples:
+      - Adding a dependency
+      - Creating a new file
+      - Adding a test case
+      - Applying standard patterns
+
+  - level: 2
+    name: "Preview and Quick Approve"
+    description: "Show what will be done and wait for quick approval"
+    action: "preview_approve"
+    timeout: 300  # 5 minutes before auto-proceed with suggested
+    examples:
+      - Database index changes
+      - API endpoint modifications
+      - Configuration changes
+      - Non-trivial refactoring
+
+  - level: 3
+    name: "Full Review Required"
+    description: "Comprehensive review before any action"
+    action: "full_review"
+    timeout: null  # Must be explicitly approved
+    examples:
+      - Authentication implementation
+      - Payment integration
+      - Security-sensitive changes
+      - Data model modifications
+
+  - level: 4
+    name: "Human Must Perform"
+    description: "Claude provides guidance but human executes"
+    action: "human_only"
+    examples:
+      - API credentials entry
+      - Production deployments
+      - Account creation
+      - Payment gateway setup
+
+# Decision classification rules
+classification_rules:
+  # File-based rules
+  file_patterns:
+    - pattern: "**/migrations/**"
+      level: 3
+      reason: "Database migrations can cause data loss"
+
+    - pattern: "**/auth/**"
+      level: 3
+      reason: "Authentication is security-critical"
+
+    - pattern: "**/*.env*"
+      level: 4
+      reason: "Environment files contain secrets"
+
+    - pattern: "**/config/production.*"
+      level: 4
+      reason: "Production config requires careful review"
+
+    - pattern: "**/tests/**"
+      level: 0
+      reason: "Tests are safe to modify"
+
+    - pattern: "**/*.test.*"
+      level: 0
+      reason: "Test files are safe to modify"
+
+    - pattern: "**/__mocks__/**"
+      level: 0
+      reason: "Mock files are safe to modify"
+
+    - pattern: "**/types/**"
+      level: 1
+      reason: "Type definitions are low risk"
+
+    - pattern: "**/utils/**"
+      level: 1
+      reason: "Utility functions are typically safe"
+
+  # Content-based rules
+  content_patterns:
+    - pattern: "password|secret|token|key|credential"
+      level: 3
+      reason: "Contains sensitive keywords"
+
+    - pattern: "delete|drop|truncate|remove"
+      level: 2
+      reason: "Destructive operations"
+
+    - pattern: "stripe|paypal|payment|billing"
+      level: 3
+      reason: "Payment-related code"
+
+    - pattern: "exec|eval|spawn|child_process"
+      level: 3
+      reason: "Code execution risk"
+
+  # Operation-based rules
+  operations:
+    - operation: "create_file"
+      level: 1
+      reason: "New files are easily reversible"
+
+    - operation: "delete_file"
+      level: 2
+      reason: "File deletion should be confirmed"
+
+    - operation: "modify_schema"
+      level: 3
+      reason: "Schema changes affect data"
+
+    - operation: "add_dependency"
+      level: 1
+      reason: "Dependencies affect project"
+
+    - operation: "remove_dependency"
+      level: 2
+      reason: "May break existing code"
+
+    - operation: "change_config"
+      level: 2
+      reason: "Configuration affects behavior"
+
+    - operation: "deploy"
+      level: 4
+      reason: "Deployments require human oversight"
+
+# Decision templates
+decision_templates:
+  - id: technology_choice
+    description: "Choosing between technology options"
+    level: 2
+    template: |
+      ## Decision: {title}
+
+      ### Context
+      {context}
+
+      ### Options
+      {options}
+
+      ### Recommendation
+      {recommendation}
+
+      ### Trade-offs
+      {trade_offs}
+
+  - id: architecture_decision
+    description: "Architectural choices"
+    level: 3
+    template: |
+      ## Architecture Decision: {title}
+
+      ### Context
+      {context}
+
+      ### Decision
+      {decision}
+
+      ### Consequences
+      {consequences}
+
+      ### Alternatives Considered
+      {alternatives}
+
+  - id: implementation_approach
+    description: "How to implement a feature"
+    level: 2
+    template: |
+      ## Implementation: {feature}
+
+      ### Approach
+      {approach}
+
+      ### Files to Create/Modify
+      {files}
+
+      ### Tests
+      {tests}
+
+  - id: breaking_change
+    description: "Changes that break compatibility"
+    level: 3
+    template: |
+      ## Breaking Change: {title}
+
+      ### What's Changing
+      {change}
+
+      ### Impact
+      {impact}
+
+      ### Migration Path
+      {migration}
+
+      ### Rollback Plan
+      {rollback}
+
+# Decision workflow
+decision_workflow:
+  capture:
+    - Identify decision point
+    - Classify by level
+    - Gather context
+    - Generate options
+
+  evaluate:
+    - Apply classification rules
+    - Consider context modifiers
+    - Determine final level
+
+  present:
+    - Level 0-1: Log only
+    - Level 2: Show preview with recommendation
+    - Level 3: Full decision template
+    - Level 4: Guidance only
+
+  record:
+    - Save to .omgkit/memory/decisions/
+    - Update state with decision
+    - Log in journal
+
+# Context modifiers
+context_modifiers:
+  # Increase level
+  increase_level:
+    - condition: "first_time_in_area"
+      modifier: +1
+      reason: "First time working in this area"
+
+    - condition: "multiple_files_affected"
+      modifier: +1
+      reason: "Changes affect multiple files"
+
+    - condition: "production_environment"
+      modifier: +1
+      reason: "Production context"
+
+  # Decrease level
+  decrease_level:
+    - condition: "pattern_established"
+      modifier: -1
+      reason: "Following established pattern"
+
+    - condition: "test_coverage_high"
+      modifier: -1
+      reason: "Well-tested code"
+
+    - condition: "rollback_easy"
+      modifier: -1
+      reason: "Easy to rollback"
+
+# Approval handling
+approval_handling:
+  level_2:
+    prompt: "Approve this change? [Y/n/details]"
+    default: "yes"
+    timeout_action: "proceed_with_recommendation"
+
+  level_3:
+    prompt: "Review required. Approve? [yes/no/modify]"
+    default: "no"
+    timeout_action: "wait"
+
+  level_4:
+    prompt: "Human action required. Confirm when complete."
+    default: null
+    timeout_action: "wait"
+
+# Decision record schema
+record_schema:
+  id:
+    type: string
+    required: true
+    description: Unique decision ID
+
+  title:
+    type: string
+    required: true
+    description: Brief decision title
+
+  level:
+    type: integer
+    required: true
+    description: Autonomy level
+
+  context:
+    type: string
+    required: true
+    description: Why this decision arose
+
+  options:
+    type: array
+    items: string
+    description: Available options
+
+  decision:
+    type: string
+    required: true
+    description: What was decided
+
+  rationale:
+    type: string
+    required: true
+    description: Why this was decided
+
+  consequences:
+    type: string
+    description: Expected outcomes
+
+  timestamp:
+    type: datetime
+    required: true
+
+  approved_by:
+    type: string
+    description: Who approved (user/auto)