Reorganize template setup workflow for better agent clarity#11
Merged
Conversation
- Add final step to change alwaysApply from true to false after template initialization - Prevents detailed template setup instructions from consuming context window space - Ensures template setup rules are visible during one-time setup but hidden afterwards - Maintains accessibility via reference in workflow.mdc if needed later
…rkflow - Add GitHub CLI commands to enable issues in new repos - Include complete branch protection rules that match template repo - Provide both CLI and manual setup instructions - Document all protection settings for consistency across projects
…rity - Nest Environment File Distinction under step 2 (Remove template content) - Nest Branch Protection Rules Summary and Manual Setup under step 4 - Eliminate duplicate sections and improve contextual flow - Group related information with their respective steps - Reduce cognitive load for agents following the workflow
- Added step 6 to git workflow: 'Return to Main' - Ensures developers always checkout main and pull after creating PR - Prevents feature mixing and keeps local environment current - Renumbered final step to 7 for clarity
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
1 participant
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.
Summary
Improved the organization of the template setup workflow by nesting related information under their respective steps, making it easier for agents to follow the complete workflow without missing context.
Changes Made
Benefits
Why This Matters
During testing, agents were missing steps because related information was scattered across multiple sections. This reorganization ensures agents have all the context and alternatives for each step right when they need it, improving workflow completion success rates.
The streamlined file now has a clear 5-step checklist with all supporting info nested appropriately, essential boundaries in the 'What NOT to Include' section, and no duplicate or orphaned sections.