helloagents 2.2.12 → 2.2.16

package/README.md

@@ -8,7 +8,7 @@
 
 **A multi-CLI workflow system that keeps going until tasks are implemented and verified.**
 
-[![Version](https://img.shields.io/badge/version-2.2.12-orange.svg)](./pyproject.toml)
+[![Version](https://img.shields.io/badge/version-2.2.16-orange.svg)](./pyproject.toml)
 [![npm](https://img.shields.io/npm/v/helloagents.svg)](https://www.npmjs.com/package/helloagents)
 [![Python](https://img.shields.io/badge/python-%3E%3D3.10-3776AB.svg)](./pyproject.toml)
 [![Commands](https://img.shields.io/badge/workflow_commands-15-6366f1.svg)](./helloagents/functions)
@@ -84,7 +84,7 @@ Compared with legacy multi-bundle releases, the v2.x line is now package-first w
 
 **RLM sub-agent orchestration**
 
-5 specialized roles (reviewer, synthesizer, kb_keeper, pkg_keeper, writer) plus host CLI native sub-agents (explore/implement/test/design) are dispatched automatically based on task complexity, with session isolation per CLI instance. Supports cross-CLI parallel scheduling and Agent Teams collaboration.
+5 specialized roles (reviewer, synthesizer, kb_keeper, pkg_keeper, writer) plus host CLI native sub-agents (explore/implement/test/design) are dispatched automatically based on task complexity, with session isolation per CLI instance. Tasks are scheduled via DAG dependency analysis with layer-by-layer parallel dispatch. Supports cross-CLI parallel scheduling and Agent Teams collaboration.
 
 **Your gain:** complex tasks are broken down and handled by the right specialist, with parallel execution when possible.
 </td>
@@ -268,9 +268,11 @@ L0 user memory (global preferences), L1 project knowledge base (structured docs
 > ⚠️ **Codex CLI config.toml compatibility notes:** The following settings may affect HelloAGENTS:
 > - `[features]` `steer = true` — changes input submission behavior, may interfere with workflow interaction
 > - `[features]` `child_agents_md = true` — experimental, injects extra instructions that may conflict with HelloAGENTS
-> - `project_doc_max_bytes` too low — default 32KB, AGENTS.md will be truncated (auto-set to 98304 during install)
+> - `project_doc_max_bytes` too low — default 32KB, AGENTS.md will be truncated (auto-set to 131072 during install)
 > - `agent_max_depth = 1` — limits sub-agent nesting depth, recommend keeping default or ≥2
 > - `agent_max_threads` too low — default 6, lower values limit parallel sub-agent scheduling
+> - `[features]` `multi_agent = true` — must be enabled for sub-agent orchestration to work
+> - Collab sub-agent scheduling is experimental, requires Codex CLI feature gate to be enabled
 
 ### Claude Code example
 
@@ -296,6 +298,11 @@ L0 user memory (global preferences), L1 project knowledge base (structured docs
 
     helloagents update
 
+> 💡 **Claude Code sub-agent orchestration tips:**
+> - Sub-agents (Task tool) work out of the box, no extra configuration needed
+> - Agent Teams collaboration mode requires environment variable: `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`
+> - Parallel sub-agent count is managed automatically by the model, no user-side limit config needed
+
 ### Beta branch
 
 To install from the `beta` branch, append `@beta` to the repository URL:
@@ -321,7 +328,7 @@ To install from the `beta` branch, append `@beta` to the repository URL:
 1. Install the package (script/pip/uv) and run `helloagents` to launch an interactive menu for selecting target CLIs (or specify directly with `helloagents install <target>`). Hooks and SKILL.md are auto-deployed during installation.
 2. In AI chat, every input is scored on five dimensions and routed to R0–R3.
 3. R2/R3 tasks enter the stage chain: EVALUATE → DESIGN → DEVELOP. R1 fast flow handles single-point operations directly.
-4. RLM dispatches native sub-agents and specialized roles based on task complexity. Supports parallel scheduling and Agent Teams for complex tasks.
+4. RLM dispatches native sub-agents and specialized roles based on task complexity. Tasks with dependencies are scheduled via DAG topological sort with layer-by-layer parallel dispatch.
 5. EHRB scans each step for destructive operations; risky actions require explicit user confirmation. Hooks provide additional pre-tool safety checks when available.
 6. Three-layer memory (user / project KB / session) preserves context across sessions.
 7. Stage chain completes with verified output and optional knowledge base sync.
@@ -330,7 +337,7 @@ To install from the `beta` branch, append `@beta` to the repository URL:
 
 - AGENTS.md: router and workflow protocol
 - SKILL.md: skill discovery metadata for CLI targets
-- pyproject.toml: package metadata (v2.2.12)
+- pyproject.toml: package metadata (v2.2.16)
 - helloagents/cli.py: installer entry
 - helloagents/functions: workflow commands
 - helloagents/stages: design, develop
@@ -371,7 +378,7 @@ These commands run inside AI chat, not your system shell.
   A: Non-HelloAGENTS files are backed up before replacement.
 
 - Q: What is RLM?
-  A: Role Language Model — a sub-agent orchestration system with 5 specialized roles + native CLI sub-agents dispatched based on task complexity.
+  A: Role Language Model — a sub-agent orchestration system with 5 specialized roles + native CLI sub-agents, DAG-based parallel scheduling, and standardized prompt/return format.
 
 - Q: Where does project knowledge go?
   A: In the project-local `.helloagents/` directory, auto-synced when code changes.
@@ -395,7 +402,32 @@ These commands run inside AI chat, not your system shell.
 
 ## Version History
 
-### v2.2.12 (current)
+### v2.2.16 (current)
+
+- Refactored evaluation dimension system with dimension isolation rule, pass threshold tuned to 8/10. Options are user-need-driven, organized by style direction rather than complexity tiers (e.g. UI design offers different styles instead of simple/medium/complex); recommended option points to the most complete deliverable, derived from recommendation principles and scoring criteria rather than hardcoded
+- Proposal design requires both implementation path and deliverable design direction to differ across alternatives, each sub-agent independently outputs a complete proposal including presentation direction, style, and experience
+- Proposal evaluation criteria optimized: user value weight is always no less than any other single dimension, evaluation dimensions dynamically adjusted by project context
+- Universal task type support: generalized evaluation, follow-up, and proposal design terminology from programming-specific to documents, design, general tasks and more
+- Added sub-agent DAG dependency scheduling with topological sort, layer-by-layer parallel dispatch, and failure propagation
+- Dynamic sub-agent parallel count based on independent work units, eliminated hardcoded limits
+- Unified output format: structured display for score breakdowns, follow-up options, and confirmation messages
+- Streamlined execution paths with shorter stage chains and step-level on-demand module loading
+- Adjusted Codex CLI memory limit to 128 KiB to prevent rules file truncation
+- Improved recommendation option generation rules, proposal differentiation requirements, and evaluation scoring criteria
+
+### v2.2.14
+
+- DAG dependency scheduling for task execution (depends_on, topological sort, layer-by-layer parallel dispatch with failure propagation)
+- Graded retry and standardized sub-agent return format with scope verification
+- Sub-agent orchestration paradigm: four-step method, prompt template, behavior constraints (route-skip, output format)
+- Execution path hardening: explicit R1 upgrade triggers, DESIGN retry limits, DEVELOP entry/exit conditions
+- Workflow rule audit: terminology and format consistency, redundancy cleanup
+
+### v2.2.13
+
+- R3 design proposals default ≥3 parallel, parallel batch limit ≤6, explicit sub-agent count principle (count = independent work units, no vague wording), add sub-agent orchestration config tips to README
+
+### v2.2.12
 
 - Comprehensive parallel sub-agent orchestration across all flows and commands, extend G10 coverage, eliminate hardcoded agent counts, add universal parallel information gathering principle
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "2.2.12",
+  "version": "2.2.16",
   "type": "module",
   "description": "HelloAGENTS - AI-native sub-agent orchestration framework for multi-CLI environments",
   "author": "HelloWind",