Back to Signal Feed
CodeTracked since May 19, 2026

Fix session-continuity resume instructions for per-unit construction artifacts

The PR fixes incorrect Per-Unit Design artifact-loading guidance in `session-continuity.md` by replacing outdated, unqualified filenames with the actual unit-scoped path format and explicit unit-selection flow, so resumed sessions can locate the correct artifacts from Construction.

session-continuity.mdPer-Unit Designaidlc-docs/construction/{unit-name}/aidlc-state.md

What Happened

  • The PR fixes incorrect Per-Unit Design artifact-loading guidance in `session-continuity.md` by replacing outdated, unqualified filenames with the actual unit-scoped path format and explicit unit-selection flow, so resumed sessions can locate the correct artifacts from Construction.
  • The PR fixes incorrect Per-Unit Design artifact-loading guidance in `session-continuity.md` by replacing outdated, unqualified filenames with the actual unit-scoped path format and explicit unit-selection flow, so resumed sessions can locate the correct artifacts from Construction.
  • 1 evidence item attached for review.

What is Different

Before

Scattered source updates, isolated context, and manual follow-up across multiple feeds.

Now

Corrected the documentation and workflow logic for mid-Construction resume: it now aligns Per-Unit Design artifact loading with the real directory layout and unit context, preventing resumed sessions from trying to read nonexistent root-level files.

Why Track This

Why It Matters

For teams running multi-unit construction workflows, resumed sessions now have a reliable path to the exact unit artifacts they need, reducing resume failures and manual intervention when work is handed off or restarted mid-run. The fix maps resume instructions to `aidlc-docs/construction/{unit-name}/...` and makes unit resolution explicit through `aidlc-state.md` plus dependency guidance; continue monitoring whether future stage output naming or layout changes are propagated to avoid the documentation becoming stale again.

Impact

For teams running multi-unit construction workflows, resumed sessions now have a reliable path to the exact unit artifacts they need, reducing resume failures and manual intervention when work is handed off or restarted mid-run. The fix maps resume instructions to `aidlc-docs/construction/{unit-name}/...` and makes unit resolution explicit through `aidlc-state.md` plus dependency guidance; continue monitoring whether future stage output naming or layout changes are propagated to avoid the documentation becoming stale again.

What To Watch Next

  • Watch whether session-continuity.md becomes a repeated pattern.
  • Track follow-up changes around AI Workflow Automation.
  • Compare future signals against this evidence trail.
  • Re-check risk flags: artifact_path_and_filename_drift, multi_unit_resume_unit_selection_errors.
Open Topic TimelineOpen Technical EventOpen Original Sourceartifact_path_and_filename_drift / multi_unit_resume_unit_selection_errors / stale_session_continuity_docs

Supporting Evidence

GITHUB PULL REQUESTHigh Trust

awslabs/aidlc-workflows PR #276: fix: scope per-unit artifact loading to unit directories in session-continuity

Per-Unit Design resume guidance now points to `aidlc-docs/construction/{unit-name}/{functional-design,nfr-requirements,nfr-design,infrastructure-design}/` and resolves the active unit via `aidlc-state.md` plus dependency links instead of a stale file list.