From 271c41be294edf35fc9dde2ebb2d5dcfaf93d851 Mon Sep 17 00:00:00 2001 From: sammiller Date: Fri, 25 Sep 2026 16:07:12 +0800 Subject: [PATCH] [P2-018] Re-pin the delivery model to the repaired claim and handoff rules Point the P2-018 section at Design-B f8dff2d (ArcForges-Design-B#3) and the Plan execution entry at Plan-B ec88207 (Plan-B#3), which replace the earlier prompt revision. Describe the Windows-safe claim and branch keys (claims/, task/), resumption from the claim's handoff record, and merges by the integration role holder at the reviewed head commit with the task IDs kept in the merge title. The design-policy note links to the same Design commit; the checker, its pin and the exports are unchanged. Documentation only; no source, dependency, package or workflow change. Co-Authored-By: Claude Opus 5.5 --- AGENTS.md | 10 +++++----- docs/design-policy.md | 6 +++--- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index a52ea71..7b8760e 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -20,12 +20,12 @@ The accepted architecture lives in [ArcForges-Design](https://github.com/ArcForg ## Delivery model (P2-018) -Work is scheduled as delivery tasks in the [delivery graph](https://github.com/ArcForges/ArcForges-Design-B/blob/fd16c5f285de0bda2d0320cdff4d52c34c9098ed/docs/planning/delivery/README.md) and executed through the [Plan execution entry](https://github.com/ArcForges/Plan-B/blob/0cb637d1bfbf64d7db22a96a2b7370a409a25d8e/arcforges-implementation.md). There is no Current task, numbered substep order or single main context. +Work is scheduled as delivery tasks in the [delivery graph](https://github.com/ArcForges/ArcForges-Design-B/blob/f8dff2d0144c7db020d35711d606334639dd078b/docs/planning/delivery/README.md) and executed through the [Plan execution entry](https://github.com/ArcForges/Plan-B/blob/ec8820732486464e92df89788edb89eafac86afb/arcforges-implementation.md). There is no Current task, numbered substep order or single main context. -- Baseline: WP00–WP02 are accepted (build governance, dependency admission, lockstep NuGet publication and the design-policy exports). Building blocks are placeholders and native families are probe-level; every platform, native, assistant and updater capability is an open task. This repository's tasks are in the [platform](https://github.com/ArcForges/ArcForges-Design-B/blob/fd16c5f285de0bda2d0320cdff4d52c34c9098ed/docs/planning/delivery/lanes/platform.md), [native](https://github.com/ArcForges/ArcForges-Design-B/blob/fd16c5f285de0bda2d0320cdff4d52c34c9098ed/docs/planning/delivery/lanes/native.md), [foundation](https://github.com/ArcForges/ArcForges-Design-B/blob/fd16c5f285de0bda2d0320cdff4d52c34c9098ed/docs/planning/delivery/lanes/foundation.md), [assistant](https://github.com/ArcForges/ArcForges-Design-B/blob/fd16c5f285de0bda2d0320cdff4d52c34c9098ed/docs/planning/delivery/lanes/assistant.md), [execution](https://github.com/ArcForges/ArcForges-Design-B/blob/fd16c5f285de0bda2d0320cdff4d52c34c9098ed/docs/planning/delivery/lanes/execution.md), [updater](https://github.com/ArcForges/ArcForges-Design-B/blob/fd16c5f285de0bda2d0320cdff4d52c34c9098ed/docs/planning/delivery/lanes/updater.md), [app-composition](https://github.com/ArcForges/ArcForges-Design-B/blob/fd16c5f285de0bda2d0320cdff4d52c34c9098ed/docs/planning/delivery/lanes/app-composition.md), [device-bridge](https://github.com/ArcForges/ArcForges-Design-B/blob/fd16c5f285de0bda2d0320cdff4d52c34c9098ed/docs/planning/delivery/lanes/device-bridge.md), [extensions](https://github.com/ArcForges/ArcForges-Design-B/blob/fd16c5f285de0bda2d0320cdff4d52c34c9098ed/docs/planning/delivery/lanes/extensions.md), [runtime-proofs](https://github.com/ArcForges/ArcForges-Design-B/blob/fd16c5f285de0bda2d0320cdff4d52c34c9098ed/docs/planning/delivery/lanes/runtime-proofs.md), [governance](https://github.com/ArcForges/ArcForges-Design-B/blob/fd16c5f285de0bda2d0320cdff4d52c34c9098ed/docs/planning/delivery/lanes/governance.md) lanes and parts of the Cloud-core, policy and release lanes. -- Start only a task that Plan-B's `python tools/delivery.py ready --claims` lists and whose `claims/` branch you hold. A task here becomes ready only after the adoption slice for its lane (`ADOPT.02.`) is recorded. -- Several workers may work here at once, each on a different claimed task in its own retained worktree and `task/` branch, inside the task's write scope. Each native family adds its own CMake targets, wrapper project and workflow entries, and each managed mechanism its own project, so families and mechanisms proceed in parallel. -- Shared files follow their [declared protocols](https://github.com/ArcForges/ArcForges-Design-B/blob/fd16c5f285de0bda2d0320cdff4d52c34c9098ed/docs/planning/delivery/shared-resources.md): solution and project lists, `Directory.Packages.props` and CI job lists are appended by the task that adds a project, dependency or job, and lock files are regenerated after rebase, never hand-merged; `eng/packaging/packages.json` gains one entry per producer task and every merge to main publishes all packages at one version; the vcpkg baseline and overlay ports change only through a dependency-admission change; generated policy data is regenerated from its pinned source and the reason-code registry is append-only; assistant store migrations are numbered at merge. The DesktopPlatform integration owner orders merges and merges only pull requests of the claimant at the current claim epoch. +- Baseline: WP00–WP02 are accepted (build governance, dependency admission, lockstep NuGet publication and the design-policy exports). Building blocks are placeholders and native families are probe-level; every platform, native, assistant and updater capability is an open task. This repository's tasks are in the [platform](https://github.com/ArcForges/ArcForges-Design-B/blob/f8dff2d0144c7db020d35711d606334639dd078b/docs/planning/delivery/lanes/platform.md), [native](https://github.com/ArcForges/ArcForges-Design-B/blob/f8dff2d0144c7db020d35711d606334639dd078b/docs/planning/delivery/lanes/native.md), [foundation](https://github.com/ArcForges/ArcForges-Design-B/blob/f8dff2d0144c7db020d35711d606334639dd078b/docs/planning/delivery/lanes/foundation.md), [assistant](https://github.com/ArcForges/ArcForges-Design-B/blob/f8dff2d0144c7db020d35711d606334639dd078b/docs/planning/delivery/lanes/assistant.md), [execution](https://github.com/ArcForges/ArcForges-Design-B/blob/f8dff2d0144c7db020d35711d606334639dd078b/docs/planning/delivery/lanes/execution.md), [updater](https://github.com/ArcForges/ArcForges-Design-B/blob/f8dff2d0144c7db020d35711d606334639dd078b/docs/planning/delivery/lanes/updater.md), [app-composition](https://github.com/ArcForges/ArcForges-Design-B/blob/f8dff2d0144c7db020d35711d606334639dd078b/docs/planning/delivery/lanes/app-composition.md), [device-bridge](https://github.com/ArcForges/ArcForges-Design-B/blob/f8dff2d0144c7db020d35711d606334639dd078b/docs/planning/delivery/lanes/device-bridge.md), [extensions](https://github.com/ArcForges/ArcForges-Design-B/blob/f8dff2d0144c7db020d35711d606334639dd078b/docs/planning/delivery/lanes/extensions.md), [runtime-proofs](https://github.com/ArcForges/ArcForges-Design-B/blob/f8dff2d0144c7db020d35711d606334639dd078b/docs/planning/delivery/lanes/runtime-proofs.md), [governance](https://github.com/ArcForges/ArcForges-Design-B/blob/f8dff2d0144c7db020d35711d606334639dd078b/docs/planning/delivery/lanes/governance.md) lanes and parts of the Cloud-core, policy and release lanes. +- Start only a task that Plan-B's `python tools/delivery.py ready` lists and whose claim you hold (`python tools/delivery.py claim --worker `, recorded as `claims/`, the ID in lower case with dots replaced by hyphens, such as `claims/plt-11`); continue interrupted work from its handoff record (`python tools/delivery.py show `) rather than restarting it. A task here becomes ready only after the adoption slice for its lane (`ADOPT.02.`) is recorded. +- Several workers may work here at once, each on a different claimed task in its own retained worktree and `task/` branch, inside the task's write scope. Each native family adds its own CMake targets, wrapper project and workflow entries, and each managed mechanism its own project, so families and mechanisms proceed in parallel. +- Shared files follow their [declared protocols](https://github.com/ArcForges/ArcForges-Design-B/blob/f8dff2d0144c7db020d35711d606334639dd078b/docs/planning/delivery/shared-resources.md): solution and project lists, `Directory.Packages.props` and CI job lists are appended by the task that adds a project, dependency or job, and lock files are regenerated after rebase, never hand-merged; `eng/packaging/packages.json` gains one entry per producer task and every merge to main publishes all packages at one version; the vcpkg baseline and overlay ports change only through a dependency-admission change; generated policy data is regenerated from its pinned source and the reason-code registry is append-only; assistant store migrations are numbered at merge. The DesktopPlatform integration owner (the holder of `roles/integration-desktopplatform`) orders merges and merges only at the head commit reviewed for the claimant at the current claim epoch, keeping the task IDs in the merge title. - Title pull requests `[] `; a bundle of compatible ready tasks lists each ID, and planning alignment uses `[P2-018]`. - The design-policy check still validates the retired package graph at the pinned Design commit. Keep `eng/policy/design-source.json` at a pre-P2-018 Design commit until the governance task `GOV.14` replaces that check with delivery-graph validation; see [design policy](docs/design-policy.md). - Earlier `docs/` records named after work packages or substeps describe their original scope; they are evidence, not execution instructions. diff --git a/docs/design-policy.md b/docs/design-policy.md index f0d7083..e7fda11 100644 --- a/docs/design-policy.md +++ b/docs/design-policy.md @@ -79,11 +79,11 @@ establish no provider, device, product behavior or commercial activation evidenc ## Delivery model (P2-018) -[P2-018](https://github.com/ArcForges/ArcForges-Design-B/blob/fd16c5f285de0bda2d0320cdff4d52c34c9098ed/docs/decisions/phase-2-specification-decisions.md#rule-p2-018) replaces the numbered serial -sequence with the [delivery graph](https://github.com/ArcForges/ArcForges-Design-B/blob/fd16c5f285de0bda2d0320cdff4d52c34c9098ed/docs/planning/delivery/README.md). This checker still validates the +[P2-018](https://github.com/ArcForges/ArcForges-Design-B/blob/f8dff2d0144c7db020d35711d606334639dd078b/docs/decisions/phase-2-specification-decisions.md#rule-p2-018) replaces the numbered serial +sequence with the [delivery graph](https://github.com/ArcForges/ArcForges-Design-B/blob/f8dff2d0144c7db020d35711d606334639dd078b/docs/planning/delivery/README.md). This checker still validates the retired package-level forward and reverse graphs, package header dependencies, topological order and serial execution line, so it cannot accept a Design commit that contains P2-018. Keep the pin at a pre-P2-018 commit, which remains valid for the glossary and invariant exports, until the governance task `GOV.14` replaces the graph check with the delivery-graph validation specified in the -[design policy export](https://github.com/ArcForges/ArcForges-Design-B/blob/fd16c5f285de0bda2d0320cdff4d52c34c9098ed/docs/architecture/29-design-policy-export.md). DesktopPlatform then moves the pin +[design policy export](https://github.com/ArcForges/ArcForges-Design-B/blob/f8dff2d0144c7db020d35711d606334639dd078b/docs/architecture/29-design-policy-export.md). DesktopPlatform then moves the pin through the normal reviewed refresh above. The P2-018 alignment changed no checker code, pin or export.