x_aeon_agents 2.7.1 → 2.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c02e664b325a3265a1397697d4730f7e95901db60483db4b3961851d7f92085d
-  data.tar.gz: 9ab1c4fbd0deb3313b55f82cd08dcf66f1bab8ff7c89f0f03a0c93e4d595fe0d
+  metadata.gz: ca63878f464258f86f9d780e3c02e8b5bd6f519caa475ebb11bb1f51457ebeb2
+  data.tar.gz: '0780aa1af3dd89ab64c00aa28fb66afa4f320d98fa471cd715b0de3298267097'
 SHA512:
-  metadata.gz: 724e0edba6d234a943beb21d3be41f4407582d4f43efd97a1fceb096c353b8f52f34801facf88257872592bd7f23bd540c078d08745eee6d3b6066fe9ab5c934
-  data.tar.gz: 753db34710e6a78dd2f6c53fadd14fbc1086b684a1a451b8b2326375173008cafe5743d778d7ce36432f71d1c3ef726f53b2a3e16b5b7b643187982a704631a7
+  metadata.gz: b231e35b0015adacf2711b6cf2bbc3994722879f42a924ed4572b2c8ee2665b2082446b51df25f07f185b99620ddee8d74efbf6781719c869ab47e9753708c1f
+  data.tar.gz: 9f12ff2f488d6735426bff1d8c88f44b9380a326018742ea1d768b8275a3aecef9343d152fa7da67084838b8f8b77f42b427082c48a19ca73a6709b10c48f6f0

data/CHANGELOG.md

