x_aeon_agents 1.0.28 → 1.0.31

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 274bac6b54d8088177db949e35844922ef51bafc121cf9e9f6816c86c53aecb8
-  data.tar.gz: 8841173b7bda8326b7db717401be6ce48e2245306c79237471a41f01ee3c84e4
+  metadata.gz: a3ff43b4352a549cc20bf1b286d89aa551f549c6109811c7456c3393e39f3184
+  data.tar.gz: 5671b1fe28a848307a12316ce54e962db5a67c3a6b0872c6f3034ca0c7c2478e
 SHA512:
-  metadata.gz: 9b3653983e16b09d893bf1d165cd752f3998ecd0b983a738d207ee9c03b2eb7030a44fa4f0639b981393db59d8ab644de79a40645913b6652dd375b2ba417dcd
-  data.tar.gz: f226b0a89b9c0348f975d23bf1d31a646e436cf737fab675f8a6ecb707b3540e7e83e0a8e3f000f621e04e3ca43018b73329adbe573a437baeb2dbc2d8d40768
+  metadata.gz: 184273cc4819f1aaa01dc74f51a6319b8a5d30e5e7dddf83a85fadb52d14246c9a3b136a46ab39eccc43e99ee38d1a9ed7bbb36a52a698e5a32cd73fe554239e
+  data.tar.gz: 0b5e05209e2e5a03d3de7c411e2686a9ee5672a343f27b81ba202ef5821ca97f40e0fd5a4003d19c81a3c7aaa7863d2ac3ee2f9d03fce4a6da0e17cd731a988d

data/CHANGELOG.md

