default - Claude MCP Skill

# KinOS Agent Analysis Framework

## 1. Mission Directory Understanding

### 1.1 File Role Analysis

- **Identifying Relevant Files:**

  - **Input and Output Files:**
    - Which specific files serve as inputs and outputs for your agent's role?
    - How do these files align with the agent's responsibilities?

  - **Scope of Operations:**
    - How does the agent determine which files are within its operational scope?
    - What criteria are used to include or exclude files from monitoring?

- **Recognizing Intervention Triggers:**

  - **File Patterns and Changes:**
    - What file patterns or modifications indicate the need for agent intervention?
    - How does the agent detect relevant content changes that require action?

  - **Monitoring Mechanisms:**
    - What methods are used to monitor files effectively?
    - How frequently should the agent check for changes?

- **Maintaining Role-Specific Focus:**

  - **Avoiding Overlap:**
    - How does the agent ensure it does not overstep into other agents' responsibilities?
    - What safeguards are in place to maintain role-specific operations?

### 1.2 Content Patterns

- **Action Triggers in Content:**

  - **Relevant Patterns:**
    - What specific content patterns should trigger the agent's actions?
    - How does the agent distinguish between significant and insignificant changes?

  - **Content Structures:**
    - What content structures need to be maintained or adhered to?
    - Are there templates or formats that the agent must follow?

- **Optimization Opportunities:**

  - **Identifying Redundancies:**
    - How does the agent identify redundancies or inefficiencies in content?
    - What signals indicate opportunities for optimization?

  - **Documenting Findings:**
    - How are identified issues recorded for action?
    - What files are used to document these findings?

## 2. Aider Operation Design

### 2.1 Trigger Conditions

- **Defining Specific Triggers:**

  - **File Changes:**
    - What exact file changes should trigger Aider operations?
    - How are these changes detected?

  - **Content Modifications:**
    - What content modifications warrant the agent's intervention?
    - How does the agent prioritize these triggers?

- **Formulating Modification Requests:**

  - **Clarity and Precision:**
    - How does the agent formulate clear modification requests for Aider?
    - What language or format is used to ensure Aider can execute commands accurately?

  - **Examples of Commands:**
    - Provide examples of Aider commands the agent would use.
    - How are these commands structured?

- **Validation of Operations:**

  - **Success Criteria:**
    - What validation steps confirm successful Aider operations?
    - How does the agent verify that modifications meet the intended objectives?

  - **Error Handling:**
    - What processes are in place if an operation fails?
    - How does the agent log and respond to errors?

- **Optimizing Aider Usage:**

  - **Efficiency Strategies:**
    - How does the agent avoid redundant operations?
    - What scheduling or batching methods are used to optimize Aider usage?

### 2.2 Content Strategies

- **Structuring Modifications:**

  - **Consistency and Coherence:**
    - How does the agent ensure that content modifications maintain consistency?
    - What guidelines are followed to preserve the original intent?

  - **Content Enhancement:**
    - What strategies are used to improve content quality?
    - How does the agent balance enhancements with maintaining existing content?

- **Maintaining Standards:**

  - **Compliance with Guidelines:**
    - What content standards or style guides must be adhered to?
    - How does the agent ensure compliance during modifications?

  - **Preservation of Patterns:**
    - What important content patterns must be preserved?
    - How does the agent avoid disrupting these patterns?

- **Post-Modification Validation:**

  - **Verification Processes:**
    - How does the agent validate content after modifications?
    - What checks are performed to ensure accuracy and integrity?

  - **Feedback Mechanisms:**
    - How are validation results documented?
    - How does the agent use feedback to improve future operations?

## 3. Validation Mechanisms

### 3.1 Content Validation

- **Defining Valid Content:**

  - **Quality Criteria:**
    - What defines valid versus invalid content in the agent's domain?
    - Are there specific metrics or standards used?

  - **Alignment with Objectives:**
    - How does the agent ensure content aligns with mission objectives?
    - What processes verify that content fulfills its intended purpose?

- **Integrity Checks:**

  - **Detecting Degradation:**
    - What patterns indicate content degradation or corruption?
    - How does the agent monitor for unintended changes?

  - **Error Identification:**
    - How are discrepancies or inconsistencies identified?
    - What tools or methods support error detection?

### 3.2 Operation Success

- **Performance Measurement:**

  - **Effectiveness Metrics:**
    - How does the agent measure the effectiveness of its operations?
    - What key performance indicators (KPIs) are tracked?

  - **Success Indicators:**
    - What indicates successful file modifications?
    - How are improvements quantified?

- **Optimization Verification:**

  - **Assessing Impact:**
    - How does the agent verify that content optimizations have achieved the desired results?
    - What benchmarks are used for comparison?

  - **Continuous Improvement:**
    - How does the agent use validation findings to enhance future operations?
    - What processes support ongoing optimization?

## 4. Error Detection and Recovery

### 4.1 Error Detection

- **Monitoring for Issues:**

  - **Anomaly Detection:**
    - What anomalies in file content or structure signal errors?
    - How does the agent stay vigilant for these issues?

  - **Logging Errors:**
    - How are errors documented within the system?
    - What information is recorded for troubleshooting?

### 4.2 Recovery Procedures

- **Corrective Actions:**

  - **Error Resolution:**
    - What steps does the agent take to correct identified errors?
    - How does the agent prioritize fixes?

  - **Reversion Protocols:**
    - How does the agent revert to previous versions if necessary?
    - What safeguards ensure data integrity during recovery?

- **Validation Post-Recovery:**

  - **Ensuring Stability:**
    - What validation steps are performed after recovery to confirm stability?
    - How does the agent prevent recurrence of the issue?

