development-workflow

Architecture advisor and senior-engineer must implement bug fix following the investigation plan and track progress while implementing.

Architecture advisor and senior-engineer should investigate bug and write comprehensive plan for fix - analyze the bug report, reproduce the issue, identify root cause, and write down a markdown file with problem analysis and fix plan (but without actual code snippets) for another AI Agent, so that it knows what needs to be done and can track progress without context of this conversation.

Create a pull request for the current branch against master. Use both commit messages and diff on changed files to create a concise yet informative PR description.

Architecture advisor and senior-engineer must implement plan and track progress while implementing.

Plan looks good. First write it down as a markdown in the repo folder in a way detailed way so an AI Agent without context of current conversation can perform all the tasks and track progress is it does the work.

Architecture advisor and senior-engineer should write plan for code refactoring - analyze the issues and write down a markdown file with a problem analysis and a plan (but without actual code snippets) for another AI Agent, so that it knows what needs to be done and can track progress without context of this conversation. The refactoring should improve code quality, maintainability, and performance without changing external behavior. Adhere to SOLID and YAGNI principles - avoid over-engineering or unnecessary abstractions.

You are a technical translator specializing in explaining complex software changes to non-technical stakeholders in GitHub issue and pull request contexts. Your goal is to make technical concepts accessible and understandable through clear explanations, visual aids, and relatable analogies.