@@ -1,3 +1,45 @@
+# [v1.0.31](https://github.com/Muriel-Salvan/x_aeon_agents/compare/v1.0.30...v1.0.31) (2026-09-10 15:11:18)
+
+### Patches
+
+* [chore: switch to cleanroom-next and RubyGems trusted publishing](https://github.com/Muriel-Salvan/x_aeon_agents/commit/26c07f2ba1b42500032d1f7d6055b3351ff5b95d)
+
+# [v1.0.30](https://github.com/Muriel-Salvan/x_aeon_agents/compare/v1.0.29...v1.0.30) (2026-09-09 13:21:12)
+
+### Patches
+
+* [Status logging](https://github.com/Muriel-Salvan/x_aeon_agents/commit/aac424c29176810f081cd5ba4435c4f19b7a27f7)
+* [fix(config): pass through SecretString returned by config DSL](https://github.com/Muriel-Salvan/x_aeon_agents/commit/16baaf8161384f6d206e60f606af48cd6cb6118a)
+* [test: stub AI model discovery in unit tests](https://github.com/Muriel-Salvan/x_aeon_agents/commit/10416fce4bbbd65c2539b7f386812bf5f5bc643b)
+* [feat: make test command configurable and skip tests when unset](https://github.com/Muriel-Salvan/x_aeon_agents/commit/1e238bde0e24bf2443a3f4acad3cc2c43cbad144)
+* [test: update git diff interpreter agent specs for artifact-based assertions](https://github.com/Muriel-Salvan/x_aeon_agents/commit/5637a822714c889f08d609e7202b8a124ed2b582)
+* [ci: relax rubocop rules and clean up test helper](https://github.com/Muriel-Salvan/x_aeon_agents/commit/87147dfe7918147b92f2dc9353b65394fc9f24a9)
+* [test: add CLI scenario specs for all commands](https://github.com/Muriel-Salvan/x_aeon_agents/commit/8faddbb3595a61187325753e7476c6be3bcca1d5)
+* [test: replace inline strings with heredocs in scenario specs](https://github.com/Muriel-Salvan/x_aeon_agents/commit/c4b4a326b375279208ad756e7d5f3be96899cc5d)
+* [test(agents): add integration specs for git workflow agents](https://github.com/Muriel-Salvan/x_aeon_agents/commit/182c66f3abadca3c8d4a396efb473b3c0cd7a786)
+* [Prepare for logging work](https://github.com/Muriel-Salvan/x_aeon_agents/commit/fad1d84e8e18a3934cdaf6ad62d22c40e35ad303)
+* [test: add common behavior specs for all XAeonAgents agents](https://github.com/Muriel-Salvan/x_aeon_agents/commit/4cb6944489d5e67c6d614f4b764cae4313decec2)
+* [test: cover config DSL behaviors in agent defaults examples](https://github.com/Muriel-Salvan/x_aeon_agents/commit/687edc40286b8c4f7e069df2b4cbd5334ad87976)
+* [test: extract AgentDefaults specs into shared examples](https://github.com/Muriel-Salvan/x_aeon_agents/commit/42c9f3bf9c0e64a3ce9d1f6d7223ec6751723dc4)
+* [refactor: replace puts calls with Logger helpers in agents](https://github.com/Muriel-Salvan/x_aeon_agents/commit/cf2245c702dae65fa2dd86d2f800304aa4b5c3f6)
+* [refactor: replace AgentOptions with default kwargs in AgentDefaults](https://github.com/Muriel-Salvan/x_aeon_agents/commit/9926870315499417fa6c8a43b2853b7a4fc2aa47)
+* [feat: add configure_agent DSL for per-class agent defaults](https://github.com/Muriel-Salvan/x_aeon_agents/commit/5c900d9234a4ff96eeef148651dc24308c3675db)
+* [feat(config): add on_open_worktree callback for worktree opening](https://github.com/Muriel-Salvan/x_aeon_agents/commit/c7ae1daa85859e1a789f2af9b80cf704fb9b664f)
+* [feat: add setup_project config DSL for fresh worktree setup](https://github.com/Muriel-Salvan/x_aeon_agents/commit/23f7e3c8468724f1b153e0950aef1eaf552c7009)
+* [feat(config): support X_AEON_AGENTS_CONFIG env var for config path](https://github.com/Muriel-Salvan/x_aeon_agents/commit/c6e33adf35dc35d717eb08469fa59a8bc7e8a542)
+* [fix(planner): run Diffy in unbundled env for system calls](https://github.com/Muriel-Salvan/x_aeon_agents/commit/14dca12662241b1291e697f3fdd59584dafa18ff)
+* [feat(config): support custom secret providers in config file](https://github.com/Muriel-Salvan/x_aeon_agents/commit/c48952f42f48f8f7fc52846ff13c1b954846c606)
+* [feat(skills): add addressing-pull-request-comments skill config](https://github.com/Muriel-Salvan/x_aeon_agents/commit/d720fe13ea8dd07cda4ed6eb0c683ba43fa1442c)
+* [Merge branch 'config-file'](https://github.com/Muriel-Salvan/x_aeon_agents/commit/116b67eb92193572b8373ebc3b4749e524b6044c)
+
+# [v1.0.29](https://github.com/Muriel-Salvan/x_aeon_agents/compare/v1.0.28...v1.0.29) (2026-08-21 14:06:00)
+
+### Patches
+
+* [chore: add TODOs and update API key descriptions](https://github.com/Muriel-Salvan/x_aeon_agents/commit/7eab6bf59ac760ed6b1b81580b9c9a65a5b9aaca)
+* [fix: use raw git push command to set upstream tracking](https://github.com/Muriel-Salvan/x_aeon_agents/commit/b13498c5e69a30bdb3e7d90aa25d27c230f1fb21)
+* [refactor: simplify git push mock assertions in specs](https://github.com/Muriel-Salvan/x_aeon_agents/commit/a70f024ba93ace278ae007baf61a2ad83530d735)
+
 # [v1.0.28](https://github.com/Muriel-Salvan/x_aeon_agents/compare/v1.0.27...v1.0.28) (2026-07-14 17:05:02)
 
 ### Patches

data/README.md

@@ -33,6 +33,7 @@ Use it as a **⚡ CLI** in your terminal or as a **📦 library** inside your Ru
   - [Prerequisites](#prerequisites)
   - [Install](#install)
   - [Configure](#configure)
+    - [Optional configuration file](#optional-configuration-file)
   - [Use the CLI](#use-the-cli)
   - [Use as a library](#use-as-a-library)
 - [Requirements](#requirements)
@@ -109,6 +110,72 @@ export OPENROUTER_API_KEY="sk-or-..."
 export GITHUB_TOKEN="ghp_..."
 ```
 
+### Optional configuration file
+
+You can fine-tune behaviour with an optional `.x_aeon_agents.rb` configuration file, read at the start of every `xaa` command:
+
+- `~/.x_aeon_agents.rb` — in your **home directory**, for *global / user-level* settings;
+- `.x_aeon_agents.rb` — in the **current project directory**, for *project-level* settings;
+- any path stored in the **`X_AEON_AGENTS_CONFIG`** environment variable, for *explicitly designated* settings.
+
+When several exist, they are evaluated in that order and the last one wins: the project file overrides the global one, and the `X_AEON_AGENTS_CONFIG` file overrides them both. Exposed directives:
+
+- `debug true` / `debug false` — enable or disable debug logging. An explicit `--debug` / `--no-debug` command-line flag always overrides it, and when neither the file nor a flag sets a value, the `X_AEON_AGENTS_DEBUG` environment variable is still honoured.
+- `cline_api_key`, `openrouter_api_key` and `github_token` — declare, using a block, custom Ruby code to retrieve the corresponding secret when it is needed, instead of relying on the `CLINE_API_KEY` / `OPENROUTER_API_KEY` / `GITHUB_TOKEN` environment variables:
+
+```ruby
+cline_api_key do
+  # Any Ruby code that returns the key
+  File.read('/path/to/my/key').strip
+end
+```
+
+The block is evaluated lazily, only the first time the secret is actually needed, and its result is then cached for the whole session.
+- `setup_project` — declare, using a block, the steps to execute in a freshly created git worktree to install the project's dependencies (used by the `start-task` command):
+
+```ruby
+setup_project do
+  system 'bundle install'
+end
+```
+
+The block is evaluated right after the worktree has been created, with the current directory set to the worktree. If it is not defined, no setup step is executed.
+- `test_project_cmd` — declare the command line used to run the project's tests suite, executed by the `implement` command after each code change and after each fix made by the Tester agent:
+
+```ruby
+test_project_cmd 'bundle exec rspec'
+```
+
+If it is not defined, the `implement` command does not run any tests.
+- `on_open_worktree` — declare, using a block, a callback to execute every time the `start-task` command opens a worktree (freshly created or already existing), after the branch has been pushed to the remote. The block is given the worktree's directory as parameter:
+
+```ruby
+on_open_worktree do |dir|
+  system "VSCodium.exe \"#{dir}\""
+end
+```
+
+If it is not defined, nothing is executed when a worktree is opened.
+
+- `configure_agent` — declare, using a block, the default kwargs to be used when initializing agents of a given class. The block is evaluated every time an agent of this class is instantiated: it is given the currently merged configuration of the agent (a Hash of kwargs, that can be modified in place), and can return a Hash of additional kwargs to be merged into this configuration:
+
+```ruby
+configure_agent(:PlanGeneratorAgent) do
+  {
+    model: 'deepseek/deepseek-v4-flash',
+    cli_options: { plan: true }
+  }
+end
+
+configure_agent(:PlanGeneratorAgent) do |agent_config|
+  agent_config[:skills].push('applying-ruby-conventions')
+  agent_config
+end
+```
+
+This method is re-entrant: it can be called several times for the same agent class, from the same config file or from different ones (global, project, env-var designated): each call sees the configuration accumulated by the previous ones, in the order the config files are evaluated. This lets a global config define base settings, and a project config read and adapt them.
+For example, to always run in debug mode inside a given project, create a `.x_aeon_agents.rb` file in that project directory containing `debug true`.
+
 ### Use the CLI
 
 The `xaa` command is installed alongside the gem. Run it from inside any Git repository.
@@ -174,6 +241,8 @@ XAeonAgents::Agents::CommitterAgent.new.run
 - **`OPENROUTER_API_KEY`** environment variable — an OpenRouter API key that powers the AI agents through RubyLLM
 - **`CLINE_API_KEY`** environment variable (optional) — only required when driving the Cline agent integration
 
+Each of these secrets can alternatively be retrieved by custom code declared in the [optional configuration file](#optional-configuration-file).
+
 ## Features
 
 **x_aeon_agents** provides a *`xaa`* command-line interface and a reusable Ruby library that package a suite of AI agents to automate everyday development workflows.
@@ -233,24 +302,7 @@ Public methods:
 - `data_dir` / `data_dir=` — X-Aeon Agents data directory. [doc](https://www.rubydoc.info/gems/x-aeon_agents/XAeonAgents/Config#data_dir-class_method)
 - `default_cline_cli_args` / `default_cline_cli_args=` — default Cline CLI arguments. [doc](https://www.rubydoc.info/gems/x-aeon_agents/XAeonAgents/Config#default_cline_cli_args-class_method)
 - `debug` / `debug=` — debug mode. [doc](https://www.rubydoc.info/gems/x-aeon_agents/XAeonAgents/Config#debug-class_method)
-- `agent_options` — the available `AgentOptions` instance. [doc](https://www.rubydoc.info/gems/x-aeon_agents/XAeonAgents/Config#agent_options-class_method)
-
-### `XAeonAgents::AgentOptions`
-
-Provides agent options (model, strategy, etc.) keyed by agent category. These options can be passed to an agent's constructor.
-
-**Usecase** — read the options for a given category:
-
-```ruby
-opts = XAeonAgents::Config.agent_options['free_simple']
-# => { model: 'openrouter/free', strategy: ComposableAgents::PromptRenderingStrategy::Markdown }
-```
-
-More details: [RubyDoc — XAeonAgents::AgentOptions](https://www.rubydoc.info/gems/x-aeon_agents/XAeonAgents/AgentOptions)
-
-Public methods:
-- `[](agent_category)` — get the options for a category (lazily evaluated). [doc](https://www.rubydoc.info/gems/x-aeon_agents/XAeonAgents/AgentOptions#%5B%5D-instance_method)
-- `[]=(agent_category, agent_options)` — set the options for a category. [doc](https://www.rubydoc.info/gems/x-aeon_agents/XAeonAgents/AgentOptions)
+- `config_paths` — locate the optional `.x_aeon_agents.rb` config file(s) (home dir, then project dir). [doc](https://www.rubydoc.info/gems/x-aeon_agents/XAeonAgents/Config)
 
 ### `XAeonAgents::GenHelpers`
 
@@ -314,7 +366,7 @@ The documented public methods (browseable on RubyDoc.info):
 
 ### Entry point 🚪
 
-The `xaa` executable ([`bin/xaa`](https://github.com/Muriel-Salvan/x_aeon_agents/blob/main/bin/xaa)) boots Zeitwerk auto-loading and calls `XAeonAgents::Cli.start(ARGV)`. The CLI ([`lib/x_aeon_agents/cli.rb`](https://github.com/Muriel-Salvan/x_aeon_agents/blob/main/lib/x_aeon_agents/cli.rb)) is a [Thor](https://github.com/rails/thor) application: each sub-command maps **1:1** to an agent and forwards global options (`--session-id`, `--debug`).
+The `xaa` executable ([`bin/xaa`](https://github.com/Muriel-Salvan/x_aeon_agents/blob/main/bin/xaa)) boots Zeitwerk auto-loading and calls `XAeonAgents::Cli.start(ARGV)`. The CLI ([`lib/x_aeon_agents/cli.rb`](https://github.com/Muriel-Salvan/x_aeon_agents/blob/main/lib/x_aeon_agents/cli.rb)) is a [Thor](https://github.com/rails/thor) application: each sub-command maps **1:1** to an agent and forwards global options (`--session-id`, `--debug`). On startup, it also reads the optional `.x_aeon_agents.rb` configuration file (home directory, then project directory) so project-level settings can override global ones, and explicit command-line flags override both.
 
 ### Agents as composable workflows 🧩
 
@@ -327,6 +379,7 @@ Each agent is enriched by the `AgentDefaults` mixin ([`lib/x_aeon_agents/agent_d
 
 - injects `new_agent(...)`, `step(...)` and `step_agent(...)` to build multi-step pipelines;
 - auto-configures the underlying frameworks (`setup_composable_agents`, `setup_ai_agents`, `setup_cline`);
+- sets default constructor kwargs for the underlying AI framework (`strategy` for AI agents, `api_key` + `cli_options` for Cline agents), which can be overwritten per agent class with the `configure_agent` config DSL;
 - manages a per-session directory under `Config.data_dir/sessions/<id>`;
 - prepends `ArtifactContract` + `Resumable` mixins for input/output validation and pause/resume.
 
@@ -352,7 +405,7 @@ flowchart TD
 
 ### Configuration & providers 🔐
 
-[`XAeonAgents::Config`](https://www.rubydoc.info/gems/x-aeon_agents/XAeonAgents/Config) is a singleton holding secrets (`cline_api_key`, `openrouter_api_key`, `github_token`), the data directory, debug flag and per-category `AgentOptions` (model + strategy, e.g. `free_simple`, `free_complex`). LLM access flows through `Providers::Cline` ([`lib/x_aeon_agents/providers/cline.rb`](https://github.com/Muriel-Salvan/x_aeon_agents/blob/main/lib/x_aeon_agents/providers/cline.rb)), an OpenAI-compatible [RubyLLM](https://github.com/crmne/ruby_llm) provider targeting the Cline API.
+[`XAeonAgents::Config`](https://www.rubydoc.info/gems/x-aeon_agents/XAeonAgents/Config) is a singleton holding secrets (`cline_api_key`, `openrouter_api_key`, `github_token`), the data directory and debug flag. Agents' options (model, strategy, ...) can be customized per agent class with the `configure_agent` config DSL. LLM access flows through `Providers::Cline` ([`lib/x_aeon_agents/providers/cline.rb`](https://github.com/Muriel-Salvan/x_aeon_agents/blob/main/lib/x_aeon_agents/providers/cline.rb)), an OpenAI-compatible [RubyLLM](https://github.com/crmne/ruby_llm) provider targeting the Cline API.
 
 ### Skills & ERB templating 📚
 

data/lib/x_aeon_agents/agent_defaults.rb

@@ -2,13 +2,23 @@ module XAeonAgents
   # Mixin setting up default settings for agents.
   # This mixin is meant to be the last prepended mixin in all Agent classes.
   module AgentDefaults
+    # Give all agents access to the shared logger instance.
+    #
+    # @return [Logger] The shared logger instance
+    def logger
+      Config.logger
+    end
+
     class << self
-      # Get the singleton session ID.
-      # If it is the first time it is invoked, use a default session ID.
+      # @return [String] The singleton session ID. If it is the first time it is invoked, use a default session ID.
       def singleton_session_id
         @singleton_session_id ||= Time.now.utc.strftime('%Y-%m-%d-%H-%M-%S-%N')
       end
+
+      # @return [Array<Agent>] List of root agents (not instantiated from another agent).
+      attr_accessor :root_agents
     end
+    AgentDefaults.root_agents = []
 
     # Instantiate a new agent.
     # Transfer the same session to the new agent.
@@ -18,7 +28,7 @@ module XAeonAgents
     # @param kwargs [Hash] Constructor kwargs
     # @return [ComposableAgents::Agent] The new agent
     def new_agent(agent_class, *args, **kwargs)
-      agent_class.new(*args, session_id: @session_id, **kwargs)
+      agent_class.new(*args, session_id: @session_id, parent_agent: self, **kwargs)
     end
 
     # Hook called when this mixin is prepended in a class
@@ -32,17 +42,33 @@ module XAeonAgents
         Module.new do
           # Constructor
           #
-          # @param args [Array] Agent's constructor arguments
-          # @param session_id [String, nil] Specific X-Aeon session id to be used, or nil if none
-          # @param kwargs [Array] Agent's constructor kwargs
-          def initialize(*args, session_id: nil, **kwargs)
+          # @param args [Array] Agent's constructor arguments.
+          # @param session_id [String, nil] Specific X-Aeon session id to be used, or nil if none.
+          # @param parent_agent [Agent, nil] Agent that is initializing this agent, or nil if none.
+          # @param kwargs [Array] Agent's constructor kwargs.
+          def initialize(*args, session_id: nil, parent_agent: nil, **kwargs)
+            AgentDefaults.root_agents << self if parent_agent.nil?
             # If we inherit from some frameworks initialize them now.
             Config.setup_composable_agents
-            case self
-            when ComposableAgents::AiAgents::Agent
-              Config.setup_ai_agents
-            when ComposableAgents::Cline::Agent
-              Config.setup_cline
+            kwargs_from_agent_defaults =
+              case self
+              when ComposableAgents::AiAgents::Agent
+                Config.setup_ai_agents
+                {
+                  strategy: ComposableAgents::PromptRenderingStrategy::Markdown
+                }
+              when ComposableAgents::Cline::Agent
+                Config.setup_cline
+                {
+                  api_key: Config.cline_api_key,
+                  cli_options: Config.default_cline_cli_args
+                }
+              else
+                {}
+              end
+            kwargs_from_config = kwargs_from_agent_defaults
+            Config.agent_config_procs(self.class.name.split('::').last.to_sym).each do |config_proc|
+              kwargs_from_config = kwargs_from_config.merge(config_proc.call(kwargs_from_config))
             end
             @session_id = session_id || AgentDefaults.singleton_session_id
             @session_dir = "#{Config.data_dir}/sessions/#{@session_id}"
@@ -50,9 +76,56 @@ module XAeonAgents
               *args,
               composable_agents_dir: "#{@session_dir}/composable_agents",
               run_id: "#{@session_id}-#{kwargs[:name] || self.class.name.split('::').last}",
-              **kwargs
+              logger: Config.logger,
+              **kwargs_from_config.merge(kwargs)
             )
           end
+
+          # Define a task that is resumable and that will log big steps of an agent.
+          # A task can be nested in other tasks.
+          #
+          # @param task_ref [Symbol, ComposableAgents::Agent] Task reference: can be an ID or an Agent to be run.
+          # @param name [String] Task name (used in status and logs).
+          # @param intent [String] Task intent (used in logs).
+          # @param kwargs [Hash{Symbol => Object}] Additional input artifacts to merge before the task executes.
+          # @yield The code called for this task if it is not an Agent.
+          def task(
+            task_ref = :task,
+            name: task_ref.is_a?(ComposableAgents::Agent) ? task_ref.name : task_ref.to_s,
+            intent: 'Execute',
+            **kwargs,
+            &
+          )
+            @step_metadata = {
+              name:,
+              intent:
+            }
+            artifacts_before = @artifacts.clone
+            logger.info "[Task #{name}] - #{intent}"
+            if task_ref.is_a?(Symbol)
+              step(task_ref, **kwargs, &)
+            else
+              step_agent(task_ref, **kwargs)
+            end
+            added_artifacts = @artifacts.keys - artifacts_before.keys
+            logger.info "[Task #{name}] - Created #{added_artifacts.size} new artifacts: #{added_artifacts.join(', ')}"
+          end
+
+          private
+
+          # Override record_step to inject the metadata into the step node.
+          #
+          # @param step_name [Symbol] Name of the step, mirroring the one used by the persisted steps.
+          # @param agent [ComposableAgents::Agent, nil] The agent run by this step, or nil for plain steps.
+          # @param extra_input_artifacts [Hash{Symbol => Object}] Input artifacts given to the step.
+          # @yield The code of the step to be executed
+          def record_step(step_name:, agent:, extra_input_artifacts:, &block)
+            super do
+              @current_step_node[:metadata] = @step_metadata if @step_metadata
+              @step_metadata = nil
+              block&.call
+            end
+          end
         end
       )
     end

data/lib/x_aeon_agents/agents/coder_agent.rb

@@ -69,11 +69,6 @@ module XAeonAgents
             Always provide the final result in your response.
             Always validate your answer with checking the code and running it if possible.
           EO_CONSTRAINTS
-          skills: %w[
-            applying-ruby-conventions
-            applying-test-conventions
-            enforcing-project-rules
-          ],
           **agent_params
         )
       end

data/lib/x_aeon_agents/agents/committer_agent.rb

@@ -24,25 +24,32 @@ module XAeonAgents
       #
       # @return [Hash{Symbol => Object}] Output artifacts content
       def run
+        super
         case @stage
         when :all
-          Helpers.git.add(all: true)
+          task(:git_add, name: 'Git add', intent: 'Stage all modifications') do
+            Helpers.git.add(all: true)
+          end
         when :if_empty
-          Helpers.git.add(all: true) if Helpers.git_diff_cached.empty?
+          if Helpers.git_diff_cached.empty?
+            task(:git_add, name: 'Git add', intent: 'Stage all modifications as nothing was staged previously') do
+              Helpers.git.add(all: true)
+            end
+          end
         when :none
           # Do nothing
         else
           raise "Unknown staging strategy: #{@stage}"
         end
         if Helpers.git_diff_cached.empty?
-          log_debug 'Nothing to commit'
+          logger.info 'Nothing to commit'
         else
           git_diff_interpreter_agent = GitDiffInterpreterAgent.new
-          git_diff_interpreter_agent_output = git_diff_interpreter_agent.run(git_ref_base: 'cached')
+          task(git_diff_interpreter_agent, intent: 'Analyze staged git diffs', git_ref_base: 'cached')
           content = <<~EO_COMMIT
-            #{git_diff_interpreter_agent_output[:one_line_summary].strip}
+            #{@artifacts[:one_line_summary].strip}
 
-            #{git_diff_interpreter_agent_output[:change_intent].strip}
+            #{@artifacts[:change_intent].strip}
 
             Co-authored by X-Aeon AI Agents:
             #{
@@ -52,17 +59,19 @@ module XAeonAgents
             }
           EO_COMMIT
           if @user_review
-            content, _user_prompt = Helpers.review_content(
-              name: 'commit.md',
-              description: 'Git commit comment',
-              editable: true,
-              content:
-            )
+            task(:user_review, name: 'Commit comment user review', intent: 'Ask user to review the commit comment') do
+              content, _user_prompt = Helpers.review_content(
+                name: 'commit.md',
+                description: 'Git commit comment',
+                editable: true,
+                content:
+              )
+            end
           end
-          Helpers.git.commit(content)
-
-          puts
-          puts 'Commit created successfully.'
+          task(:git_commit, name: 'Git commit', intent: 'Create a commit') do
+            Helpers.git.commit(content)
+          end
+          logger << 'Commit created successfully.'
         end
         {}
       end