@totaland/create-starter-kit 1.0.0 → 2.0.1
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.
- package/README.md +130 -18
- package/bin/index.js +109 -21
- package/package.json +2 -2
- package/templates/backend/.github/agents/ /360/237/216/255 planner.agent.md" +92 -0
- package/templates/backend/.github/agents/api-architect.agent.md +41 -0
- package/templates/backend/.github/agents/code-reviewer.agent.md +26 -0
- package/templates/backend/.github/agents/code-simplifier.agent.md +41 -0
- package/templates/backend/.github/agents/code-skeptic.agent.md +74 -0
- package/templates/backend/.github/agents/docs-specialist.agent.md +25 -0
- package/templates/backend/.github/agents/implementation-plan.agent.md +160 -0
- package/templates/backend/.github/agents/janitor.agent.md +90 -0
- package/templates/backend/.github/agents/ms-sql-dba.agent.md +25 -0
- package/templates/backend/.github/agents/plan.agent.md +115 -0
- package/templates/backend/.github/agents/planner.agent.md +15 -0
- package/templates/backend/.github/agents/playwright-tester.agent.md +13 -0
- package/templates/backend/.github/agents/postgresql-dba.agent.md +18 -0
- package/templates/backend/.github/agents/prd.agent.md +202 -0
- package/templates/backend/.github/agents/research-technical-spike.agent.md +170 -0
- package/templates/backend/.github/agents/software-engineer-agent-v1.agent.md +165 -0
- package/templates/backend/.github/agents/task-planner.agent.md +375 -0
- package/templates/backend/.github/agents/task-researcher.agent.md +255 -0
- package/templates/backend/.github/agents/tdd-green.agent.md +60 -0
- package/templates/backend/.github/agents/tdd-red.agent.md +60 -0
- package/templates/backend/.github/agents/tdd-refactor.agent.md +85 -0
- package/templates/backend/.github/agents/tech-debt-remediation-plan.agent.md +50 -0
- package/templates/backend/.github/agents/typescript-mcp-expert.agent.md +91 -0
- package/templates/backend/.github/agents/ultimate-thinking-beastmode.agent.md +644 -0
- package/templates/backend/.github/agents//360/237/216/255 generator.agent.md" +264 -0
- package/templates/backend/.github/agents//360/237/216/255 healer.agent.md" +44 -0
- package/templates/backend/.github/agents//360/237/216/255 pom.agent.md" +308 -0
- package/templates/backend/.github/instructions/a11y.instructions.md +369 -0
- package/templates/backend/.github/instructions/ms-sql-dba.instructions.md +25 -0
- package/templates/backend/.github/instructions/object-calisthenics.instructions.md +302 -0
- package/templates/backend/.github/instructions/performance-optimization.instructions.md +420 -0
- package/templates/backend/.github/instructions/playwright-python.instructions.md +62 -0
- package/templates/backend/.github/instructions/playwright-typescript.instructions.md +86 -0
- package/templates/backend/.github/instructions/security-and-owasp.instructions.md +51 -0
- package/templates/backend/.github/instructions/self-explanatory-code-commenting.instructions.md +162 -0
- package/templates/backend/.github/instructions/spec-driven-workflow-v1.instructions.md +323 -0
- package/templates/backend/.github/instructions/sql-sp-generation.instructions.md +74 -0
- package/templates/backend/.github/instructions/task-implementation.instructions.md +190 -0
- package/templates/backend/.github/instructions/typescript-mcp-server.instructions.md +228 -0
- package/templates/backend/.github/prompts/ai-prompt-engineering-safety-review.prompt.md +229 -0
- package/templates/backend/.github/prompts/architecture-blueprint-generator.prompt.md +321 -0
- package/templates/backend/.github/prompts/breakdown-epic-arch.prompt.md +65 -0
- package/templates/backend/.github/prompts/breakdown-epic-pm.prompt.md +57 -0
- package/templates/backend/.github/prompts/breakdown-feature-implementation.prompt.md +127 -0
- package/templates/backend/.github/prompts/breakdown-feature-prd.prompt.md +60 -0
- package/templates/backend/.github/prompts/breakdown-plan.prompt.md +508 -0
- package/templates/backend/.github/prompts/copilot-instructions-blueprint-generator.prompt.md +293 -0
- package/templates/backend/.github/prompts/create-agentsmd.prompt.md +248 -0
- package/templates/backend/.github/prompts/create-github-issue-feature-from-specification.prompt.md +27 -0
- package/templates/backend/.github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md +27 -0
- package/templates/backend/.github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md +35 -0
- package/templates/backend/.github/prompts/create-implementation-plan.prompt.md +156 -0
- package/templates/backend/.github/prompts/create-llms.prompt.md +209 -0
- package/templates/backend/.github/prompts/create-specification.prompt.md +126 -0
- package/templates/backend/.github/prompts/create-technical-spike.prompt.md +230 -0
- package/templates/backend/.github/prompts/csharp-nunit.prompt.md +71 -0
- package/templates/backend/.github/prompts/ef-core.prompt.md +76 -0
- package/templates/backend/.github/prompts/folder-structure-blueprint-generator.prompt.md +404 -0
- package/templates/backend/.github/prompts/gen-specs-as-issues.prompt.md +165 -0
- package/templates/backend/.github/prompts/generate-custom-instructions-from-codebase.prompt.md +239 -0
- package/templates/backend/.github/prompts/java-junit.prompt.md +64 -0
- package/templates/backend/.github/prompts/memory-merger.prompt.md +107 -0
- package/templates/backend/.github/prompts/multi-stage-dockerfile.prompt.md +46 -0
- package/templates/backend/.github/prompts/playwright-automation-fill-in-form.prompt.md +29 -0
- package/templates/backend/.github/prompts/playwright-explore-website.prompt.md +19 -0
- package/templates/backend/.github/prompts/playwright-generate-test.prompt.md +19 -0
- package/templates/backend/.github/prompts/postgresql-code-review.prompt.md +214 -0
- package/templates/backend/.github/prompts/postgresql-optimization.prompt.md +406 -0
- package/templates/backend/.github/prompts/project-workflow-analysis-blueprint-generator.prompt.md +294 -0
- package/templates/backend/.github/prompts/prompt-builder.prompt.md +142 -0
- package/templates/backend/.github/prompts/remember.prompt.md +125 -0
- package/templates/backend/.github/prompts/review-and-refactor.prompt.md +15 -0
- package/templates/backend/.github/prompts/sql-code-review.prompt.md +303 -0
- package/templates/backend/.github/prompts/sql-optimization.prompt.md +298 -0
- package/templates/backend/.github/prompts/suggest-awesome-github-copilot-agents.prompt.md +72 -0
- package/templates/backend/.github/prompts/suggest-awesome-github-copilot-chatmodes.prompt.md +71 -0
- package/templates/backend/.github/prompts/suggest-awesome-github-copilot-collections.prompt.md +149 -0
- package/templates/backend/.github/prompts/suggest-awesome-github-copilot-instructions.prompt.md +88 -0
- package/templates/backend/.github/prompts/suggest-awesome-github-copilot-prompts.prompt.md +71 -0
- package/templates/backend/.github/prompts/technology-stack-blueprint-generator.prompt.md +242 -0
- package/templates/backend/.github/prompts/typescript-mcp-server-generator.prompt.md +90 -0
- package/templates/backend/.github/prompts/update-implementation-plan.prompt.md +157 -0
- package/templates/backend/.github/prompts/update-markdown-file-index.prompt.md +76 -0
- package/templates/backend/Project_Folders_Structure_Blueprint.md +529 -0
- package/templates/backend/README.md +99 -0
- package/templates/backend/biome.json +45 -0
- package/{template → templates/backend}/drizzle.config.ts +1 -1
- package/{template → templates/backend}/package.json +9 -4
- package/templates/backend/pnpm-lock.yaml +4240 -0
- package/templates/backend/src/features/health/health.test.ts +23 -0
- package/{template → templates/backend}/src/features/health/index.ts +1 -0
- package/templates/backend/src/features/health/schemas.ts +29 -0
- package/templates/backend/src/features/orders/controller.ts +18 -0
- package/templates/backend/src/features/orders/index.ts +10 -0
- package/templates/backend/src/features/orders/schemas.ts +62 -0
- package/{template → templates/backend}/src/index.ts +3 -36
- package/templates/backend/src/lib/openapi.ts +25 -0
- package/templates/backend/src/lib/validateRequest.test.ts +84 -0
- package/templates/backend/src/lib/validateRequest.ts +72 -0
- package/{template → templates/backend}/tsconfig.json +2 -2
- package/{template → templates/backend}/vitest.config.ts +8 -1
- package/templates/frontend/.env.example +7 -0
- package/templates/frontend/.github/agents/ /360/237/216/255 planner.agent.md" +92 -0
- package/templates/frontend/.github/agents/api-architect.agent.md +41 -0
- package/templates/frontend/.github/agents/code-reviewer.agent.md +26 -0
- package/templates/frontend/.github/agents/code-simplifier.agent.md +41 -0
- package/templates/frontend/.github/agents/code-skeptic.agent.md +74 -0
- package/templates/frontend/.github/agents/docs-specialist.agent.md +25 -0
- package/templates/frontend/.github/agents/implementation-plan.agent.md +160 -0
- package/templates/frontend/.github/agents/janitor.agent.md +90 -0
- package/templates/frontend/.github/agents/ms-sql-dba.agent.md +25 -0
- package/templates/frontend/.github/agents/plan.agent.md +115 -0
- package/templates/frontend/.github/agents/planner.agent.md +15 -0
- package/templates/frontend/.github/agents/playwright-tester.agent.md +13 -0
- package/templates/frontend/.github/agents/postgresql-dba.agent.md +18 -0
- package/templates/frontend/.github/agents/prd.agent.md +202 -0
- package/templates/frontend/.github/agents/research-technical-spike.agent.md +170 -0
- package/templates/frontend/.github/agents/software-engineer-agent-v1.agent.md +165 -0
- package/templates/frontend/.github/agents/task-planner.agent.md +375 -0
- package/templates/frontend/.github/agents/task-researcher.agent.md +255 -0
- package/templates/frontend/.github/agents/tdd-green.agent.md +60 -0
- package/templates/frontend/.github/agents/tdd-red.agent.md +60 -0
- package/templates/frontend/.github/agents/tdd-refactor.agent.md +85 -0
- package/templates/frontend/.github/agents/tech-debt-remediation-plan.agent.md +50 -0
- package/templates/frontend/.github/agents/typescript-mcp-expert.agent.md +91 -0
- package/templates/frontend/.github/agents/ultimate-thinking-beastmode.agent.md +644 -0
- package/templates/frontend/.github/agents//360/237/216/255 generator.agent.md" +264 -0
- package/templates/frontend/.github/agents//360/237/216/255 healer.agent.md" +44 -0
- package/templates/frontend/.github/agents//360/237/216/255 pom.agent.md" +308 -0
- package/templates/frontend/.github/instructions/a11y.instructions.md +369 -0
- package/templates/frontend/.github/instructions/ms-sql-dba.instructions.md +25 -0
- package/templates/frontend/.github/instructions/object-calisthenics.instructions.md +302 -0
- package/templates/frontend/.github/instructions/performance-optimization.instructions.md +420 -0
- package/templates/frontend/.github/instructions/playwright-python.instructions.md +62 -0
- package/templates/frontend/.github/instructions/playwright-typescript.instructions.md +86 -0
- package/templates/frontend/.github/instructions/security-and-owasp.instructions.md +51 -0
- package/templates/frontend/.github/instructions/self-explanatory-code-commenting.instructions.md +162 -0
- package/templates/frontend/.github/instructions/spec-driven-workflow-v1.instructions.md +323 -0
- package/templates/frontend/.github/instructions/sql-sp-generation.instructions.md +74 -0
- package/templates/frontend/.github/instructions/task-implementation.instructions.md +190 -0
- package/templates/frontend/.github/instructions/typescript-mcp-server.instructions.md +228 -0
- package/templates/frontend/.github/prompts/ai-prompt-engineering-safety-review.prompt.md +229 -0
- package/templates/frontend/.github/prompts/architecture-blueprint-generator.prompt.md +321 -0
- package/templates/frontend/.github/prompts/breakdown-epic-arch.prompt.md +65 -0
- package/templates/frontend/.github/prompts/breakdown-epic-pm.prompt.md +57 -0
- package/templates/frontend/.github/prompts/breakdown-feature-implementation.prompt.md +127 -0
- package/templates/frontend/.github/prompts/breakdown-feature-prd.prompt.md +60 -0
- package/templates/frontend/.github/prompts/breakdown-plan.prompt.md +508 -0
- package/templates/frontend/.github/prompts/copilot-instructions-blueprint-generator.prompt.md +293 -0
- package/templates/frontend/.github/prompts/create-agentsmd.prompt.md +248 -0
- package/templates/frontend/.github/prompts/create-github-issue-feature-from-specification.prompt.md +27 -0
- package/templates/frontend/.github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md +27 -0
- package/templates/frontend/.github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md +35 -0
- package/templates/frontend/.github/prompts/create-implementation-plan.prompt.md +156 -0
- package/templates/frontend/.github/prompts/create-llms.prompt.md +209 -0
- package/templates/frontend/.github/prompts/create-specification.prompt.md +126 -0
- package/templates/frontend/.github/prompts/create-technical-spike.prompt.md +230 -0
- package/templates/frontend/.github/prompts/csharp-nunit.prompt.md +71 -0
- package/templates/frontend/.github/prompts/ef-core.prompt.md +76 -0
- package/templates/frontend/.github/prompts/folder-structure-blueprint-generator.prompt.md +404 -0
- package/templates/frontend/.github/prompts/gen-specs-as-issues.prompt.md +165 -0
- package/templates/frontend/.github/prompts/generate-custom-instructions-from-codebase.prompt.md +239 -0
- package/templates/frontend/.github/prompts/java-junit.prompt.md +64 -0
- package/templates/frontend/.github/prompts/memory-merger.prompt.md +107 -0
- package/templates/frontend/.github/prompts/multi-stage-dockerfile.prompt.md +46 -0
- package/templates/frontend/.github/prompts/playwright-automation-fill-in-form.prompt.md +29 -0
- package/templates/frontend/.github/prompts/playwright-explore-website.prompt.md +19 -0
- package/templates/frontend/.github/prompts/playwright-generate-test.prompt.md +19 -0
- package/templates/frontend/.github/prompts/postgresql-code-review.prompt.md +214 -0
- package/templates/frontend/.github/prompts/postgresql-optimization.prompt.md +406 -0
- package/templates/frontend/.github/prompts/project-workflow-analysis-blueprint-generator.prompt.md +294 -0
- package/templates/frontend/.github/prompts/prompt-builder.prompt.md +142 -0
- package/templates/frontend/.github/prompts/remember.prompt.md +125 -0
- package/templates/frontend/.github/prompts/review-and-refactor.prompt.md +15 -0
- package/templates/frontend/.github/prompts/sql-code-review.prompt.md +303 -0
- package/templates/frontend/.github/prompts/sql-optimization.prompt.md +298 -0
- package/templates/frontend/.github/prompts/suggest-awesome-github-copilot-agents.prompt.md +72 -0
- package/templates/frontend/.github/prompts/suggest-awesome-github-copilot-chatmodes.prompt.md +71 -0
- package/templates/frontend/.github/prompts/suggest-awesome-github-copilot-collections.prompt.md +149 -0
- package/templates/frontend/.github/prompts/suggest-awesome-github-copilot-instructions.prompt.md +88 -0
- package/templates/frontend/.github/prompts/suggest-awesome-github-copilot-prompts.prompt.md +71 -0
- package/templates/frontend/.github/prompts/technology-stack-blueprint-generator.prompt.md +242 -0
- package/templates/frontend/.github/prompts/typescript-mcp-server-generator.prompt.md +90 -0
- package/templates/frontend/.github/prompts/update-implementation-plan.prompt.md +157 -0
- package/templates/frontend/.github/prompts/update-markdown-file-index.prompt.md +76 -0
- package/templates/frontend/README.md +199 -0
- package/templates/frontend/biome.json +45 -0
- package/templates/frontend/components.json +22 -0
- package/templates/frontend/index.html +13 -0
- package/templates/frontend/package.json +44 -0
- package/templates/frontend/pnpm-lock.yaml +2011 -0
- package/templates/frontend/postcss.config.js +6 -0
- package/templates/frontend/public/vite.svg +1 -0
- package/templates/frontend/src/App.css +42 -0
- package/templates/frontend/src/App.tsx +17 -0
- package/templates/frontend/src/assets/react.svg +1 -0
- package/templates/frontend/src/components/layout/layout.component.tsx +31 -0
- package/templates/frontend/src/components/menu-toggle-icon.tsx +53 -0
- package/templates/frontend/src/components/ui/button.tsx +57 -0
- package/templates/frontend/src/docs/RECOMMENDED_LIBRARIES.md +226 -0
- package/templates/frontend/src/docs/SETUP_SUMMARY.md +162 -0
- package/templates/frontend/src/hooks/use-scroll.ts +21 -0
- package/templates/frontend/src/index.css +121 -0
- package/templates/frontend/src/lib/api-client.ts +46 -0
- package/templates/frontend/src/lib/utils.ts +6 -0
- package/templates/frontend/src/main.tsx +30 -0
- package/templates/frontend/src/pages/about/about.page.tsx +50 -0
- package/templates/frontend/src/pages/home/home.page.tsx +43 -0
- package/templates/frontend/tailwind.config.js +59 -0
- package/templates/frontend/tsconfig.app.json +41 -0
- package/templates/frontend/tsconfig.json +13 -0
- package/templates/frontend/tsconfig.node.json +26 -0
- package/templates/frontend/vite.config.ts +14 -0
- package/template/.env.example +0 -8
- package/template/AGENTS.md +0 -23
- package/template/ARCHITECTURE.md +0 -53
- package/template/ORDER_SYSTEM.md +0 -93
- package/template/biome.json +0 -3
- package/template/src/features/orders/controller.ts +0 -13
- package/template/src/features/orders/index.ts +0 -7
- /package/{template → templates/backend}/knip.json +0 -0
- /package/{template → templates/backend}/playwright.config.ts +0 -0
- /package/{template → templates/backend}/pnpm-workspace.yaml +0 -0
- /package/{template → templates/backend}/src/features/health/controller.ts +0 -0
- /package/{template → templates/backend}/tsconfig.build.json +0 -0
|
@@ -0,0 +1,293 @@
|
|
|
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.
|
|
@@ -0,0 +1,248 @@
|
|
|
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.
|
package/templates/frontend/.github/prompts/create-github-issue-feature-from-specification.prompt.md
ADDED
|
@@ -0,0 +1,27 @@
|
|
|
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)
|
|
@@ -0,0 +1,27 @@
|
|
|
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)
|
|
@@ -0,0 +1,35 @@
|
|
|
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
|