"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.mdindex 6b085a3ba..65966c9a4 100644--- a/reasonix-skill/README.md+++ b/reasonix-skill/README.md@@ -24,6 +24,15 @@ cd CLI-Anything\reasonix-skillBoth 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.+## UsageAfter installation, invoke the skill in any Reasonix session:diff --git a/reasonix-skill/SKILL.md b/reasonix-skill/SKILL.mdindex 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