Release 0.6.0 with persistent project model presets

.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-sdlc",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Run evidence-backed software delivery across one or more repositories with Codex.",
   "author": {
     "name": "vimihi",

CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to codex-sdlc are documented here.
 
+## 0.6.0 - 2026-09-24
+
+- Add the `sdlc` entry skill for `/sdlc --save-my-token` and `/sdlc --normal` chat shorthand, with explicit `$sdlc` invocation support.
+- Add project presets through `configure-agents --save-my-token` and `--normal`. Token-saving mode inherits PM, selects `gpt-6-sol/high` for BA, and `gpt-6-luna/xhigh` for backend, web/mobile frontend, and QC. Normal mode restores inheritance for those delivery roles.
+- Persist presets for future runs while preserving existing run snapshots, optional AI Product Owner settings, and unrelated project configuration. Support dry-run previews and reject conflicting mode/custom settings.
+
 ## 0.4.3 - 2026-09-11
 
 - Shorten every default prompt to satisfy the Plugins Directory 128-character maximum.

README.md

@@ -43,7 +43,7 @@ PM coordinates the stages and reviews each handoff. Frontend work follows the re
 
 ### A workflow you can resume
 
-Seven Codex skills and a repository-local CLI keep tasks, evidence, blockers, and decisions in your repository. The next session can continue from recorded state.
+Eight Codex skills and a repository-local CLI keep tasks, evidence, blockers, and decisions in your repository. The next session can continue from recorded state.
 
 | What you need | What codex-sdlc provides |
 | --- | --- |
@@ -83,15 +83,15 @@ Start a codex-sdlc feature delivery for: <describe the outcome you want>.
 
 To continue later, ask Codex to resume the existing run. Its manifest records the current tasks, completed work, and remaining decisions.
 
-**Version note:** Per-role model routing and AI Product Owner review require both the **0.5.0 plugin and runtime**. Check your installed plugin version; updating the plugin does not upgrade an existing project's runtime. See the [upgrade guide](docs/getting-started.md#upgrade-an-existing-project).
+**Version note:** Project model modes require both the **0.6.0 plugin and runtime**. Per-role routing and AI Product Owner review remain available from 0.5.0. Check your installed plugin version; updating the plugin does not upgrade an existing project's runtime. See the [upgrade guide](docs/getting-started.md#upgrade-an-existing-project).
 
 <details>
 <summary><strong>Prefer the CLI? Preview a Next.js setup</strong></summary>
 
 Run this against an existing web repository:
 
 ```sh
-npx --yes codex-sdlc@0.5.0 init \
+npx --yes codex-sdlc@0.6.0 init \
   --root /absolute/path/to/web --name example-web \
   --applications web --web-root . --web-preset nextjs \
   --dry-run
@@ -106,7 +106,7 @@ node .sdlc/runtime.cjs doctor
 node .sdlc/runtime.cjs validate-config
 ```
 
-For a global CLI installation, use `npm install --global codex-sdlc@0.5.0`.
+For a global CLI installation, use `npm install --global codex-sdlc@0.6.0`.
 
 </details>
 
@@ -143,6 +143,7 @@ Keep Codex's inherited models, or configure a model and reasoning effort for eac
 
 | Skill | Responsibility |
 | --- | --- |
+| `sdlc` | Apply project model modes and route feature requests to PM. |
 | `sdlc-setup` | Initialize, diagnose, configure, upgrade, roll back, and uninstall. |
 | `sdlc-pm` | Coordinate delivery, review handoffs, and prepare the final package. |
 | `sdlc-ba` | Define requirements, acceptance criteria, and traceability. |
@@ -151,7 +152,7 @@ Keep Codex's inherited models, or configure a model and reasoning effort for eac
 | `sdlc-qc` | Independently verify acceptance coverage, defects, and retests. |
 | `sdlc-po` | Provide an optional advisory Product Owner review after QC. |
 
-For example, with a compatible 0.5.0 plugin and runtime:
+For example, with a compatible plugin and runtime:
 
 ```text
 Use Astra for frontend, Luna for backend, and Sol for PM and QC.
@@ -163,6 +164,19 @@ Selections must be available on your Codex host. New runs snapshot the settings;
 
 → [Model configuration, fallbacks, and AI Product Owner review](docs/agent-models.md)
 
+### Project model modes
+
+Version 0.6.0 adds these chat shortcuts:
+
+```text
+/sdlc --save-my-token
+/sdlc --normal
+```
+
+Token-saving mode keeps PM inherited, uses Sol (`gpt-6-sol`) with high reasoning for BA, and Luna (`gpt-6-luna`) with extra-high reasoning for backend, web/mobile frontend, and QC. Normal mode restores inheritance for those roles. Both save to the current project's `.sdlc/project.yaml` for every new run; existing runs and optional AI Product Owner settings are preserved.
+
+These are skill-handled chat shortcuts. In clients that reject custom slash commands, invoke `$sdlc --save-my-token` or `$sdlc --normal`. Both plugin and runtime must be 0.6.0 or newer. See [project mode details and CLI equivalents](docs/agent-models.md#project-model-modes).
+
 ## What stays in your repository
 
 ```text
@@ -186,7 +200,7 @@ codex-sdlc does not operate a hosted service or send repository content to a cod
 Preview a project upgrade before applying it:
 
 ```sh
-npx --yes codex-sdlc@0.5.0 upgrade \
+npx --yes codex-sdlc@0.6.0 upgrade \
   --root /absolute/path/to/coordinator --dry-run
 ```
 
@@ -200,10 +214,10 @@ Applied upgrades create backups. Rollback checks managed-file integrity before r
 | --- | --- |
 | [Getting started](docs/getting-started.md) | [CLI setup and lifecycle reference](docs/cli-reference.md) |
 | [Multi-repository workspaces](docs/multi-repository.md) | [Role models and dispatch records](docs/agent-models.md) |
-| [What's new in 0.5.0](docs/releases/0.5.0.md) | [Release history](https://github.com/prime-vimihi/codex-sdlc/releases) |
+| [What's new in 0.6.0](docs/releases/0.6.0.md) | [Release history](https://github.com/prime-vimihi/codex-sdlc/releases) |
 | [Support](SUPPORT.md) | [Contributing](CONTRIBUTING.md) |
 
-Current verification includes macOS CI, the automated runtime tests, plugin and skill validation, and a live PM dispatch smoke test. Native Linux/Windows qualification and a complete delivery test spanning multiple models remain pending. See the [0.5.0 validation notes](docs/releases/0.5.0.md#validation).
+Current verification includes automated runtime tests, plugin and skill validation, and independent built-CLI checks. Native Linux/Windows qualification and a complete delivery test spanning multiple models remain pending. See the [0.6.0 validation notes](docs/releases/0.6.0.md#validation).
 
 ## Build with us
 

assets/framework.yaml

@@ -1,7 +1,7 @@
 schema_version: 1
 framework:
   name: codex-sdlc
-  version: 0.5.0
+  version: 0.6.0
   run_schema_version: 1
   project_schema_version: 2
 installation:

docs/agent-models.md

@@ -1,6 +1,49 @@
 # Choose a model for each SDLC role
 
-Available in codex-sdlc 0.5.0. Both the plugin and the repository runtime must support this version. Updating the plugin does not upgrade existing projects; upgrade the runtime first as described in the [getting started guide](getting-started.md).
+Custom role settings are available in codex-sdlc 0.5.0. The project mode shortcuts below require both the 0.6.0 plugin and runtime. Updating the plugin does not upgrade existing projects; upgrade the runtime as described in the [getting started guide](getting-started.md).
+
+## Project model modes
+
+In your initialized project's Codex task, send:
+
+```text
+/sdlc --save-my-token
+```
+
+The new `sdlc` skill interprets this chat shorthand and saves the following project configuration:
+
+| Role | Model | Reasoning |
+| --- | --- | --- |
+| PM | Inherited | Inherited |
+| BA | `gpt-6-sol` | `high` |
+| Backend | `gpt-6-luna` | `xhigh` (extra-high) |
+| Frontend, including web and mobile | `gpt-6-luna` | `xhigh` (extra-high) |
+| QC | `gpt-6-luna` | `xhigh` (extra-high) |
+
+To restore normal inherited models:
+
+```text
+/sdlc --normal
+```
+
+Normal mode removes model, reasoning, and fallback overrides for PM, BA, backend, frontend, and QC. It does not restore custom models that existed before token-saving mode. Both commands preserve optional AI Product Owner configuration and all other project settings.
+
+Each selection is stored in the coordinator's `.sdlc/project.yaml` and applies to **every new run** until you change it. Other projects and existing runs are unaffected. A mode-only request does not start a feature run. In a multi-repository workspace, run it in the coordinator to cover its mapped applications. An uninitialized project needs setup first.
+
+Codex's explicit skill syntax is `$sdlc --save-my-token` or `$sdlc --normal`; use it if your client reserves slash commands for built-in actions. The plugin handles `/sdlc` as prompt shorthand rather than registering a native slash command. See [official skill invocation guidance](https://learn.chatgpt.com/docs/build-skills).
+
+The equivalent runtime commands, from the coordinator, are:
+
+```sh
+node .sdlc/runtime.cjs configure-agents --save-my-token
+node .sdlc/runtime.cjs configure-agents --normal
+```
+
+Add `--dry-run --json` to preview without saving. Use `--root /absolute/path/to/coordinator` to select a project explicitly. The two modes are mutually exclusive and cannot be combined with individual role or PO configuration flags; make custom changes in a separate invocation. Applying the same preset again keeps the same settings.
+
+The presets require `gpt-6-sol/high` and `gpt-6-luna/xhigh` support on the user's host. Configuration saves the requested policy; dispatch still validates availability. No fallback is added, and an unavailable model or effort stops dispatch. Token-saving mode selects these models; actual token usage depends on the work.
+
+## Custom role settings
 
 Ask Codex:
 

docs/cli-reference.md

@@ -15,11 +15,25 @@ npm pack
 Install the published CLI with:
 
 ```sh
-npm install --global codex-sdlc@0.5.0
+npm install --global codex-sdlc@0.6.0
 ```
 
 ## Project setup modes
 
+### Project model modes
+
+After initialization, the 0.6.0 runtime accepts:
+
+```sh
+node .sdlc/runtime.cjs configure-agents --save-my-token --dry-run --json
+node .sdlc/runtime.cjs configure-agents --save-my-token
+node .sdlc/runtime.cjs configure-agents --normal
+```
+
+Both commands accept `--root <coordinator>`. Token-saving mode uses inherited PM, `gpt-6-sol/high` for BA, and `gpt-6-luna/xhigh` for backend, web/mobile frontend, and QC. Normal mode removes those five roles' overrides. Optional PO configuration is preserved. The choice persists for new runs in this project; existing runs keep their policies. Mode flags cannot be combined with one another or individual agent/PO settings, and are supported on `configure-agents`, not `init` or `start`. See [model modes](agent-models.md#project-model-modes) for chat invocation and compatibility.
+
+### Application setup
+
 The initializer configures an existing repository; it does not generate application source code. Each selected application root must already exist.
 
 Initialize a web-only Next.js project:
@@ -98,9 +112,9 @@ Use the `generic` application preset or `none` database preset when a listed pre
 Install the generated tarball, preview the bounded changes, and then initialize. During local testing, pin the generated repository launcher to the tarball:
 
 ```sh
-npm install --global ./codex-sdlc-0.5.0.tgz
-codex-sdlc init --root /path/to/project --name example --applications web --web-root . --web-preset nextjs --runtime-spec file:/absolute/path/codex-sdlc-0.5.0.tgz --dry-run
-codex-sdlc init --root /path/to/project --name example --applications web --web-root . --web-preset nextjs --runtime-spec file:/absolute/path/codex-sdlc-0.5.0.tgz
+npm install --global ./codex-sdlc-0.6.0.tgz
+codex-sdlc init --root /path/to/project --name example --applications web --web-root . --web-preset nextjs --runtime-spec file:/absolute/path/codex-sdlc-0.6.0.tgz --dry-run
+codex-sdlc init --root /path/to/project --name example --applications web --web-root . --web-preset nextjs --runtime-spec file:/absolute/path/codex-sdlc-0.6.0.tgz
 cd /path/to/project
 node .sdlc/runtime.cjs restore
 ```
@@ -119,8 +133,8 @@ The installer preserves existing `AGENTS.md` and `.gitignore` content, refuses c
 Preview and apply an upgrade with the new runtime package pinned into the repository:
 
 ```sh
-codex-sdlc upgrade --root /path/to/project --runtime-spec file:/absolute/path/codex-sdlc-0.5.0.tgz --dry-run
-codex-sdlc upgrade --root /path/to/project --runtime-spec file:/absolute/path/codex-sdlc-0.5.0.tgz
+codex-sdlc upgrade --root /path/to/project --runtime-spec file:/absolute/path/codex-sdlc-0.6.0.tgz --dry-run
+codex-sdlc upgrade --root /path/to/project --runtime-spec file:/absolute/path/codex-sdlc-0.6.0.tgz
 cd /path/to/project
 node .sdlc/runtime.cjs restore
 node .sdlc/runtime.cjs doctor

docs/getting-started.md

@@ -14,7 +14,7 @@ codex-sdlc combines a Codex skills plugin with a deterministic npm CLI. The plug
 Open the repository that should own `.sdlc` and start a new Codex task:
 
 ```text
-Initialize codex-sdlc for this existing repository. Explain the setup choices and show the dry run before applying changes. If the CLI is unavailable, use codex-sdlc@0.5.0 through npx.
+Initialize codex-sdlc for this existing repository. Explain the setup choices and show the dry run before applying changes. If the CLI is unavailable, use codex-sdlc@0.6.0 through npx.
 ```
 
 Tell Codex which applications already exist and where they live. Supported presets are Go for backend, Next.js for web, Flutter for mobile, PostgreSQL for the primary database, and Redis for cache. Codex will inspect the repository, show the proposed files, apply the same command without `--dry-run`, restore the pinned project runtime, and run diagnostics.
@@ -34,7 +34,7 @@ Tell Codex which applications already exist and where they live. Supported prese
 Preview first:
 
 ```sh
-npx --yes codex-sdlc@0.5.0 init --root /absolute/path/to/web --name example-web \
+npx --yes codex-sdlc@0.6.0 init --root /absolute/path/to/web --name example-web \
   --applications web --web-root . --web-preset nextjs --dry-run
 ```
 
@@ -54,7 +54,7 @@ One checkout is the coordinator and owns `.sdlc`. The reserved repository ID `co
 This example uses the frontend checkout as the coordinator and maps a backend elsewhere:
 
 ```sh
-npx --yes codex-sdlc@0.5.0 init \
+npx --yes codex-sdlc@0.6.0 init \
   --root /absolute/path/to/frontend \
   --name example-platform \
   --workspace-mode multi-repository \
@@ -75,22 +75,22 @@ node .sdlc/runtime.cjs doctor
 node .sdlc/runtime.cjs validate-config
 ```
 
-Only the coordinator receives `.sdlc`. The plugin skills remain in each user's Codex plugin cache. Another contributor binds their local checkout paths with `npx --yes codex-sdlc@0.5.0 configure --root <coordinator> --repo <id>=<absolute-path>` and reruns `doctor`.
+Only the coordinator receives `.sdlc`. The plugin skills remain in each user's Codex plugin cache. Another contributor binds their local checkout paths with `npx --yes codex-sdlc@0.6.0 configure --root <coordinator> --repo <id>=<absolute-path>` and reruns `doctor`.
 
-Choose single-repository or multi-repository mode before starting delivery. Version 0.5.0 does not automatically convert an initialized single-repository project to multi-repository mode. Preserve existing runs before changing topology.
+Choose single-repository or multi-repository mode before starting delivery. Version 0.6.0 does not automatically convert an initialized single-repository project to multi-repository mode. Preserve existing runs before changing topology.
 
 ## Choose agent models (optional)
 
 Ask Codex: `Configure frontend to use Astra, backend to use Luna, and PM and QC to use Sol.` The setup skill maps your choices to model IDs supported by your Codex host and stores them in the coordinator’s `.sdlc/project.yaml`. Unspecified roles inherit from Codex.
 
-You can also ask: `Enable an advisory AI Product Owner review using Sol.` The review runs after QC; final acceptance remains your decision. See [Choose a model for each role](agent-models.md) for exact commands, explicit fallbacks, and resetting settings. These options require the 0.5.0 plugin and runtime. Existing runs keep their original model settings.
+You can also ask: `Enable an advisory AI Product Owner review using Sol.` The review runs after QC; final acceptance remains your decision. See [Choose a model for each role](agent-models.md) for exact commands, explicit fallbacks, and resetting settings. Custom role settings require plugin/runtime 0.5.0 or newer. Project presets (`$sdlc --save-my-token` and `$sdlc --normal`) require 0.6.0. Existing runs keep their original model settings.
 
 ## Upgrade an existing project
 
 After installing the new plugin version, preview the project runtime upgrade:
 
 ```sh
-npx --yes codex-sdlc@0.5.0 upgrade --root /absolute/path/to/coordinator --dry-run
+npx --yes codex-sdlc@0.6.0 upgrade --root /absolute/path/to/coordinator --dry-run
 ```
 
 Run the same command without `--dry-run`, then run `node .sdlc/runtime.cjs restore`, `doctor`, and `validate-config` from the coordinator. The plugin update supplies skills; the project upgrade supplies commands and schemas.