Skip to content

Fix Institutional Memory Framework PR comments - #20

Open
dandye wants to merge 1 commit into
mainfrom
institutional_memory-8647627324536481608
Open

Fix Institutional Memory Framework PR comments#20
dandye wants to merge 1 commit into
mainfrom
institutional_memory-8647627324536481608

Conversation

@dandye

@dandye dandye commented Jan 29, 2026

Copy link
Copy Markdown
Owner

Addressed feedback from PR #13 review:

  • Fixed YAML syntax in apply_memory_procedure.md.
  • Aligned confidence definitions in MEMORY-THESAURUS.md.
  • Updated promotion criteria to use quantitative metrics in automated_memory_lifecycle.md.
  • Fixed time format in PHASE_3_INTEGRATION_SUMMARY.md.
  • Aligned comments in README.md.
  • Removed trailing whitespace in multiple files.

PR created automatically by Jules for task 8647627324536481608 started by @dandye

Co-authored-by: dandye <121151+dandye@users.noreply.github.com>
@google-labs-jules

Copy link
Copy Markdown
Contributor

👋 Jules, reporting for duty! I'm here to lend a hand with this pull request.

When you start a review, I'll add a 👀 emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down.

I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job!

For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with @jules. You can find this option in the Pull Request section of your global Jules UI settings. You can always switch back!

New to Jules? Learn more at jules.google/docs.


For security, I will only act on instructions from the user who triggered this task.

@gemini-code-assist

Copy link
Copy Markdown
Contributor

Summary of Changes

Hello @dandye, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request significantly enhances the AI Runbooks project by integrating a new 'Institutional Memory Framework' and the 'SuperClaude_Framework' as a submodule. The core purpose is to introduce adaptive learning capabilities, allowing AI agents to dynamically improve their procedural execution based on operational feedback and organizational context. This involves a comprehensive set of new documentation, runbooks, and common steps for managing, optimizing, and applying institutional knowledge, alongside a refactoring of the existing skills system. The changes aim to streamline security operations, improve decision-making accuracy, and foster continuous organizational learning within the AI-assisted cybersecurity workflows.

