feat(chatmodes): Add HLBPA (documentation architect) chat mode (#278)

* feat(chatmodes): Add HLBPA (documentation architect) chat modes

- HLBPA is a high-level, big-picture architect for systems documentation
- It can be used either in VSC as usual or dropped in coding agent for auto-updates
- Depends on user's prompting skills to get the best results
- Will default to a more generalist mode if not enough context is given
- Minor updates to README and CONTRIBUTING to fix formatting errors

Assisted-by: GitHub Copilot & Verdent AI
Signed-off-by: Ashley Childress <[email protected]>

* chore(chatmodes): Remove copy from md fence in HLBPA chat mode

- Copilot complains about the copy in the md fence
- Isn't likely to be used in this context anyway

Assisted-by: GitHub Copilot
Signed-off-by: Ashley Childress <[email protected]>

---------

Signed-off-by: Ashley Childress <[email protected]>

Author: anchildress1

.gitignore

@@ -4,3 +4,4 @@ Copilot-Processing.md
 
 # macOS system files
 .DS_Store
+*.tmp

CONTRIBUTING.md

@@ -13,7 +13,8 @@ Instructions help customize GitHub Copilot's behavior for specific technologies,
 3. **Structure your content**: Start with a clear heading and organize your instructions logically
 4. **Test your instructions**: Make sure your instructions work well with GitHub Copilot
 
-#### Example instruction format:
+#### Example instruction format
+
 ```markdown
 ---
 description: 'Instructions for customizing GitHub Copilot behavior for specific technologies and practices'
@@ -41,7 +42,8 @@ Prompts are ready-to-use templates for specific development scenarios and tasks.
 3. **Include frontmatter**: Add metadata at the top of your file (optional but recommended)
 4. **Structure your prompt**: Provide clear context and specific instructions
 
-#### Example prompt format:
+#### Example prompt format
+
 ```markdown
 ---
 mode: 'agent'
@@ -69,7 +71,8 @@ Chat modes are specialized configurations that transform GitHub Copilot Chat int
 4. **Define the persona**: Create a clear identity and expertise area for the chat mode
 5. **Test your chat mode**: Ensure the chat mode provides helpful, accurate responses in its domain
 
-#### Example chat mode format:
+#### Example chat mode format
+
 ```markdown
 ---
 description: 'Brief description of the chat mode and its purpose'
@@ -109,15 +112,17 @@ Collections group related prompts, instructions, and chat modes around specific
 3. **Reference existing items**: Collections should only reference files that already exist in the repository
 4. **Test your collection**: Verify all referenced files exist and work well together
 
-#### Creating a collection:
+#### Creating a collection
+
 ```bash
 # Using the creation script
 node create-collection.js my-collection-id
 
 # Or using VS Code Task: Ctrl+Shift+P > "Tasks: Run Task" > "create-collection"
 ```
 
-#### Example collection format:
+#### Example collection format
+
 ```yaml
 id: my-collection-id
 name: My Collection Name
@@ -135,7 +140,8 @@ display:
   show_badge: false # set to true to show collection badge
 ```
 
-#### Collection Guidelines:
+#### Collection Guidelines
+
 - **Focus on workflows**: Group items that work together for specific use cases
 - **Reasonable size**: Typically 3-10 items work well
 - **Test combinations**: Ensure the items complement each other effectively
@@ -155,7 +161,7 @@ display:
    - A brief description of what your instruction/prompt does
    - Any relevant context or usage notes
 
-**Note**: Once your contribution is merged, you'll automatically be added to our [Contributors](#contributors-) section! We use [all-contributors](https://github.com/all-contributors/all-contributors) to recognize all types of contributions to the project.
+**Note**: Once your contribution is merged, you'll automatically be added to our [Contributors](./README.md#contributors-) section! We use [all-contributors](https://github.com/all-contributors/all-contributors) to recognize all types of contributions to the project.
 
 ## What We Accept
 
@@ -194,6 +200,7 @@ To maintain a safe, responsible, and constructive community, we will **not accep
 This project uses [all-contributors](https://github.com/all-contributors/all-contributors) to recognize contributors. When you make a contribution, you'll automatically be recognized in our contributors list!
 
 We welcome contributions of all types, including:
+
 - 📝 Documentation improvements
 - 💻 Code contributions
 - 🐛 Bug reports and fixes

README.chatmodes.md

@@ -40,6 +40,7 @@ Custom chat modes define specific behaviors and tools for GitHub Copilot Chat, e
 | [Expert C++ software engineer mode instructions](chatmodes/expert-cpp-software-engineer.chatmode.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fexpert-cpp-software-engineer.chatmode.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fexpert-cpp-software-engineer.chatmode.md) | Provide expert C++ software engineering guidance using modern C++ and industry best practices. |
 | [Expert React Frontend Engineer Mode Instructions](chatmodes/expert-react-frontend-engineer.chatmode.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fexpert-react-frontend-engineer.chatmode.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fexpert-react-frontend-engineer.chatmode.md) | Provide expert React frontend engineering guidance using modern TypeScript and design patterns. |
 | [Gilfoyle Code Review Mode](chatmodes/gilfoyle.chatmode.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fgilfoyle.chatmode.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fgilfoyle.chatmode.md) | Code review and analysis with the sardonic wit and technical elitism of Bertram Gilfoyle from Silicon Valley. Prepare for brutal honesty about your code. |
+| [High-Level Big Picture Architect (HLBPA)](chatmodes/hlbpa.chatmode.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fhlbpa.chatmode.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fhlbpa.chatmode.md) | HLBPA: Your perfect AI chat mode for high-level architectural documentation and review. Perfect for targeted updates after a story or researching that legacy system when nobody remembers what it's supposed to be doing. |
 | [Idea Generator mode instructions](chatmodes/simple-app-idea-generator.chatmode.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fsimple-app-idea-generator.chatmode.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fsimple-app-idea-generator.chatmode.md) | Brainstorm and develop new application ideas through fun, interactive questioning until ready for specification creation. |
 | [Implementation Plan Generation Mode](chatmodes/implementation-plan.chatmode.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fimplementation-plan.chatmode.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fimplementation-plan.chatmode.md) | Generate an implementation plan for new features or refactoring existing code. |
 | [Kusto Assistant: Azure Data Explorer (Kusto) Engineering Assistant](chatmodes/kusto-assistant.chatmode.md)<br />[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fkusto-assistant.chatmode.md)<br />[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fkusto-assistant.chatmode.md) | Expert KQL assistant for live Azure Data Explorer analysis via Azure MCP server |

README.md

@@ -47,33 +47,39 @@ To make it easy to add these customizations to your editor, we have created a [M
 ## 🔧 How to Use
 
 ### 🎯 Prompts
+
 Use the `/` command in GitHub Copilot Chat to access prompts:
-```
+
+```plaintext
 /awesome-copilot create-readme
 ```
 
 ### 📋 Instructions
+
 Instructions automatically apply to files based on their patterns and provide contextual guidance for coding standards, frameworks, and best practices.
 
 ### 💭 Chat Modes
+
 Activate chat modes to get specialized assistance from AI personas tailored for specific roles like architects, DBAs, or security experts.
 
 ## 🤝 Contributing
 
 We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details on how to:
+
 - Add new prompts, instructions, or chat modes
 - Improve existing content
 - Report issues or suggest enhancements
 
 ### Quick Contribution Guide
+
 1. Follow our file naming conventions and frontmatter requirements
 2. Test your contributions thoroughly
 3. Update the appropriate README tables
 4. Submit a pull request with a clear description
 
 ## 📖 Repository Structure
 
-```
+```plaintext
 ├── prompts/          # Task-specific prompts (.prompt.md)
 ├── instructions/     # Coding standards and best practices (.instructions.md)
 ├── chatmodes/        # AI personas and specialized modes (.chatmode.md)