fix(conductor): improve track parsing robustness and cleanup documentation#151
Open
fernandomenuk wants to merge 1 commit intogemini-cli-extensions:mainfrom
Open
Conversation
- Update implement.toml to support both bulleted and heading track formats - Fix duplicate 'Aliases' section in C++ style guide - Add conductor/index.md to generated artifacts list in README
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Pull Request: Improve Track Parsing Robustness and Documentation Cleanup
1. Overview
This PR addresses several minor technical inconsistencies and documentation gaps identified during a repository audit. The primary focus is on making the
implementcommand more resilient to different formatting styles in thetracks.mdfile and ensuring that our public-facing documentation and style guides are accurate and free of duplicates.2. Problem Statement
implementcommand previously relied on a strict heading format (## [ ] Track:) for identifying and updating tracks. However, the setup process and other commands often utilize a bulleted list format (- [ ] **Track:), which could lead to parsing failures or status update errors.README.mdomittedconductor/index.mdfrom the list of files generated by/conductor:setup, which could lead to confusion for new users regarding the project structure.3. Proposed Solution & Detailed Changes
commands/conductor/implement.toml- [ ] **Track:and## [ ] Track:formats. This ensures that the agent can accurately identify and transition track statuses regardless of the initial formatting style used during track creation.templates/code_styleguides/cpp.mdusingovertypedefand clarifies the requirements for documentation and public API usage.README.mdconductor/index.mdto the "Generated Artifacts" section under the/conductor:setupcommand description. This ensures the documentation is a 1:1 match with the actual scaffolding behavior.4. Technical Rationale
tracks.mdfile or if different versions of the Conductor extension use slightly different formatting.README.mdin sync with the actual tool behavior is critical for maintaining user trust and reducing onboarding friction.5. Verification Performed
.tomlprompt logic to ensure that the branching and replacement strings are correctly escaped and contextually accurate.cpp.mdandREADME.mdmaintain proper markdown structure and rendering.6. Checklist
type(scope): descriptionformat.