@@ -1,3 +1,15 @@
+# [v2.8.0](https://github.com/Muriel-Salvan/x_aeon_agents/compare/v2.7.1...v2.8.0) (2026-11-12 17:47:11)
+
+## Global changes
+### Patches
+
+* [feat(agents): support non-interactive constraints if needed in the prompts](https://github.com/Muriel-Salvan/x_aeon_agents/commit/2ef0511f6a711d28c91de95c498c0deb8ee71607)
+
+## Changes for agents
+### Features
+
+* [feat(agents): support non-interactive constraints if needed in the prompts](https://github.com/Muriel-Salvan/x_aeon_agents/commit/2ef0511f6a711d28c91de95c498c0deb8ee71607)
+
 # [v2.7.1](https://github.com/Muriel-Salvan/x_aeon_agents/compare/v2.7.0...v2.7.1) (2026-11-12 15:59:52)
 
 ## Global changes

data/lib/x_aeon_agents/agents/coder_agent.rb

@@ -46,39 +46,46 @@ module XAeonAgents
             When you have completed the task, please provide a summary of what you did and any relevant information that the user should know.
             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.
           EO_INSTRUCTIONS
-          constraints: <<~EO_CONSTRAINTS,
-            Remember:
-            - Always adhere to existing code conventions and patterns.
-            - Use only libraries and frameworks that are confirmed to be in use in the current codebase.
-            - Provide complete and functional code without omissions or placeholders.
-            - Always think about new tests and corner cases to be added or changed with new features, fixes or feature changes.
-            - Always think about documentation updates with new features or feature changes.
-            - Be explicit about any assumptions or limitations in your solution.
-            - Always show your planning process before executing any task.
-              This will help ensure that you have a clear understanding of the requirements and that your approach aligns with the user's needs.
-            - Always use absolute paths when referring to files.
-            - You can call multiple tools in a single response.
-              Before using tools, identify every independent read, search, command, or edit needed for the next step and emit all of those tool calls now, either as multiple tool calls or as one batched input for tools that accept arrays.
-              Do not wait for one independent result before requesting another.
-              Do not split independent reads, searches, checks, or edits across separate turns.
-            - Good parallelism examples: read all known relevant files in one read_files call;
-              run independent inspection commands in one run_commands call;
-              emit independent read_files, search_codebase, and run_commands calls together in one response;
-              emit multiple editor calls together when editing different files or non-overlapping regions.
-            - Always verify the files you have edited or created at the end of the task to ensure they are completed and working as expected.
-            - #{Helpers.repository_access_constraint(writable: true)}
-
-            REMEMBER, be helpful and proactive!
-            Don't ask for permission to do something when you can do it!
-            Do not indicates you will be using a tool unless you are actually going to use it.
-
-            IMPORTANT: Always includes tool calls in your response until the task is completed.
-            Response without tool calls will be considered as completed with the final answer.
-
-            Do not indicate that you will perform an action without actually doing it.
-            Always provide the final result in your response.
-            Always validate your answer with checking the code and running it if possible.
-          EO_CONSTRAINTS
+          constraints: [
+            'Remember:',
+            '- Always adhere to existing code conventions and patterns.',
+            '- Use only libraries and frameworks that are confirmed to be in use in the current codebase.',
+            '- Provide complete and functional code without omissions or placeholders.',
+            '- Always think about new tests and corner cases to be added or changed with new features, fixes or feature changes.',
+            '- Always think about documentation updates with new features or feature changes.',
+            '- Be explicit about any assumptions or limitations in your solution.',
+            <<~EO_CONSTRAINT.rstrip,
+              - Always show your planning process before executing any task.
+                This will help ensure that you have a clear understanding of the requirements and that your approach aligns with the user's needs.
+            EO_CONSTRAINT
+            '- Always use absolute paths when referring to files.',
+            <<~EO_CONSTRAINT.rstrip,
+              - You can call multiple tools in a single response.
+                Before using tools, identify every independent read, search, command, or edit needed for the next step and emit all of those tool calls now, either as multiple tool calls or as one batched input for tools that accept arrays.
+                Do not wait for one independent result before requesting another.
+                Do not split independent reads, searches, checks, or edits across separate turns.
+            EO_CONSTRAINT
+            <<~EO_CONSTRAINT.rstrip,
+              - Good parallelism examples: read all known relevant files in one read_files call;
+                run independent inspection commands in one run_commands call;
+                emit independent read_files, search_codebase, and run_commands calls together in one response;
+                emit multiple editor calls together when editing different files or non-overlapping regions.
+            EO_CONSTRAINT
+            '- Always verify the files you have edited or created at the end of the task to ensure they are completed and working as expected.',
+            Helpers.repository_access_constraint(writable: true),
+            Helpers.non_interactive_constraint,
+            '',
+            'REMEMBER, be helpful and proactive!',
+            "Don't ask for permission to do something when you can do it!",
+            'Do not indicates you will be using a tool unless you are actually going to use it.',
+            '',
+            'IMPORTANT: Always includes tool calls in your response until the task is completed.',
+            'Response without tool calls will be considered as completed with the final answer.',
+            '',
+            'Do not indicate that you will perform an action without actually doing it.',
+            'Always provide the final result in your response.',
+            'Always validate your answer with checking the code and running it if possible.'
+          ].compact.join("\n"),
           **agent_params
         )
       end

data/lib/x_aeon_agents/agents/diff_interpreter_agent.rb

@@ -66,14 +66,15 @@ module XAeonAgents
             EO_INSTRUCTIONS
           ]
         }
-        self.constraints = <<~EO_CONSTRAINTS
-          - You are in read-only mode.
-          - Do NOT modify or write any file.
-          - You must ONLY explain the changes of the artifact named `#{artifact_ref(:files_diff)}`, NOT other changes.
-          - You already have ALL the information required.
-          - The user's intent is fully specified.
-          - The conversation log is provided for context only. You MUST NOT ask follow-up questions.
-        EO_CONSTRAINTS
+        self.constraints = [
+          '- You are in read-only mode.',
+          '- Do NOT modify or write any file.',
+          "- You must ONLY explain the changes of the artifact named `#{artifact_ref(:files_diff)}`, NOT other changes.",
+          '- You already have ALL the information required.',
+          "- The user's intent is fully specified.",
+          '- The conversation log is provided for context only. You MUST NOT ask follow-up questions.',
+          Helpers.non_interactive_constraint
+        ].compact.join("\n")
       end
     end
   end

data/lib/x_aeon_agents/agents/documenter_agent.rb

@@ -48,15 +48,16 @@ module XAeonAgents
             When you have completed the task, please provide a summary of what you did and any relevant information that the user should know.
             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.
           EO_INSTRUCTIONS
