@totaland/create-starter-kit 2.0.1 → 2.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (221) hide show
  1. package/README.md +27 -3
  2. package/bin/index.js +88 -30
  3. package/package.json +1 -1
  4. package/templates/backend/.github/agents/ /360/237/216/255 planner.agent.md" +0 -92
  5. package/templates/backend/.github/agents/api-architect.agent.md +0 -41
  6. package/templates/backend/.github/agents/code-reviewer.agent.md +0 -26
  7. package/templates/backend/.github/agents/code-simplifier.agent.md +0 -41
  8. package/templates/backend/.github/agents/code-skeptic.agent.md +0 -74
  9. package/templates/backend/.github/agents/docs-specialist.agent.md +0 -25
  10. package/templates/backend/.github/agents/implementation-plan.agent.md +0 -160
  11. package/templates/backend/.github/agents/janitor.agent.md +0 -90
  12. package/templates/backend/.github/agents/ms-sql-dba.agent.md +0 -25
  13. package/templates/backend/.github/agents/plan.agent.md +0 -115
  14. package/templates/backend/.github/agents/planner.agent.md +0 -15
  15. package/templates/backend/.github/agents/playwright-tester.agent.md +0 -13
  16. package/templates/backend/.github/agents/postgresql-dba.agent.md +0 -18
  17. package/templates/backend/.github/agents/prd.agent.md +0 -202
  18. package/templates/backend/.github/agents/research-technical-spike.agent.md +0 -170
  19. package/templates/backend/.github/agents/software-engineer-agent-v1.agent.md +0 -165
  20. package/templates/backend/.github/agents/task-planner.agent.md +0 -375
  21. package/templates/backend/.github/agents/task-researcher.agent.md +0 -255
  22. package/templates/backend/.github/agents/tdd-green.agent.md +0 -60
  23. package/templates/backend/.github/agents/tdd-red.agent.md +0 -60
  24. package/templates/backend/.github/agents/tdd-refactor.agent.md +0 -85
  25. package/templates/backend/.github/agents/tech-debt-remediation-plan.agent.md +0 -50
  26. package/templates/backend/.github/agents/typescript-mcp-expert.agent.md +0 -91
  27. package/templates/backend/.github/agents/ultimate-thinking-beastmode.agent.md +0 -644
  28. package/templates/backend/.github/agents//360/237/216/255 generator.agent.md" +0 -264
  29. package/templates/backend/.github/agents//360/237/216/255 healer.agent.md" +0 -44
  30. package/templates/backend/.github/agents//360/237/216/255 pom.agent.md" +0 -308
  31. package/templates/backend/.github/instructions/a11y.instructions.md +0 -369
  32. package/templates/backend/.github/instructions/ms-sql-dba.instructions.md +0 -25
  33. package/templates/backend/.github/instructions/object-calisthenics.instructions.md +0 -302
  34. package/templates/backend/.github/instructions/performance-optimization.instructions.md +0 -420
  35. package/templates/backend/.github/instructions/playwright-python.instructions.md +0 -62
  36. package/templates/backend/.github/instructions/playwright-typescript.instructions.md +0 -86
  37. package/templates/backend/.github/instructions/security-and-owasp.instructions.md +0 -51
  38. package/templates/backend/.github/instructions/self-explanatory-code-commenting.instructions.md +0 -162
  39. package/templates/backend/.github/instructions/spec-driven-workflow-v1.instructions.md +0 -323
  40. package/templates/backend/.github/instructions/sql-sp-generation.instructions.md +0 -74
  41. package/templates/backend/.github/instructions/task-implementation.instructions.md +0 -190
  42. package/templates/backend/.github/instructions/typescript-mcp-server.instructions.md +0 -228
  43. package/templates/backend/.github/prompts/ai-prompt-engineering-safety-review.prompt.md +0 -229
  44. package/templates/backend/.github/prompts/architecture-blueprint-generator.prompt.md +0 -321
  45. package/templates/backend/.github/prompts/breakdown-epic-arch.prompt.md +0 -65
  46. package/templates/backend/.github/prompts/breakdown-epic-pm.prompt.md +0 -57
  47. package/templates/backend/.github/prompts/breakdown-feature-implementation.prompt.md +0 -127
  48. package/templates/backend/.github/prompts/breakdown-feature-prd.prompt.md +0 -60
  49. package/templates/backend/.github/prompts/breakdown-plan.prompt.md +0 -508
  50. package/templates/backend/.github/prompts/copilot-instructions-blueprint-generator.prompt.md +0 -293
  51. package/templates/backend/.github/prompts/create-agentsmd.prompt.md +0 -248
  52. package/templates/backend/.github/prompts/create-github-issue-feature-from-specification.prompt.md +0 -27
  53. package/templates/backend/.github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md +0 -27
  54. package/templates/backend/.github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md +0 -35
  55. package/templates/backend/.github/prompts/create-implementation-plan.prompt.md +0 -156
  56. package/templates/backend/.github/prompts/create-llms.prompt.md +0 -209
  57. package/templates/backend/.github/prompts/create-specification.prompt.md +0 -126
  58. package/templates/backend/.github/prompts/create-technical-spike.prompt.md +0 -230
  59. package/templates/backend/.github/prompts/csharp-nunit.prompt.md +0 -71
  60. package/templates/backend/.github/prompts/ef-core.prompt.md +0 -76
  61. package/templates/backend/.github/prompts/folder-structure-blueprint-generator.prompt.md +0 -404
  62. package/templates/backend/.github/prompts/gen-specs-as-issues.prompt.md +0 -165
  63. package/templates/backend/.github/prompts/generate-custom-instructions-from-codebase.prompt.md +0 -239
  64. package/templates/backend/.github/prompts/java-junit.prompt.md +0 -64
  65. package/templates/backend/.github/prompts/memory-merger.prompt.md +0 -107
  66. package/templates/backend/.github/prompts/multi-stage-dockerfile.prompt.md +0 -46
  67. package/templates/backend/.github/prompts/playwright-automation-fill-in-form.prompt.md +0 -29
  68. package/templates/backend/.github/prompts/playwright-explore-website.prompt.md +0 -19
  69. package/templates/backend/.github/prompts/playwright-generate-test.prompt.md +0 -19
  70. package/templates/backend/.github/prompts/postgresql-code-review.prompt.md +0 -214
  71. package/templates/backend/.github/prompts/postgresql-optimization.prompt.md +0 -406
  72. package/templates/backend/.github/prompts/project-workflow-analysis-blueprint-generator.prompt.md +0 -294
  73. package/templates/backend/.github/prompts/prompt-builder.prompt.md +0 -142
  74. package/templates/backend/.github/prompts/remember.prompt.md +0 -125
  75. package/templates/backend/.github/prompts/review-and-refactor.prompt.md +0 -15
  76. package/templates/backend/.github/prompts/sql-code-review.prompt.md +0 -303
  77. package/templates/backend/.github/prompts/sql-optimization.prompt.md +0 -298
  78. package/templates/backend/.github/prompts/suggest-awesome-github-copilot-agents.prompt.md +0 -72
  79. package/templates/backend/.github/prompts/suggest-awesome-github-copilot-chatmodes.prompt.md +0 -71
  80. package/templates/backend/.github/prompts/suggest-awesome-github-copilot-collections.prompt.md +0 -149
  81. package/templates/backend/.github/prompts/suggest-awesome-github-copilot-instructions.prompt.md +0 -88
  82. package/templates/backend/.github/prompts/suggest-awesome-github-copilot-prompts.prompt.md +0 -71
  83. package/templates/backend/.github/prompts/technology-stack-blueprint-generator.prompt.md +0 -242
  84. package/templates/backend/.github/prompts/typescript-mcp-server-generator.prompt.md +0 -90
  85. package/templates/backend/.github/prompts/update-implementation-plan.prompt.md +0 -157
  86. package/templates/backend/.github/prompts/update-markdown-file-index.prompt.md +0 -76
  87. package/templates/backend/Project_Folders_Structure_Blueprint.md +0 -529
  88. package/templates/backend/README.md +0 -99
  89. package/templates/backend/biome.json +0 -45
  90. package/templates/backend/drizzle.config.ts +0 -10
  91. package/templates/backend/knip.json +0 -10
  92. package/templates/backend/package.json +0 -60
  93. package/templates/backend/playwright.config.ts +0 -16
  94. package/templates/backend/pnpm-lock.yaml +0 -4240
  95. package/templates/backend/pnpm-workspace.yaml +0 -3
  96. package/templates/backend/src/features/health/controller.ts +0 -5
  97. package/templates/backend/src/features/health/health.test.ts +0 -23
  98. package/templates/backend/src/features/health/index.ts +0 -7
  99. package/templates/backend/src/features/health/schemas.ts +0 -29
  100. package/templates/backend/src/features/orders/controller.ts +0 -18
  101. package/templates/backend/src/features/orders/index.ts +0 -10
  102. package/templates/backend/src/features/orders/schemas.ts +0 -62
  103. package/templates/backend/src/index.ts +0 -43
  104. package/templates/backend/src/lib/openapi.ts +0 -25
  105. package/templates/backend/src/lib/validateRequest.test.ts +0 -84
  106. package/templates/backend/src/lib/validateRequest.ts +0 -72
  107. package/templates/backend/tsconfig.build.json +0 -10
  108. package/templates/backend/tsconfig.json +0 -30
  109. package/templates/backend/vitest.config.ts +0 -31
  110. package/templates/frontend/.env.example +0 -7
  111. package/templates/frontend/.github/agents/ /360/237/216/255 planner.agent.md" +0 -92
  112. package/templates/frontend/.github/agents/api-architect.agent.md +0 -41
  113. package/templates/frontend/.github/agents/code-reviewer.agent.md +0 -26
  114. package/templates/frontend/.github/agents/code-simplifier.agent.md +0 -41
  115. package/templates/frontend/.github/agents/code-skeptic.agent.md +0 -74
  116. package/templates/frontend/.github/agents/docs-specialist.agent.md +0 -25
  117. package/templates/frontend/.github/agents/implementation-plan.agent.md +0 -160
  118. package/templates/frontend/.github/agents/janitor.agent.md +0 -90
  119. package/templates/frontend/.github/agents/ms-sql-dba.agent.md +0 -25
  120. package/templates/frontend/.github/agents/plan.agent.md +0 -115
  121. package/templates/frontend/.github/agents/planner.agent.md +0 -15
  122. package/templates/frontend/.github/agents/playwright-tester.agent.md +0 -13
  123. package/templates/frontend/.github/agents/postgresql-dba.agent.md +0 -18
  124. package/templates/frontend/.github/agents/prd.agent.md +0 -202
  125. package/templates/frontend/.github/agents/research-technical-spike.agent.md +0 -170
  126. package/templates/frontend/.github/agents/software-engineer-agent-v1.agent.md +0 -165
  127. package/templates/frontend/.github/agents/task-planner.agent.md +0 -375
  128. package/templates/frontend/.github/agents/task-researcher.agent.md +0 -255
  129. package/templates/frontend/.github/agents/tdd-green.agent.md +0 -60
  130. package/templates/frontend/.github/agents/tdd-red.agent.md +0 -60
  131. package/templates/frontend/.github/agents/tdd-refactor.agent.md +0 -85
  132. package/templates/frontend/.github/agents/tech-debt-remediation-plan.agent.md +0 -50
  133. package/templates/frontend/.github/agents/typescript-mcp-expert.agent.md +0 -91
  134. package/templates/frontend/.github/agents/ultimate-thinking-beastmode.agent.md +0 -644
  135. package/templates/frontend/.github/agents//360/237/216/255 generator.agent.md" +0 -264
  136. package/templates/frontend/.github/agents//360/237/216/255 healer.agent.md" +0 -44
  137. package/templates/frontend/.github/agents//360/237/216/255 pom.agent.md" +0 -308
  138. package/templates/frontend/.github/instructions/a11y.instructions.md +0 -369
  139. package/templates/frontend/.github/instructions/ms-sql-dba.instructions.md +0 -25
  140. package/templates/frontend/.github/instructions/object-calisthenics.instructions.md +0 -302
  141. package/templates/frontend/.github/instructions/performance-optimization.instructions.md +0 -420
  142. package/templates/frontend/.github/instructions/playwright-python.instructions.md +0 -62
  143. package/templates/frontend/.github/instructions/playwright-typescript.instructions.md +0 -86
  144. package/templates/frontend/.github/instructions/security-and-owasp.instructions.md +0 -51
  145. package/templates/frontend/.github/instructions/self-explanatory-code-commenting.instructions.md +0 -162
  146. package/templates/frontend/.github/instructions/spec-driven-workflow-v1.instructions.md +0 -323
  147. package/templates/frontend/.github/instructions/sql-sp-generation.instructions.md +0 -74
  148. package/templates/frontend/.github/instructions/task-implementation.instructions.md +0 -190
  149. package/templates/frontend/.github/instructions/typescript-mcp-server.instructions.md +0 -228
  150. package/templates/frontend/.github/prompts/ai-prompt-engineering-safety-review.prompt.md +0 -229
  151. package/templates/frontend/.github/prompts/architecture-blueprint-generator.prompt.md +0 -321
  152. package/templates/frontend/.github/prompts/breakdown-epic-arch.prompt.md +0 -65
  153. package/templates/frontend/.github/prompts/breakdown-epic-pm.prompt.md +0 -57
  154. package/templates/frontend/.github/prompts/breakdown-feature-implementation.prompt.md +0 -127
  155. package/templates/frontend/.github/prompts/breakdown-feature-prd.prompt.md +0 -60
  156. package/templates/frontend/.github/prompts/breakdown-plan.prompt.md +0 -508
  157. package/templates/frontend/.github/prompts/copilot-instructions-blueprint-generator.prompt.md +0 -293
  158. package/templates/frontend/.github/prompts/create-agentsmd.prompt.md +0 -248
  159. package/templates/frontend/.github/prompts/create-github-issue-feature-from-specification.prompt.md +0 -27
  160. package/templates/frontend/.github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md +0 -27
  161. package/templates/frontend/.github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md +0 -35
  162. package/templates/frontend/.github/prompts/create-implementation-plan.prompt.md +0 -156
  163. package/templates/frontend/.github/prompts/create-llms.prompt.md +0 -209
  164. package/templates/frontend/.github/prompts/create-specification.prompt.md +0 -126
  165. package/templates/frontend/.github/prompts/create-technical-spike.prompt.md +0 -230
  166. package/templates/frontend/.github/prompts/csharp-nunit.prompt.md +0 -71
  167. package/templates/frontend/.github/prompts/ef-core.prompt.md +0 -76
  168. package/templates/frontend/.github/prompts/folder-structure-blueprint-generator.prompt.md +0 -404
  169. package/templates/frontend/.github/prompts/gen-specs-as-issues.prompt.md +0 -165
  170. package/templates/frontend/.github/prompts/generate-custom-instructions-from-codebase.prompt.md +0 -239
  171. package/templates/frontend/.github/prompts/java-junit.prompt.md +0 -64
  172. package/templates/frontend/.github/prompts/memory-merger.prompt.md +0 -107
  173. package/templates/frontend/.github/prompts/multi-stage-dockerfile.prompt.md +0 -46
  174. package/templates/frontend/.github/prompts/playwright-automation-fill-in-form.prompt.md +0 -29
  175. package/templates/frontend/.github/prompts/playwright-explore-website.prompt.md +0 -19
  176. package/templates/frontend/.github/prompts/playwright-generate-test.prompt.md +0 -19
  177. package/templates/frontend/.github/prompts/postgresql-code-review.prompt.md +0 -214
  178. package/templates/frontend/.github/prompts/postgresql-optimization.prompt.md +0 -406
  179. package/templates/frontend/.github/prompts/project-workflow-analysis-blueprint-generator.prompt.md +0 -294
  180. package/templates/frontend/.github/prompts/prompt-builder.prompt.md +0 -142
  181. package/templates/frontend/.github/prompts/remember.prompt.md +0 -125
  182. package/templates/frontend/.github/prompts/review-and-refactor.prompt.md +0 -15
  183. package/templates/frontend/.github/prompts/sql-code-review.prompt.md +0 -303
  184. package/templates/frontend/.github/prompts/sql-optimization.prompt.md +0 -298
  185. package/templates/frontend/.github/prompts/suggest-awesome-github-copilot-agents.prompt.md +0 -72
  186. package/templates/frontend/.github/prompts/suggest-awesome-github-copilot-chatmodes.prompt.md +0 -71
  187. package/templates/frontend/.github/prompts/suggest-awesome-github-copilot-collections.prompt.md +0 -149
  188. package/templates/frontend/.github/prompts/suggest-awesome-github-copilot-instructions.prompt.md +0 -88
  189. package/templates/frontend/.github/prompts/suggest-awesome-github-copilot-prompts.prompt.md +0 -71
  190. package/templates/frontend/.github/prompts/technology-stack-blueprint-generator.prompt.md +0 -242
  191. package/templates/frontend/.github/prompts/typescript-mcp-server-generator.prompt.md +0 -90
  192. package/templates/frontend/.github/prompts/update-implementation-plan.prompt.md +0 -157
  193. package/templates/frontend/.github/prompts/update-markdown-file-index.prompt.md +0 -76
  194. package/templates/frontend/README.md +0 -199
  195. package/templates/frontend/biome.json +0 -45
  196. package/templates/frontend/components.json +0 -22
  197. package/templates/frontend/index.html +0 -13
  198. package/templates/frontend/package.json +0 -44
  199. package/templates/frontend/pnpm-lock.yaml +0 -2011
  200. package/templates/frontend/postcss.config.js +0 -6
  201. package/templates/frontend/public/vite.svg +0 -1
  202. package/templates/frontend/src/App.css +0 -42
  203. package/templates/frontend/src/App.tsx +0 -17
  204. package/templates/frontend/src/assets/react.svg +0 -1
  205. package/templates/frontend/src/components/layout/layout.component.tsx +0 -31
  206. package/templates/frontend/src/components/menu-toggle-icon.tsx +0 -53
  207. package/templates/frontend/src/components/ui/button.tsx +0 -57
  208. package/templates/frontend/src/docs/RECOMMENDED_LIBRARIES.md +0 -226
  209. package/templates/frontend/src/docs/SETUP_SUMMARY.md +0 -162
  210. package/templates/frontend/src/hooks/use-scroll.ts +0 -21
  211. package/templates/frontend/src/index.css +0 -121
  212. package/templates/frontend/src/lib/api-client.ts +0 -46
  213. package/templates/frontend/src/lib/utils.ts +0 -6
  214. package/templates/frontend/src/main.tsx +0 -30
  215. package/templates/frontend/src/pages/about/about.page.tsx +0 -50
  216. package/templates/frontend/src/pages/home/home.page.tsx +0 -43
  217. package/templates/frontend/tailwind.config.js +0 -59
  218. package/templates/frontend/tsconfig.app.json +0 -41
  219. package/templates/frontend/tsconfig.json +0 -13
  220. package/templates/frontend/tsconfig.node.json +0 -26
  221. package/templates/frontend/vite.config.ts +0 -14
