Skip to content

docs(gemini): Update knowledge base and maintenance instructions#1819

Merged
jcscottiii merged 1 commit intomainfrom
jcscottiii/update-gemini-md
Sep 10, 2025
Merged

docs(gemini): Update knowledge base and maintenance instructions#1819
jcscottiii merged 1 commit intomainfrom
jcscottiii/update-gemini-md

Conversation

@jcscottiii
Copy link
Collaborator

Updates the Gemini assistant's knowledge base (GEMINI.md) based on an analysis of recent commits. This captures significant architectural and feature changes, including:

  • Developer Signals: Documents the new developer_signals_consumer workflow, the LatestFeatureDeveloperSignals database table, and the associated data adapters and types.
  • Feature Evolution: Explains how the system now handles "moved" and "split" features, including the new MovedWebFeatures and SplitWebFeatures tables.
  • Data Migration: Details the new pre-delete hook (GetChildDeleteKeyMutations) for handling large cascade deletes in Spanner and the generic data migrator for feature key renames.
  • Code Refactoring: Notes the refactoring of HTTP fetching into a common fetchtypes module and the use of ProcessedWebFeaturesData in the web_feature_consumer.

Additionally, this commit improves the process for maintaining the knowledge base itself:

  • Consolidates the "Living Document" and "Updating the Knowledge Base" sections into a single, more comprehensive guide.
  • Adds a hidden marker with the last analyzed commit SHA to streamline future updates.
  • Provides a standardized prompt for triggering knowledge base updates.

Updates the Gemini assistant's knowledge base (`GEMINI.md`) based on an analysis of recent commits. This captures significant architectural and feature changes, including:

- **Developer Signals:** Documents the new `developer_signals_consumer` workflow, the `LatestFeatureDeveloperSignals` database table, and the associated data adapters and types.
- **Feature Evolution:** Explains how the system now handles "moved" and "split" features, including the new `MovedWebFeatures` and `SplitWebFeatures` tables.
- **Data Migration:** Details the new pre-delete hook (`GetChildDeleteKeyMutations`) for handling large cascade deletes in Spanner and the generic data migrator for feature key renames.
- **Code Refactoring:** Notes the refactoring of HTTP fetching into a common `fetchtypes` module and the use of `ProcessedWebFeaturesData` in the `web_feature_consumer`.

Additionally, this commit improves the process for maintaining the knowledge base itself:

- Consolidates the "Living Document" and "Updating the Knowledge Base" sections into a single, more comprehensive guide.
- Adds a hidden marker with the last analyzed commit SHA to streamline future updates.
- Provides a standardized prompt for triggering knowledge base updates.
@jcscottiii jcscottiii requested a review from jrobbins September 10, 2025 19:11
Copy link
Collaborator

@jrobbins jrobbins left a comment

Choose a reason for hiding this comment

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

Fascinating.

@jcscottiii jcscottiii added this pull request to the merge queue Sep 10, 2025
Merged via the queue into main with commit 604d7da Sep 10, 2025
8 of 9 checks passed
@jcscottiii jcscottiii deleted the jcscottiii/update-gemini-md branch September 10, 2025 22:54
@jcscottiii jcscottiii mentioned this pull request Sep 18, 2025
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.

2 participants