-          constraints: <<~EO_CONSTRAINTS,
-            - Only update documentation files.
-            - Do NOT change any code or test.
-            - NEVER document the fact that a change happened.
-            - NEVER explain that something was removed, renamed, or fixed.
-            - Documentation describes the CURRENT STATE only.
-            - Documentation is NOT a changelog.
-            - #{Helpers.repository_access_constraint(writable: true)}
-          EO_CONSTRAINTS
+          constraints: [
+            '- Only update documentation files.',
+            '- Do NOT change any code or test.',
+            '- NEVER document the fact that a change happened.',
+            '- NEVER explain that something was removed, renamed, or fixed.',
+            '- Documentation describes the CURRENT STATE only.',
+            '- Documentation is NOT a changelog.',
+            Helpers.repository_access_constraint(writable: true),
+            Helpers.non_interactive_constraint
+          ].compact.join("\n"),
           **agent_params
         )
       end

data/lib/x_aeon_agents/agents/executor_agent.rb

@@ -9,7 +9,13 @@ module XAeonAgents
       #
       # @param agent_params [Hash{Symbol => Object}] Extra agent parameters
       def initialize(**agent_params)
-        super(name: 'Executor', **agent_params)
+        super(
+          name: 'Executor',
+          constraints: [
+            Helpers.non_interactive_constraint
+          ].compact.join("\n"),
+          **agent_params
+        )
       end
     end
   end

data/lib/x_aeon_agents/agents/feedback_analyst_agent.rb

@@ -60,14 +60,15 @@ module XAeonAgents
           EO_INSTRUCTIONS
           **agent_params
         )
-        self.constraints = <<~EO_CONSTRAINTS
-          - You are in read-only mode for the repository: do NOT modify any file of it.
-          - Focus only on agent-directed comments (/agent) for requirement extraction.
-          - Write the extracted requirements to the output artifact file given in this prompt.
-          - If no implementation is required, write exactly `No requirements` in this file.
-          - #{Helpers.repository_access_constraint}
-          - #{Helpers.artifacts_access_constraint(artifact_ref(:requirements))}
-        EO_CONSTRAINTS
+        self.constraints = [
+          '- You are in read-only mode for the repository: do NOT modify any file of it.',
+          '- Focus only on agent-directed comments (/agent) for requirement extraction.',
+          '- Write the extracted requirements to the output artifact file given in this prompt.',
+          '- If no implementation is required, write exactly `No requirements` in this file.',
+          Helpers.repository_access_constraint,
+          Helpers.artifacts_access_constraint(artifact_ref(:requirements)),
+          Helpers.non_interactive_constraint
+        ].compact.join("\n")
       end
     end
   end

data/lib/x_aeon_agents/agents/one_line_code_diff_summarizer_agent.rb

@@ -26,13 +26,14 @@ module XAeonAgents
           name: '1-line code diff summarizer',
           role: 'You are a 1-line code diff summarizer agent',
           objective: 'Produce a 1-line summary of a code change intent report.',
-          constraints: <<~EO_CONSTRAINTS,
-            - You are in read-only mode.
-            - Do NOT modify or write any file.
-            - You already have ALL the information required.
-            - The user's intent is fully specified.
-            - You MUST NOT ask follow-up questions.
-          EO_CONSTRAINTS
+          constraints: [
+            '- You are in read-only mode.',
+            '- Do NOT modify or write any file.',
+            '- You already have ALL the information required.',
+            "- The user's intent is fully specified.",
+            '- You MUST NOT ask follow-up questions.',
+            Helpers.non_interactive_constraint
+          ].compact.join("\n"),
           **agent_params
         )
         self.system_instructions = {

data/lib/x_aeon_agents/agents/plan_generator_agent.rb

@@ -48,13 +48,14 @@ module XAeonAgents
           EO_INSTRUCTIONS
           **agent_params
         )
