@dzhechkov/skills-feature-adr 1.3.28 → 1.3.30

package/README.md

@@ -117,11 +117,11 @@ knobs (via the workflow `args`, or offered interactively at the planning checkpo
 | `planner: 'codex'` | 6 Plan | plan on Codex's top model (Claude fallback) |
 | `coder: 'codex-fallback'` | 7 Code | Claude first; **if the Claude Code limit is exhausted mid-run → retry on Codex** |
 | `qeReviewer: 'codex-fallback'` | 8 QE/tests | same fallback for the review/testing stage |
-| `codexModel: 'gpt-5-codex'` | — | which Codex model (`gpt-5-codex` default · `gpt-5` · `o3` · `auto`) |
+| `codexModel: 'auto'` | — | which Codex model (`auto` default (Codex self-selects) · or an id your account exposes (e.g. `gpt-5.5`)) |
 
 **Scenario — never stall on a rate limit:** a long L/XL feature hits the Claude Code session limit while
 writing code. Without this the run stalls; with `coder: 'codex-fallback'` the pipeline logs *"Claude
-unavailable (limit?) — falling back to Codex gpt-5-codex"* and finishes the code + tests on Codex, no
+unavailable (limit?) — falling back to Codex auto"* and finishes the code + tests on Codex, no
 restart and no lost work.
 
 ```bash
@@ -135,7 +135,7 @@ printenv OPENAI_API_KEY | codex login --with-api-key
 // ultracode (the deterministic workflow form): plan on Codex, code+QE fall back to Codex on Claude-limit:
 Workflow({ scriptPath: '.claude/workflows/feature-adr.js',
   args: { slug: 'add-oauth', description: '…', tier: 'M',
-          planner: 'codex', coder: 'codex-fallback', qeReviewer: 'codex-fallback', codexModel: 'gpt-5-codex' } })
+          planner: 'codex', coder: 'codex-fallback', qeReviewer: 'codex-fallback', codexModel: 'auto' } })  // 'auto' = Codex picks top; or pin e.g. 'gpt-5.5'
 ```
 
 Omit the Codex knobs entirely for today's all-Claude behavior. The run result reports

package/docs/team-onboarding.md

@@ -179,14 +179,14 @@ In the **ultracode workflow form**, feature-adr can hand steps to [Codex](https:
 2. **Never stall on a rate limit** — the killer feature: `coder: 'codex-fallback'` +
    `qeReviewer: 'codex-fallback'`. Claude writes the code/tests as usual; but if a long L/XL run hits
    the **Claude Code session limit mid-Step-7/8**, the pipeline auto-retries that step on Codex
-   (`gpt-5-codex` by default) instead of stalling — no restart, no lost work.
+   (`auto` by default) instead of stalling — no restart, no lost work.
 
 ```bash
 # one-time headless login (VPS, no browser):
 codex login --device-auth        # approve the printed code+URL on your phone/laptop
 
 # then, when launching a run, pass the knobs (or accept the interactive pre-flight offer):
-#   planner: 'codex' | coder: 'codex-fallback' | qeReviewer: 'codex-fallback' | codexModel: 'gpt-5-codex'
+#   planner: 'codex' | coder: 'codex-fallback' | qeReviewer: 'codex-fallback' | codexModel: 'auto'
 ```
 
 Omit the knobs for the all-Claude default. Full reference: `.claude/rules/feature-adr-ultracode.md`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dzhechkov/skills-feature-adr",
-  "version": "1.3.28",
+  "version": "1.3.30",
   "description": "Adaptive Feature Development skill pack for Claude Code — 11-step pipeline with Complexity Router (S/M/L/XL), ADR-driven architecture, 15 agentic-qe skills, multi-agent fleet QE. Supports --full-qe, --full-qe-extended, --with-learning, and --knowledge-extractor modes.",
   "bin": {
     "skills-feature-adr": "./bin/cli.js"

package/templates/.claude/rules/feature-adr-ultracode.md

@@ -36,7 +36,7 @@ overridable via `args`:
 | `planner` | 6 (Plan) | `claude` (default) · `codex` | `codex` → Step-6 plans on Codex, Claude fallback |
 | `coder` | 7 (Code) | `claude` (default) · `codex` · `codex-fallback` | `codex-fallback` → Claude first, **on limit-exhaustion (null) → Codex** |
 | `qeReviewer` | 8 (QE/tests) | `claude` (default) · `codex` · `codex-fallback` | same fallback, for the QE/testing stage |
-| `codexModel` | — | `gpt-5-codex` (default) · `gpt-5` · `o3` · `auto` | which Codex model to use |
+| `codexModel` | — | `auto` (default — Codex self-selects the top available) · or a specific id your account exposes (e.g. `gpt-5.5`, `gpt-5.4`) | which Codex model to use |
 
 The result reports `plannerUsed` / `coderUsed` / `qeReviewerUsed` / `codexModel` so you can see who did what.
 
@@ -48,24 +48,24 @@ If `ready`, ASK the user once (skip all of this if not ready — Claude does eve
 1. *"Plan (Step 6) on the top Codex model?"* → set `planner: 'codex'`.
 2. *"Fall back to Codex for code + tests/QE (Step 7/8) if the Claude Code limit is exhausted?"* →
    set `coder: 'codex-fallback'`, `qeReviewer: 'codex-fallback'`.
-3. *"Which Codex model?"* (`gpt-5-codex` / `gpt-5` / `o3` / `auto`) → **write it into codex config so the
+3. *"Which Codex model?"* (`auto` — Codex self-selects — or a specific id your account exposes; model ids are account/version-specific, so verify via the runtime rather than assuming) → **write it into codex config so the
    `codex:codex-rescue` runtime picks it up**, then pass `codexModel`:
    ```bash
-   printf '\nmodel = "gpt-5-codex"\n' >> ~/.codex/config.toml   # or -c model=... per invocation
+   printf '\nmodel = "gpt-5.5"\n' >> ~/.codex/config.toml   # pin a REAL id your account has (auto = default; verify: ask the codex runtime what -m ids it accepts)
    ```
 For the interactive SKILL (plain `/feature-adr`), make the same three offers at the planning checkpoint.
 
 **Scenario (the reason this exists):** a long L/XL run hits the Claude Code session limit mid-Step-7.
 Without this, the Code agent returns null and the run stalls. With `coder: 'codex-fallback'`, feature-adr
-detects the null, logs *"Claude unavailable (limit?) — falling back to Codex gpt-5-codex"*, and finishes
+detects the null, logs *"Claude unavailable (limit?) — falling back to Codex auto"*, and finishes
 the code + tests on Codex — no restart, no lost work.
 
 **Example invocations:**
 ```js
-// Plan on Codex, code+QE fall back to Codex only if Claude runs out, gpt-5-codex:
+// Plan on Codex, code+QE fall back to Codex only if Claude runs out, auto:
 Workflow({ scriptPath: '.claude/workflows/feature-adr.js',
   args: { slug: 'add-x', description: '…', tier: 'M',
-          planner: 'codex', coder: 'codex-fallback', qeReviewer: 'codex-fallback', codexModel: 'gpt-5-codex' } })
+          planner: 'codex', coder: 'codex-fallback', qeReviewer: 'codex-fallback', codexModel: 'auto' } })  // 'auto' = Codex picks top; or pin e.g. 'gpt-5.5'
 
 // All-Claude (the default — omit the Codex knobs entirely):
 Workflow({ scriptPath: '.claude/workflows/feature-adr.js', args: { slug: 'add-x', description: '…', tier: 'M' } })

package/templates/.claude/skills/feature-adr/SKILL.md

@@ -363,13 +363,13 @@ to Codex — always ASKING first, always with a Claude fallback (never blocks):
 - **Code (Step 7) + tests/QE (Step 8) FALLBACK** → `args.coder: 'codex-fallback'`, `args.qeReviewer:
   'codex-fallback'`: Claude runs first, and only if the **Claude Code limit is exhausted mid-run** (the
   agent returns null) does the SAME task retry on Codex — so a long build never stalls on a rate limit.
-- **Model choice** → `args.codexModel` (`gpt-5-codex` default · `gpt-5` · `o3` · `auto`).
+- **Model choice** → `args.codexModel` (`auto` default (Codex self-selects) · or an id your account exposes (e.g. `gpt-5.5`)).
 
 *Scenario:* an L/XL run hits the session limit during coding → with `coder: 'codex-fallback'` feature-adr
-logs *"Claude unavailable (limit?) — falling back to Codex gpt-5-codex"* and finishes on Codex, no restart.
+logs *"Claude unavailable (limit?) — falling back to Codex auto"* and finishes on Codex, no restart.
 
 *Example:* `Workflow({ scriptPath: '.claude/workflows/feature-adr.js', args: { slug, description, tier:
-'M', planner: 'codex', coder: 'codex-fallback', qeReviewer: 'codex-fallback', codexModel: 'gpt-5-codex' } })`.
+'M', planner: 'codex', coder: 'codex-fallback', qeReviewer: 'codex-fallback', codexModel: 'auto' } })  // 'auto' = Codex picks top; or pin e.g. 'gpt-5.5'`.
 
 Pre-flight, if Codex is `ready` (`codex-companion setup --json`), the orchestrator asks these three
 before launching; plain `/feature-adr` offers the same at the planning checkpoint. Omit the Codex knobs

package/templates/.claude/workflows/feature-adr.js

@@ -1,6 +1,6 @@
 export const meta = {
   name: 'feature-adr',
-  description: 'Canonical /feature-adr --full-qe-extended pipeline as a reusable workflow: router+RECALL then design(ADR, applies learned patterns) then plan then code then agentic-qe QE+TEACH, producing features/<slug>/00-09 artifacts. MANDATORY in-process self-learning loop (Step-0 recall, apply, Step-8 teach). OPTIONAL Codex routing: args.planner=codex (Step-6), args.coder/qeReviewer='codex-fallback' (Step-7/8 fall back to Codex gpt-5-codex when Claude limits exhaust; args.codexModel picks the model). Hybrid checkpoints (S/M autonomous; L/XL stop-after-plan).',
+  description: 'Canonical /feature-adr --full-qe-extended pipeline as a reusable workflow: router+RECALL then design(ADR, applies learned patterns) then plan then code then agentic-qe QE+TEACH, producing features/<slug>/00-09 artifacts. MANDATORY in-process self-learning loop (Step-0 recall, apply, Step-8 teach). OPTIONAL Codex routing: args.planner=codex (Step-6), args.coder/qeReviewer='codex-fallback' (Step-7/8 fall back to Codex when Claude limits exhaust; args.codexModel default 'auto' (Codex self-selects top; account-specific)). Hybrid checkpoints (S/M autonomous; L/XL stop-after-plan).',
   whenToUse: 'ultracode + a feature implementation. Invoke via Workflow({scriptPath:".claude/workflows/feature-adr.js", args:{slug, description, code, tier, stopAfter, planner, coder, qeReviewer, codexModel}}) instead of an ad-hoc orchestration, so every feature ships with an ADR + inline agentic-qe QE + self-learning.',
   phases: [
     { title: 'Router', detail: 'Step 0 - classify + self-learning recall' },
@@ -89,9 +89,11 @@ if (stopHere) {
 // Codex fallback config (opt-in). CODER/QE_REVIEWER ∈ 'claude'|'codex'|'codex-fallback'. On
 // 'codex-fallback' the Claude agent runs FIRST; if it returns null (e.g. the Claude Code session limit
 // is exhausted mid-code/mid-QE — exactly the failure we hit before), the SAME task is retried on the
-// codex:codex-rescue runtime (model = args.codexModel, default gpt-5-codex). The model is set into
-// ~/.codex/config.toml by the orchestrator at pre-flight; the hint below reinforces it.
-const CODEX_MODEL = A.codexModel || 'gpt-5-codex'
+// codex:codex-rescue runtime. args.codexModel is DEFAULT 'auto' (Codex self-selects the top model
+// available to the account — model ids are account/version-specific and move ahead of any static
+// default, so 'auto' is the portable choice). To hard-pin a specific id (e.g. this account's top is
+// gpt-5.5), the orchestrator writes it into ~/.codex/config.toml at pre-flight; the hint below only nudges.
+const CODEX_MODEL = A.codexModel || 'auto'
 const CODEX_HINT = ' (If you are the Codex runtime, prefer the ' + CODEX_MODEL + ' model.)'
 const CODER = (A.coder === 'codex' || A.coder === 'codex-fallback') ? A.coder : 'claude'
 const QE_REVIEWER = (A.qeReviewer === 'codex' || A.qeReviewer === 'codex-fallback') ? A.qeReviewer : 'claude'