>>> [!note] Migrated issue <!-- Drupal.org comment --> <!-- Migrated from issue #3588750. --> Reported by: [ajv009](https://www.drupal.org/user/3653917) >>> <h3 id="summary-problem-motivation">Problem/Motivation</h3> <p>Sprint 8 &mdash; Patterns To Encode. This is a roll-up meta-issue covering eight net-new feature requests derived from the research corpus's <code>what-actually-works.md</code> and <code>NEW-things-to-try.md</code>. Each child issue takes a pattern that demonstrably succeeded in at least one recorded session and bakes it into the migrate-site skill or its agents so that the pattern is applied by default on every future migration run &mdash; without user prompting.</p> <p>These are the flip side of the bug fixes in Sprints 1&ndash;7: instead of "fix this broken behaviour", each child issue says "this worked, encode it so it always happens." Several have direct functional overlap with bug fixes elsewhere (noted per child); this sprint encodes the positive pattern, the related sprint fixes the failure mode.</p> <h4 id="summary-steps-reproduce">Steps to reproduce</h4> <p>See each child issue for repro/evidence specific to that pattern.</p> <h3 id="summary-proposed-resolution">Proposed resolution</h3> <p>Land the eight child issues in suggested order. Order rationale:</p> <ul> <li><strong>8-01 &rarr; 8-06 &rarr; 8-03</strong>: pure documentation changes to existing agent <code>.md</code> files &mdash; zero new code, high leverage. Run first to establish communication standards (PASS/FAIL table, skill-as-cognitive-reset, committed screenshot baseline) before other agents are built on top.</li> <li><strong>8-05</strong> (getComputedStyle measurement-first): updates <code>visual-verifier.md</code> and Ralph Loop instructions; overlaps with Sprint 3 P1-10. Coordinate to avoid double-editing the same files.</li> <li><strong>8-04</strong> (retrospective phase): benefits from 8-01's table format being in place first because the retrospective phase naturally produces structured output.</li> <li><strong>8-02</strong> (Canvas content templates): most novel &mdash; requires a new phase/sub-skill and the most research. Run last so earlier issues don't block it.</li> <li><strong>8-07</strong> (Phase 1.5 content model setup) and <strong>8-08</strong> (Phase 5.5 asset library): scope-gated phases. Both depend on 1-08 (verify-scopes preflight) writing <code>scope-availability.json</code>. 8-07 is currently empirically blocked (no API endpoint shipped); 8-08 is ready (scope confirmed in canvas_oauth).</li> </ul> <h3 id="summary-remaining-tasks">Remaining tasks</h3> <ul> <li>8-01 &mdash; Promote artifact-checker PASS/FAIL table format across all sub-agents (P1, Feature Request)</li> <li>8-02 &mdash; Canvas content templates as a phase for content-type migrations (P1, Feature Request)</li> <li>8-03 &mdash; Commit-anchored screenshot baseline (P1, Feature Request)</li> <li>8-04 &mdash; Self-aware retrospective phase (Phase 9) (P1, Feature Request)</li> <li>8-05 &mdash; getComputedStyle measurement-first comparison as default visual-verifier mode (P1, Feature Request)</li> <li>8-06 &mdash; Skill-as-cognitive-reset trigger documentation (P1, Feature Request)</li> <li>8-07 &mdash; Add Phase 1.5 (content model setup) using content_type and taxonomy scopes (P2, Feature Request &mdash; currently blocked on Acquia endpoint)</li> <li>8-08 &mdash; Add Phase 5.5 (asset library setup) using <code>canvas:asset_library</code> (P2, Feature Request)</li> </ul> <h3 id="summary-ui-changes">User interface changes</h3> <p>None at the sprint level &mdash; see child issues. 8-05 changes the visual-verifier comparison methodology (measurement-first).</p> <h3 id="summary-api-changes">API changes</h3> <p>None at the sprint level. Child issues 8-02, 8-07, 8-08 consume new Canvas/Acquia Source API endpoints (page templates, content type management, asset library) but do not introduce new endpoints.</p> <h3 id="summary-data-model-changes">Data model changes</h3> <p>New artifact files: <code>docs/migration/screenshots/source-baseline/*.png</code> (8-03), <code>docs/migration/lessons.md</code> (8-04), <code>docs/migration/workflow/&lt;phase&gt;-&lt;agent&gt;-checklist.json</code> (8-01), <code>docs/migration/workflow/phase1.5-content-model-checklist.json</code> (8-07), <code>docs/migration/workflow/phase5.5-asset-library-checklist.json</code> (8-08).</p> <h3 id="summary-internal-references">Internal references</h3> <ul> <li>Sprint folder: <code>RESEARCH-2026-04-28/99-final/ISSUES/Sprint-8-Patterns-To-Encode/</code></li> <li>Sprint README: <code>Sprint-8-Patterns-To-Encode/README.md</code></li> <li>Top-level issues README: <code>RESEARCH-2026-04-28/99-final/ISSUES/README.md</code></li> <li>Pattern source: <code>RESEARCH-2026-04-28/07-cross-cutting/what-actually-works.md</code></li> <li>Pattern encoding source: <code>RESEARCH-2026-04-28/99-final/NEW-things-to-try.md</code></li> <li>Empirical scope status: <code>RESEARCH-2026-04-28/99-final/SCOPE-PROBE-FINDINGS-2026-05-01.md</code></li> </ul> <h3 id="summary-child-issues">Child issues</h3> <p>Linked child issues for this sprint (auto-rendered with status badges):</p> <ul> <li><span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/canvas_ai_migrations/issues/3588798" title="Status: Closed (fixed)">#3588798: [Sprint 8] Promote PASS/FAIL table format across all sub-agents</a></span></li> <li><span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/canvas_ai_migrations/issues/3588799" title="Status: Closed (fixed)">#3588799: [Sprint 8] Canvas content templates as a phase for content-type migrations</a></span></li> <li><span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-5"><a href="https://www.drupal.org/project/canvas_ai_migrations/issues/3588800" title="Status: Closed (won't fix)">#3588800: [Sprint 8] Commit-anchored screenshot baseline for QA</a></span></li> <li><span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/canvas_ai_migrations/issues/3588804" title="Status: Closed (fixed)">#3588804: [Sprint 8] Self-aware retrospective phase (Phase 9)</a></span></li> <li><span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-4"><a href="https://www.drupal.org/project/canvas_ai_migrations/issues/3588805" title="Status: Postponed">#3588805: [Sprint 8] getComputedStyle measurement-first as default visual-verifier mode</a></span></li> <li><span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/canvas_ai_migrations/issues/3588806" title="Status: Closed (fixed)">#3588806: [Sprint 8] Skill-as-cognitive-reset trigger documentation</a></span></li> <li><span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/canvas_ai_migrations/issues/3588808" title="Status: Closed (fixed)">#3588808: [Sprint 8] Add Phase 1.5 (content model setup) using content_type and taxonomy scopes</a></span></li> <li><span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/canvas_ai_migrations/issues/3588809" title="Status: Closed (fixed)">#3588809: [Sprint 8] Add Phase 5.5 (asset library setup) using canvas:asset_library</a></span></li> </ul>