-        self.constraints = <<~EO_CONSTRAINTS
-          - You are in read-only mode for the repository: do NOT modify any file of it.
-          - You may only analyze and propose plans.
-          - Do NOT execute the plan yourself.
-          - #{Helpers.repository_access_constraint}
-          - #{Helpers.artifacts_access_constraint(artifact_ref(:plan))}
-        EO_CONSTRAINTS
+        self.constraints = [
+          '- You are in read-only mode for the repository: do NOT modify any file of it.',
+          '- You may only analyze and propose plans.',
+          '- Do NOT execute the plan yourself.',
+          Helpers.repository_access_constraint,
+          Helpers.artifacts_access_constraint(artifact_ref(:plan)),
+          Helpers.non_interactive_constraint
+        ].compact.join("\n")
       end
     end
   end

data/lib/x_aeon_agents/agents/readme/about_analyzer_agent.rb

@@ -48,15 +48,18 @@ module XAeonAgents
             EO_INSTRUCTIONS
             **agent_params
           )
-          self.constraints = <<~EO_CONSTRAINTS
-            - Write only the required content to the output artifact files, without any additional header or title.
-            - Do NOT write any explanation or description in the artifact files: write only the required content.
-            - Only focus on the specific scope of the required documentation required.
-              Other agents will generate other sections of the README.
-              Do not try to document other parts.
-            - #{Helpers.repository_access_constraint}
-            - #{Helpers.artifacts_access_constraint(artifact_ref(:about), artifact_ref(:name), artifact_ref(:description))}
-          EO_CONSTRAINTS
+          self.constraints = [
+            '- Write only the required content to the output artifact files, without any additional header or title.',
+            '- Do NOT write any explanation or description in the artifact files: write only the required content.',
+            <<~EO_CONSTRAINT.rstrip,
+              - Only focus on the specific scope of the required documentation required.
+                Other agents will generate other sections of the README.
+                Do not try to document other parts.
+            EO_CONSTRAINT
+            Helpers.repository_access_constraint,
+            Helpers.artifacts_access_constraint(artifact_ref(:about), artifact_ref(:name), artifact_ref(:description)),
+            Helpers.non_interactive_constraint
+          ].compact.join("\n")
         end
       end
     end

data/lib/x_aeon_agents/agents/readme/contributing_agent.rb

@@ -38,17 +38,20 @@ module XAeonAgents
             EO_INSTRUCTIONS
             **agent_params
           )
-          self.constraints = <<~EO_CONSTRAINTS
-            - Write only the required content to the output artifact file, without any additional header or title.
-            - Do NOT write any explanation or description in the artifact file: write only the required content.
-            - Only focus on the specific scope of the required documentation required.
-              Other agents will generate other sections of the README.
-              Do not try to document other parts.
-            - Do not describe the technical setup or prequisites, as they are already covered by other sections.
-            - Do not cover how to develop in this project: it is already covered in other sections.
-            - #{Helpers.repository_access_constraint}
-            - #{Helpers.artifacts_access_constraint(artifact_ref(:contributing))}
-          EO_CONSTRAINTS
+          self.constraints = [
+            '- Write only the required content to the output artifact file, without any additional header or title.',
+            '- Do NOT write any explanation or description in the artifact file: write only the required content.',
+            <<~EO_CONSTRAINT.rstrip,
+              - Only focus on the specific scope of the required documentation required.
+                Other agents will generate other sections of the README.
+                Do not try to document other parts.
+            EO_CONSTRAINT
+            '- Do not describe the technical setup or prequisites, as they are already covered by other sections.',
+            '- Do not cover how to develop in this project: it is already covered in other sections.',
+            Helpers.repository_access_constraint,
+            Helpers.artifacts_access_constraint(artifact_ref(:contributing)),
+            Helpers.non_interactive_constraint
+          ].compact.join("\n")
         end
       end
     end

data/lib/x_aeon_agents/agents/readme/development_agent.rb

@@ -45,17 +45,20 @@ module XAeonAgents
             EO_INSTRUCTIONS
             **agent_params
           )
