x_aeon_agents 2.5.3 → 2.6.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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +18 -0
- data/TODO.md +0 -9
- data/lib/x_aeon_agents/agents/coder_agent.rb +3 -0
- data/lib/x_aeon_agents/agents/documenter_agent.rb +17 -0
- data/lib/x_aeon_agents/agents/feedback_analyst_agent.rb +10 -0
- data/lib/x_aeon_agents/agents/plan_generator_agent.rb +11 -0
- data/lib/x_aeon_agents/agents/readme/about_analyzer_agent.rb +8 -0
- data/lib/x_aeon_agents/agents/readme/contributing_agent.rb +8 -0
- data/lib/x_aeon_agents/agents/readme/development_agent.rb +8 -0
- data/lib/x_aeon_agents/agents/readme/documentation_agent.rb +8 -0
- data/lib/x_aeon_agents/agents/readme/features_agent.rb +8 -0
- data/lib/x_aeon_agents/agents/readme/how_it_works_agent.rb +8 -0
- data/lib/x_aeon_agents/agents/readme/license_agent.rb +8 -0
- data/lib/x_aeon_agents/agents/readme/public_api_agent.rb +8 -0
- data/lib/x_aeon_agents/agents/readme/quick_start_agent.rb +8 -0
- data/lib/x_aeon_agents/agents/readme/requirements_agent.rb +8 -0
- data/lib/x_aeon_agents/agents/tester_agent.rb +25 -0
- data/lib/x_aeon_agents/helpers.rb +19 -0
- data/lib/x_aeon_agents/version.rb +1 -1
- metadata +1 -1
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 9e35c93ce34d5bcbd4425bd104b6f7e318a5d80d32176d9c4292d886acf25ae5
|
|
4
|
+
data.tar.gz: 425cc6c7babc621315dddba419cf3a0e331104d902b4794ea7bab3ea979231fe
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: a0eca635a5b4a026f14c88d1bc041fe24d78355fa06c2a0dd00644df0a7c2d6265a7c20ecfed8ffd16c8075e4e9a84e9486b3a2e1dcb9abf0e0ddc8eee57c40d
|
|
7
|
+
data.tar.gz: c886025ea23528c114403da962f878cf8d2176a778c81211fdac2fe98881c44ea29310c588c3ec758199b1cbc9357822cefc2beb769c538cf4e1c601eaa419fb
|
data/CHANGELOG.md
CHANGED
|
@@ -1,3 +1,21 @@
|
|
|
1
|
+
# [v2.6.1](https://github.com/Muriel-Salvan/x_aeon_agents/compare/v2.6.0...v2.6.1) (2026-11-07 01:29:31)
|
|
2
|
+
|
|
3
|
+
### Patches
|
|
4
|
+
|
|
5
|
+
* [refactor(agents): improve prompts to avoid artifact files](https://github.com/Muriel-Salvan/x_aeon_agents/commit/71afa833c80e574eb74b6349e6371762a447350a)
|
|
6
|
+
|
|
7
|
+
# [v2.6.0](https://github.com/Muriel-Salvan/x_aeon_agents/compare/v2.5.3...v2.6.0) (2026-11-06 19:39:17)
|
|
8
|
+
|
|
9
|
+
## Global changes
|
|
10
|
+
### Patches
|
|
11
|
+
|
|
12
|
+
* [feat(agents): scope repository file access in agent prompts](https://github.com/Muriel-Salvan/x_aeon_agents/commit/703f1a0b672018fd11f8ae266054c330d887e4e7)
|
|
13
|
+
|
|
14
|
+
## Changes for agents
|
|
15
|
+
### Features
|
|
16
|
+
|
|
17
|
+
* [feat(agents): scope repository file access in agent prompts](https://github.com/Muriel-Salvan/x_aeon_agents/commit/703f1a0b672018fd11f8ae266054c330d887e4e7)
|
|
18
|
+
|
|
1
19
|
# [v2.5.3](https://github.com/Muriel-Salvan/x_aeon_agents/compare/v2.5.2...v2.5.3) (2026-11-06 18:10:39)
|
|
2
20
|
|
|
3
21
|
### Patches
|
data/TODO.md
CHANGED
|
@@ -1,12 +1,3 @@
|
|
|
1
|
-
* Add the repository to be worked on in the prompts, and with the constraint that it should not edit files outside of this repo:
|
|
2
|
-
- - "Your git repository root is the current working directory. Use __relative__ paths only, and always prefix commands with `git rev-parse --show-toplevel` verification; never use `/workspace` absolute paths (that is a *different* checkout of the base branch)."
|
|
3
|
-
* Improve prompts:
|
|
4
|
-
- "Never create files (`ARTIFACT_*`, `/tmp/*`) to hold artifacts. Put the fenced ` ```json output_artifact=… ` block in your final message and end the turn with __no tool call__. If `ARTIFACT_PLAN_MODIFICATIONS` has nothing to report, say so in plain text."
|
|
5
|
-
* Improve Tester prompt:
|
|
6
|
-
- "Fix __all__ issues reported in `ARTIFACT_TESTS_OUTPUT` in this iteration (not a subset)."
|
|
7
|
-
- "Identify the exact failing spec file(s) and run __those__ (`<tests_cmd> spec/scenarios/code_quality_spec.rb`), then a final full run. __Never__ conclude success from a partial run."
|
|
8
|
-
- "Quote the final summary line of your verification run in your answer."
|
|
9
|
-
* Replace `JSON.dump(artifact_content)` by `JSON.pretty_generate(artifact_content)` (and `JSON.pretty_generate(@context)`), so no line exceeds a few hundred chars → survives `read_files`' 2 KB/line cap.
|
|
10
1
|
* Make the tester loop with a max retries when the same tests are failing (maybe use a JSON/XML output format for tests that allow for parsing which test fail and only give this information in the prompt).
|
|
11
2
|
* Don't use project skills and rules: it adds noise to the LLMs that scan the files and code base. Use only global objects from dedicated config dirs.
|
|
12
3
|
* Add desktop notification when user input is needed.
|
|
@@ -24,6 +24,8 @@ module XAeonAgents
|
|
|
24
24
|
Given the user's prompt, you should use the tools available to you to answer user's question.
|
|
25
25
|
EO_OBJECTIVE
|
|
26
26
|
system_instructions: <<~EO_INSTRUCTIONS,
|
|
27
|
+
#{Helpers.repository_access_system_instructions}
|
|
28
|
+
|
|
27
29
|
Always gather all the necessary context before starting to work on a task.
|
|
28
30
|
For example, if you are generating a unit test or new code, make sure you understand the requirement, the naming conventions, frameworks and libraries used and aligned in the current codebase, and the environment and commands used to run and test the code etc.
|
|
29
31
|
Always validate the new unit test at the end including running the code if possible for live feedback.
|
|
@@ -59,6 +61,7 @@ module XAeonAgents
|
|
|
59
61
|
emit independent read_files, search_codebase, and run_commands calls together in one response;
|
|
60
62
|
emit multiple editor calls together when editing different files or non-overlapping regions.
|
|
61
63
|
- Always verify the files you have edited or created at the end of the task to ensure they are completed and working as expected.
|
|
64
|
+
- #{Helpers.repository_access_constraint(writable: true)}
|
|
62
65
|
|
|
63
66
|
REMEMBER, be helpful and proactive!
|
|
64
67
|
Don't ask for permission to do something when you can do it!
|
|
@@ -22,6 +22,22 @@ module XAeonAgents
|
|
|
22
22
|
super(
|
|
23
23
|
name: 'Documenter',
|
|
24
24
|
objective: 'Ensure documentation reflects the current product behavior and usage after a new development.',
|
|
25
|
+
system_instructions: <<~EO_INSTRUCTIONS,
|
|
26
|
+
#{Helpers.repository_access_system_instructions}
|
|
27
|
+
|
|
28
|
+
Always gather all the necessary context before starting to work on a task.
|
|
29
|
+
For example, make sure you understand the current behavior of the product by exploring the code, the tests, the existing documentation and the configuration files, so that the documentation you write reflects the current state of the project.
|
|
30
|
+
Begin by analyzing the user's input and gathering any necessary additional context.
|
|
31
|
+
Then, present your plan at the start of your response along with tool calls before proceeding with the task.
|
|
32
|
+
It's OK for this section to be quite long.
|
|
33
|
+
|
|
34
|
+
Review each question carefully and answer it with detailed, accurate information.
|
|
35
|
+
|
|
36
|
+
If you need more information, use one of the available tools or ask for clarification instead of making assumptions or lies.
|
|
37
|
+
|
|
38
|
+
When you have completed the task, please provide a summary of what you did and any relevant information that the user should know.
|
|
39
|
+
This will help ensure that the user understands the changes made and can easily follow up if they have any questions or need further assistance.
|
|
40
|
+
EO_INSTRUCTIONS
|
|
25
41
|
constraints: <<~EO_CONSTRAINTS,
|
|
26
42
|
- Only update documentation files.
|
|
27
43
|
- Do NOT change any code or test.
|
|
@@ -29,6 +45,7 @@ module XAeonAgents
|
|
|
29
45
|
- NEVER explain that something was removed, renamed, or fixed.
|
|
30
46
|
- Documentation describes the CURRENT STATE only.
|
|
31
47
|
- Documentation is NOT a changelog.
|
|
48
|
+
- #{Helpers.repository_access_constraint(writable: true)}
|
|
32
49
|
EO_CONSTRAINTS
|
|
33
50
|
**agent_params
|
|
34
51
|
)
|
|
@@ -43,11 +43,21 @@ module XAeonAgents
|
|
|
43
43
|
name: 'Feedback analyst',
|
|
44
44
|
role: 'You are a feedback analyst agent, analyzing feedback from a Pull Request and devising new requirements to address this feedback.',
|
|
45
45
|
objective: 'Extract requirements from Pull Request comments',
|
|
46
|
+
system_instructions: <<~EO_INSTRUCTIONS,
|
|
47
|
+
#{Helpers.repository_access_system_instructions}
|
|
48
|
+
|
|
49
|
+
Always gather all the necessary context before starting to work on a task: read the Pull Request description, files diffs and conversations, and explore the repository's code when needed.
|
|
50
|
+
Begin by analyzing the user's input and gathering any necessary additional context.
|
|
51
|
+
Review each question carefully and answer it with detailed, accurate information.
|
|
52
|
+
If you need more information, use one of the available tools or ask for clarification instead of making assumptions or lies.
|
|
53
|
+
Do not indicate that you will perform an action without actually doing it.
|
|
54
|
+
EO_INSTRUCTIONS
|
|
46
55
|
constraints: <<~EO_CONSTRAINTS,
|
|
47
56
|
- You are in read-only mode.
|
|
48
57
|
- Do NOT modify or write any file.
|
|
49
58
|
- Focus only on agent-directed comments (/agent) for requirement extraction.
|
|
50
59
|
- Output clear, actionable requirements or "No requirements" if none exist.
|
|
60
|
+
- #{Helpers.repository_access_constraint}
|
|
51
61
|
EO_CONSTRAINTS
|
|
52
62
|
**agent_params
|
|
53
63
|
)
|
|
@@ -32,11 +32,22 @@ module XAeonAgents
|
|
|
32
32
|
name: 'Plan generator',
|
|
33
33
|
role: 'You are an implementation plan generator agent',
|
|
34
34
|
objective: 'Produce a full and detailed implementation plan that can be used to implement some requirements.',
|
|
35
|
+
system_instructions: <<~EO_INSTRUCTIONS,
|
|
36
|
+
#{Helpers.repository_access_system_instructions}
|
|
37
|
+
|
|
38
|
+
Always gather all the necessary context before starting to work on a task: read the relevant code, tests, documentation and configuration files of the repository.
|
|
39
|
+
Begin by analyzing the user's input and gathering any necessary additional context.
|
|
40
|
+
Review each question carefully and answer it with detailed, accurate information.
|
|
41
|
+
If you need more information, use one of the available tools or ask for clarification instead of making assumptions or lies.
|
|
42
|
+
Do not indicate that you will perform an action without actually doing it.
|
|
43
|
+
EO_INSTRUCTIONS
|
|
35
44
|
constraints: <<~EO_CONSTRAINTS,
|
|
36
45
|
- You are in read-only mode.
|
|
37
46
|
- Do NOT modify or write any file.
|
|
38
47
|
- You may only analyze and propose plans.
|
|
39
48
|
- Do NOT execute the plan yourself.
|
|
49
|
+
- #{Helpers.repository_access_constraint}
|
|
50
|
+
- Never create files (`ARTIFACT_*`, `/tmp/*`) to hold artifacts. Put the fenced ` ```json output_artifact=… ` block in your final message and end the turn with __no tool call__.
|
|
40
51
|
EO_CONSTRAINTS
|
|
41
52
|
**agent_params
|
|
42
53
|
)
|
|
@@ -39,12 +39,20 @@ module XAeonAgents
|
|
|
39
39
|
- The 1-line description of the project, using Markdown.
|
|
40
40
|
- A high-level overview (about section) of the project in Markdown format, compatible with Github flavor.
|
|
41
41
|
EO_OBJECTIVE
|
|
42
|
+
system_instructions: <<~EO_INSTRUCTIONS,
|
|
43
|
+
#{Helpers.repository_access_system_instructions}
|
|
44
|
+
|
|
45
|
+
Always gather all the necessary context before starting to work on a task: explore the current repository's code, configuration and documentation to ground your analysis in the actual project.
|
|
46
|
+
If you need more information, use one of the available tools instead of making assumptions.
|
|
47
|
+
Do not indicate that you will perform an action without actually doing it.
|
|
48
|
+
EO_INSTRUCTIONS
|
|
42
49
|
constraints: <<~EO_CONSTRAINTS,
|
|
43
50
|
- The required output artifacts content should only contain the required content, without additional header or title.
|
|
44
51
|
- Do not explain or describe the artifact contents: only provide the content as required.
|
|
45
52
|
- Only focus on the specific scope of the required documentation required.
|
|
46
53
|
Other agents will generate other sections of the README.
|
|
47
54
|
Do not try to document other parts.
|
|
55
|
+
- #{Helpers.repository_access_constraint}
|
|
48
56
|
EO_CONSTRAINTS
|
|
49
57
|
**agent_params
|
|
50
58
|
)
|
|
@@ -29,6 +29,13 @@ module XAeonAgents
|
|
|
29
29
|
Focus on giving community specific guidelines (issues, pull requests, CI, fork...).
|
|
30
30
|
Use emphasis, bullet points, useful links to the project resources and small emojis to better format your section.
|
|
31
31
|
EO_OBJECTIVE
|
|
32
|
+
system_instructions: <<~EO_INSTRUCTIONS,
|
|
33
|
+
#{Helpers.repository_access_system_instructions}
|
|
34
|
+
|
|
35
|
+
Always gather all the necessary context before starting to work on a task: explore the current repository's code, configuration and documentation to ground your analysis in the actual project.
|
|
36
|
+
If you need more information, use one of the available tools instead of making assumptions.
|
|
37
|
+
Do not indicate that you will perform an action without actually doing it.
|
|
38
|
+
EO_INSTRUCTIONS
|
|
32
39
|
constraints: <<~EO_CONSTRAINTS,
|
|
33
40
|
- The required output artifact content should only contain the required content, without additional header or title.
|
|
34
41
|
- Do not explain or describe the artifact content: only provide the content as required.
|
|
@@ -37,6 +44,7 @@ module XAeonAgents
|
|
|
37
44
|
Do not try to document other parts.
|
|
38
45
|
- Do not describe the technical setup or prequisites, as they are already covered by other sections.
|
|
39
46
|
- Do not cover how to develop in this project: it is already covered in other sections.
|
|
47
|
+
- #{Helpers.repository_access_constraint}
|
|
40
48
|
EO_CONSTRAINTS
|
|
41
49
|
**agent_params
|
|
42
50
|
)
|
|
@@ -36,6 +36,13 @@ module XAeonAgents
|
|
|
36
36
|
- package the project deliverables,
|
|
37
37
|
- perform common development tasks.
|
|
38
38
|
EO_OBJECTIVE
|
|
39
|
+
system_instructions: <<~EO_INSTRUCTIONS,
|
|
40
|
+
#{Helpers.repository_access_system_instructions}
|
|
41
|
+
|
|
42
|
+
Always gather all the necessary context before starting to work on a task: explore the current repository's code, configuration and documentation to ground your analysis in the actual project.
|
|
43
|
+
If you need more information, use one of the available tools instead of making assumptions.
|
|
44
|
+
Do not indicate that you will perform an action without actually doing it.
|
|
45
|
+
EO_INSTRUCTIONS
|
|
39
46
|
constraints: <<~EO_CONSTRAINTS,
|
|
40
47
|
- The required output artifact content should only contain the required content, without additional header or title.
|
|
41
48
|
- Do not explain or describe the artifact content: only provide the content as required.
|
|
@@ -44,6 +51,7 @@ module XAeonAgents
|
|
|
44
51
|
Do not try to document other parts.
|
|
45
52
|
- Do not cover the end-user main requirements and prerequisites: they are already covered in other sections.
|
|
46
53
|
- Do not cover the contribution workflow (pull requests, CI, issues...): this is already covered in other sections.
|
|
54
|
+
- #{Helpers.repository_access_constraint}
|
|
47
55
|
EO_CONSTRAINTS
|
|
48
56
|
**agent_params
|
|
49
57
|
)
|
|
@@ -27,12 +27,20 @@ module XAeonAgents
|
|
|
27
27
|
Explore the project's documentation files and resources to identify all available documentation.
|
|
28
28
|
Generate a "Documentation" section in Markdown format, compatible with Github flavor, providing links to documentation resources.
|
|
29
29
|
EO_OBJECTIVE
|
|
30
|
+
system_instructions: <<~EO_INSTRUCTIONS,
|
|
31
|
+
#{Helpers.repository_access_system_instructions}
|
|
32
|
+
|
|
33
|
+
Always gather all the necessary context before starting to work on a task: explore the current repository's code, configuration and documentation to ground your analysis in the actual project.
|
|
34
|
+
If you need more information, use one of the available tools instead of making assumptions.
|
|
35
|
+
Do not indicate that you will perform an action without actually doing it.
|
|
36
|
+
EO_INSTRUCTIONS
|
|
30
37
|
constraints: <<~EO_CONSTRAINTS,
|
|
31
38
|
- The required output artifact content should only contain the required content, without additional header or title.
|
|
32
39
|
- Do not explain or describe the artifact content: only provide the content as required.
|
|
33
40
|
- Only focus on the specific scope of the required documentation required.
|
|
34
41
|
Other agents will generate other sections of the README.
|
|
35
42
|
Do not try to document other parts.
|
|
43
|
+
- #{Helpers.repository_access_constraint}
|
|
36
44
|
EO_CONSTRAINTS
|
|
37
45
|
**agent_params
|
|
38
46
|
)
|
|
@@ -29,12 +29,20 @@ module XAeonAgents
|
|
|
29
29
|
Use emphasis, bullet points and small emojis to illustrate in a readable way the list of features.
|
|
30
30
|
Don't provide an overall description of the project: another section is already doing it.
|
|
31
31
|
EO_OBJECTIVE
|
|
32
|
+
system_instructions: <<~EO_INSTRUCTIONS,
|
|
33
|
+
#{Helpers.repository_access_system_instructions}
|
|
34
|
+
|
|
35
|
+
Always gather all the necessary context before starting to work on a task: explore the current repository's code, configuration and documentation to ground your analysis in the actual project.
|
|
36
|
+
If you need more information, use one of the available tools instead of making assumptions.
|
|
37
|
+
Do not indicate that you will perform an action without actually doing it.
|
|
38
|
+
EO_INSTRUCTIONS
|
|
32
39
|
constraints: <<~EO_CONSTRAINTS,
|
|
33
40
|
- The required output artifact content should only contain the required content, without additional header or title.
|
|
34
41
|
- Do not explain or describe the artifact content: only provide the content as required.
|
|
35
42
|
- Only focus on the specific scope of the required documentation required.
|
|
36
43
|
Other agents will generate other sections of the README.
|
|
37
44
|
Do not try to document other parts.
|
|
45
|
+
- #{Helpers.repository_access_constraint}
|
|
38
46
|
EO_CONSTRAINTS
|
|
39
47
|
**agent_params
|
|
40
48
|
)
|
|
@@ -30,6 +30,13 @@ module XAeonAgents
|
|
|
30
30
|
You can use SocratiCode if it is available to get a better understanding of this project.
|
|
31
31
|
You can use Mermaid graphs to also illustrate the way this project works.
|
|
32
32
|
EO_OBJECTIVE
|
|
33
|
+
system_instructions: <<~EO_INSTRUCTIONS,
|
|
34
|
+
#{Helpers.repository_access_system_instructions}
|
|
35
|
+
|
|
36
|
+
Always gather all the necessary context before starting to work on a task: explore the current repository's code, configuration and documentation to ground your analysis in the actual project.
|
|
37
|
+
If you need more information, use one of the available tools instead of making assumptions.
|
|
38
|
+
Do not indicate that you will perform an action without actually doing it.
|
|
39
|
+
EO_INSTRUCTIONS
|
|
33
40
|
constraints: <<~EO_CONSTRAINTS,
|
|
34
41
|
- The required output artifact content should only contain the required content, without additional header or title.
|
|
35
42
|
- Do not explain or describe the artifact content: only provide the content as required.
|
|
@@ -37,6 +44,7 @@ module XAeonAgents
|
|
|
37
44
|
Other agents will generate other sections of the README.
|
|
38
45
|
Do not try to document other parts.
|
|
39
46
|
- Do not provide long paragraphs: focus on readability by splitting long paragraphs into several short ones.
|
|
47
|
+
- #{Helpers.repository_access_constraint}
|
|
40
48
|
EO_CONSTRAINTS
|
|
41
49
|
**agent_params
|
|
42
50
|
)
|
|
@@ -27,12 +27,20 @@ module XAeonAgents
|
|
|
27
27
|
Analyze the project's LICENSE file to identify the license type and terms.
|
|
28
28
|
Generate a "License" section in Markdown format, compatible with Github flavor, describing the project license.
|
|
29
29
|
EO_OBJECTIVE
|
|
30
|
+
system_instructions: <<~EO_INSTRUCTIONS,
|
|
31
|
+
#{Helpers.repository_access_system_instructions}
|
|
32
|
+
|
|
33
|
+
Always gather all the necessary context before starting to work on a task: explore the current repository's code, configuration and documentation to ground your analysis in the actual project.
|
|
34
|
+
If you need more information, use one of the available tools instead of making assumptions.
|
|
35
|
+
Do not indicate that you will perform an action without actually doing it.
|
|
36
|
+
EO_INSTRUCTIONS
|
|
30
37
|
constraints: <<~EO_CONSTRAINTS,
|
|
31
38
|
- The required output artifact content should only contain the required content, without additional header or title.
|
|
32
39
|
- Do not explain or describe the artifact content: only provide the content as required.
|
|
33
40
|
- Only focus on the specific scope of the required documentation required.
|
|
34
41
|
Other agents will generate other sections of the README.
|
|
35
42
|
Do not try to document other parts.
|
|
43
|
+
- #{Helpers.repository_access_constraint}
|
|
36
44
|
EO_CONSTRAINTS
|
|
37
45
|
**agent_params
|
|
38
46
|
)
|
|
@@ -27,6 +27,13 @@ module XAeonAgents
|
|
|
27
27
|
Analyze the project's codebase to identify all public APIs, classes, methods, and interfaces exposed to users.
|
|
28
28
|
Generate a "Public API" section in Markdown format, compatible with Github flavor, documenting the public API surface.
|
|
29
29
|
EO_OBJECTIVE
|
|
30
|
+
system_instructions: <<~EO_INSTRUCTIONS,
|
|
31
|
+
#{Helpers.repository_access_system_instructions}
|
|
32
|
+
|
|
33
|
+
Always gather all the necessary context before starting to work on a task: explore the current repository's code, configuration and documentation to ground your analysis in the actual project.
|
|
34
|
+
If you need more information, use one of the available tools instead of making assumptions.
|
|
35
|
+
Do not indicate that you will perform an action without actually doing it.
|
|
36
|
+
EO_INSTRUCTIONS
|
|
30
37
|
constraints: <<~EO_CONSTRAINTS,
|
|
31
38
|
- The required output artifact content should only contain the required content, without additional header or title.
|
|
32
39
|
- Do not explain or describe the artifact content: only provide the content as required.
|
|
@@ -34,6 +41,7 @@ module XAeonAgents
|
|
|
34
41
|
Other agents will generate other sections of the README.
|
|
35
42
|
Do not try to document other parts.
|
|
36
43
|
- Only document public API entry points: executables and library public methods belonging to yarn `Public API` group.
|
|
44
|
+
- #{Helpers.repository_access_constraint}
|
|
37
45
|
EO_CONSTRAINTS
|
|
38
46
|
**agent_params
|
|
39
47
|
)
|
|
@@ -33,6 +33,13 @@ module XAeonAgents
|
|
|
33
33
|
- If this project defines a web app, explain how to install this web app, run it and access it using a web browser.
|
|
34
34
|
This section should be concise: don't cover all features, just simple install and startup guides for the main happy paths.
|
|
35
35
|
EO_OBJECTIVE
|
|
36
|
+
system_instructions: <<~EO_INSTRUCTIONS,
|
|
37
|
+
#{Helpers.repository_access_system_instructions}
|
|
38
|
+
|
|
39
|
+
Always gather all the necessary context before starting to work on a task: explore the current repository's code, configuration and documentation to ground your analysis in the actual project.
|
|
40
|
+
If you need more information, use one of the available tools instead of making assumptions.
|
|
41
|
+
Do not indicate that you will perform an action without actually doing it.
|
|
42
|
+
EO_INSTRUCTIONS
|
|
36
43
|
constraints: <<~EO_CONSTRAINTS,
|
|
37
44
|
- The required output artifact content should only contain the required content, without additional header or title.
|
|
38
45
|
- Do not explain or describe the artifact content: only provide the content as required.
|
|
@@ -40,6 +47,7 @@ module XAeonAgents
|
|
|
40
47
|
Other agents will generate other sections of the README.
|
|
41
48
|
Do not try to document other parts.
|
|
42
49
|
- This section is not meant for developers: don't describe how to develop, test, document, package or contribute to this project.
|
|
50
|
+
- #{Helpers.repository_access_constraint}
|
|
43
51
|
EO_CONSTRAINTS
|
|
44
52
|
**agent_params
|
|
45
53
|
)
|
|
@@ -27,12 +27,20 @@ module XAeonAgents
|
|
|
27
27
|
Analyze the project's dependencies, runtime environment, and prerequisites.
|
|
28
28
|
Generate a "Requirements" section in Markdown format, compatible with Github flavor, listing all prerequisites needed to use or run the project.
|
|
29
29
|
EO_OBJECTIVE
|
|
30
|
+
system_instructions: <<~EO_INSTRUCTIONS,
|
|
31
|
+
#{Helpers.repository_access_system_instructions}
|
|
32
|
+
|
|
33
|
+
Always gather all the necessary context before starting to work on a task: explore the current repository's code, configuration and documentation to ground your analysis in the actual project.
|
|
34
|
+
If you need more information, use one of the available tools instead of making assumptions.
|
|
35
|
+
Do not indicate that you will perform an action without actually doing it.
|
|
36
|
+
EO_INSTRUCTIONS
|
|
30
37
|
constraints: <<~EO_CONSTRAINTS,
|
|
31
38
|
- The required output artifact content should only contain the required content, without additional header or title.
|
|
32
39
|
- Do not explain or describe the artifact content: only provide the content as required.
|
|
33
40
|
- Only focus on the specific scope of the required documentation required.
|
|
34
41
|
Other agents will generate other sections of the README.
|
|
35
42
|
Do not try to document other parts.
|
|
43
|
+
- #{Helpers.repository_access_constraint}
|
|
36
44
|
EO_CONSTRAINTS
|
|
37
45
|
**agent_params
|
|
38
46
|
)
|
|
@@ -42,8 +42,33 @@ module XAeonAgents
|
|
|
42
42
|
Fix any regression that has been induced by new features or fixes, while keeping the initial requirements and implementation plan in mind.
|
|
43
43
|
If the decisions taken in the implementation plan prevent you from fixing regressions, modify the implementation plan and report those modifications to the user.
|
|
44
44
|
EO_OBJECTIVE
|
|
45
|
+
constraints: <<~EO_CONSTRAINTS,
|
|
46
|
+
- #{Helpers.repository_access_constraint(writable: true)}
|
|
47
|
+
- Never create files (`ARTIFACT_*`, `/tmp/*`) to hold artifacts. Put the fenced ` ```json output_artifact=… ` block in your final message and end the turn with __no tool call__.
|
|
48
|
+
EO_CONSTRAINTS
|
|
45
49
|
**agent_params
|
|
46
50
|
)
|
|
51
|
+
self.system_instructions = <<~EO_INSTRUCTIONS
|
|
52
|
+
#{Helpers.repository_access_system_instructions}
|
|
53
|
+
|
|
54
|
+
Always gather all the necessary context before starting to work on a task.
|
|
55
|
+
For example, make sure you understand the regressions to fix, the naming conventions, frameworks and libraries used and aligned in the current codebase, and the environment and commands used to run and test the code etc.
|
|
56
|
+
Always run the whole tests suite using the tests command provided, and validate your fixes with live feedback until all tests pass.
|
|
57
|
+
Begin by analyzing the user's input and gathering any necessary additional context.
|
|
58
|
+
Then, present your plan at the start of your response along with tool calls before proceeding with the task.
|
|
59
|
+
It's OK for this section to be quite long.
|
|
60
|
+
|
|
61
|
+
Review each question carefully and answer it with detailed, accurate information.
|
|
62
|
+
|
|
63
|
+
If you need more information, use one of the available tools or ask for clarification instead of making assumptions or lies.
|
|
64
|
+
|
|
65
|
+
Fix __all__ issues reported in the `#{artifact_ref(:tests_output)}` artifact in this iteration (not a subset).
|
|
66
|
+
Identify the exact failing spec file(s) and run __those__, then a final full run. __Never__ conclude success from a partial run.
|
|
67
|
+
Quote the final summary line of your verification run in your answer.
|
|
68
|
+
|
|
69
|
+
When you have completed the task, please provide a summary of what you did and any relevant information that the user should know, including the final summary line of the tests suite.
|
|
70
|
+
This will help ensure that the user understands the changes made and can easily follow up if they have any questions or need further assistance.
|
|
71
|
+
EO_INSTRUCTIONS
|
|
47
72
|
end
|
|
48
73
|
end
|
|
49
74
|
end
|
|
@@ -149,6 +149,25 @@ module XAeonAgents
|
|
|
149
149
|
end
|
|
150
150
|
end
|
|
151
151
|
|
|
152
|
+
# Get the system instructions telling agents in which repository they are working.
|
|
153
|
+
# This instruction is format-agnostic: it does not include any formatting (bullet, header...) so that it can be
|
|
154
|
+
# included in any system instructions section.
|
|
155
|
+
#
|
|
156
|
+
# @return [String] The system instructions about the current repository
|
|
157
|
+
def repository_access_system_instructions
|
|
158
|
+
"The current repository in which you are working is `#{Dir.pwd}`."
|
|
159
|
+
end
|
|
160
|
+
|
|
161
|
+
# Get the constraint restricting the files agents are allowed to access.
|
|
162
|
+
# This constraint is format-agnostic: it does not include any formatting (bullet, header...) so that it can be
|
|
163
|
+
# included in any constraints section.
|
|
164
|
+
#
|
|
165
|
+
# @param writable [Boolean] True if the agent is allowed to write files, false if it is read-only
|
|
166
|
+
# @return [String] The constraint restricting the agents' file accesses to the current repository
|
|
167
|
+
def repository_access_constraint(writable: false)
|
|
168
|
+
"You should only #{writable ? 'read and write' : 'read'} files that are part of the current repository: `#{Dir.pwd}`"
|
|
169
|
+
end
|
|
170
|
+
|
|
152
171
|
# Allow user to review and edit content before using it
|
|
153
172
|
#
|
|
154
173
|
# When the interactive mode is disabled (Config.interactive), no review file
|