>>> [!note] Migrated issue <!-- Drupal.org comment --> <!-- Migrated from issue #3588749. --> Reported by: [ajv009](https://www.drupal.org/user/3653917) >>> <h3 id="summary-problem-motivation">Problem/Motivation</h3> <p>Sprint 6 &mdash; Skill Architecture &amp; Quality. This roll-up tracks long-game structural improvements to the migrate-site skill: file size discipline, phase ordering, dynamic content-type support, and the Figma pipeline's single point of failure. These are not bug fixes that unblock a specific run &mdash; they are changes to how the skill is structured and what phases it contains. Each one makes every future migration run cheaper, more complete, or less likely to hit a hard blocker on the first attempt.</p> <p>The four contributors are independent &mdash; none has a sequential dependency on the others &mdash; so the suggested order is by risk and speed, not by data flow. 6-01 is a one-line SKILL.md change (homepage-first ordering in Phase 7) that ensures the most important page is always composed; in a recorded session the homepage was never reached, leaving the entire Storybook component library looking like a blank canvas-starter template. 6-02 is a single preflight check on the figma-analyzer that prevents a 13+ hour design investment from being wasted on a monthly hard cap that has already been hit twice. 6-03 adds an entire missing phase (Phase 4.5) and a new agent for Canvas content templates so that dynamic content sites (events, blog posts, news items) end up self-service rather than requiring a script to create a Canvas page for every new node. 6-04 is the user-requested 4-step gated audit of skill files over 300 lines: a baseline reconnaissance step before any future skill rewrite.</p> <h4 id="summary-steps-reproduce">Steps to reproduce</h4> <p>See each child issue for repro steps specific to that defect.</p> <h3 id="summary-proposed-resolution">Proposed resolution</h3> <p>Land the four child issues in suggested order. Order rationale:</p> <ul> <li><strong>6-01 first</strong> (Phase 7 homepage ordering) &mdash; single SKILL.md text change, fastest win in the sprint, unblocks all page composition quality, costs nothing to implement.</li> <li><strong>6-02 second</strong> (Figma rate limit preflight) &mdash; also small effort and self-contained: a change to the figma-analyzer agent only. Prevents a catastrophic time-waste that has already happened twice.</li> <li><strong>6-03 third</strong> (Canvas content templates) &mdash; medium effort because it adds a new Phase 4.5 and a new <code>canvas-content-template-agent.md</code>. Touches more files and requires thinking through the discovery logic and verification gate.</li> <li><strong>6-04 last</strong> (skill file audit) &mdash; medium effort, structured as a 4-step gated task with an explicit user gate after step 3. Placed last because the audit is best done after 6-01, 6-02, and 6-03 are already incorporated; otherwise the audit examines a stale state.</li> </ul> <h3 id="summary-remaining-tasks">Remaining tasks</h3> <ul> <li>6-01 &mdash; Phase 7 homepage not prioritized, 4 of 8 pages missing (P1, Bug Report)</li> <li>6-02 &mdash; Figma MCP rate limit (6 calls/month) kills Figma-first pipeline (P2, Bug Report)</li> <li>6-03 &mdash; Canvas content templates not used for content-type migrations (P2, Feature Request &mdash; new Phase 4.5 + new agent)</li> <li>6-04 &mdash; Skill file &gt;300 line audit + lazy-load reference architecture (P2, Task &mdash; gated 4-step audit)</li> </ul> <h3 id="summary-ui-changes">User interface changes</h3> <p>None at the sprint level &mdash; see child issues.</p> <h3 id="summary-api-changes">API changes</h3> <p>None at the sprint level &mdash; see child issues.</p> <h3 id="summary-data-model-changes">Data model changes</h3> <p>New artifact files: <code>workflow/08-migration-complete-checklist.json</code> (6-01, shared with Sprint 1 1-06), <code>workflow/content-template-&lt;type&gt;-complete.json</code> (6-03). New agent file: <code>.claude/agents/canvas-content-template-agent.md</code> (6-03). No schema changes to existing migration artefacts.</p> <h3 id="summary-definition-of-done">Definition of done</h3> <ul> <li><code>SKILL.md</code> Phase 7 section explicitly names homepage (<code>/</code>) as the first page to compose, with priority order: homepage, about, services, then remaining pages.</li> <li><code>SKILL.md</code> Phase 8 completion gate prevents <code>migration_completed</code> being logged unless every page has at least 3 components excluding site-header and site-footer.</li> <li>The figma-analyzer agent (or SKILL.md Figma branch) has a single preflight <code>get_metadata</code> call that fails fast with clear options on rate limit error and never retries on 429.</li> <li>The manual CSS paste fallback is documented as a first-class option in the SKILL.md Figma branch.</li> <li><code>SKILL.md</code> has a Phase 1 dynamic-content-type detection step and a Phase 4.5 covering Canvas content template creation, with a self-service verification gate (creating a test node in the admin UI must render correctly without scripts).</li> <li><code>.claude/agents/canvas-content-template-agent.md</code> exists and describes the <code>node.&lt;type&gt;.full</code> template creation workflow with entity-field prop bindings.</li> <li>6-04 has produced a written audit report (table of files over 300 lines + per-file proposals) ready for user review &mdash; NO destructive changes have been made before user sign-off.</li> <li><code>docs/migration/gotchas.md</code> has Figma rate limit and Canvas content template entries.</li> </ul> <h3 id="summary-internal-references">Internal references</h3> <ul> <li>Sprint folder: <code>RESEARCH-2026-04-28/99-final/ISSUES/Sprint-6-Skill-Architecture/</code></li> <li>Sprint README: <code>Sprint-6-Skill-Architecture/README.md</code></li> <li>Top-level issues README: <code>RESEARCH-2026-04-28/99-final/ISSUES/README.md</code></li> <li>Recommendation source: <code>RESEARCH-2026-04-28/99-final/migrate-site-skill-recommendations.md</code></li> <li>Consolidated issues: <code>RESEARCH-2026-04-28/99-final/consolidated-issues.md</code> (P1-11, P2-3, P2-6, P2-7)</li> <li>Skill evolution timeline: <code>RESEARCH-2026-04-28/07-cross-cutting/migrate-site-skill-evolution.md</code></li> <li>Memory rule: <code>feedback_dry_skill_instructions.md</code> (one shared note beats per-phase repetition &mdash; informs 6-04 audit criteria)</li> </ul> <h3 id="summary-open-questions">Open questions</h3> <ul> <li>6-01 and Sprint 1 1-06 both touch the same Phase 8 gate section in SKILL.md. Resolve as a single edit to avoid touching the section twice &mdash; confirm scope ownership when scheduling.</li> <li>6-03 depends on whether <code>page_template:administer</code> exposes a usable REST endpoint on the target Acquia Source instance. Empirical probe on 2026-05-01 found the endpoints still return 404 &mdash; implement the agent using the browser-session path until <code>scripts/verify-scopes.mjs</code> (Sprint 1 1-08) reports otherwise.</li> <li>6-04 step 2 (per-file evaluation): the user's verbatim request says "separate sub agents think about EACH skill" &mdash; confirm one planning subagent per oversized file, dispatched in parallel, before starting.</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/3588791" title="Status: Closed (fixed)">#3588791: [Sprint 6] Phase 7 &mdash; homepage not prioritized, 4 of 8 pages missing</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/3588792" title="Status: Postponed">#3588792: [Sprint 6] Figma MCP rate limit kills Figma-first pipeline</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/3588793" title="Status: Closed (fixed)">#3588793: [Sprint 6] Canvas content templates not used for content-type migrations</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/3588795" title="Status: Closed (fixed)">#3588795: [Sprint 6] Skill file audit &mdash; lazy-load reference architecture</a></span></li> </ul>