-          self.constraints = <<~EO_CONSTRAINTS
-            - Write only the required content to the output artifact file, without any additional header or title.
-            - Do NOT write any explanation or description in the artifact file: write only the required content.
-            - Only focus on the specific scope of the required documentation required.
-              Other agents will generate other sections of the README.
-              Do not try to document other parts.
-            - Do not cover the end-user main requirements and prerequisites: they are already covered in other sections.
-            - Do not cover the contribution workflow (pull requests, CI, issues...): this is already covered in other sections.
-            - #{Helpers.repository_access_constraint}
-            - #{Helpers.artifacts_access_constraint(artifact_ref(:development))}
-          EO_CONSTRAINTS
+          self.constraints = [
+            '- Write only the required content to the output artifact file, without any additional header or title.',
+            '- Do NOT write any explanation or description in the artifact file: write only the required content.',
+            <<~EO_CONSTRAINT.rstrip,
+              - Only focus on the specific scope of the required documentation required.
+                Other agents will generate other sections of the README.
+                Do not try to document other parts.
+            EO_CONSTRAINT
+            '- Do not cover the end-user main requirements and prerequisites: they are already covered in other sections.',
+            '- Do not cover the contribution workflow (pull requests, CI, issues...): this is already covered in other sections.',
+            Helpers.repository_access_constraint,
+            Helpers.artifacts_access_constraint(artifact_ref(:development)),
+            Helpers.non_interactive_constraint
+          ].compact.join("\n")
         end
       end
     end

data/lib/x_aeon_agents/agents/readme/documentation_agent.rb

@@ -36,15 +36,18 @@ module XAeonAgents
             EO_INSTRUCTIONS
             **agent_params
           )
-          self.constraints = <<~EO_CONSTRAINTS
-            - Write only the required content to the output artifact file, without any additional header or title.
-            - Do NOT write any explanation or description in the artifact file: write only the required content.
-            - Only focus on the specific scope of the required documentation required.
-              Other agents will generate other sections of the README.
-              Do not try to document other parts.
-            - #{Helpers.repository_access_constraint}
-            - #{Helpers.artifacts_access_constraint(artifact_ref(:documentation))}
-          EO_CONSTRAINTS
+          self.constraints = [
+            '- Write only the required content to the output artifact file, without any additional header or title.',
+            '- Do NOT write any explanation or description in the artifact file: write only the required content.',
+            <<~EO_CONSTRAINT.rstrip,
+              - Only focus on the specific scope of the required documentation required.
+                Other agents will generate other sections of the README.
+                Do not try to document other parts.
+            EO_CONSTRAINT
+            Helpers.repository_access_constraint,
+            Helpers.artifacts_access_constraint(artifact_ref(:documentation)),
+            Helpers.non_interactive_constraint
+          ].compact.join("\n")
         end
       end
     end

data/lib/x_aeon_agents/agents/readme/features_agent.rb

@@ -38,15 +38,18 @@ module XAeonAgents
             EO_INSTRUCTIONS
             **agent_params
           )
-          self.constraints = <<~EO_CONSTRAINTS
-            - Write only the required content to the output artifact file, without any additional header or title.
-            - Do NOT write any explanation or description in the artifact file: write only the required content.
-            - Only focus on the specific scope of the required documentation required.
-              Other agents will generate other sections of the README.
-              Do not try to document other parts.
-            - #{Helpers.repository_access_constraint}
-            - #{Helpers.artifacts_access_constraint(artifact_ref(:features))}
-          EO_CONSTRAINTS
+          self.constraints = [
+            '- Write only the required content to the output artifact file, without any additional header or title.',
+            '- Do NOT write any explanation or description in the artifact file: write only the required content.',
+            <<~EO_CONSTRAINT.rstrip,
+              - Only focus on the specific scope of the required documentation required.
+                Other agents will generate other sections of the README.
+                Do not try to document other parts.
+            EO_CONSTRAINT
+            Helpers.repository_access_constraint,
+            Helpers.artifacts_access_constraint(artifact_ref(:features)),
+            Helpers.non_interactive_constraint
+          ].compact.join("\n")
         end
       end
     end

data/lib/x_aeon_agents/agents/readme/how_it_works_agent.rb

@@ -39,16 +39,19 @@ module XAeonAgents
             EO_INSTRUCTIONS
             **agent_params
           )