@@ -1,293 +0,0 @@
1
- ---
2
- description: 'Technology-agnostic blueprint generator for creating comprehensive copilot-instructions.md files that guide GitHub Copilot to produce code consistent with project standards, architecture patterns, and exact technology versions by analyzing existing codebase patterns and avoiding assumptions.'
3
- ---
4
-
5
- # Copilot Instructions Blueprint Generator
6
-
7
- ## Configuration Variables
8
- ${PROJECT_TYPE="Auto-detect|.NET|Java|JavaScript|TypeScript|React|Angular|Python|Multiple|Other"} <!-- Primary technology -->
9
- ${ARCHITECTURE_STYLE="Layered|Microservices|Monolithic|Domain-Driven|Event-Driven|Serverless|Mixed"} <!-- Architectural approach -->
10
- ${CODE_QUALITY_FOCUS="Maintainability|Performance|Security|Accessibility|Testability|All"} <!-- Quality priorities -->
11
- ${DOCUMENTATION_LEVEL="Minimal|Standard|Comprehensive"} <!-- Documentation requirements -->
12
- ${TESTING_REQUIREMENTS="Unit|Integration|E2E|TDD|BDD|All"} <!-- Testing approach -->
13
- ${VERSIONING="Semantic|CalVer|Custom"} <!-- Versioning approach -->
14
-
15
- ## Generated Prompt
16
-
17
- "Generate a comprehensive copilot-instructions.md file that will guide GitHub Copilot to produce code consistent with our project's standards, architecture, and technology versions. The instructions must be strictly based on actual code patterns in our codebase and avoid making any assumptions. Follow this approach:
18
-
19
- ### 1. Core Instruction Structure
20
-
21
- ```markdown
22
- # GitHub Copilot Instructions
23
-
24
- ## Priority Guidelines
25
-
26
- When generating code for this repository:
27
-
28
- 1. **Version Compatibility**: Always detect and respect the exact versions of languages, frameworks, and libraries used in this project
29
- 2. **Context Files**: Prioritize patterns and standards defined in the .github/copilot directory
30
- 3. **Codebase Patterns**: When context files don't provide specific guidance, scan the codebase for established patterns
31
- 4. **Architectural Consistency**: Maintain our ${ARCHITECTURE_STYLE} architectural style and established boundaries
32
- 5. **Code Quality**: Prioritize ${CODE_QUALITY_FOCUS == "All" ? "maintainability, performance, security, accessibility, and testability" : CODE_QUALITY_FOCUS} in all generated code
33
-
34
- ## Technology Version Detection
35
-
36
- Before generating code, scan the codebase to identify:
37
-
38
- 1. **Language Versions**: Detect the exact versions of programming languages in use
39
- - Examine project files, configuration files, and package managers
40
- - Look for language-specific version indicators (e.g., <LangVersion> in .NET projects)
41
- - Never use language features beyond the detected version
42
-
43
- 2. **Framework Versions**: Identify the exact versions of all frameworks
44
- - Check package.json, .csproj, pom.xml, requirements.txt, etc.
45
- - Respect version constraints when generating code
46
- - Never suggest features not available in the detected framework versions
47
-
48
- 3. **Library Versions**: Note the exact versions of key libraries and dependencies
49
- - Generate code compatible with these specific versions
50
- - Never use APIs or features not available in the detected versions
51
-
52
- ## Context Files
53
-
54
- Prioritize the following files in .github/copilot directory (if they exist):
55
-
56
- - **architecture.md**: System architecture guidelines
57
- - **tech-stack.md**: Technology versions and framework details
58
- - **coding-standards.md**: Code style and formatting standards
59
- - **folder-structure.md**: Project organization guidelines
60
- - **exemplars.md**: Exemplary code patterns to follow
61
-
62
- ## Codebase Scanning Instructions
63
-
64
- When context files don't provide specific guidance:
65
-
66
- 1. Identify similar files to the one being modified or created
67
- 2. Analyze patterns for:
68
- - Naming conventions
69
- - Code organization
70
- - Error handling
71
- - Logging approaches
72
- - Documentation style
73
- - Testing patterns
74
-
75
- 3. Follow the most consistent patterns found in the codebase
76
- 4. When conflicting patterns exist, prioritize patterns in newer files or files with higher test coverage
77
- 5. Never introduce patterns not found in the existing codebase
78
-
79
- ## Code Quality Standards
80
-
81
- ${CODE_QUALITY_FOCUS.includes("Maintainability") || CODE_QUALITY_FOCUS == "All" ? `### Maintainability
82
- - Write self-documenting code with clear naming
83
- - Follow the naming and organization conventions evident in the codebase
84
- - Follow established patterns for consistency
85
- - Keep functions focused on single responsibilities
86
- - Limit function complexity and length to match existing patterns` : ""}
87
-
88
- ${CODE_QUALITY_FOCUS.includes("Performance") || CODE_QUALITY_FOCUS == "All" ? `### Performance
89
- - Follow existing patterns for memory and resource management
90
- - Match existing patterns for handling computationally expensive operations
91
- - Follow established patterns for asynchronous operations
92
- - Apply caching consistently with existing patterns
93
- - Optimize according to patterns evident in the codebase` : ""}
94
-
95
- ${CODE_QUALITY_FOCUS.includes("Security") || CODE_QUALITY_FOCUS == "All" ? `### Security
96
- - Follow existing patterns for input validation
97
- - Apply the same sanitization techniques used in the codebase
98
- - Use parameterized queries matching existing patterns
99
- - Follow established authentication and authorization patterns
100
- - Handle sensitive data according to existing patterns` : ""}
101
-
102
- ${CODE_QUALITY_FOCUS.includes("Accessibility") || CODE_QUALITY_FOCUS == "All" ? `### Accessibility
103
- - Follow existing accessibility patterns in the codebase
104
- - Match ARIA attribute usage with existing components
105
- - Maintain keyboard navigation support consistent with existing code
106
- - Follow established patterns for color and contrast
107
- - Apply text alternative patterns consistent with the codebase` : ""}
108
-
109
- ${CODE_QUALITY_FOCUS.includes("Testability") || CODE_QUALITY_FOCUS == "All" ? `### Testability
110
- - Follow established patterns for testable code
111
- - Match dependency injection approaches used in the codebase
112
- - Apply the same patterns for managing dependencies
113
- - Follow established mocking and test double patterns
114
- - Match the testing style used in existing tests` : ""}
115
-
116
- ## Documentation Requirements
117
-
118
- ${DOCUMENTATION_LEVEL == "Minimal" ?
119
- `- Match the level and style of comments found in existing code
120
- - Document according to patterns observed in the codebase
121
- - Follow existing patterns for documenting non-obvious behavior
122
- - Use the same format for parameter descriptions as existing code` : ""}
123
-
124
- ${DOCUMENTATION_LEVEL == "Standard" ?
125
- `- Follow the exact documentation format found in the codebase
126
- - Match the XML/JSDoc style and completeness of existing comments
127
- - Document parameters, returns, and exceptions in the same style
128
- - Follow existing patterns for usage examples
129
- - Match class-level documentation style and content` : ""}
130
-
131
- ${DOCUMENTATION_LEVEL == "Comprehensive" ?
132
- `- Follow the most detailed documentation patterns found in the codebase
133
- - Match the style and completeness of the best-documented code
134
- - Document exactly as the most thoroughly documented files do
135
- - Follow existing patterns for linking documentation
136
- - Match the level of detail in explanations of design decisions` : ""}
137
-
138
- ## Testing Approach
139
-
140
- ${TESTING_REQUIREMENTS.includes("Unit") || TESTING_REQUIREMENTS == "All" ?
141
- `### Unit Testing
142
- - Match the exact structure and style of existing unit tests
143
- - Follow the same naming conventions for test classes and methods
144
- - Use the same assertion patterns found in existing tests
145
- - Apply the same mocking approach used in the codebase
146
- - Follow existing patterns for test isolation` : ""}
147
-
148
- ${TESTING_REQUIREMENTS.includes("Integration") || TESTING_REQUIREMENTS == "All" ?
149
- `### Integration Testing
150
- - Follow the same integration test patterns found in the codebase
151
- - Match existing patterns for test data setup and teardown
152
- - Use the same approach for testing component interactions
153
- - Follow existing patterns for verifying system behavior` : ""}
154
-
155
- ${TESTING_REQUIREMENTS.includes("E2E") || TESTING_REQUIREMENTS == "All" ?
156
- `### End-to-End Testing
157
- - Match the existing E2E test structure and patterns
158
- - Follow established patterns for UI testing
159
- - Apply the same approach for verifying user journeys` : ""}
160
-
161
- ${TESTING_REQUIREMENTS.includes("TDD") || TESTING_REQUIREMENTS == "All" ?
162
- `### Test-Driven Development
163
- - Follow TDD patterns evident in the codebase
164
- - Match the progression of test cases seen in existing code
165
- - Apply the same refactoring patterns after tests pass` : ""}
166
-
167
- ${TESTING_REQUIREMENTS.includes("BDD") || TESTING_REQUIREMENTS == "All" ?
168
- `### Behavior-Driven Development
169
- - Match the existing Given-When-Then structure in tests
170
- - Follow the same patterns for behavior descriptions
171
- - Apply the same level of business focus in test cases` : ""}
172
-
173
- ## Technology-Specific Guidelines
174
-
175
- ${PROJECT_TYPE == ".NET" || PROJECT_TYPE == "Auto-detect" || PROJECT_TYPE == "Multiple" ? `### .NET Guidelines
176
- - Detect and strictly adhere to the specific .NET version in use
177
- - Use only C# language features compatible with the detected version
178
- - Follow LINQ usage patterns exactly as they appear in the codebase
179
- - Match async/await usage patterns from existing code
180
- - Apply the same dependency injection approach used in the codebase
181
- - Use the same collection types and patterns found in existing code` : ""}
182
-
183
- ${PROJECT_TYPE == "Java" || PROJECT_TYPE == "Auto-detect" || PROJECT_TYPE == "Multiple" ? `### Java Guidelines
184
- - Detect and adhere to the specific Java version in use
185
- - Follow the exact same design patterns found in the codebase
186
- - Match exception handling patterns from existing code
187
- - Use the same collection types and approaches found in the codebase
188
- - Apply the dependency injection patterns evident in existing code` : ""}
189
-
190
- ${PROJECT_TYPE == "JavaScript" || PROJECT_TYPE == "TypeScript" || PROJECT_TYPE == "Auto-detect" || PROJECT_TYPE == "Multiple" ? `### JavaScript/TypeScript Guidelines
191
- - Detect and adhere to the specific ECMAScript/TypeScript version in use
192
- - Follow the same module import/export patterns found in the codebase
193
- - Match TypeScript type definitions with existing patterns
194
- - Use the same async patterns (promises, async/await) as existing code
195
- - Follow error handling patterns from similar files` : ""}
196
-
197
- ${PROJECT_TYPE == "React" || PROJECT_TYPE == "Auto-detect" || PROJECT_TYPE == "Multiple" ? `### React Guidelines
198
- - Detect and adhere to the specific React version in use
199
- - Match component structure patterns from existing components
200
- - Follow the same hooks and lifecycle patterns found in the codebase
201
- - Apply the same state management approach used in existing components
202
- - Match prop typing and validation patterns from existing code` : ""}
203
-
204
- ${PROJECT_TYPE == "Angular" || PROJECT_TYPE == "Auto-detect" || PROJECT_TYPE == "Multiple" ? `### Angular Guidelines
205
- - Detect and adhere to the specific Angular version in use
206
- - Follow the same component and module patterns found in the codebase
207
- - Match decorator usage exactly as seen in existing code
208
- - Apply the same RxJS patterns found in the codebase
209
- - Follow existing patterns for component communication` : ""}
210
-
211
- ${PROJECT_TYPE == "Python" || PROJECT_TYPE == "Auto-detect" || PROJECT_TYPE == "Multiple" ? `### Python Guidelines
212
- - Detect and adhere to the specific Python version in use
213
- - Follow the same import organization found in existing modules
214
- - Match type hinting approaches if used in the codebase
215
- - Apply the same error handling patterns found in existing code
216
- - Follow the same module organization patterns` : ""}
217
-
218
- ## Version Control Guidelines
219
-
220
- ${VERSIONING == "Semantic" ?
221
- `- Follow Semantic Versioning patterns as applied in the codebase
222
- - Match existing patterns for documenting breaking changes
223
- - Follow the same approach for deprecation notices` : ""}
224
-
225
- ${VERSIONING == "CalVer" ?
226
- `- Follow Calendar Versioning patterns as applied in the codebase
227
- - Match existing patterns for documenting changes
228
- - Follow the same approach for highlighting significant changes` : ""}
229
-
230
- ${VERSIONING == "Custom" ?
231
- `- Match the exact versioning pattern observed in the codebase
232
- - Follow the same changelog format used in existing documentation
233
- - Apply the same tagging conventions used in the project` : ""}
234
-
235
- ## General Best Practices
236
-
237
- - Follow naming conventions exactly as they appear in existing code
238
- - Match code organization patterns from similar files
239
- - Apply error handling consistent with existing patterns
240
- - Follow the same approach to testing as seen in the codebase
241
- - Match logging patterns from existing code
242
- - Use the same approach to configuration as seen in the codebase
243
-
244
- ## Project-Specific Guidance
245
-
246
- - Scan the codebase thoroughly before generating any code
247
- - Respect existing architectural boundaries without exception
248
- - Match the style and patterns of surrounding code
249
- - When in doubt, prioritize consistency with existing code over external best practices
250
- ```
251
-
252
- ### 2. Codebase Analysis Instructions
253
-
254
- To create the copilot-instructions.md file, first analyze the codebase to:
255
-
256
- 1. **Identify Exact Technology Versions**:
257
- - ${PROJECT_TYPE == "Auto-detect" ? "Detect all programming languages, frameworks, and libraries by scanning file extensions and configuration files" : `Focus on ${PROJECT_TYPE} technologies`}
258
- - Extract precise version information from project files, package.json, .csproj, etc.
259
- - Document version constraints and compatibility requirements
260
-
261
- 2. **Understand Architecture**:
262
- - Analyze folder structure and module organization
263
- - Identify clear layer boundaries and component relationships
264
- - Document communication patterns between components
265
-
266
- 3. **Document Code Patterns**:
267
- - Catalog naming conventions for different code elements
268
- - Note documentation styles and completeness
269
- - Document error handling patterns
270
- - Map testing approaches and coverage
271
-
272
- 4. **Note Quality Standards**:
273
- - Identify performance optimization techniques actually used
274
- - Document security practices implemented in the code
275
- - Note accessibility features present (if applicable)
276
- - Document code quality patterns evident in the codebase
277
-
278
- ### 3. Implementation Notes
279
-
280
- The final copilot-instructions.md should:
281
- - Be placed in the .github/copilot directory
282
- - Reference only patterns and standards that exist in the codebase
283
- - Include explicit version compatibility requirements
284
- - Avoid prescribing any practices not evident in the code
285
- - Provide concrete examples from the codebase
286
- - Be comprehensive yet concise enough for Copilot to effectively use
287
-
288
- Important: Only include guidance based on patterns actually observed in the codebase. Explicitly instruct Copilot to prioritize consistency with existing code over external best practices or newer language features.
289
- "
290
-
291
- ## Expected Output
292
-
293
- A comprehensive copilot-instructions.md file that will guide GitHub Copilot to produce code that is perfectly compatible with your existing technology versions and follows your established patterns and architecture.
@@ -1,248 +0,0 @@
1
- ---
2
- description: "Prompt for generating an AGENTS.md file for a repository"
3
- ---
4
-
5
- # Create high‑quality AGENTS.md file
6
-
7
- You are a code agent. Your task is to create a complete, accurate AGENTS.md at the root of this repository that follows the public guidance at https://agents.md/.
8
-
9
- AGENTS.md is an open format designed to provide coding agents with the context and instructions they need to work effectively on a project.
10
-
11
- ## What is AGENTS.md?
12
-
13
- AGENTS.md is a Markdown file that serves as a "README for agents" - a dedicated, predictable place to provide context and instructions to help AI coding agents work on your project. It complements README.md by containing detailed technical context that coding agents need but might clutter a human-focused README.
14
-
15
- ## Key Principles
16
-
17
- - **Agent-focused**: Contains detailed technical instructions for automated tools
18
- - **Complements README.md**: Doesn't replace human documentation but adds agent-specific context
19
- - **Standardized location**: Placed at repository root (or subproject roots for monorepos)
20
- - **Open format**: Uses standard Markdown with flexible structure
21
- - **Ecosystem compatibility**: Works across 20+ different AI coding tools and agents
22
-
23
- ## File Structure and Content Guidelines
24
-
25
- ### 1. Required Setup
26
-
27
- - Create the file as `AGENTS.md` in the repository root
28
- - Use standard Markdown formatting
29
- - No required fields - flexible structure based on project needs
30
-
31
- ### 2. Essential Sections to Include
32
-
33
- #### Project Overview
34
-
35
- - Brief description of what the project does
36
- - Architecture overview if complex
37
- - Key technologies and frameworks used
38
-
39
- #### Setup Commands
40
-
41
- - Installation instructions
42
- - Environment setup steps
43
- - Dependency management commands
44
- - Database setup if applicable
45
-
46
- #### Development Workflow
47
-
48
- - How to start development server
49
- - Build commands
50
- - Watch/hot-reload setup
51
- - Package manager specifics (npm, pnpm, yarn, etc.)
52
-
53
- #### Testing Instructions
54
-
55
- - How to run tests (unit, integration, e2e)
56
- - Test file locations and naming conventions
57
- - Coverage requirements
58
- - Specific test patterns or frameworks used
59
- - How to run subset of tests or focus on specific areas
60
-
61
- #### Code Style Guidelines
62
-
63
- - Language-specific conventions
64
- - Linting and formatting rules
65
- - File organization patterns
66
- - Naming conventions
67
- - Import/export patterns
68
-
69
- #### Build and Deployment
70
-
71
- - Build commands and outputs
72
- - Environment configurations
73
- - Deployment steps and requirements
74
- - CI/CD pipeline information
75
-
76
- ### 3. Optional but Recommended Sections
77
-
78
- #### Security Considerations
79
-
80
- - Security testing requirements
81
- - Secrets management
82
- - Authentication patterns
83
- - Permission models
84
-
85
- #### Monorepo Instructions (if applicable)
86
-
87
- - How to work with multiple packages
88
- - Cross-package dependencies
89
- - Selective building/testing
90
- - Package-specific commands
91
-
92
- #### Pull Request Guidelines
93
-
94
- - Title format requirements
95
- - Required checks before submission
96
- - Review process
97
- - Commit message conventions
98
-
99
- #### Debugging and Troubleshooting
100
-
101
- - Common issues and solutions
102
- - Logging patterns
103
- - Debug configuration
104
- - Performance considerations
105
-
106
- ## Example Template
107
-
108
- Use this as a starting template and customize based on the specific project:
109
-
110
- ```markdown
111
- # AGENTS.md
112
-
113
- ## Project Overview
114
-
115
- [Brief description of the project, its purpose, and key technologies]
116
-
117
- ## Setup Commands
118
-
119
- - Install dependencies: `[package manager] install`
120
- - Start development server: `[command]`
121
- - Build for production: `[command]`
122
-
123
- ## Development Workflow
124
-
125
- - [Development server startup instructions]
126
- - [Hot reload/watch mode information]
127
- - [Environment variable setup]
128
-
129
- ## Testing Instructions
130
-
131
- - Run all tests: `[command]`
132
- - Run unit tests: `[command]`
133
- - Run integration tests: `[command]`
134
- - Test coverage: `[command]`
135
- - [Specific testing patterns or requirements]
136
-
137
- ## Code Style
138
-
139
- - [Language and framework conventions]
140
- - [Linting rules and commands]
141
- - [Formatting requirements]
142
- - [File organization patterns]
143
-
144
- ## Build and Deployment
145
-
146
- - [Build process details]
147
- - [Output directories]
148
- - [Environment-specific builds]
149
- - [Deployment commands]
150
-
151
- ## Pull Request Guidelines
152
-
153
- - Title format: [component] Brief description
154
- - Required checks: `[lint command]`, `[test command]`
155
- - [Review requirements]
156
-
157
- ## Additional Notes
158
-
159
- - [Any project-specific context]
160
- - [Common gotchas or troubleshooting tips]
161
- - [Performance considerations]
162
- ```
163
-
164
- ## Working Example from agents.md
165
-
166
- Here's a real example from the agents.md website:
167
-
168
- ```markdown
169
- # Sample AGENTS.md file
170
-
171
- ## Dev environment tips
172
-
173
- - Use `pnpm dlx turbo run where <project_name>` to jump to a package instead of scanning with `ls`.
174
- - Run `pnpm install --filter <project_name>` to add the package to your workspace so Vite, ESLint, and TypeScript can see it.
175
- - Use `pnpm create vite@latest <project_name> -- --template react-ts` to spin up a new React + Vite package with TypeScript checks ready.
176
- - Check the name field inside each package's package.json to confirm the right name—skip the top-level one.
177
-
178
- ## Testing instructions
179
-
180
- - Find the CI plan in the .github/workflows folder.
181
- - Run `pnpm turbo run test --filter <project_name>` to run every check defined for that package.
182
- - From the package root you can just call `pnpm test`. The commit should pass all tests before you merge.
183
- - To focus on one step, add the Vitest pattern: `pnpm vitest run -t "<test name>"`.
184
- - Fix any test or type errors until the whole suite is green.
185
- - After moving files or changing imports, run `pnpm lint --filter <project_name>` to be sure ESLint and TypeScript rules still pass.
186
- - Add or update tests for the code you change, even if nobody asked.
187
-
188
- ## PR instructions
189
-
190
- - Title format: [<project_name>] <Title>
191
- - Always run `pnpm lint` and `pnpm test` before committing.
192
- ```
193
-
194
- ## Implementation Steps
195
-
196
- 1. **Analyze the project structure** to understand:
197
-
198
- - Programming languages and frameworks used
199
- - Package managers and build tools
200
- - Testing frameworks
201
- - Project architecture (monorepo, single package, etc.)
202
-
203
- 2. **Identify key workflows** by examining:
204
-
205
- - package.json scripts
206
- - Makefile or other build files
207
- - CI/CD configuration files
208
- - Documentation files
209
-
210
- 3. **Create comprehensive sections** covering:
211
-
212
- - All essential setup and development commands
213
- - Testing strategies and commands
214
- - Code style and conventions
215
- - Build and deployment processes
216
-
217
- 4. **Include specific, actionable commands** that agents can execute directly
218
-
219
- 5. **Test the instructions** by ensuring all commands work as documented
220
-
221
- 6. **Keep it focused** on what agents need to know, not general project information
222
-
223
- ## Best Practices
224
-
225
- - **Be specific**: Include exact commands, not vague descriptions
226
- - **Use code blocks**: Wrap commands in backticks for clarity
227
- - **Include context**: Explain why certain steps are needed
228
- - **Stay current**: Update as the project evolves
229
- - **Test commands**: Ensure all listed commands actually work
230
- - **Consider nested files**: For monorepos, create AGENTS.md files in subprojects as needed
231
-
232
- ## Monorepo Considerations
233
-
234
- For large monorepos:
235
-
236
- - Place a main AGENTS.md at the repository root
237
- - Create additional AGENTS.md files in subproject directories
238
- - The closest AGENTS.md file takes precedence for any given location
239
- - Include navigation tips between packages/projects
240
-
241
- ## Final Notes
242
-
243
- - AGENTS.md works with 20+ AI coding tools including Cursor, Aider, Gemini CLI, and many others
244
- - The format is intentionally flexible - adapt it to your project's needs
245
- - Focus on actionable instructions that help agents understand and work with your codebase
246
- - This is living documentation - update it as your project evolves
247
-
248
- When creating the AGENTS.md file, prioritize clarity, completeness, and actionability. The goal is to give any coding agent enough context to effectively contribute to the project without requiring additional human guidance.
@@ -1,27 +0,0 @@
1
- ---
2
- description: 'Create GitHub Issue for feature request from specification file using feature_request.yml template.'
3
- tools: ['edit', 'runNotebooks', 'search', 'new', 'runCommands', 'runTasks', 'na2/*', 'microsoft/playwright-mcp/*', 'usages', 'vscodeAPI', 'problems', 'changes', 'testFailure', 'openSimpleBrowser', 'fetch', 'githubRepo', 'extensions', 'todos', 'runSubagent', 'runTests']
4
- ---
5
- # Create GitHub Issue from Specification
6
-
7
- Create GitHub Issue for the specification at `${file}`.
8
-
9
- ## Process
10
-
11
- 1. Analyze specification file to extract requirements
12
- 2. Check existing issues using `search_issues`
13
- 3. Create new issue using `create_issue` or update existing with `update_issue`
14
- 4. Use `feature_request.yml` template (fallback to default)
15
-
16
- ## Requirements
17
-
18
- - Single issue for the complete specification
19
- - Clear title identifying the specification
20
- - Include only changes required by the specification
21
- - Verify against existing issues before creation
22
-
23
- ## Issue Content
24
-
25
- - Title: Feature name from specification
26
- - Description: Problem statement, proposed solution, and context
27
- - Labels: feature, enhancement (as appropriate)
@@ -1,27 +0,0 @@
1
- ---
2
- description: 'Create GitHub Issues from implementation plan phases using feature_request.yml or chore_request.yml templates.'
3
- tools: ['search', 'na2/*', 'microsoft/playwright-mcp/*', 'githubRepo', 'github.vscode-pull-request-github/copilotCodingAgent', 'github.vscode-pull-request-github/issue_fetch', 'github.vscode-pull-request-github/suggest-fix', 'github.vscode-pull-request-github/searchSyntax', 'github.vscode-pull-request-github/doSearch', 'github.vscode-pull-request-github/renderIssues', 'github.vscode-pull-request-github/activePullRequest', 'github.vscode-pull-request-github/openPullRequest', 'todos']
4
- ---
5
- # Create GitHub Issue from Implementation Plan
6
-
7
- Create GitHub Issues for the implementation plan at `${file}`.
8
-
9
- ## Process
10
-
11
- 1. Analyze plan file to identify phases
12
- 2. Check existing issues using `search_issues`
13
- 3. Create new issue per phase using `create_issue` or update existing with `update_issue`
14
- 4. Use `feature_request.yml` or `chore_request.yml` templates (fallback to default)
15
-
16
- ## Requirements
17
-
18
- - One issue per implementation phase
19
- - Clear, structured titles and descriptions
20
- - Include only changes required by the plan
21
- - Verify against existing issues before creation
22
-
23
- ## Issue Content
24
-
25
- - Title: Phase name from implementation plan
26
- - Description: Phase details, requirements, and context
27
- - Labels: Appropriate for issue type (feature/chore)
@@ -1,35 +0,0 @@
1
- ---
2
- mode: 'agent'
3
- description: 'Create GitHub Issues for unimplemented requirements from specification files using feature_request.yml template.'
4
- tools: ['search/codebase', 'search', 'github', 'create_issue', 'search_issues', 'update_issue']
5
- ---
6
- # Create GitHub Issues for Unmet Specification Requirements
7
-
8
- Create GitHub Issues for unimplemented requirements in the specification at `${file}`.
9
-
10
- ## Process
11
-
12
- 1. Analyze specification file to extract all requirements
13
- 2. Check codebase implementation status for each requirement
14
- 3. Search existing issues using `search_issues` to avoid duplicates
15
- 4. Create new issue per unimplemented requirement using `create_issue`
16
- 5. Use `feature_request.yml` template (fallback to default)
17
-
18
- ## Requirements
19
-
20
- - One issue per unimplemented requirement from specification
21
- - Clear requirement ID and description mapping
22
- - Include implementation guidance and acceptance criteria
23
- - Verify against existing issues before creation
24
-
25
- ## Issue Content
26
-
27
- - Title: Requirement ID and brief description
28
- - Description: Detailed requirement, implementation method, and context
29
- - Labels: feature, enhancement (as appropriate)
30
-
31
- ## Implementation Check
32
-
33
- - Search codebase for related code patterns
34
- - Check related specification files in `/spec/` directory
35
- - Verify requirement isn't partially implemented