8229a03986
- Introduced a prompt for creating standardized documentation for object-oriented components, adhering to industry best practices and architectural standards. - Added a prompt for generating new specification files optimized for Generative AI consumption, including best practices for AI-ready specifications. - Created a prompt for reviewing .NET/C# code against best practices, focusing on documentation, design patterns, dependency injection, and error handling. - Developed a prompt for reviewing design pattern implementations in .NET/C# code, providing a checklist and improvement focus areas. - Implemented a prompt for updating Azure Verified Modules in Bicep files to the latest versions, including a breaking change policy. - Added a prompt for updating existing implementation plans with new requirements or updates to existing code. - Created a prompt for updating the llms.txt file to reflect changes in documentation or specifications. - Developed a prompt for updating markdown file sections with an index/table of files from specified folders. - Introduced a prompt for updating existing object-oriented component documentation based on current implementation. - Added a prompt for updating existing specifications based on new requirements or code updates.
77 lines
2.9 KiB
Markdown
77 lines
2.9 KiB
Markdown
---
|
||
mode: 'agent'
|
||
description: 'Update a markdown file section with an index/table of files from a specified folder.'
|
||
tools: ['changes', 'codebase', 'editFiles', 'extensions', 'fetch', 'findTestFiles', 'githubRepo', 'openSimpleBrowser', 'problems', 'runCommands', 'runTasks', 'runTests', 'search', 'searchResults', 'terminalLastCommand', 'terminalSelection', 'testFailure', 'updateUserPreferences', 'usages', 'vscodeAPI', 'ado']
|
||
---
|
||
# Update Markdown File Index
|
||
|
||
Update markdown file `${file}` with an index/table of files from folder `${input:folder}`.
|
||
|
||
## Process
|
||
|
||
1. **Scan**: Read the target markdown file `${file}` to understand existing structure
|
||
2. **Discover**: List all files in the specified folder `${input:folder}` matching pattern `${input:pattern}`
|
||
3. **Analyze**: Identify if an existing table/index section exists to update, or create new structure
|
||
4. **Structure**: Generate appropriate table/list format based on file types and existing content
|
||
5. **Update**: Replace existing section or add new section with file index
|
||
6. **Validate**: Ensure markdown syntax is valid and formatting is consistent
|
||
|
||
## File Analysis
|
||
|
||
For each discovered file, extract:
|
||
|
||
- **Name**: Filename with or without extension based on context
|
||
- **Type**: File extension and category (e.g., `.md`, `.js`, `.py`)
|
||
- **Description**: First line comment, header, or inferred purpose
|
||
- **Size**: File size for reference (optional)
|
||
- **Modified**: Last modified date (optional)
|
||
|
||
## Table Structure Options
|
||
|
||
Choose format based on file types and existing content:
|
||
|
||
### Option 1: Simple List
|
||
|
||
```markdown
|
||
## Files in ${folder}
|
||
|
||
- [filename.ext](path/to/filename.ext) - Description
|
||
- [filename2.ext](path/to/filename2.ext) - Description
|
||
```
|
||
|
||
### Option 2: Detailed Table
|
||
|
||
| File | Type | Description |
|
||
|------|------|-------------|
|
||
| [filename.ext](path/to/filename.ext) | Extension | Description |
|
||
| [filename2.ext](path/to/filename2.ext) | Extension | Description |
|
||
|
||
### Option 3: Categorized Sections
|
||
|
||
Group files by type/category with separate sections or sub-tables.
|
||
|
||
## Update Strategy
|
||
|
||
- 🔄 **Update existing**: If table/index section exists, replace content while preserving structure
|
||
- ➕ **Add new**: If no existing section, create new section using best-fit format
|
||
- 📋 **Preserve**: Maintain existing markdown formatting, heading levels, and document flow
|
||
- 🔗 **Links**: Use relative paths for file links within the repository
|
||
|
||
## Section Identification
|
||
|
||
Look for existing sections with these patterns:
|
||
|
||
- Headings containing: "index", "files", "contents", "directory", "list"
|
||
- Tables with file-related columns
|
||
- Lists with file links
|
||
- HTML comments marking file index sections
|
||
|
||
## Requirements
|
||
|
||
- Preserve existing markdown structure and formatting
|
||
- Use relative paths for file links
|
||
- Include file descriptions when available
|
||
- Sort files alphabetically by default
|
||
- Handle special characters in filenames
|
||
- Validate all generated markdown syntax
|