-          self.constraints = <<~EO_CONSTRAINTS
-            - Write only the required content to the output artifact file, without any additional header or title.
-            - Do NOT write any explanation or description in the artifact file: write only the required content.
-            - Only focus on the specific scope of the required documentation required.
-              Other agents will generate other sections of the README.
-              Do not try to document other parts.
-            - Do not provide long paragraphs: focus on readability by splitting long paragraphs into several short ones.
-            - #{Helpers.repository_access_constraint}
-            - #{Helpers.artifacts_access_constraint(artifact_ref(:how_it_works))}
-          EO_CONSTRAINTS
+          self.constraints = [
+            '- Write only the required content to the output artifact file, without any additional header or title.',
+            '- Do NOT write any explanation or description in the artifact file: write only the required content.',
+            <<~EO_CONSTRAINT.rstrip,
+              - Only focus on the specific scope of the required documentation required.
+                Other agents will generate other sections of the README.
+                Do not try to document other parts.
+            EO_CONSTRAINT
+            '- Do not provide long paragraphs: focus on readability by splitting long paragraphs into several short ones.',
+            Helpers.repository_access_constraint,
+            Helpers.artifacts_access_constraint(artifact_ref(:how_it_works)),
+            Helpers.non_interactive_constraint
+          ].compact.join("\n")
         end
       end
     end

data/lib/x_aeon_agents/agents/readme/license_agent.rb

@@ -36,15 +36,18 @@ module XAeonAgents
             EO_INSTRUCTIONS
             **agent_params
           )
-          self.constraints = <<~EO_CONSTRAINTS
-            - Write only the required content to the output artifact file, without any additional header or title.
-            - Do NOT write any explanation or description in the artifact file: write only the required content.
-            - Only focus on the specific scope of the required documentation required.
-              Other agents will generate other sections of the README.
-              Do not try to document other parts.
-            - #{Helpers.repository_access_constraint}
-            - #{Helpers.artifacts_access_constraint(artifact_ref(:license))}
-          EO_CONSTRAINTS
+          self.constraints = [
+            '- Write only the required content to the output artifact file, without any additional header or title.',
+            '- Do NOT write any explanation or description in the artifact file: write only the required content.',
+            <<~EO_CONSTRAINT.rstrip,
+              - Only focus on the specific scope of the required documentation required.
+                Other agents will generate other sections of the README.
+                Do not try to document other parts.
+            EO_CONSTRAINT
+            Helpers.repository_access_constraint,
+            Helpers.artifacts_access_constraint(artifact_ref(:license)),
+            Helpers.non_interactive_constraint
+          ].compact.join("\n")
         end
       end
     end

data/lib/x_aeon_agents/agents/readme/public_api_agent.rb

@@ -36,16 +36,19 @@ module XAeonAgents
             EO_INSTRUCTIONS
             **agent_params
           )
-          self.constraints = <<~EO_CONSTRAINTS
-            - Write only the required content to the output artifact file, without any additional header or title.
-            - Do NOT write any explanation or description in the artifact file: write only the required content.
-            - Only focus on the specific scope of the required documentation required.
-              Other agents will generate other sections of the README.
-              Do not try to document other parts.
-            - Only document public API entry points: executables and library public methods belonging to yarn `Public API` group.
-            - #{Helpers.repository_access_constraint}
-            - #{Helpers.artifacts_access_constraint(artifact_ref(:public_api))}
-          EO_CONSTRAINTS
+          self.constraints = [
+            '- Write only the required content to the output artifact file, without any additional header or title.',
+            '- Do NOT write any explanation or description in the artifact file: write only the required content.',
+            <<~EO_CONSTRAINT.rstrip,
+              - Only focus on the specific scope of the required documentation required.
+                Other agents will generate other sections of the README.
+                Do not try to document other parts.
+            EO_CONSTRAINT
+            '- Only document public API entry points: executables and library public methods belonging to yarn `Public API` group.',
+            Helpers.repository_access_constraint,
+            Helpers.artifacts_access_constraint(artifact_ref(:public_api)),
+            Helpers.non_interactive_constraint
+          ].compact.join("\n")
         end
       end
     end

data/lib/x_aeon_agents/agents/readme/quick_start_agent.rb

@@ -42,16 +42,19 @@ module XAeonAgents
             EO_INSTRUCTIONS
             **agent_params
           )
