@iamdevlinph/codex-kit 1.0.3 → 1.0.4

package/README.md

@@ -27,6 +27,11 @@ For one-off use without a global installation, prefix a command with
 `global install` copies reusable agents to `${CODEX_HOME:-~/.codex}` and
 maintains a marked routing section in the global `AGENTS.md`.
 
+The Sol root agent plans, coordinates, and validates. All project-file changes,
+including small one-file edits, are delegated to a Luna `quick-implementer` or
+`implementer`; the selected implementation agent edits directly without further
+delegation.
+
 `global configure` sets these defaults while preserving unrelated settings:
 
 ```toml

package/assets/SUBAGENT_ROUTING.md

@@ -1,18 +1,24 @@
 # Subagent Routing
 
-Keep focused, tightly coupled work in the parent task. Delegate only bounded,
-independent work when it materially reduces parent-context growth, latency, or
-cost. The user does not need to request subagents explicitly.
+The root parent is the Sol planner and orchestrator. It must delegate all
+file-changing implementation to a Luna implementation agent. The user does not
+need to request subagents explicitly.
 
 The parent owns requirements, architecture, integration, and final validation.
 Never delegate the overall objective. Avoid parallel write-heavy work and never
 assign overlapping files to multiple agents.
 
-Do not delegate trivial conversation, known-target edits limited to one or two
-files, or straightforward commands. A slow command alone is not a reason to
-delegate.
+For any task that creates, edits, or deletes project files, delegate the work to
+exactly one of `quick-implementer` or `implementer`. Include bookkeeping commands
+that write project state in that assignment. The parent may perform read-only
+inspection and final validation, but must not make the project-file changes itself.
 
-When delegation is worthwhile:
+These routing rules apply to the root parent. An implementation subagent performs
+its assigned edits directly and must not delegate them again. Do not delegate
+trivial conversation or straightforward read-only commands. A slow command alone
+is not a reason to delegate.
+
+For delegated work:
 
 - Prefer one subagent. Add more only for independent, non-overlapping work.
 - Give each agent a bounded task and request a concise, decision-ready report.
@@ -27,9 +33,9 @@ Select custom agents by exact name:
 - Multi-file behavior change, debugging, or substantial tests: `implementer`
 - Independent review of high-risk or difficult-to-validate changes: `code-reviewer`
 
-Use either `quick-implementer` or `implementer` for a change, not both. Use the
-lowest reasoning effort that reliably fits the work. Do not substitute a generic
-agent when a matching custom role is available.
+Use either `quick-implementer` or `implementer` for a change, not both. Both roles
+run Luna; use the lowest reasoning effort that reliably fits the work. Do not
+substitute a generic agent when a matching custom role is available.
 
 There is no commit-pusher role. Never delegate Git publishing. Do not stage,
 commit, or push unless the user explicitly requests that operation in the current

package/bin/codex-kit.js

@@ -647,22 +647,30 @@ function help() {
     console.log(`codex-kit ${PACKAGE.version}
 
 Usage:
-  codex-kit global install [--codex-home PATH] [--force]
-  codex-kit global configure [--orchestrator MODEL] [--reasoning-effort LEVEL]
-  codex-kit global list [--codex-home PATH]
-  codex-kit global uninstall [--codex-home PATH]
-  codex-kit project init [--cwd PATH]
-  codex-kit project sync [--cwd PATH]
-  codex-kit project status [--cwd PATH]
-  codex-kit project mark-applied [--cwd PATH]
-  codex-kit version check
-  codex-kit --help
-  codex-kit --version
+  codex-kit <command> [options]
 
-Global configure defaults to gpt-5.6-sol with high normal and Plan-mode reasoning
-and edits only those top-level model settings in CODEX_HOME/config.toml.
-Global install manages custom agents and a marked routing block under CODEX_HOME.
-Project sync refreshes TEMPLATE_AGENTS.md and never merges it into AGENTS.md.`);
+Commands:
+  global install       Install or update package-owned agents and routing guidance.
+  global configure     Set the orchestrator and normal/Plan reasoning defaults.
+  global list          Show model settings, routing status, and custom agents.
+  global uninstall     Restore managed config values and remove package-owned files.
+  project init         Initialize AGENTS.md, TEMPLATE_AGENTS.md, and project state.
+  project sync         Refresh TEMPLATE_AGENTS.md without editing AGENTS.md.
+  project status       Show whether template changes still need reconciliation.
+  project mark-applied Record the current template as reconciled with AGENTS.md.
+  version check        Compare the installed version with the latest npm release.
+  --help               Show this help.
+  --version            Print the installed version.
+
+Options:
+  --codex-home PATH         Use a Codex home other than CODEX_HOME or ~/.codex.
+  --cwd PATH                Use a project directory other than the current directory.
+  --force                   Replace modified files or config managed by codex-kit.
+  --orchestrator MODEL      Set the root/orchestrator model (default: gpt-5.6-sol).
+  --model MODEL             Alias for --orchestrator.
+  --reasoning-effort LEVEL  Set normal and Plan-mode effort (default: high).
+
+Run a command with only its applicable options.`);
 }
 export function main(argv = process.argv.slice(2)) {
     const options = parse(argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iamdevlinph/codex-kit",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Portable Codex subagents and project AGENTS.md defaults.",
   "type": "module",
   "bin": {