## 5. Coordination with Other Agents

### 5.1 Indirect Communication

- **Signaling Changes:**

  - **File Updates:**
    - How does the agent inform other agents of its actions through file modifications?
    - What conventions ensure clear communication?

  - **Shared Logs or Notices:**
    - Are there shared files or logs that agents use to coordinate?
    - How does the agent update these resources?

- **Preventing Conflicts:**

  - **Awareness of Other Agents:**
    - How does the agent stay informed about other agents' activities?
    - What mechanisms help detect potential overlaps?

  - **Coordination Strategies:**
    - How does the agent adjust its operations to avoid conflicts?
    - What protocols govern inter-agent coordination?

### 5.2 Collaboration via Files

- **Shared Resources:**

  - **Common Directories:**
    - What files or directories are designated for collaborative purposes?
    - How are access and modifications managed?

  - **Updating Collaborations:**
    - How does the agent contribute to shared content?
    - What guidelines ensure consistency and integrity?

- **Monitoring Impact:**

  - **Observing Effects:**
    - How does the agent monitor the impact of its actions on other agents?
    - What feedback loops are in place?

  - **Adjusting Operations:**
    - How does the agent respond to unintended consequences of its actions?
    - What processes support adaptive behavior?

## 6. Maintaining KinOS Compliance

### 6.1 Adherence to Principles

- **File-Based Operations:**

  - **Avoiding Direct Communication:**
    - Does the agent operate strictly through file modifications?
    - How does it ensure compliance with the principle of indirect communication?

  - **Role-Specific Focus:**
    - Is the agent consistently acting within its defined role?
    - What measures prevent scope creep?

### 6.2 Documentation and Transparency

- **Recording Actions:**

  - **Activity Logs:**
    - How does the agent document its actions and decisions?
    - Where are these logs stored?

  - **Audit Trails:**
    - Are all changes traceable to the agent's operations?
    - How does the agent facilitate audits or reviews?

- **Ensuring Accountability:**

  - **Transparency Practices:**
    - What practices ensure transparency of the agent's operations?
    - How does the agent communicate its contributions to the system?

## 7. System Impact Awareness

### 7.1 Assessing Impact

- **Evaluating Actions:**

  - **System Health:**
    - How does the agent assess the impact of its actions on overall system health?
    - What indicators are monitored?

  - **Risk Management:**
    - How does the agent identify potential risks associated with its operations?
    - What strategies mitigate these risks?

### 7.2 Verifying Benefits

- **Measuring Improvements:**

  - **Value Contribution:**
    - How does the agent quantify the benefits of its actions?
    - What metrics demonstrate added value?

  - **Alignment with Goals:**
    - How does the agent ensure its actions align with mission objectives?
    - What processes confirm alignment?

- **Feedback Integration:**

  - **Learning Mechanisms:**
    - How does the agent incorporate feedback into its operations?
    - What systems support continuous learning?

## 8. Concrete Implementation

### 8.1 Critical Questions

- **Monitoring Specific Files:**

  - **Tools and Methods:**
    - What tools does the agent use to monitor files?
    - How are these tools configured?

  - **Scheduling:**
    - How frequently are files checked for changes?
    - Is there a schedule or event-driven trigger?

- **Aider Command Usage:**

  - **Command Examples:**
    - Provide specific examples of Aider commands the agent uses.
    - How are these commands optimized for efficiency?

  - **Command Execution:**
    - How does the agent ensure commands are executed safely?
    - What error-checking mechanisms are in place?

- **Structuring Modifications:**

  - **File Formats:**
    - What file formats or structures are used?
    - How does the agent maintain consistency?

  - **Content Organization:**
    - How are modifications organized within the files?
    - What conventions support readability and maintainability?

### 8.2 Practical Considerations

- **Content Optimizations:**

  - **Applicable Techniques:**
    - What specific optimizations are relevant to the agent's role?
    - How are these implemented?

  - **Balancing Trade-offs:**
    - How does the agent balance optimization with potential impacts?
    - What considerations guide decision-making?

- **Maintaining Consistency:**

  - **Standards Compliance:**
    - What standards or guidelines govern content consistency?
    - How does the agent ensure adherence?

  - **Pattern Preservation:**
    - What patterns must be preserved during modifications?
    - How are these patterns identified and protected?

- **Resource Management:**

  - **Efficiency Practices:**
    - How does the agent manage computational or storage resources?
    - What practices minimize resource consumption?

  - **Scalability:**
    - How does the agent's operation scale with increasing workload?
    - What strategies support scalability?

## 9. KinOS Compliance Checklist

- **Adherence to File-Based Operations:**
  - Are all actions performed strictly through file modifications mediated by Aider?

- **Avoiding Direct Communication:**
  - Does the agent coordinate solely via file changes without direct messaging to other agents?

- **Role-Specific Focus:**
  - Is the agent consistently adhering to its defined role and not overstepping into other agents' responsibilities?

- **Documentation and Transparency:**
  - Are all actions and decisions transparently recorded in the files?

- **Validation Through Files:**
  - Are all validations and error detections based exclusively on file content and structure?

## Remember:

- **Focus on Concrete File Operations:**

  - Every action must translate to concrete Aider file operations. Avoid theoretical constructs that don't map to actual file monitoring and modification capabilities.

- **Adhere to KinOS Principles:**

  - Operate strictly within the defined framework, avoiding scope creep and direct communication.

- **Coordinate via Files Only:**

  - Use designated files for signaling and coordination with other agents.

- **Document Thoroughly:**

  - Keep detailed records of changes, decisions, and processes within the file system.

- **Maintain System Awareness:**

  - Always consider the broader impact of actions on the system and other agents.