Highlights

  • Institutional Memory Framework Introduction: A new framework has been introduced to enable AI agents to learn from analyst feedback and operational experience, transforming static runbooks into adaptive, organization-specific expertise.
  • SuperClaude Integration: The SuperClaude security commands system has been integrated as a submodule, providing advanced command orchestration and specialized security slash commands for AI Runbooks.
  • Automated Memory Management: New runbooks and components for automated confidence tuning, lifecycle management (promotion and retirement), and health monitoring of institutional memories have been added.
  • Enhanced Triage and Hunting Workflows: Existing triage and hunting runbooks have been updated to leverage institutional memory for improved efficiency, pattern recognition, and decision-making.
  • Comprehensive Documentation Updates: Extensive new documentation has been added, including a thesaurus for memory concepts, report templates for memory-enhanced operations, and detailed runbooks for various threat intelligence and security operations.
  • Skills System Refactoring: The previous 'skills/' directory has been removed and replaced by the 'SuperClaude_Framework' submodule, indicating a significant refactoring of the skills and persona system.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Ignored Files
  • Ignored by pattern: .gemini/** (1)
    • .gemini/skills
  • Ignored by pattern: .github/workflows/** (2)
    • .github/workflows/claude-code-review.yml
    • .github/workflows/claude.yml
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces a significant and well-structured "Institutional Memory" framework, which is a great step towards an adaptive learning system for security runbooks. The addition of the SuperClaude_Framework submodule and the detailed documentation for new commands and concepts are excellent. The cleanup of old runbooks by removing rubrics and boilerplate completion steps simplifies the codebase.

My review focuses on ensuring consistency within the new framework. I've identified a minor but important inconsistency in how "confidence levels" are defined across different new files. Aligning these definitions will improve clarity and prevent ambiguity during implementation. Overall, this is a high-quality contribution that greatly enhances the repository's capabilities.

Comment on lines +210 to +232
### HIGH_CONFIDENCE
USE FOR: High Trust, Proven Memory, Validated Learning
BT: Confidence Level
RT: Automatic Application, Validated Memory, High Success Rate
SN: Confidence level 0.9-1.0, suitable for automatic application

### EXPERIMENTAL_CONFIDENCE
USE FOR: Experimental Memory, Unproven Learning
BT: Confidence Level
RT: Low Confidence, Validation Required, Analyst Approval
SN: Confidence level 0.0-0.3, requires analyst approval before application

### LOW_CONFIDENCE
USE FOR: Low Trust, Cautious Application
BT: Confidence Level
RT: Experimental Confidence, Medium Confidence, Careful Monitoring
SN: Confidence level 0.4-0.6, suggest with caution and track closely

### MEDIUM_CONFIDENCE
USE FOR: Moderate Trust, Recommended Application
BT: Confidence Level
RT: High Confidence, Recommended Procedure
SN: Confidence level 0.7-0.8, suitable for recommendation with explanation No newline at end of file

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The definitions for confidence levels have gaps between the ranges (e.g., values between 0.3 and 0.4, or 0.6 and 0.7 are undefined), which could lead to ambiguity. To ensure consistency across the new framework, consider adopting continuous ranges as defined in rules_bank/institutional_memory/SYSTEM_HEALTH_DASHBOARD.md. This would make the definitions clearer and cover all possible values.

### HIGH_CONFIDENCE
  USE FOR: High Trust, Proven Memory, Validated Learning
  BT: Confidence Level
  RT: Automatic Application, Validated Memory, High Success Rate
  SN: Confidence level ≥0.9, suitable for automatic application.

### EXPERIMENTAL_CONFIDENCE
  USE FOR: Experimental Memory, Unproven Learning, Very Low Confidence
  BT: Confidence Level
  RT: Low Confidence, Validation Required, Analyst Approval
  SN: Confidence level <0.4, requires analyst approval before application.

### LOW_CONFIDENCE
  USE FOR: Low Trust, Cautious Application
  BT: Confidence Level
  RT: Experimental Confidence, Medium Confidence, Careful Monitoring
  SN: Confidence level 0.4-0.69, suggest with caution and track closely.

### MEDIUM_CONFIDENCE
  USE FOR: Moderate Trust, Recommended Application
  BT: Confidence Level
  RT: High Confidence, Recommended Procedure
  SN: Confidence level 0.7-0.89, suitable for recommendation with explanation.

Comment on lines +108 to +111
- **0.0-0.3**: Experimental/unvalidated memories (requires analyst approval)
- **0.4-0.6**: Low confidence (suggest with caution, track closely)
- **0.7-0.8**: Medium confidence (recommend with explanation)
- **0.9-1.0**: High confidence (apply automatically with notification)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The confidence scoring guidelines have gaps between the ranges, which can cause ambiguity. To ensure consistency across the framework, I recommend using continuous ranges, similar to the definitions in SYSTEM_HEALTH_DASHBOARD.md.

Suggested change
- **0.0-0.3**: Experimental/unvalidated memories (requires analyst approval)
- **0.4-0.6**: Low confidence (suggest with caution, track closely)
- **0.7-0.8**: Medium confidence (recommend with explanation)
- **0.9-1.0**: High confidence (apply automatically with notification)
- **<0.4**: Experimental/unvalidated memories (requires analyst approval)
- **0.4-0.69**: Low confidence (suggest with caution, track closely)
- **0.7-0.89**: Medium confidence (recommend with explanation)
- **0.9**: High confidence (apply automatically with notification)

@dandye

dandye commented Aug 14, 2026

Copy link
Copy Markdown
Owner Author

Status: deferred together with #13 pending the issue #12 go/no-go decision. If #13 proceeds in phased form, this comment-fix PR folds into it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant