Skip to content

Commit 646a4ce

Browse files
committed
chore: update prompt
1 parent 906c8d9 commit 646a4ce

File tree

2 files changed

+87
-249
lines changed

2 files changed

+87
-249
lines changed
Lines changed: 87 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,87 @@
1+
---
2+
description: Generates an AGENTS.md file for a project repository
3+
---
4+
5+
# Create high‑quality AGENTS.md file
6+
7+
- **Input**: Any files that may provide context about the project, including but not limited to README files, documentation, configuration files (e.g., package.json, pyproject.toml, etc.), CI/CD workflows and any other relevant files.
8+
9+
## Role
10+
11+
You are an expert software architect and 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/.
12+
13+
AGENTS.md is an open format designed to provide coding agents with the context and instructions they need to work effectively on a project.
14+
15+
## Goal
16+
17+
Based on your analysis of the project, your goal is to generate these:
18+
19+
- Create or update `AGENTS.md`: A comprehensive document detailing the project's context, requirements, stack and constraints for the code agents that will implement the project.
20+
- There must at least one `AGENTS.md` file at the root of the repository, but if the project is a monorepo or has multiple distinct project roots, you can create additional `AGENTS.md` files in each relevant subdirectories.
21+
22+
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.
23+
24+
## Instructions
25+
26+
1. Examine the current project to understand its context, requirements, constraints, architecture, tech stack and specificities, and any existing files that may provide insights.
27+
- For example, look for files that may contain the project name, idea, vision, requirements, technology stack and constraints. This may include README files, project documentation, configuration files (e.g., package.json, pyproject.toml, etc.), CI/CD workflows and any other relevant files.
28+
- If the project is a monorepo or has multiple distinct project roots, identify the relevant subdirectories that may require their own `AGENTS.md` files.
29+
30+
2. Once you have all the necessary information, create or update the `AGENTS.md` file with all relevant project context, requirements, stack and constraints for the code agents that will implement the project.
31+
- When doing so, use this the template for structuring the document:
32+
```md
33+
# [project_name]
34+
[Project summary]
35+
36+
## Overview
37+
- [Brief description of what the project does, its purpose and audience]
38+
- [Architecture overview if complex]
39+
- [Project structure if relevant]
40+
41+
## Key Technologies and Frameworks
42+
- [List of main technologies, frameworks, and libraries used in the project]
43+
44+
## Constraints and Requirements [if any]
45+
- [Any specific constraints, requirements, or considerations for the project]
46+
47+
## Challenges and Mitigation Strategies [if any]
48+
- [Potential challenges and how they will be addressed]
49+
50+
## Development Workflow [if applicable]
51+
- [Most important scripts, commands, and tools for development, testing, and deployment. How to start dev server, run tests, build for production, etc.]
52+
53+
## Coding Guidelines [if any]
54+
- [Any specific coding standards, style guides, or best practices to follow]
55+
56+
## Security Considerations [if any]
57+
- [Any security practices or considerations relevant to the project]
58+
59+
## Pull Request Guidelines [if any]
60+
- [Any specific guidelines for creating pull requests, such as, title format, required checks, review process, commit message conventions, etc.]
61+
62+
## Debugging and Troubleshooting [if applicable]
63+
- [Common issues and solutions, logging patterns, debug configuration, performance considerations]
64+
```
65+
- If a section is not relevant, you can omit it.
66+
- **Be specific and concise**: include exact commands, and information from the provided context, do not make any assumptions or add unnecessary details.
67+
- Only use information you found to fill the sections.
68+
- Use standard Markdown formatting.
69+
- If needed, you can add specific sections relevant to the project that are not covered by the template if they provide important context for the code agents.
70+
- If the file already contains enough relevant information, you can skip this step.
71+
72+
## Best Practices
73+
74+
- **Be specific**: Include exact commands, not vague descriptions
75+
- **Use code blocks**: Wrap commands in backticks for clarity
76+
- **Include context**: Explain why certain steps are needed
77+
- **Stay current**: Update as the project evolves
78+
- **Test commands**: Ensure all listed commands actually work
79+
- **Keep it focused** on what agents need to know, not general project information
80+
81+
## Monorepo Considerations
82+
83+
For large monorepos:
84+
- Place a main `AGENTS.md` at the repository root
85+
- Create additional `AGENTS.md` files in subproject directories if they have distinct contexts, requirements or constraints
86+
- The closest `AGENTS.md` file takes precedence for any given location
87+
- Include navigation tips between packages/projects

.github/prompts/create-agentsmd.prompt.md

Lines changed: 0 additions & 249 deletions
This file was deleted.

0 commit comments

Comments
 (0)