Skip to content

Comments

chore: remove unused agentic files and audit research docs#2191

Merged
IsmaelMartinez merged 2 commits intomainfrom
chore/cleanup-agentic-files-and-docs
Feb 18, 2026
Merged

chore: remove unused agentic files and audit research docs#2191
IsmaelMartinez merged 2 commits intomainfrom
chore/cleanup-agentic-files-and-docs

Conversation

@IsmaelMartinez
Copy link
Owner

Summary

  • Remove .github/instructions/ directory (3 unused PRD/task workflow files from the Copilot era, replaced by Claude Code skills)
  • Update references in CLAUDE.md and contributing.md
  • Add status info boxes to all 7 research docs that were missing them
  • Reorganise research README.md into clearer categories (Ready, Awaiting Feedback, Shipped, Archived)
  • Pruned 25 stale local branches (7 merged + 18 unmerged for completed/dropped work)

Test plan

  • npm run lint passes
  • Verify docs site renders correctly with updated research index

🤖 Generated with Claude Code

Remove .github/instructions/ (PRD/task workflow files unused since
Claude Code skills replaced the Copilot-era workflow). Update CLAUDE.md
and contributing.md references. Add status info boxes to all research
docs and reorganise the research README into clearer categories.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@github-actions
Copy link
Contributor

✅ Changelog entry generated and committed to this PR:

