Skip to content

Add DSYS-616 cross-repo migration automation spec#1007

Draft
georgewrmarshall wants to merge 8 commits intomainfrom
chore/dsys-616-automation
Draft

Add DSYS-616 cross-repo migration automation spec#1007
georgewrmarshall wants to merge 8 commits intomainfrom
chore/dsys-616-automation

Conversation

@georgewrmarshall
Copy link
Copy Markdown
Contributor

@georgewrmarshall georgewrmarshall commented Mar 27, 2026

Description

Adds a new Cursor automation spec for DSYS-616 that handles cross-repo migration-doc workflow and Jira transitions.

The spec introduces:

  • a scheduled merge-sweeper automation that only closes DSYS-616 Stories when required repos are merged,
  • Fixes: DSYS-<id> PR-description matching as the source of issue linkage,
  • an optional PR-opened companion automation to move tickets from To Do to In Progress.

Related issues

Fixes: DSYS-616

Manual testing steps

  1. Open .cursor/automations/dsys-616-migration-docs-cross-repo.md.
  2. Confirm repo-scope logic and Fixes: matching rules are present.
  3. Confirm both prompt blocks exist:
    • scheduled merge sweeper
    • PR opened -> In Progress

Screenshots/Recordings

N/A (documentation-only change)

Before

N/A

After

N/A

Pre-merge author checklist

  • I've followed MetaMask Contributor Docs
  • I've completed the PR template to the best of my ability
  • I’ve included tests if applicable
  • I’ve documented my code using JSDoc format if applicable
  • I’ve applied the right labels on the PR (see labeling guidelines). Not required for external contributors.

Pre-merge reviewer checklist

  • I've manually tested the PR (e.g. pull and build branch, run the app, test code being changed).
  • I confirm that this PR addresses all acceptance criteria described in the ticket it closes and includes the necessary testing evidence such as recordings and or screenshots.

Note

Low Risk
Low risk documentation-only change that adds markdown specs for Cursor automations; no runtime code or production behavior is modified.

Overview
Introduces a new .cursor/automations/ directory as the version-controlled source of truth for Cursor Cloud Automation specs, including an operating model and conventions.

Adds a DSYS-616 cross-repo automation suite split into three specs: MMDS migration-doc authoring (with lint/quality gates and feedback loop), and mobile/extension cron-driven “replace single instance + update @deprecated JSDoc” client workflows with deterministic MIGRATION_DOCS_VERSION/Processed MIGRATION_DOCS_VERSION markers and Jira transition rules.

Updates docs/ai-agents.md to document this new “Layer 2.5” automation-spec layer in the agent documentation structure.

Written by Cursor Bugbot for commit 26a61ca. This will update automatically on new commits. Configure here.

@github-actions
Copy link
Copy Markdown
Contributor

📖 Storybook Preview

@github-actions
Copy link
Copy Markdown
Contributor

📖 Storybook Preview

Copy link
Copy Markdown
Contributor

@cursor cursor bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

Bugbot Autofix prepared a fix for the issue found in the latest run.

  • ✅ Fixed: Epic completion query misses issuetype filter causing deadlock
    • Updated both epic completion JQL snippets to include "issuetype = Story" so the closure check matches the automation’s Story-only processing scope.

Create PR

Or push these changes by commenting:

@cursor push 2afd5d2441
Preview (2afd5d2441)
diff --git a/.cursor/automations/dsys-616-migration-docs-cross-repo.md b/.cursor/automations/dsys-616-migration-docs-cross-repo.md
--- a/.cursor/automations/dsys-616-migration-docs-cross-repo.md
+++ b/.cursor/automations/dsys-616-migration-docs-cross-repo.md
@@ -116,7 +116,7 @@
 After Story updates, evaluate epic:
 
 ```jql
-parent = DSYS-616 AND statusCategory != Done
+parent = DSYS-616 AND issuetype = Story AND statusCategory != Done
  • If zero remaining, transition DSYS-616 to Done and comment summary.
    @@ -167,7 +167,7 @@
  1. After processing Stories:
    • Query remaining:
  • parent = DSYS-616 AND statusCategory != Done
    
  • parent = DSYS-616 AND issuetype = Story AND statusCategory != Done
    
    • If none remain, transition DSYS-616 to Done and comment with summary.
  1. Output concise run summary:

</details>


<sub>You can send follow-ups to this agent <a href="https://cursor.com/agents/bc-5c80bc8a-0a6c-43bf-b7a0-b2f9d281e429">here</a>.</sub>
<!-- BUGBOT_AUTOFIX_REVIEW_FOOTNOTE_END -->

@github-actions
Copy link
Copy Markdown
Contributor

📖 Storybook Preview

@github-actions
Copy link
Copy Markdown
Contributor

📖 Storybook Preview

@github-actions
Copy link
Copy Markdown
Contributor

📖 Storybook Preview

@github-actions
Copy link
Copy Markdown
Contributor

📖 Storybook Preview

@georgewrmarshall georgewrmarshall self-assigned this Mar 30, 2026
@github-actions
Copy link
Copy Markdown
Contributor

📖 Storybook Preview

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant