Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -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/<task-id>` branch you hold. A task here becomes ready only after the adoption slice for its lane (`ADOPT.02.<lane>`) is recorded.
- Several workers may work here at once, each on a different claimed task in its own retained worktree and `task/<task-id>` 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 <TASK-ID> --worker <name>`, recorded as `claims/<key>`, 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 <TASK-ID>`) rather than restarting it. A task here becomes ready only after the adoption slice for its lane (`ADOPT.02.<lane>`) is recorded.
- Several workers may work here at once, each on a different claimed task in its own retained worktree and `task/<key>` 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 `[<TASK-ID>] <summary>`; 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.
Expand Down
6 changes: 3 additions & 3 deletions docs/design-policy.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Loading