Files
channel-delivery-skic/references/planning-artifact-reconciliation.md

4.7 KiB

Planning-artifact reconciliation

Use when planning or readiness documentation changes while implementation remains gated.

Verification owners — load at the decision point

Before verifying a PR or CI, run skill_view(name="development-gates") and load its references/review-ci-merge-contract.md: Evidence model, Attempt integrity, and Concurrent publication own candidate/remote equality, complete successful job inventory including aggregates, and separate integration evidence. Do not use a successful listed-task subset as a gate.

Before reporting, load skill_view(name="development-integrity") and its references/remote-checkpoint-matrix.md for the current remote checkpoint, changed-head invalidation and candidate-versus-integration claims; then load status-and-reporting.md for Delivery formatting. Preserve project merge authority; A02/A04 follow global independent review-before-push and any-target-base-change invalidation without local exceptions.

Before validation, load documentation-docusaurus-global and the project-adopted overlay through Documentation Ownership; verify source identity. Run the complete repository validator and production build with frozen-lockfile installation and git diff --check. Generic and VSSA packages now have separate source-qualified names. Retain the bounded nested-pnpm fallback below until that procedure is present in the generic owner; identity repair alone does not establish procedural coverage.

If child scripts cannot find pnpm, use corepack enable --install-directory <cache>/pnpm-bin, prepend that temporary shim directory to PATH, and rerun the declared command. Keep shim/dependency caches outside commits and verify the worktree remains clean.

Retained validation bindings

  • Use the fresh PR API head.ref and full SHA, never a title or old report, for a clean detached worktree inside the Task boundary. Assert its actual HEAD and process working directory before repository-native validation. These exact-worktree checks remain local until the installed owner carries them.
  • If the PR merged or closed during validation, update its reported state and validate the freshly resolved merge/default head, including semantic probes. Use the owners above for fresh evidence immediately before reporting; repeat if it changes. Keep API task id, run_number, run/attempt/job IDs and UI URLs distinct in retained evidence.

Delivery interpretation

Read current same-project activity and distinguish human decisions from agent reports. Verify changed artifacts by authenticated readback at the validated revision and inspect their semantics: the exact Task row and status, evidence timestamp, new head/task pairs and absence of superseded pairs when reconciliation claims their removal. Parse lifecycle sections separately; headings, keyword counts and generated presentations are not Task-state evidence. If a probe disagrees with rendered Markdown, inspect numbered lines and correct the probe before reporting.

New pickup requires current READY_FOR_DELIVERY, dependencies, target version, parent Feature implementation approval and FR/NFR/ADR/UI/UX readiness under the preserved project authority. That status already records admission: no second Focus-admission decision. Continuation instead requires current IN_PROGRESS, its existing claim and historical verified admission; do not demand re-admission or mistake historical portfolio status for current Task authority. A merged Board page does not itself admit a Task. If the gate remains closed, do not create application changes; verify or reconcile documentation or route the evidenced blocker instead.

Evidence interpretation

Evidence What it proves What it does not prove
Documentation PR merged by a human The reviewed documentation landed Feature implementation approval
Architecture hierarchy/validator passes Documentation structure meets its contract A proposed Feature has an accepted solution
Kanban Board lists an item in ideation The unfinished scope record is visible Exact Task READY_FOR_DELIVERY handoff
Documentation CI succeeds That documentation head passed its checks Application CI or release readiness
Application baseline CI succeeds The observed application head is healthy A new Task PR, deployment, or release

Avoid duplicate status

Before posting, compare the proposed report with enough Delivery history to find the newest marker, head SHA, CI task, and blocker set. If there is no new human decision, repository head, CI result, actionable failure, or durable documentation change, return the configured silent response instead of restating the same gate.