Skip to content

"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/

Python

docs: add step budget guidance for subagent builds

Locodocowwc4d7e78719a3
diff --git a/reasonix-skill/README.md b/reasonix-skill/README.md
index 6b085a3ba..65966c9a4 100644
--- a/reasonix-skill/README.md
+++ b/reasonix-skill/README.md
@@ -24,6 +24,15 @@ cd CLI-Anything\reasonix-skill
Both scripts copy the skill to Reasonix's global skill directory at `~/.reasonix/skills/cli-anything`.
+## Configuration Note
+
+A full CLI-Anything build (architecture analysis, 10+ file generation, installation, and multiple test runs) typically requires 25–40 tool-call rounds. Reasonix's subagent step budget is derived from the `agent.max_steps` setting in `reasonix.toml`:
+
+- The default `max_steps = 0` means unlimited, which is recommended for this workflow.
+- If you have set `max_steps` to a finite value, the subagent receives half that budget (minimum 5), which may cause a build to be truncated before completion.
+
+To ensure builds complete successfully, set `agent.max_steps = 0` in your `reasonix.toml`, or use a sufficiently high value such as 64 or more.
+
## Usage
After installation, invoke the skill in any Reasonix session:
diff --git a/reasonix-skill/SKILL.md b/reasonix-skill/SKILL.md
index c91d479b0..f24056e91 100644
--- a/reasonix-skill/SKILL.md
+++ b/reasonix-skill/SKILL.md
@@ -51,6 +51,15 @@ Reasonix agents build harnesses by combining these built-in tools:
**Phase 7 (Packaging)** — Use `write_file` for setup.py, `bash` for `pip install -e .` and `which cli-anything-<software>` verification.
+## Step Budget
+
+A full harness build typically requires 25–40 tool-call rounds (architecture inspection, 10+ file writes, installation, and multiple test runs). When invoked via `run_skill`, the subagent inherits a step budget derived from the parent agent's `agent.max_steps` setting in `reasonix.toml`:
+
+- If `max_steps = 0` (the default, meaning unlimited), the subagent also runs with no step cap — this is the recommended configuration for the CLI-Anything workflow.
+- If `max_steps` is set to a finite value, the subagent receives half that budget (minimum 5), which may truncate a complex build before completion.
+
+Users who have configured a finite `max_steps` should ensure it is set to 0 or a sufficiently high value (e.g., 64 or more) before running a CLI-Anything build, so the subagent has enough rounds to complete all seven phases.
+
## Modes
### Build