-          self.constraints = <<~EO_CONSTRAINTS
-            - Write only the required content to the output artifact file, without any additional header or title.
-            - Do NOT write any explanation or description in the artifact file: write only the required content.
-            - Only focus on the specific scope of the required documentation required.
-              Other agents will generate other sections of the README.
-              Do not try to document other parts.
-            - This section is not meant for developers: don't describe how to develop, test, document, package or contribute to this project.
-            - #{Helpers.repository_access_constraint}
-            - #{Helpers.artifacts_access_constraint(artifact_ref(:quick_start))}
-          EO_CONSTRAINTS
+          self.constraints = [
+            '- Write only the required content to the output artifact file, without any additional header or title.',
+            '- Do NOT write any explanation or description in the artifact file: write only the required content.',
+            <<~EO_CONSTRAINT.rstrip,
+              - Only focus on the specific scope of the required documentation required.
+                Other agents will generate other sections of the README.
+                Do not try to document other parts.
+            EO_CONSTRAINT
+            "- This section is not meant for developers: don't describe how to develop, test, document, package or contribute to this project.",
+            Helpers.repository_access_constraint,
+            Helpers.artifacts_access_constraint(artifact_ref(:quick_start)),
+            Helpers.non_interactive_constraint
+          ].compact.join("\n")
         end
       end
     end

data/lib/x_aeon_agents/agents/readme/requirements_agent.rb

@@ -36,15 +36,18 @@ module XAeonAgents
             EO_INSTRUCTIONS
             **agent_params
           )
-          self.constraints = <<~EO_CONSTRAINTS
-            - Write only the required content to the output artifact file, without any additional header or title.
-            - Do NOT write any explanation or description in the artifact file: write only the required content.
-            - Only focus on the specific scope of the required documentation required.
-              Other agents will generate other sections of the README.
-              Do not try to document other parts.
-            - #{Helpers.repository_access_constraint}
-            - #{Helpers.artifacts_access_constraint(artifact_ref(:requirements))}
-          EO_CONSTRAINTS
+          self.constraints = [
+            '- Write only the required content to the output artifact file, without any additional header or title.',
+            '- Do NOT write any explanation or description in the artifact file: write only the required content.',
+            <<~EO_CONSTRAINT.rstrip,
+              - Only focus on the specific scope of the required documentation required.
+                Other agents will generate other sections of the README.
+                Do not try to document other parts.
+            EO_CONSTRAINT
+            Helpers.repository_access_constraint,
+            Helpers.artifacts_access_constraint(artifact_ref(:requirements)),
+            Helpers.non_interactive_constraint
+          ].compact.join("\n")
         end
       end
     end

data/lib/x_aeon_agents/agents/review_responder_agent.rb

@@ -63,18 +63,19 @@ module XAeonAgents
           EO_INSTRUCTIONS
           **agent_params
         )
-        self.constraints = <<~EO_CONSTRAINTS
-          - You are in read-only mode for the repository: do NOT modify any file of it.
-          - The implementation work is already complete (captured in the input artifacts).
-          - ONLY focus on addressing the specific comment described in the file `#{artifact_ref(:open_comment_for_reply)}`.
-          - Do NOT answer or reply to any other comment.
-          - You already have ALL the information required.
-          - You MUST NOT ask follow-up questions.
-          - You MUST NOT ask for user confirmation.
-          - Write the reply text to the output artifact file `#{artifact_ref(:reply)}`.
-          - #{Helpers.repository_access_constraint}
-          - #{Helpers.artifacts_access_constraint(artifact_ref(:reply))}
-        EO_CONSTRAINTS
+        self.constraints = [
+          '- You are in read-only mode for the repository: do NOT modify any file of it.',
+          '- The implementation work is already complete (captured in the input artifacts).',
+          "- ONLY focus on addressing the specific comment described in the file `#{artifact_ref(:open_comment_for_reply)}`.",
+          '- Do NOT answer or reply to any other comment.',
+          '- You already have ALL the information required.',
+          '- You MUST NOT ask follow-up questions.',
+          '- You MUST NOT ask for user confirmation.',
+          "- Write the reply text to the output artifact file `#{artifact_ref(:reply)}`.",
+          Helpers.repository_access_constraint,
+          Helpers.artifacts_access_constraint(artifact_ref(:reply)),
+          Helpers.non_interactive_constraint
+        ].compact.join("\n")
       end
     end
   end

