readme: consolidate What's-new stack, name engineering-process skills, state delegate-selection order - #88
Conversation
…, state delegate-selection order Removes the released v4.3.5-v4.6.0 What's-new sections (history lives in CHANGELOG.md; the untagged v4.7.0-v4.9.0 tail stays until released), adds decision-map/prototype/architecture-review to the Skill surface enumeration, and spells out the capability-availability-cost selection law in the cost-tiered delegation bullet. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: dfae14ce18
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
…ation (codex P2) CHANGELOG.md currently holds only [Unreleased]; released history lives in uncompiled fragments, so the What's-new stack is the only reader-facing versioned history until a release cut compiles it. Consolidation deferred to that cut. Skill-surface and delegate-selection edits unchanged. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 9fc052c8d2
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| cost and quality stay auditable. Delegate selection follows a fixed order: | ||
| capability first (the delegate must clear the task's quality bar — an | ||
| under-capable cheap choice that forces rework costs more than it saves), | ||
| availability second (an exhausted quota pool is infeasible, not merely | ||
| expensive), and only then cost rank, preferring routes that conserve the |
There was a problem hiding this comment.
When users delegate through the shipped skills, no fixed capability→availability→cost selection currently occurs: skill-specs/dev-delegate.md requires the primary to select one explicit route, while skill-specs/route.md states that automatic worker routing is unavailable and that an unavailable explicit target stops without substitution. Thus this user-facing statement promises current behavior that neither the editable skill policy nor the coordinator provides; describe it as a future policy or add it to the authoritative skill workflow.
AGENTS.md reference: AGENTS.md:L9-L12
Useful? React with 👍 / 👎.
…-instructed) (#89) Removes the released v4.3.5-v4.6.0 sections and rewords the history pointer to state accurately that release notes live as changelog.d/ fragments compiled into CHANGELOG.md at each release cut. Operator instructed consolidation with the compilation gap known (overrides the defer recorded on #88); the unreleased v4.7.0-v4.9.0 tail stays, keeping the release-consistency whatsnew-version gate satisfied. Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
1 participant
Public-README currency pass following the workspace-README concept review (workspace #2533), per operator instruction: consolidate stacked release notes, surface the v4.7.0 engineering-process skills, and state the delegate-selection law.
What changed
CHANGELOG.md) are removed; the unreleased v4.7.0–v4.9.0 tail stays until those versions ship, and the existing "full, versioned release history" CHANGELOG pointer covers the rest. 145 lines removed; the architecture section is no longer buried mid-page.decision-map,prototype,architecture-review) shipped in v4.7.0 — previously visible only in release notes.plugins/content, version, or contract change; repo-root README only.Deliberately NOT added: the workspace learning loop (operator-confirmed workspace-only — the package ships no learning-loop capability, so documenting it here would overclaim), drift sentinel, CI budget governor, GitHub API quota mechanics (all workspace-internal).
Validation
git diff --checkclean; 3 What's-new sections remain (v4.9.0/v4.8.0/v4.7.0)author: claude
standing_directives: operator-instructed draft (2026-08-04); distribution-boundary respected (no workspace-internal subsystems added); fragment-only changelog; directive #5 note: not a release PR — README refresh here is content-currency, release-cycle refresh unaffected
tier: 1
cross_check: N/A (tier 1 — repo-root README + changelog fragment only; no plugins/ content, schema, or workflow change)
post_condition: pre-push release-consistency all PASS; git diff --check clean
mcp_coverage_gap: NONE
contributor_rights: OWNER-AUTHORED
operator_reserved: no
plugin_affected: NONE (repo-root README only; package content untouched, no version bump required)
🤖 Generated with Claude Code