@dzhechkov/skills-feature-adr 1.3.24 → 1.3.26

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dzhechkov/skills-feature-adr",
-  "version": "1.3.24",
+  "version": "1.3.26",
   "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

@@ -25,6 +25,23 @@ The pipeline ALWAYS runs the feature-adr Pattern memory loop **in-process** —
 - **Step 0** recalls learned patterns (`dz recall`) → folds the top ones into requirements/ADR as `{LEARNED_PATTERNS}` + records the recalled count in the live panel (`dz statusline --fa-record`).
 - **Step 8** teaches the durable lessons back (`dz teach`) + records the stored count. The loop pays off (recall) and grows (teach) every run.
 
+## Optional Codex planner (opt-in, pre-flight ASK)
+
+feature-adr can route the **planning step (Step 6)** to Codex's top model instead of Claude. It is
+**opt-in and graceful**: absent/declined/failed → the default Claude planner runs (the pipeline never
+blocks on Codex).
+
+Pre-flight, BEFORE launching a feature-adr run, detect Codex readiness:
+```
+node "<codex-plugin>/scripts/codex-companion.mjs" setup --json   → { ready: true }
+```
+If `ready`, **ASK the user once**: *"Use the top Codex model for the planning step?"* On yes, pass
+`args.planner: 'codex'` (the workflow routes Step 6 to the `codex:codex-rescue` agentType, with a
+Claude fallback and `plannerUsed` in the result). On no / not-ready, omit `planner` (Claude plans).
+For the interactive SKILL (plain `/feature-adr`), make the same offer at the planning checkpoint.
+Codex needs a headless login on a VPS: `codex login --device-auth` (code + URL) or
+`printenv OPENAI_API_KEY | codex login --with-api-key`.
+
 ## Hybrid checkpoints (router decides)
 
 - **S / M** → run autonomously to completion; present a final consolidated review (ADR + plan + QE).

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

@@ -355,6 +355,12 @@ Step 0 (Complexity Router) checks:
   description, code, tier, stopAfter, repo, dzBin } })`. Hybrid checkpoints: S/M autonomous; L/XL return
   after the Plan phase for your steer. See `.claude/rules/feature-adr-ultracode.md`.
 
+**Optional Codex planner (opt-in).** When Codex is installed + logged in (`codex login --device-auth`
+on a headless VPS, or `printenv OPENAI_API_KEY | codex login --with-api-key`), the pipeline can route the
+**planning step to Codex's top model**. It ALWAYS asks first — a pre-flight *"Use the top Codex model for
+planning?"* — and falls back to Claude if you decline or Codex is unavailable (never blocks). ultracode:
+pass `args.planner: 'codex'`. Plain `/feature-adr`: the same offer appears at the planning checkpoint.
+
 ### Pattern memory loop (self-learning — runs in ALL modes)
 
 **Self-learning is MANDATORY on EVERY `/feature-adr` run — including plain `/feature-adr` without any

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

@@ -1,7 +1,7 @@
 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). 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}}) instead of an ad-hoc orchestration, so every feature ships with an ADR + inline agentic-qe QE + self-learning.',
+  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 planner (args.planner=codex → Step-6 routed to codex:codex-rescue top model, graceful fallback to Claude). 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}}) 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' },
     { title: 'Design', detail: 'Steps 1-5 - requirements, ADR, QCSD, architecture (tier-gated)' },
@@ -58,14 +58,32 @@ if (isMplus) {
 }
 const design = await parallel(designThunks)
 
-// Step 6: Plan
+// Step 6: Plan — optionally routed to Codex's top model (opt-in via args.planner='codex').
+// The user opts in at pre-flight ('use the top Codex model for planning?'); we route the Plan step to
+// the codex:codex-rescue runtime and GRACEFULLY FALL BACK to the default (Claude) planner if Codex is
+// unavailable/errors — the pipeline never blocks on Codex.
 phase('Plan')
-const plan = await agent('Step 6 (SPARC-GOAP implementation plan) of /feature-adr for "' + DESC + '" (' + SLUG + ', tier ' + tier + '). Given the requirements + ADR + architecture in ' + FDIR + ', decompose into milestones + concrete tasks with success metrics. Write ' + FDIR + '/06_implementation_plan.md. Return wrote[] + summary.', { label: 'plan', phase: 'Plan', schema: ARTIFACT })
+const PLANNER = (A.planner === 'codex') ? 'codex' : 'claude'
+const planPrompt = 'Step 6 (SPARC-GOAP implementation plan) of /feature-adr for "' + DESC + '" (' + SLUG + ', tier ' + tier + '). Given the requirements + ADR + architecture in ' + FDIR + ', decompose into milestones + concrete tasks with success metrics. Write ' + FDIR + '/06_implementation_plan.md. Return wrote[] + summary.'
+let plan = null
+if (PLANNER === 'codex') {
+  const codexPlan = await agent(planPrompt, { label: 'plan:codex', phase: 'Plan', agentType: 'codex:codex-rescue' })
+  if (codexPlan) {
+    plan = { wrote: [FDIR + '/06_implementation_plan.md'], summary: String(codexPlan).slice(0, 500), planner: 'codex' }
+    log('Plan: Codex (top model)')
+  } else {
+    log('Plan: Codex unavailable — falling back to the default planner')
+  }
+}
+if (plan === null) {
+  const claudePlan = await agent(planPrompt, { label: 'plan', phase: 'Plan', schema: ARTIFACT })
+  plan = claudePlan ? { wrote: claudePlan.wrote, summary: claudePlan.summary, planner: PLANNER === 'codex' ? 'claude-fallback' : 'claude' } : null
+}
 
 // Hybrid checkpoint for L/XL
 const stopHere = STOP_AFTER === 'plan' || (isLplus && STOP_AFTER !== 'none')
 if (stopHere) {
-  return { tier: tier, phase: 'checkpoint-after-plan', artifactsDir: FDIR, plan: (plan ? plan.summary : null), note: 'L/XL checkpoint - review the ADR + plan, then re-invoke with args.stopAfter="none" to implement + QE.' }
+  return { tier: tier, phase: 'checkpoint-after-plan', artifactsDir: FDIR, planner: (plan ? plan.planner : null), plan: (plan ? plan.summary : null), note: 'L/XL checkpoint - review the ADR + plan, then re-invoke with args.stopAfter="none" to implement + QE.' }
 }
 
 // Step 7: Code
@@ -100,6 +118,7 @@ return {
   codeTestsAdequate: qe ? qe.codeTestsAdequate : null,
   docTestsPresent: qe ? qe.docTestsPresent : null,
   fleetQE: fleet,
+  plannerUsed: plan ? plan.planner : null,
   selfLearning: 'recall@Step0 + teach@Step8 (mandatory)',
   promiseTags: tags,
 }