chore: remove unused agentic files and audit research docs - by @IsmaelMartinez (#2191)

The file .changelog/pr-2191.txt will be included when you merge this PR.

You can edit it directly in this PR if needed.

@gemini-code-assist
Copy link
Contributor

Summary of Changes

Hello @IsmaelMartinez, 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 focuses on a significant cleanup and reorganization of the project's documentation and internal tooling. It streamlines the codebase by removing obsolete AI agent instruction files, updates documentation to reflect these changes, and enhances the clarity and structure of research documents. The overall impact is improved maintainability, reduced clutter, and a more accurate representation of the project's current development and research statuses.

Highlights

  • Agentic File Removal: Removed three unused AI agent instruction files (create-prd.instructions.md, generate-tasks.instructions.md, process-tasks-list.instructions.md) from the .github/instructions/ directory, as they are now superseded by Claude Code skills.
  • Documentation References Updated: Updated CLAUDE.md and docs-site/docs/development/contributing.md to remove outdated references to the removed agentic instruction files and task management directories.
  • Research Document Status Audited: Added clear status info boxes (using Docusaurus admonitions) to seven research documents, providing immediate context on their implementation stage (e.g., 'Ready for Implementation', 'Shipped', 'Archived', 'Not Recommended').
  • Research README Reorganization: Reorganized the docs-site/docs/development/research/README.md into clearer categories: 'Ready for Implementation', 'Awaiting User Feedback', 'Shipped (Historical Reference)', and 'Archived / Not Feasible', improving navigability and understanding of research statuses.

🧠 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.

Changelog
  • .github/instructions/create-prd.instructions.md
    • Removed the file, which contained instructions for AI agents to generate Product Requirements Documents (PRDs).
  • .github/instructions/generate-tasks.instructions.md
    • Removed the file, which provided instructions for AI agents to generate task lists from PRDs.
  • .github/instructions/process-tasks-list.instructions.md
    • Removed the file, which outlined guidelines for AI agents to manage task lists and implementation protocols.
  • CLAUDE.md
    • Removed references to the now-deleted .github/instructions/*.instructions.md files from the AI Workflow Instructions section.
  • docs-site/docs/development/contributing.md
    • Removed Task management files (tasks/) and AI agent instruction files (.github/instructions/) from the list of markdown files to which standards apply.
  • docs-site/docs/development/research/README.md
    • Reorganized research topics into new categories: 'Ready for Implementation', 'Awaiting User Feedback', 'Shipped (Historical Reference)', and 'Archived / Not Feasible'.
    • Updated status descriptions and moved entries between categories to reflect current project state.
    • Removed 'External Changelog Generation' from the 'Implemented Features (Research Removed)' table, as it is now listed under 'Shipped (Historical Reference)'.
  • docs-site/docs/development/research/electron-40-migration-research.md
    • Added a Docusaurus info admonition indicating the research is 'Ready for Implementation' and targeted for v2.8.0.
  • docs-site/docs/development/research/electron-updater-auto-update-research.md
    • Added a Docusaurus tip admonition indicating the feature was 'Shipped in v2.7.6' and updated the status field accordingly.
  • docs-site/docs/development/research/external-changelog-generation-research.md
    • Added a Docusaurus tip admonition indicating both phases were 'Shipped' and updated the status field.
  • docs-site/docs/development/research/gnome-search-provider-investigation.md
    • Added a Docusaurus warning admonition indicating the feature is 'Not Recommended' due to high latency and updated the status field.
  • docs-site/docs/development/research/logout-indicator-investigation.md
    • Added a Docusaurus danger admonition indicating the research is 'Archived' due to lack of user response and updated the status field.
  • docs-site/docs/development/research/mqtt-extended-status-investigation.md
    • Added a Docusaurus info admonition indicating 'Phase 1 Shipped — Phase 2 Awaiting User Feedback'.
  • docs-site/docs/development/research/screen-lock-media-privacy-investigation.md
    • Updated the Docusaurus admonition from 'tip' to 'warning' and changed its content to 'Awaiting User Feedback', referencing a closure PR.
Activity
  • The author removed the .github/instructions/ directory, which contained three unused PRD/task workflow files from the Copilot era, now replaced by Claude Code skills.
  • The author updated references in CLAUDE.md and contributing.md to reflect the removal of the old instruction files.
  • The author added status info boxes to all seven research documents that were missing them, enhancing clarity.
  • The author reorganized the research README.md into clearer categories: Ready, Awaiting Feedback, Shipped, and Archived.
  • The author pruned 25 stale local branches (7 merged + 18 unmerged for completed/dropped work) as part of general repository hygiene.
  • The author verified that npm run lint passes.
  • The author indicated that verification of the docs site rendering correctly with the updated research index is pending.
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.

@sonarqubecloud
Copy link

Copy link
Contributor

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

Choose a reason for hiding this comment

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

Code Review

This is a great cleanup PR. It removes unused files from an old workflow and significantly improves the structure and clarity of the research documentation. The addition of status info boxes in the research documents is a nice touch that provides immediate context to the reader. The reorganization of the research README.md makes it much easier to understand the status of different research topics. I found one minor inconsistency in a link, which I've commented on.

@github-actions
Copy link
Contributor

📦 PR Snap Build Artifacts

Snap builds successful! Download artifacts:

🐧 Linux Snap Packages

x86_64 (107.67 MB)

arm64 (104.58 MB)

armv7l (98.81 MB)


📝 Note: Other package formats (.deb, .rpm, .AppImage, .dmg, .exe) are built in the main workflow

View workflow run

@github-actions
Copy link
Contributor

📦 PR Build Artifacts

Build successful! Download artifacts:

🐧 Linux

x86_64 (435.53 MB) - Contains: .deb, .rpm, .tar.gz, .AppImage

arm64 (426.74 MB) - Contains: .deb, .rpm, .tar.gz, .AppImage

armv7l (404.83 MB) - Contains: .deb, .rpm, .tar.gz, .AppImage

🍎 macOS

x86_64 (125.26 MB) - Contains: .dmg

🪟 Windows

x86_64 (105.72 MB) - Contains: .exe installer


📝 Note: Snap packages (.snap) are built in a separate workflow

View workflow run

🕐 Last updated: 2026-02-18 22:27 UTC

@IsmaelMartinez IsmaelMartinez merged commit 836402e into main Feb 18, 2026
3 checks passed
@IsmaelMartinez IsmaelMartinez deleted the chore/cleanup-agentic-files-and-docs branch February 18, 2026 22:30
@github-actions github-actions bot mentioned this pull request Feb 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Development

Successfully merging this pull request may close these issues.

1 participant