data/lib/x_aeon_agents/agents/tester_agent.rb

@@ -59,10 +59,11 @@ module XAeonAgents
           EO_OBJECTIVE
           **agent_params
         )
-        self.constraints = <<~EO_CONSTRAINTS
-          - #{Helpers.repository_access_constraint(writable: true)}
-          - #{Helpers.artifacts_access_constraint(artifact_ref(:plan_modifications))}
-        EO_CONSTRAINTS
+        self.constraints = [
+          Helpers.repository_access_constraint(writable: true),
+          Helpers.artifacts_access_constraint(artifact_ref(:plan_modifications)),
+          Helpers.non_interactive_constraint
+        ].compact.join("\n")
         self.system_instructions = <<~EO_INSTRUCTIONS
           #{Helpers.repository_access_system_instructions}
 

data/lib/x_aeon_agents/helpers.rb

@@ -159,28 +159,44 @@ module XAeonAgents
       end
 
       # Get the constraint restricting the files agents are allowed to access.
-      # This constraint is format-agnostic: it does not include any formatting (bullet, header...) so that it can be
-      # included in any constraints section.
+      # Constraints are rendered as Markdown bullet lists: the returned sentence includes its own bullet prefix.
       #
       # @param writable [Boolean] True if the agent is allowed to write files, false if it is read-only
       # @return [String] The constraint restricting the agents' file accesses to the current repository
       def repository_access_constraint(writable: false)
-        "You should only #{writable ? 'read and write' : 'read'} files that are part of the current repository: `#{Dir.pwd}`"
+        "- You should only #{writable ? 'read and write' : 'read'} files that are part of the current repository: `#{Dir.pwd}`"
       end
 
       # Get the constraint allowing agents to access their artifact files, which can be located outside of the
       # current repository.
-      # This constraint is format-agnostic: it does not include any formatting (bullet, header...) so that it can be
-      # included in any constraints section.
+      # Constraints are rendered as Markdown bullet lists: the returned sentence includes its own bullet prefix.
+      # A nil is returned when no artifact path is given, so that callers can interpolate the result
+      # unconditionally in an array of constraint lines and simply compact the array.
       #
       # @param artifact_paths [Array<String>] Absolute paths of the artifact files the agent is allowed to access
-      # @return [String] The constraint about artifact files access
+      # @return [String, nil] The constraint about artifact files access, or nil when no artifact path is given
       def artifacts_access_constraint(*artifact_paths)
-        'You are allowed to read and write the artifact files at ' \
+        return nil if artifact_paths.empty?
+
+        '- You are allowed to read and write the artifact files at ' \
           "#{artifact_paths.map { |artifact_path| "`#{artifact_path}`" }.join(', ')}, " \
           'even if they are not part of the current repository'
       end
 
+      # Get the constraint forbidding the agent from using the ask_question tool when no human user is available.
+      # Constraints are rendered as Markdown bullet lists: the returned sentence includes its own bullet prefix.
+      # A nil is returned when the interactive mode is enabled, so that callers can interpolate the result
+      # unconditionally in an array of constraint lines and simply compact the array.
+      #
+      # @return [String, nil] The constraint about not asking questions, or nil when the interactive mode is enabled
+      def non_interactive_constraint
+        return nil if Config.interactive
+
+        '- You MUST NOT use the ask_question tool under any circumstances: ' \
+          'you are running in non-interactive mode with no human user available, ' \
+          'so proceed using your best judgment without asking'
+      end
+
       # Allow user to review and edit content before using it
       #
       # When the interactive mode is disabled (Config.interactive), no review file

data/lib/x_aeon_agents/version.rb

@@ -2,5 +2,5 @@ module XAeonAgents
   # @!group Global API
 
   # Gem version
-  VERSION = '2.7.1'
+  VERSION = '2.8.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: x_aeon_agents
 version: !ruby/object:Gem::Version
-  version: 2.7.1
+  version: 2.8.0
 platform: ruby
 authors:
 - Muriel Salvan