>>> [!note] Migrated issue <!-- Drupal.org comment --> <!-- Migrated from issue #3588791. --> Reported by: [ajv009](https://www.drupal.org/user/3653917) >>> <h3 id="summary-problem-motivation">Problem/Motivation</h3> <p>Phase 7 content composition dispatches content-composer agents in discovery order &mdash; the order pages were found by site-analyzer in Phase 1 &mdash; which is neither priority-ordered nor guaranteed to reach the homepage before the session budget is exhausted. SKILL.md Phase 7 has no explicit page ordering instruction.</p> <p>In a recorded session, the sequential content-composer dispatch processed pages in arbitrary order, ran out of time, and never attempted the homepage. Only 4 of 8 pages were composed. The homepage, /about, /artificial-intelligence, and /contact-us were all skipped. The result: <code>Home.stories.tsx</code> contained generic boilerplate ("Welcome to Our Site", "Service One", placehold.co images) &mdash; the canvas-starter default, not the migrated content. The entire Storybook component library looked like an unconfigured template rather than a clone of the source site.</p> <p>The homepage is the primary visual deliverable of any site migration &mdash; it is what the user opens first to judge the quality of the work. If the session budget is exhausted, the homepage must be the one page that is definitely composed.</p> <p>This issue covers the ordering fix only; Sprint 1 1-04 covers the parallelism fix that also contributes to running out of time. There was also no completion gate: <code>migration_completed</code> was logged while 7 of 8 pages were still skeleton-only (header + footer). The Phase 8 gate proposed below also addresses Sprint 1 1-06 (stale completion).</p> <h4 id="summary-steps-reproduce">Steps to reproduce</h4> <ol> <li>Run the migrate-site skill end-to-end against a multi-page site with 6 or more pages.</li> <li>Observe Phase 7 dispatch order in the session JSONL &mdash; pages are processed in discovery order, not priority order.</li> <li>If the session reaches its time/turn budget before all pages are done, inspect the resulting <code>Home.stories.tsx</code>: it will contain the canvas-starter "Welcome to Our Site" boilerplate.</li> <li>Inspect <code>state.jsonl</code>: <code>migration_completed</code> may be logged even though 7 of 8 pages contain only header + footer.</li> </ol> <h3 id="summary-proposed-resolution">Proposed resolution</h3> <p><strong>Step 1 &mdash; Add a Phase 7 priority-order block</strong> to <code>.claude/skills/migrate-site/SKILL.md</code>, immediately before the content-composer dispatch instructions:</p> <pre>PHASE 7 COMPOSITION ORDER: ALWAYS compose the homepage (/) first. The homepage is the primary visual deliverable. If the session budget is exhausted before all pages are done, the homepage must be the one page that is definitely composed with full verbatim content. Priority order: 1. / (homepage) &mdash; FIRST, always 2. /about 3. /services (or equivalent primary service page) 4. All remaining pages in any order CRITICAL: Phase 7 dispatches are INDEPENDENT (each page writes to its own content file). Batch 4-6 content-composer Agent calls in a SINGLE turn &mdash; NOT one at a time. (See Sprint 1 1-04 for the parallelism mandate.)</pre><p><strong>Step 2 &mdash; Add a Phase 8 final completion gate</strong> (also resolves Sprint 1 1-06):</p> <pre>PHASE 8 &mdash; Final Completion Gate (mandatory before migration_completed): Run artifact-checker with: 1. All pages in the page inventory have page JSON files in content/page/ 2. Each page JSON has at least 3 components EXCLUDING site-header and site-footer 3. All media files are uploaded (media-map.md shows no "pending" entries) 4. All hard gates have "passed: true" in their checklist JSON files Only after ALL 4 criteria pass: log migration_completed in state.jsonl. Write 08-migration-complete-checklist.json to docs/migration/workflow/.</pre><p>Both changes are SKILL.md text only &mdash; no new agent files required.</p> <h3 id="summary-remaining-tasks">Remaining tasks</h3> <ul> <li>Add the Phase 7 priority-order block to SKILL.md.</li> <li>Add the Phase 8 completion gate block to SKILL.md.</li> <li>Confirm scope with Sprint 1 1-06 (stale <code>migration_completed</code>) &mdash; this Phase 8 gate also fixes that issue. Resolve both together to avoid touching the same SKILL.md section twice.</li> <li>Verify on a fresh run: the first content-composer Agent dispatch in Phase 7 must target the homepage URL (<code>/</code>).</li> <li>Verify <code>migration_completed</code> is not logged when any page has fewer than 3 non-header/non-footer components.</li> </ul> <h3 id="summary-ui-changes">User interface changes</h3> <p>None.</p> <h3 id="summary-api-changes">API changes</h3> <p>None.</p> <h3 id="summary-data-model-changes">Data model changes</h3> <p>New artifact: <code>docs/migration/workflow/08-migration-complete-checklist.json</code> (shared with Sprint 1 1-06).</p> <h3 id="summary-internal-references">Internal references</h3> <ul> <li>Source markdown: <code>RESEARCH-2026-04-28/99-final/ISSUES/Sprint-6-Skill-Architecture/01-P1-11-phase7-homepage-not-prioritized.md</code> (id: P1-11)</li> <li>Consolidated issue: <code>RESEARCH-2026-04-28/99-final/consolidated-issues.md</code> &sect; P1-11 &mdash; all evidence and deep analysis verbatim</li> <li>CRITICAL P0 recommendation 5: <code>RESEARCH-2026-04-28/00-existing-issues/prior-deep-analysis-key-points.md</code> (Phase 7 homepage ordering)</li> <li>Recommended verbatim text: <code>RESEARCH-2026-04-28/99-final/migrate-site-skill-recommendations.md</code> &sect; SKILL.md / Add: Homepage Priority in Phase 7 Ordering</li> <li>Phase 8 gate source: <code>RESEARCH-2026-04-28/99-final/migrate-site-skill-recommendations.md</code> &sect; SKILL.md / Add: Phase 8 Final Completion Gate</li> <li>Open P0 items confirming this is missing: <code>RESEARCH-2026-04-28/07-cross-cutting/migrate-site-skill-evolution.md</code> &sect; 95q5i Session Failures and Open P0 Items (item 6)</li> <li>Session evidence: <code>RESEARCH-2026-04-28/06-jamie-demo-old/95q5i-77cf5bb9-half1/issues-found.md</code> I1 (<code>migration_completed</code> logged with 7/8 pages empty)</li> </ul> <h3 id="summary-open-questions">Open questions</h3> <ul> <li>Does the current SKILL.md Phase 7 have any ordering instruction at all, or is it purely discovery-order? If it has an existing ordering instruction, the edit is a replacement rather than an insertion.</li> <li>The Phase 8 gate is also proposed in Sprint 1 1-06 (stale <code>migration_completed</code> with empty pages). Resolve 1-06 as part of this issue, or vice versa, to avoid touching the same SKILL.md section twice.</li> </ul>