diff --git a/.claude/agents/dotnet-developer.md b/.claude/agents/dotnet-developer.md deleted file mode 100644 index fe21deea..00000000 --- a/.claude/agents/dotnet-developer.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -name: dotnet-developer -description: .NET developer agent specialized in building enterprise applications using C# and the .NET ecosystem. Delegates to specialized skills for SDK development, testing, data access, package management, documentation, code review, and refactoring. ---- - -# .NET Developer Agent - -**Scope: C# / .NET Projects** - -## Role - -You are a .NET developer specialized in building enterprise applications using the .NET ecosystem. You delegate to specialized skills for each area of work. - -## Skills - -Use the following skills based on the task at hand: - -| Area | Skill | Description | -|------|-------|-------------| -| Web & REST APIs | `dotnet-aspnet` | ASP.NET Core controllers, minimal APIs, middleware, auth, and API conventions | -| SDK & Library Development | `dotnet-sdk-builder` | Generate .NET SDK libraries with DI support, typed HTTP clients, and Options pattern | -| Testing | `dotnet-tester` | Write and execute unit tests using xUnit, FakeItEasy, and AwesomeAssertions | -| Data Access | `dotnet-ef-core` | Entity Framework Core best practices, DbContext design, migrations, and queries | -| Package Management | `dotnet-nuget-manager` | Add, remove, and update NuGet packages via dotnet CLI | -| Documentation | `dotnet-xmldocs` | C# XML documentation comments following Microsoft standards | -| Code Review | `code-review` | Structured code reviews covering quality, security, and performance | -| Refactoring | `refactoring` | Improve code structure and maintainability without changing behavior | diff --git a/.claude/skills/convert-plaintext-to-md/SKILL.md b/.claude/skills/convert-plaintext-to-md/SKILL.md deleted file mode 100644 index e92d220c..00000000 --- a/.claude/skills/convert-plaintext-to-md/SKILL.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -name: convert-plaintext-to-md -description: Converts plain text or legacy documentation files to properly formatted Markdown. Use when asked to convert, migrate, or reformat a plaintext file to .md format. Supports reference-guided conversion, formatting options (headers, code blocks, indentation), and finalization/cleanup of existing .md files. ---- - -# Convert Plaintext Documentation to Markdown - -## Conversion Methods - -You can perform conversions using one of three approaches: - -1. **From explicit instructions** — Follow specific conversion instructions provided with the request. -2. **From documented options** — If a documented option/procedure is passed, follow those established conversion rules. -3. **From reference file** — Use another markdown file (that was previously converted from text format) as a template and guide for converting similar documents. - -When using a reference file, apply the same formatting patterns, structure, and conventions — while adapting to the specific content of the file being converted. - -## Workflow - -1. Determine the input file and check whether a `.md` counterpart already exists (see [parameters.md](./references/parameters.md)) -2. Identify which conversion method applies -3. Apply the requested parameters and options (see [parameters.md](./references/parameters.md)) -4. Follow pattern recognition and content preservation rules (see [considerations.md](./references/considerations.md)) -5. If `finalize` is passed, clean up formatting after conversion - -## References - -- [Parameters and Options](./references/parameters.md) — Full parameter reference, options (`--header`, `--pattern`, `--stop`), predefined instructions -- [Usage Examples](./references/examples.md) — Worked examples: basic conversion, guide-based, finalize, inline regex pattern -- [Conversion Considerations](./references/considerations.md) — Pattern recognition, conversion goals, markdown style references - -> [!IMPORTANT] -> Do not change the data content unless the prompt instructions clearly and without a doubt specify to do so. diff --git a/.claude/skills/convert-plaintext-to-md/references/azure-devops-markdown-guidance.md b/.claude/skills/convert-plaintext-to-md/references/azure-devops-markdown-guidance.md deleted file mode 100644 index 59631614..00000000 --- a/.claude/skills/convert-plaintext-to-md/references/azure-devops-markdown-guidance.md +++ /dev/null @@ -1,173 +0,0 @@ -# Azure DevOps Markdown Guidance - -This reference describes Markdown syntax supported by Azure DevOps features including Wiki pages, README files, dashboards, and pull requests. - -## Supported Features - -| Markdown type | Definition of Done | Widget | Pull Requests | README | Wiki | -|---|---|---|---|---|---| -| Headings | Yes | Yes | Yes | Yes | Yes | -| Paragraphs/line breaks | Yes | Yes | Yes | Yes | Yes | -| Blockquotes | Yes | Yes | Yes | Yes | Yes | -| Horizontal rules | Yes | Yes | Yes | Yes | Yes | -| Emphasis (bold, italic) | Yes | Yes | Yes | Yes | Yes | -| Tables | No | Yes | Yes | Yes | Yes | -| Lists (ordered, unordered) | Yes | Yes | Yes | Yes | Yes | -| Links | Yes | Yes | Yes | Yes | Yes | -| Images | No | Yes | Yes | Yes | Yes | -| Code highlighting | No | Yes | Yes | Yes | Yes | -| Math notation | No | No | Yes | Yes | Yes | -| Checklists/task lists | No | No | Yes | Yes | Yes | -| Mermaid diagrams | No | No | No | No | Yes | - -> **Note:** Markdown in Azure DevOps doesn't support JavaScript or iframes. - -## Headings - -```markdown -# Heading 1 -## Heading 2 -### Heading 3 -#### Heading 4 -##### Heading 5 -###### Heading 6 -``` - -## Paragraphs and Line Breaks - -Use a blank line for new paragraphs. Use two spaces at line end or `
` for line breaks within a paragraph. - -## Blockquotes - -```markdown -> Single blockquote ->> Nested blockquote -``` - -## Horizontal Rules - -Use three or more hyphens, asterisks, or underscores on a line by themselves. - -## Emphasis - -```markdown -*Italic* or _Italic_ -**Bold** or __Bold__ -***Bold italic*** -~~Strikethrough~~ -``` - -## Code Highlighting - -**Inline:** Use single backticks `` `code` `` - -**Block:** Use triple backticks with optional language identifier: - -````markdown -```javascript -const x = 1; -``` -```` - -Supported languages include: ActionScript, Apex, Bash, C, C#, C++, CSS, Dart, Go, Groovy, Haskell, HTML, Java, JavaScript, JSON, Kotlin, Lua, Markdown, Objective-C, Perl, PHP, PowerShell, Python, R, Ruby, Rust, Scala, Shell, SQL, Swift, TypeScript, XML, YAML, and more. - -## Tables - -```markdown -| Header 1 | Header 2 | -|----------|----------| -| Cell 1 | Cell 2 | -``` - -Alignment with colons: `:---` (left), `:---:` (center), `---:` (right). - -## Lists - -**Ordered:** - -```markdown -1. First item -2. Second item -``` - -**Unordered:** - -```markdown -- Item 1 -- Item 2 -``` - -**Nested:** Indent with spaces. - -## Links - -```markdown -[Link text](URL) -[Link text](URL "Title") -``` - -**Anchor links:** Link to headings within the same page using `#section-name`. - -## Images - -```markdown -![Alt text](image-url) -![Alt text](image-url =WIDTHxHEIGHT) -``` - -Azure DevOps supports image resizing with `=WIDTHxHEIGHT` syntax. - -## Checklists / Task Lists - -```markdown -- [ ] Incomplete task -- [x] Completed task -``` - -## Mathematical Notation - -**Inline:** `$` delimiters: `$e^{i\pi} = -1$` - -**Block:** `$$` delimiters: - -```markdown -$$ -\sum_{i=1}^{n} x_i -$$ -``` - -Uses KaTeX for rendering. - -## Mermaid Diagrams (Wiki only) - -````markdown -```mermaid -graph TD; - A-->B; - B-->C; -``` -```` - -Supports: flowcharts, sequence diagrams, Gantt charts, and more. - -## Collapsible Sections - -```html -
- Click to expand - - Content here (leave blank line after summary tag). -
-``` - -## Emoji - -Use standard emoji shortcodes: `:smile:`, `:thumbsup:`, etc. - -## Special Characters - -Escape special Markdown characters with backslash: `\*`, `\#`, `\[`, etc. - -## HTML Tags - -Supported HTML tags in Wiki include: `
`, ``, ``, `
`, ``, ``, `
`, ``, ``, ``, ``, `
`, `
`, `