@mr.dj2u/cli 0.1.5 → 0.1.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bundles/claude-code/.claude-plugin/plugin.json +20 -12
- package/bundles/claude-code/.mcp.json +11 -8
- package/bundles/claude-code/README.md +31 -11
- package/bundles/claude-code/commands/continue-development.md +3 -3
- package/bundles/claude-code/commands/create-expo-super-stack.md +1 -1
- package/bundles/claude-code/commands/fix-seo.md +1 -1
- package/bundles/claude-code/commands/prepare-deploy.md +2 -4
- package/bundles/claude-code/commands/project-research-plan.md +1 -1
- package/bundles/claude-code/commands/push-merge-loop.md +25 -0
- package/bundles/claude-code/commands/review-expo-project.md +3 -6
- package/bundles/claude-code/commands/run-doctor.md +4 -6
- package/bundles/claude-code/commands/wrap-up.md +67 -0
- package/bundles/claude-code/skills/continue-development/SKILL.md +3 -3
- package/bundles/claude-code/skills/create-expo-super-stack/SKILL.md +1 -1
- package/bundles/claude-code/skills/dev-server-management/SKILL.md +1 -1
- package/bundles/claude-code/skills/fix-seo/SKILL.md +1 -1
- package/bundles/claude-code/skills/prepare-deploy/SKILL.md +2 -4
- package/bundles/claude-code/skills/project-research-plan/SKILL.md +1 -1
- package/bundles/claude-code/skills/push-merge-loop/SKILL.md +30 -0
- package/bundles/claude-code/skills/review-expo-project/SKILL.md +3 -6
- package/bundles/claude-code/skills/run-doctor/SKILL.md +4 -6
- package/bundles/claude-code/skills/wrap-up/SKILL.md +72 -0
- package/bundles/codex/.codex-plugin/plugin.json +4 -4
- package/bundles/codex/commands/continue-development.md +3 -3
- package/bundles/codex/commands/create-expo-super-stack.md +1 -1
- package/bundles/codex/commands/fix-seo.md +1 -1
- package/bundles/codex/commands/prepare-deploy.md +2 -4
- package/bundles/codex/commands/project-research-plan.md +1 -1
- package/bundles/codex/commands/push-merge-loop.md +24 -0
- package/bundles/codex/commands/review-expo-project.md +3 -6
- package/bundles/codex/commands/run-doctor.md +4 -6
- package/bundles/codex/commands/wrap-up.md +67 -0
- package/bundles/codex/skills/workflow-continue-development/SKILL.md +3 -3
- package/bundles/codex/skills/workflow-create-expo-super-stack/SKILL.md +1 -1
- package/bundles/codex/skills/workflow-fix-seo/SKILL.md +1 -1
- package/bundles/codex/skills/workflow-prepare-deploy/SKILL.md +2 -4
- package/bundles/codex/skills/workflow-project-research-plan/SKILL.md +1 -1
- package/bundles/codex/skills/workflow-push-merge-loop/SKILL.md +36 -0
- package/bundles/codex/skills/workflow-review-expo-project/SKILL.md +3 -6
- package/bundles/codex/skills/workflow-run-doctor/SKILL.md +4 -6
- package/bundles/codex/skills/workflow-wrap-up/SKILL.md +79 -0
- package/bundles/vscode-copilot/.github/prompts/continue-development.prompt.md +3 -3
- package/bundles/vscode-copilot/.github/prompts/create-expo-super-stack.prompt.md +1 -1
- package/bundles/vscode-copilot/.github/prompts/fix-seo.prompt.md +1 -1
- package/bundles/vscode-copilot/.github/prompts/prepare-deploy.prompt.md +2 -4
- package/bundles/vscode-copilot/.github/prompts/project-research-plan.prompt.md +1 -1
- package/bundles/vscode-copilot/.github/prompts/push-merge-loop.prompt.md +30 -0
- package/bundles/vscode-copilot/.github/prompts/review-expo-project.prompt.md +3 -6
- package/bundles/vscode-copilot/.github/prompts/run-doctor.prompt.md +4 -6
- package/bundles/vscode-copilot/.github/prompts/wrap-up.prompt.md +72 -0
- package/bundles/vscode-copilot/user/.copilot/skills/workflow-continue-development/SKILL.md +3 -3
- package/bundles/vscode-copilot/user/.copilot/skills/workflow-create-expo-super-stack/SKILL.md +1 -1
- package/bundles/vscode-copilot/user/.copilot/skills/workflow-fix-seo/SKILL.md +1 -1
- package/bundles/vscode-copilot/user/.copilot/skills/workflow-prepare-deploy/SKILL.md +2 -4
- package/bundles/vscode-copilot/user/.copilot/skills/workflow-project-research-plan/SKILL.md +1 -1
- package/bundles/vscode-copilot/user/.copilot/skills/workflow-push-merge-loop/SKILL.md +30 -0
- package/bundles/vscode-copilot/user/.copilot/skills/workflow-review-expo-project/SKILL.md +3 -6
- package/bundles/vscode-copilot/user/.copilot/skills/workflow-run-doctor/SKILL.md +4 -6
- package/bundles/vscode-copilot/user/.copilot/skills/workflow-wrap-up/SKILL.md +72 -0
- package/dist/cli.js +9 -1
- package/dist/cli.js.map +1 -1
- package/dist/commands/continue.d.ts +1 -1
- package/dist/commands/continue.d.ts.map +1 -1
- package/dist/commands/continue.js +21 -0
- package/dist/commands/continue.js.map +1 -1
- package/dist/commands/onboard.d.ts +27 -1
- package/dist/commands/onboard.d.ts.map +1 -1
- package/dist/commands/onboard.js +214 -23
- package/dist/commands/onboard.js.map +1 -1
- package/dist/project-memory.d.ts +1 -0
- package/dist/project-memory.d.ts.map +1 -1
- package/dist/project-memory.js +24 -16
- package/dist/project-memory.js.map +1 -1
- package/package.json +65 -66
|
@@ -13,16 +13,16 @@ Resume work on an onboarded project by following MDS phase order from `project/t
|
|
|
13
13
|
3. Pull `get_skill` for `continue-development` to enforce phase-first sequencing.
|
|
14
14
|
4. If blockers appear, use `doctor_scan_project` and `doctor_explain_result` for targeted remediation before feature work.
|
|
15
15
|
|
|
16
|
-
##
|
|
16
|
+
## MDS Routing Guardrails
|
|
17
17
|
|
|
18
|
-
- Treat
|
|
18
|
+
- Treat a request to continue development with MDS as a request for the MDS MCP tool and phase rules first.
|
|
19
19
|
- Do not jump directly into app edits until `continue_project` or the CLI fallback has identified the active phase and blockers.
|
|
20
20
|
- Never invoke `@mrdj/cli`; that package name is wrong. The published CLI package is `@mr.dj2u/cli` and its executable is `mds`.
|
|
21
21
|
|
|
22
22
|
## CLI / Manual Fallback
|
|
23
23
|
|
|
24
24
|
1. If MCP is not configured, install it manually:
|
|
25
|
-
- `mds mcp install --client
|
|
25
|
+
- `mds mcp install --client <client> --scope project`
|
|
26
26
|
2. Direct CLI flow:
|
|
27
27
|
- `mds continue <projectPath>`
|
|
28
28
|
- `mds doctor <projectPath>` when blockers are unclear.
|
|
@@ -18,7 +18,7 @@ Create a new Expo app with the MDS Super Stack flow, using this knowledge packag
|
|
|
18
18
|
## CLI / Manual Fallback
|
|
19
19
|
|
|
20
20
|
1. If MCP is not configured, install it manually:
|
|
21
|
-
- `mds mcp install --client
|
|
21
|
+
- `mds mcp install --client <client> --scope project`
|
|
22
22
|
2. Direct CLI generation:
|
|
23
23
|
- `npx -y create-expo-super-stack <appName>`
|
|
24
24
|
3. Then onboard/continue from inside the generated app using the current CLI behavior:
|
|
@@ -18,7 +18,7 @@ Apply SEO metadata fixes for Expo web routes with MCP guidance and post-fix veri
|
|
|
18
18
|
## CLI / Manual Fallback
|
|
19
19
|
|
|
20
20
|
1. If MCP is not configured, install it manually:
|
|
21
|
-
- `mds mcp install --client
|
|
21
|
+
- `mds mcp install --client <client> --scope project`
|
|
22
22
|
2. Direct CLI checks:
|
|
23
23
|
- `mds doctor <projectPath> --ci`
|
|
24
24
|
- Run project-specific web build/preview commands to verify metadata output.
|
|
@@ -13,13 +13,12 @@ Prepare an Expo project for release using deployment-focused skills plus Doctor
|
|
|
13
13
|
2. Run `doctor_scan_project` in `ci` mode for release parity.
|
|
14
14
|
3. Pull `get_skill` for `deployment`; if web is involved also pull `seo-metadata`.
|
|
15
15
|
4. Use `knowledge_list_resources` (`kind: "rule"`) to confirm env hygiene, SSR safety, and metadata requirements.
|
|
16
|
-
5.
|
|
17
|
-
6. Produce a release checklist mapped to current failing checks.
|
|
16
|
+
5. Produce a release checklist mapped to current failing checks.
|
|
18
17
|
|
|
19
18
|
## CLI / Manual Fallback
|
|
20
19
|
|
|
21
20
|
1. If MCP is not configured, install it manually:
|
|
22
|
-
- `mds mcp install --client
|
|
21
|
+
- `mds mcp install --client <client> --scope project`
|
|
23
22
|
2. Direct CLI path:
|
|
24
23
|
- `mds doctor <projectPath> --ci`
|
|
25
24
|
- Run project scripts: `lint`, `type-check`, `test`, and production build/profile scripts.
|
|
@@ -27,5 +26,4 @@ Prepare an Expo project for release using deployment-focused skills plus Doctor
|
|
|
27
26
|
## Verification And Output
|
|
28
27
|
|
|
29
28
|
- Re-run `doctor_scan_project` (or CLI equivalent) until blockers are cleared.
|
|
30
|
-
- Keep the response user-facing and checklist-driven; avoid internal tool chatter and avoid asking for a PR unless the user requested GitHub workflow.
|
|
31
29
|
- Output: release readiness status, unresolved blockers, and rollback/readiness notes.
|
|
@@ -18,7 +18,7 @@ Turn rough product notes/research into actionable MDS project memory and next-ph
|
|
|
18
18
|
## CLI / Manual Fallback
|
|
19
19
|
|
|
20
20
|
1. If MCP is not configured, install it manually:
|
|
21
|
-
- `mds mcp install --client
|
|
21
|
+
- `mds mcp install --client <client> --scope project`
|
|
22
22
|
2. Direct CLI fallback:
|
|
23
23
|
- Use `mds onboard <projectPath>` for structured intake when memory files are missing.
|
|
24
24
|
- Use `mds continue <projectPath>` after memory normalization to select the next task.
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# /push-merge-loop
|
|
2
|
+
|
|
3
|
+
Execute the short PR iteration loop for the test branch with strict quality gates.
|
|
4
|
+
|
|
5
|
+
## Goal
|
|
6
|
+
|
|
7
|
+
Push intentional changes with a meaningful commit message, open/update a PR to `test`, poll for feedback and failed checks, fix issues, and merge to `test` once all checks are green.
|
|
8
|
+
|
|
9
|
+
## Loop Rules
|
|
10
|
+
|
|
11
|
+
1. Run `mds doctor --ci` before any git mutation.
|
|
12
|
+
2. Stage only intentional files and create a meaningful commit message.
|
|
13
|
+
3. Push branch and open or update a PR targeting `test`.
|
|
14
|
+
4. Wait about 2 minutes, then poll PR comments, review threads, and failed checks.
|
|
15
|
+
5. Fix issues locally, rerun Doctor, push updates, and poll again.
|
|
16
|
+
6. Repeat polling/fix cycles up to 5 total iterations.
|
|
17
|
+
7. Merge to `test` only when all required checks are green and no unresolved blocking feedback remains.
|
|
18
|
+
|
|
19
|
+
## Guardrails
|
|
20
|
+
|
|
21
|
+
- Do not merge when required checks are failing.
|
|
22
|
+
- Do not skip Doctor between fix cycles.
|
|
23
|
+
- Keep a concise changelog per iteration: what failed, what was changed, what passed.
|
|
24
|
+
- If still failing after 5 cycles, stop and summarize remaining blockers with concrete next actions.
|
|
@@ -13,20 +13,17 @@ Review an Expo project with MCP-first diagnostics and skill-guided remediation.
|
|
|
13
13
|
2. Call `continue_project` to summarize current project state and blockers.
|
|
14
14
|
3. Call `doctor_scan_project` with `projectPath` and `mode`.
|
|
15
15
|
4. For each warning/error, call `doctor_explain_result`, then pull targeted guidance with `get_skill` (for example: `project-onboarding`, `debugging`, `deployment`).
|
|
16
|
-
5.
|
|
17
|
-
6. Call `knowledge_list_resources` with `kind: "guide"` if extra reference context is needed.
|
|
16
|
+
5. Call `knowledge_list_resources` with `kind: "guide"` if extra reference context is needed.
|
|
18
17
|
|
|
19
18
|
## CLI / Manual Fallback
|
|
20
19
|
|
|
21
20
|
1. If MCP is not configured, install it manually:
|
|
22
|
-
- `mds mcp install --client
|
|
21
|
+
- `mds mcp install --client <client> --scope project`
|
|
23
22
|
2. If MCP still cannot run, use direct CLI flows:
|
|
24
23
|
- `mds continue <projectPath>`
|
|
25
24
|
- `mds doctor <projectPath> --ci`
|
|
26
25
|
|
|
27
26
|
## Verification And Output
|
|
28
27
|
|
|
29
|
-
- Keep the response user-facing: summarize findings and next steps without echoing internal tool chatter or file-read noise.
|
|
30
28
|
- Re-run `doctor_scan_project` (or `mds doctor --ci`) after fixes.
|
|
31
|
-
-
|
|
32
|
-
- Output: blocker summary, failing checks, recommended next task, and concrete follow-up commands. Avoid proposing a PR unless the user explicitly asks for a GitHub workflow.
|
|
29
|
+
- Output: blocker summary, failing checks, recommended next task, and concrete follow-up commands.
|
|
@@ -13,19 +13,18 @@ Run MDS Doctor as the primary health check for an Expo project.
|
|
|
13
13
|
1. Confirm the `mr-djs-dev-suite` MCP server is available.
|
|
14
14
|
2. Call `doctor_scan_project` with selected arguments.
|
|
15
15
|
3. For each non-pass result, call `doctor_explain_result`.
|
|
16
|
-
4.
|
|
17
|
-
5. Pull targeted implementation guidance with `get_skill` (typically `deployment`, `debugging`, or `dev-server-management`).
|
|
16
|
+
4. Pull targeted implementation guidance with `get_skill` (typically `deployment`, `debugging`, or `dev-server-management`).
|
|
18
17
|
|
|
19
|
-
##
|
|
18
|
+
## MDS Routing Guardrails
|
|
20
19
|
|
|
21
|
-
- Treat
|
|
20
|
+
- Treat a request to run MDS Doctor as a request for the MDS MCP tool, not as a request to run app-local npm scripts.
|
|
22
21
|
- Do not run `npm run mds:doctor`, `npm run doctor`, or other project package scripts as the MDS Doctor path unless the user explicitly asks for app scripts.
|
|
23
22
|
- Never invoke `@mrdj/cli`; that package name is wrong. The published CLI package is `@mr.dj2u/cli` and its executable is `mds`.
|
|
24
23
|
|
|
25
24
|
## CLI / Manual Fallback
|
|
26
25
|
|
|
27
26
|
1. If MCP is not configured, install it manually:
|
|
28
|
-
- `mds mcp install --client
|
|
27
|
+
- `mds mcp install --client <client> --scope project`
|
|
29
28
|
2. Direct CLI alternatives:
|
|
30
29
|
- `mds doctor <projectPath>`
|
|
31
30
|
- `mds doctor <projectPath> --ci`
|
|
@@ -36,5 +35,4 @@ Run MDS Doctor as the primary health check for an Expo project.
|
|
|
36
35
|
## Verification And Output
|
|
37
36
|
|
|
38
37
|
- Re-run Doctor after each fix batch.
|
|
39
|
-
- Keep the response concise and user-facing; do not surface internal tool chatter or intermediate file reads.
|
|
40
38
|
- Output: check summary, blocking errors first, and the exact command used for re-check.
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
# /wrap-up
|
|
2
|
+
|
|
3
|
+
Run the post-testing release wrap-up flow: final local checks, git inclusion confirmation, PR loop, and merge handling.
|
|
4
|
+
|
|
5
|
+
## Goal
|
|
6
|
+
|
|
7
|
+
When the developer says testing is complete, finish the handoff safely by:
|
|
8
|
+
|
|
9
|
+
1. Marking completed todo items.
|
|
10
|
+
2. Running `mds doctor --ci`.
|
|
11
|
+
3. Reviewing `git status` and confirming intentionally excluded files.
|
|
12
|
+
4. Running the publish/PR/check loop.
|
|
13
|
+
5. Handling merge according to policy defaults and repo overrides.
|
|
14
|
+
|
|
15
|
+
## Required Flow Order
|
|
16
|
+
|
|
17
|
+
1. Update `project/todo.md` only for tasks clearly completed in this session.
|
|
18
|
+
2. Run `mds doctor --ci` before any git mutation.
|
|
19
|
+
3. Review `git status --short` and list changed files.
|
|
20
|
+
4. Confirm any intentionally omitted files with the developer before staging.
|
|
21
|
+
5. Publish through GitHub flow (branch push + PR).
|
|
22
|
+
6. Poll checks and unresolved feedback.
|
|
23
|
+
7. Fix failures locally, rerun Doctor, push updates, and poll again.
|
|
24
|
+
8. Repeat up to 5 cycles total.
|
|
25
|
+
|
|
26
|
+
## GitHub Skill Routing
|
|
27
|
+
|
|
28
|
+
Use GitHub workflows in this order when available:
|
|
29
|
+
|
|
30
|
+
1. `github` for repo/PR context and routing.
|
|
31
|
+
2. `yeet` for commit/push/open-or-update PR flow.
|
|
32
|
+
3. `gh-fix-ci` for failed checks/log inspection and CI-driven fix loops.
|
|
33
|
+
4. `gh-address-comments` when unresolved review threads are blocking merge.
|
|
34
|
+
|
|
35
|
+
## Merge Policy
|
|
36
|
+
|
|
37
|
+
Evaluate policy in this order:
|
|
38
|
+
|
|
39
|
+
1. Explicit user instruction in the current session.
|
|
40
|
+
2. Optional repo config at `project/release-policy.json`.
|
|
41
|
+
3. Defaults if config is absent.
|
|
42
|
+
|
|
43
|
+
Supported repo config shape:
|
|
44
|
+
|
|
45
|
+
```json
|
|
46
|
+
{
|
|
47
|
+
"wrapUp": {
|
|
48
|
+
"autoMergeTest": true,
|
|
49
|
+
"autoMergeMain": false
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
Default behavior:
|
|
55
|
+
|
|
56
|
+
- Auto-merge to `test`: enabled.
|
|
57
|
+
- Per-repo override: allowed.
|
|
58
|
+
- Auto-merge to `main`: never allowed.
|
|
59
|
+
|
|
60
|
+
If the workflow targets `main` directly (no `test` branch flow), stop before merge and tell the developer to merge manually.
|
|
61
|
+
|
|
62
|
+
## Guardrails
|
|
63
|
+
|
|
64
|
+
- Never auto-merge to `main`.
|
|
65
|
+
- Do not skip `mds doctor --ci` between fix cycles.
|
|
66
|
+
- Do not assume omitted files are intentional; confirm them.
|
|
67
|
+
- If checks or blocking threads still fail after 5 cycles, stop and request human help with a concise blocker summary.
|
|
@@ -25,16 +25,16 @@ Resume work on an onboarded project by following MDS phase order from `project/t
|
|
|
25
25
|
3. Pull `get_skill` for `continue-development` to enforce phase-first sequencing.
|
|
26
26
|
4. If blockers appear, use `doctor_scan_project` and `doctor_explain_result` for targeted remediation before feature work.
|
|
27
27
|
|
|
28
|
-
##
|
|
28
|
+
## MDS Routing Guardrails
|
|
29
29
|
|
|
30
|
-
- Treat
|
|
30
|
+
- Treat a request to continue development with MDS as a request for the MDS MCP tool and phase rules first.
|
|
31
31
|
- Do not jump directly into app edits until `continue_project` or the CLI fallback has identified the active phase and blockers.
|
|
32
32
|
- Never invoke `@mrdj/cli`; that package name is wrong. The published CLI package is `@mr.dj2u/cli` and its executable is `mds`.
|
|
33
33
|
|
|
34
34
|
## CLI / Manual Fallback
|
|
35
35
|
|
|
36
36
|
1. If MCP is not configured, install it manually:
|
|
37
|
-
- `mds mcp install --client
|
|
37
|
+
- `mds mcp install --client <client> --scope project`
|
|
38
38
|
2. Direct CLI flow:
|
|
39
39
|
- `mds continue <projectPath>`
|
|
40
40
|
- `mds doctor <projectPath>` when blockers are unclear.
|
|
@@ -30,7 +30,7 @@ Create a new Expo app with the MDS Super Stack flow, using this knowledge packag
|
|
|
30
30
|
## CLI / Manual Fallback
|
|
31
31
|
|
|
32
32
|
1. If MCP is not configured, install it manually:
|
|
33
|
-
- `mds mcp install --client
|
|
33
|
+
- `mds mcp install --client <client> --scope project`
|
|
34
34
|
2. Direct CLI generation:
|
|
35
35
|
- `npx -y create-expo-super-stack <appName>`
|
|
36
36
|
3. Then onboard/continue from inside the generated app using the current CLI behavior:
|
|
@@ -30,7 +30,7 @@ Apply SEO metadata fixes for Expo web routes with MCP guidance and post-fix veri
|
|
|
30
30
|
## CLI / Manual Fallback
|
|
31
31
|
|
|
32
32
|
1. If MCP is not configured, install it manually:
|
|
33
|
-
- `mds mcp install --client
|
|
33
|
+
- `mds mcp install --client <client> --scope project`
|
|
34
34
|
2. Direct CLI checks:
|
|
35
35
|
- `mds doctor <projectPath> --ci`
|
|
36
36
|
- Run project-specific web build/preview commands to verify metadata output.
|
|
@@ -25,13 +25,12 @@ Prepare an Expo project for release using deployment-focused skills plus Doctor
|
|
|
25
25
|
2. Run `doctor_scan_project` in `ci` mode for release parity.
|
|
26
26
|
3. Pull `get_skill` for `deployment`; if web is involved also pull `seo-metadata`.
|
|
27
27
|
4. Use `knowledge_list_resources` (`kind: "rule"`) to confirm env hygiene, SSR safety, and metadata requirements.
|
|
28
|
-
5.
|
|
29
|
-
6. Produce a release checklist mapped to current failing checks.
|
|
28
|
+
5. Produce a release checklist mapped to current failing checks.
|
|
30
29
|
|
|
31
30
|
## CLI / Manual Fallback
|
|
32
31
|
|
|
33
32
|
1. If MCP is not configured, install it manually:
|
|
34
|
-
- `mds mcp install --client
|
|
33
|
+
- `mds mcp install --client <client> --scope project`
|
|
35
34
|
2. Direct CLI path:
|
|
36
35
|
- `mds doctor <projectPath> --ci`
|
|
37
36
|
- Run project scripts: `lint`, `type-check`, `test`, and production build/profile scripts.
|
|
@@ -39,5 +38,4 @@ Prepare an Expo project for release using deployment-focused skills plus Doctor
|
|
|
39
38
|
## Verification And Output
|
|
40
39
|
|
|
41
40
|
- Re-run `doctor_scan_project` (or CLI equivalent) until blockers are cleared.
|
|
42
|
-
- Keep the response user-facing and checklist-driven; avoid internal tool chatter and avoid asking for a PR unless the user requested GitHub workflow.
|
|
43
41
|
- Output: release readiness status, unresolved blockers, and rollback/readiness notes.
|
|
@@ -30,7 +30,7 @@ Turn rough product notes/research into actionable MDS project memory and next-ph
|
|
|
30
30
|
## CLI / Manual Fallback
|
|
31
31
|
|
|
32
32
|
1. If MCP is not configured, install it manually:
|
|
33
|
-
- `mds mcp install --client
|
|
33
|
+
- `mds mcp install --client <client> --scope project`
|
|
34
34
|
2. Direct CLI fallback:
|
|
35
35
|
- Use `mds onboard <projectPath>` for structured intake when memory files are missing.
|
|
36
36
|
- Use `mds continue <projectPath>` after memory normalization to select the next task.
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: "MDS Push Merge Loop"
|
|
3
|
+
description: "Use when the user asks Mr. DJ's Dev Suite to run the PR iteration loop: doctor, commit, push, poll checks, fix, and merge to test."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Codex Workflow Routing
|
|
7
|
+
|
|
8
|
+
- This is a Mr. DJ's Dev Suite plugin workflow. Prefer the bundled MCP tools before terminal fallbacks.
|
|
9
|
+
- When an MCP tool named in this workflow is available, call that tool directly instead of running app-local npm scripts.
|
|
10
|
+
- Do not use stale package names such as `@mrdj/cli`. The CLI package is `@mr.dj2u/cli`; the executable is `mds`.
|
|
11
|
+
- If the MCP server is unavailable, prefer `mds <command>` from PATH, then `npx -y -p @mr.dj2u/cli@latest mds <command>`.
|
|
12
|
+
|
|
13
|
+
# /push-merge-loop
|
|
14
|
+
|
|
15
|
+
Execute the short PR iteration loop for the test branch with strict quality gates.
|
|
16
|
+
|
|
17
|
+
## Goal
|
|
18
|
+
|
|
19
|
+
Push intentional changes with a meaningful commit message, open/update a PR to `test`, poll for feedback and failed checks, fix issues, and merge to `test` once all checks are green.
|
|
20
|
+
|
|
21
|
+
## Loop Rules
|
|
22
|
+
|
|
23
|
+
1. Run `mds doctor --ci` before any git mutation.
|
|
24
|
+
2. Stage only intentional files and create a meaningful commit message.
|
|
25
|
+
3. Push branch and open or update a PR targeting `test`.
|
|
26
|
+
4. Wait about 2 minutes, then poll PR comments, review threads, and failed checks.
|
|
27
|
+
5. Fix issues locally, rerun Doctor, push updates, and poll again.
|
|
28
|
+
6. Repeat polling/fix cycles up to 5 total iterations.
|
|
29
|
+
7. Merge to `test` only when all required checks are green and no unresolved blocking feedback remains.
|
|
30
|
+
|
|
31
|
+
## Guardrails
|
|
32
|
+
|
|
33
|
+
- Do not merge when required checks are failing.
|
|
34
|
+
- Do not skip Doctor between fix cycles.
|
|
35
|
+
- Keep a concise changelog per iteration: what failed, what was changed, what passed.
|
|
36
|
+
- If still failing after 5 cycles, stop and summarize remaining blockers with concrete next actions.
|
|
@@ -25,20 +25,17 @@ Review an Expo project with MCP-first diagnostics and skill-guided remediation.
|
|
|
25
25
|
2. Call `continue_project` to summarize current project state and blockers.
|
|
26
26
|
3. Call `doctor_scan_project` with `projectPath` and `mode`.
|
|
27
27
|
4. For each warning/error, call `doctor_explain_result`, then pull targeted guidance with `get_skill` (for example: `project-onboarding`, `debugging`, `deployment`).
|
|
28
|
-
5.
|
|
29
|
-
6. Call `knowledge_list_resources` with `kind: "guide"` if extra reference context is needed.
|
|
28
|
+
5. Call `knowledge_list_resources` with `kind: "guide"` if extra reference context is needed.
|
|
30
29
|
|
|
31
30
|
## CLI / Manual Fallback
|
|
32
31
|
|
|
33
32
|
1. If MCP is not configured, install it manually:
|
|
34
|
-
- `mds mcp install --client
|
|
33
|
+
- `mds mcp install --client <client> --scope project`
|
|
35
34
|
2. If MCP still cannot run, use direct CLI flows:
|
|
36
35
|
- `mds continue <projectPath>`
|
|
37
36
|
- `mds doctor <projectPath> --ci`
|
|
38
37
|
|
|
39
38
|
## Verification And Output
|
|
40
39
|
|
|
41
|
-
- Keep the response user-facing: summarize findings and next steps without echoing internal tool chatter or file-read noise.
|
|
42
40
|
- Re-run `doctor_scan_project` (or `mds doctor --ci`) after fixes.
|
|
43
|
-
-
|
|
44
|
-
- Output: blocker summary, failing checks, recommended next task, and concrete follow-up commands. Avoid proposing a PR unless the user explicitly asks for a GitHub workflow.
|
|
41
|
+
- Output: blocker summary, failing checks, recommended next task, and concrete follow-up commands.
|
|
@@ -25,19 +25,18 @@ Run MDS Doctor as the primary health check for an Expo project.
|
|
|
25
25
|
1. Confirm the `mr-djs-dev-suite` MCP server is available.
|
|
26
26
|
2. Call `doctor_scan_project` with selected arguments.
|
|
27
27
|
3. For each non-pass result, call `doctor_explain_result`.
|
|
28
|
-
4.
|
|
29
|
-
5. Pull targeted implementation guidance with `get_skill` (typically `deployment`, `debugging`, or `dev-server-management`).
|
|
28
|
+
4. Pull targeted implementation guidance with `get_skill` (typically `deployment`, `debugging`, or `dev-server-management`).
|
|
30
29
|
|
|
31
|
-
##
|
|
30
|
+
## MDS Routing Guardrails
|
|
32
31
|
|
|
33
|
-
- Treat
|
|
32
|
+
- Treat a request to run MDS Doctor as a request for the MDS MCP tool, not as a request to run app-local npm scripts.
|
|
34
33
|
- Do not run `npm run mds:doctor`, `npm run doctor`, or other project package scripts as the MDS Doctor path unless the user explicitly asks for app scripts.
|
|
35
34
|
- Never invoke `@mrdj/cli`; that package name is wrong. The published CLI package is `@mr.dj2u/cli` and its executable is `mds`.
|
|
36
35
|
|
|
37
36
|
## CLI / Manual Fallback
|
|
38
37
|
|
|
39
38
|
1. If MCP is not configured, install it manually:
|
|
40
|
-
- `mds mcp install --client
|
|
39
|
+
- `mds mcp install --client <client> --scope project`
|
|
41
40
|
2. Direct CLI alternatives:
|
|
42
41
|
- `mds doctor <projectPath>`
|
|
43
42
|
- `mds doctor <projectPath> --ci`
|
|
@@ -48,5 +47,4 @@ Run MDS Doctor as the primary health check for an Expo project.
|
|
|
48
47
|
## Verification And Output
|
|
49
48
|
|
|
50
49
|
- Re-run Doctor after each fix batch.
|
|
51
|
-
- Keep the response concise and user-facing; do not surface internal tool chatter or intermediate file reads.
|
|
52
50
|
- Output: check summary, blocking errors first, and the exact command used for re-check.
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: "MDS Wrap Up"
|
|
3
|
+
description: "Use when the user has finished testing and wants Mr. DJ's Dev Suite to run the final wrap-up workflow (Doctor, git inclusion checks, PR loop, CI fix retries, and merge policy guardrails)."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Codex Workflow Routing
|
|
7
|
+
|
|
8
|
+
- This is a Mr. DJ's Dev Suite plugin workflow. Prefer the bundled MCP tools before terminal fallbacks.
|
|
9
|
+
- When an MCP tool named in this workflow is available, call that tool directly instead of running app-local npm scripts.
|
|
10
|
+
- Do not use stale package names such as `@mrdj/cli`. The CLI package is `@mr.dj2u/cli`; the executable is `mds`.
|
|
11
|
+
- If the MCP server is unavailable, prefer `mds <command>` from PATH, then `npx -y -p @mr.dj2u/cli@latest mds <command>`.
|
|
12
|
+
|
|
13
|
+
# /wrap-up
|
|
14
|
+
|
|
15
|
+
Run the post-testing release wrap-up flow: final local checks, git inclusion confirmation, PR loop, and merge handling.
|
|
16
|
+
|
|
17
|
+
## Goal
|
|
18
|
+
|
|
19
|
+
When the developer says testing is complete, finish the handoff safely by:
|
|
20
|
+
|
|
21
|
+
1. Marking completed todo items.
|
|
22
|
+
2. Running `mds doctor --ci`.
|
|
23
|
+
3. Reviewing `git status` and confirming intentionally excluded files.
|
|
24
|
+
4. Running the publish/PR/check loop.
|
|
25
|
+
5. Handling merge according to policy defaults and repo overrides.
|
|
26
|
+
|
|
27
|
+
## Required Flow Order
|
|
28
|
+
|
|
29
|
+
1. Update `project/todo.md` only for tasks clearly completed in this session.
|
|
30
|
+
2. Run `mds doctor --ci` before any git mutation.
|
|
31
|
+
3. Review `git status --short` and list changed files.
|
|
32
|
+
4. Confirm any intentionally omitted files with the developer before staging.
|
|
33
|
+
5. Publish through GitHub flow (branch push + PR).
|
|
34
|
+
6. Poll checks and unresolved feedback.
|
|
35
|
+
7. Fix failures locally, rerun Doctor, push updates, and poll again.
|
|
36
|
+
8. Repeat up to 5 cycles total.
|
|
37
|
+
|
|
38
|
+
## GitHub Skill Routing
|
|
39
|
+
|
|
40
|
+
Use GitHub workflows in this order when available:
|
|
41
|
+
|
|
42
|
+
1. `github` for repo/PR context and routing.
|
|
43
|
+
2. `yeet` for commit/push/open-or-update PR flow.
|
|
44
|
+
3. `gh-fix-ci` for failed checks/log inspection and CI-driven fix loops.
|
|
45
|
+
4. `gh-address-comments` when unresolved review threads are blocking merge.
|
|
46
|
+
|
|
47
|
+
## Merge Policy
|
|
48
|
+
|
|
49
|
+
Evaluate policy in this order:
|
|
50
|
+
|
|
51
|
+
1. Explicit user instruction in the current session.
|
|
52
|
+
2. Optional repo config at `project/release-policy.json`.
|
|
53
|
+
3. Defaults if config is absent.
|
|
54
|
+
|
|
55
|
+
Supported repo config shape:
|
|
56
|
+
|
|
57
|
+
```json
|
|
58
|
+
{
|
|
59
|
+
"wrapUp": {
|
|
60
|
+
"autoMergeTest": true,
|
|
61
|
+
"autoMergeMain": false
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
Default behavior:
|
|
67
|
+
|
|
68
|
+
- Auto-merge to `test`: enabled.
|
|
69
|
+
- Per-repo override: allowed.
|
|
70
|
+
- Auto-merge to `main`: never allowed.
|
|
71
|
+
|
|
72
|
+
If the workflow targets `main` directly (no `test` branch flow), stop before merge and tell the developer to merge manually.
|
|
73
|
+
|
|
74
|
+
## Guardrails
|
|
75
|
+
|
|
76
|
+
- Never auto-merge to `main`.
|
|
77
|
+
- Do not skip `mds doctor --ci` between fix cycles.
|
|
78
|
+
- Do not assume omitted files are intentional; confirm them.
|
|
79
|
+
- If checks or blocking threads still fail after 5 cycles, stop and request human help with a concise blocker summary.
|
|
@@ -18,16 +18,16 @@ Resume work on an onboarded project by following MDS phase order from `project/t
|
|
|
18
18
|
3. Pull `get_skill` for `continue-development` to enforce phase-first sequencing.
|
|
19
19
|
4. If blockers appear, use `doctor_scan_project` and `doctor_explain_result` for targeted remediation before feature work.
|
|
20
20
|
|
|
21
|
-
##
|
|
21
|
+
## MDS Routing Guardrails
|
|
22
22
|
|
|
23
|
-
- Treat
|
|
23
|
+
- Treat a request to continue development with MDS as a request for the MDS MCP tool and phase rules first.
|
|
24
24
|
- Do not jump directly into app edits until `continue_project` or the CLI fallback has identified the active phase and blockers.
|
|
25
25
|
- Never invoke `@mrdj/cli`; that package name is wrong. The published CLI package is `@mr.dj2u/cli` and its executable is `mds`.
|
|
26
26
|
|
|
27
27
|
## CLI / Manual Fallback
|
|
28
28
|
|
|
29
29
|
1. If MCP is not configured, install it manually:
|
|
30
|
-
- `mds mcp install --client
|
|
30
|
+
- `mds mcp install --client <client> --scope project`
|
|
31
31
|
2. Direct CLI flow:
|
|
32
32
|
- `mds continue <projectPath>`
|
|
33
33
|
- `mds doctor <projectPath>` when blockers are unclear.
|
|
@@ -23,7 +23,7 @@ Create a new Expo app with the MDS Super Stack flow, using this knowledge packag
|
|
|
23
23
|
## CLI / Manual Fallback
|
|
24
24
|
|
|
25
25
|
1. If MCP is not configured, install it manually:
|
|
26
|
-
- `mds mcp install --client
|
|
26
|
+
- `mds mcp install --client <client> --scope project`
|
|
27
27
|
2. Direct CLI generation:
|
|
28
28
|
- `npx -y create-expo-super-stack <appName>`
|
|
29
29
|
3. Then onboard/continue from inside the generated app using the current CLI behavior:
|
|
@@ -23,7 +23,7 @@ Apply SEO metadata fixes for Expo web routes with MCP guidance and post-fix veri
|
|
|
23
23
|
## CLI / Manual Fallback
|
|
24
24
|
|
|
25
25
|
1. If MCP is not configured, install it manually:
|
|
26
|
-
- `mds mcp install --client
|
|
26
|
+
- `mds mcp install --client <client> --scope project`
|
|
27
27
|
2. Direct CLI checks:
|
|
28
28
|
- `mds doctor <projectPath> --ci`
|
|
29
29
|
- Run project-specific web build/preview commands to verify metadata output.
|
|
@@ -18,13 +18,12 @@ Prepare an Expo project for release using deployment-focused skills plus Doctor
|
|
|
18
18
|
2. Run `doctor_scan_project` in `ci` mode for release parity.
|
|
19
19
|
3. Pull `get_skill` for `deployment`; if web is involved also pull `seo-metadata`.
|
|
20
20
|
4. Use `knowledge_list_resources` (`kind: "rule"`) to confirm env hygiene, SSR safety, and metadata requirements.
|
|
21
|
-
5.
|
|
22
|
-
6. Produce a release checklist mapped to current failing checks.
|
|
21
|
+
5. Produce a release checklist mapped to current failing checks.
|
|
23
22
|
|
|
24
23
|
## CLI / Manual Fallback
|
|
25
24
|
|
|
26
25
|
1. If MCP is not configured, install it manually:
|
|
27
|
-
- `mds mcp install --client
|
|
26
|
+
- `mds mcp install --client <client> --scope project`
|
|
28
27
|
2. Direct CLI path:
|
|
29
28
|
- `mds doctor <projectPath> --ci`
|
|
30
29
|
- Run project scripts: `lint`, `type-check`, `test`, and production build/profile scripts.
|
|
@@ -32,5 +31,4 @@ Prepare an Expo project for release using deployment-focused skills plus Doctor
|
|
|
32
31
|
## Verification And Output
|
|
33
32
|
|
|
34
33
|
- Re-run `doctor_scan_project` (or CLI equivalent) until blockers are cleared.
|
|
35
|
-
- Keep the response user-facing and checklist-driven; avoid internal tool chatter and avoid asking for a PR unless the user requested GitHub workflow.
|
|
36
34
|
- Output: release readiness status, unresolved blockers, and rollback/readiness notes.
|
|
@@ -23,7 +23,7 @@ Turn rough product notes/research into actionable MDS project memory and next-ph
|
|
|
23
23
|
## CLI / Manual Fallback
|
|
24
24
|
|
|
25
25
|
1. If MCP is not configured, install it manually:
|
|
26
|
-
- `mds mcp install --client
|
|
26
|
+
- `mds mcp install --client <client> --scope project`
|
|
27
27
|
2. Direct CLI fallback:
|
|
28
28
|
- Use `mds onboard <projectPath>` for structured intake when memory files are missing.
|
|
29
29
|
- Use `mds continue <projectPath>` after memory normalization to select the next task.
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
---
|
|
2
|
+
mode: "agent"
|
|
3
|
+
description: "Run the MDS Push Merge Loop workflow with MCP-first diagnostics and CLI fallback."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# /push-merge-loop
|
|
7
|
+
|
|
8
|
+
Execute the short PR iteration loop for the test branch with strict quality gates.
|
|
9
|
+
|
|
10
|
+
## Goal
|
|
11
|
+
|
|
12
|
+
Push intentional changes with a meaningful commit message, open/update a PR to `test`, poll for feedback and failed checks, fix issues, and merge to `test` once all checks are green.
|
|
13
|
+
|
|
14
|
+
## Loop Rules
|
|
15
|
+
|
|
16
|
+
1. Run `mds doctor --ci` before any git mutation.
|
|
17
|
+
2. Stage only intentional files and create a meaningful commit message.
|
|
18
|
+
3. Push branch and open or update a PR targeting `test`.
|
|
19
|
+
4. Wait about 2 minutes, then poll PR comments, review threads, and failed checks.
|
|
20
|
+
5. Fix issues locally, rerun Doctor, push updates, and poll again.
|
|
21
|
+
6. Repeat polling/fix cycles up to 5 total iterations.
|
|
22
|
+
7. Merge to `test` only when all required checks are green and no unresolved blocking feedback remains.
|
|
23
|
+
|
|
24
|
+
## Guardrails
|
|
25
|
+
|
|
26
|
+
- Do not merge when required checks are failing.
|
|
27
|
+
- Do not skip Doctor between fix cycles.
|
|
28
|
+
- Keep a concise changelog per iteration: what failed, what was changed, what passed.
|
|
29
|
+
- If still failing after 5 cycles, stop and summarize remaining blockers with concrete next actions.
|
|
30
|
+
|
|
@@ -18,20 +18,17 @@ Review an Expo project with MCP-first diagnostics and skill-guided remediation.
|
|
|
18
18
|
2. Call `continue_project` to summarize current project state and blockers.
|
|
19
19
|
3. Call `doctor_scan_project` with `projectPath` and `mode`.
|
|
20
20
|
4. For each warning/error, call `doctor_explain_result`, then pull targeted guidance with `get_skill` (for example: `project-onboarding`, `debugging`, `deployment`).
|
|
21
|
-
5.
|
|
22
|
-
6. Call `knowledge_list_resources` with `kind: "guide"` if extra reference context is needed.
|
|
21
|
+
5. Call `knowledge_list_resources` with `kind: "guide"` if extra reference context is needed.
|
|
23
22
|
|
|
24
23
|
## CLI / Manual Fallback
|
|
25
24
|
|
|
26
25
|
1. If MCP is not configured, install it manually:
|
|
27
|
-
- `mds mcp install --client
|
|
26
|
+
- `mds mcp install --client <client> --scope project`
|
|
28
27
|
2. If MCP still cannot run, use direct CLI flows:
|
|
29
28
|
- `mds continue <projectPath>`
|
|
30
29
|
- `mds doctor <projectPath> --ci`
|
|
31
30
|
|
|
32
31
|
## Verification And Output
|
|
33
32
|
|
|
34
|
-
- Keep the response user-facing: summarize findings and next steps without echoing internal tool chatter or file-read noise.
|
|
35
33
|
- Re-run `doctor_scan_project` (or `mds doctor --ci`) after fixes.
|
|
36
|
-
-
|
|
37
|
-
- Output: blocker summary, failing checks, recommended next task, and concrete follow-up commands. Avoid proposing a PR unless the user explicitly asks for a GitHub workflow.
|
|
34
|
+
- Output: blocker summary, failing checks, recommended next task, and concrete follow-up commands.
|
|
@@ -18,19 +18,18 @@ Run MDS Doctor as the primary health check for an Expo project.
|
|
|
18
18
|
1. Confirm the `mds` MCP server is available.
|
|
19
19
|
2. Call `doctor_scan_project` with selected arguments.
|
|
20
20
|
3. For each non-pass result, call `doctor_explain_result`.
|
|
21
|
-
4.
|
|
22
|
-
5. Pull targeted implementation guidance with `get_skill` (typically `deployment`, `debugging`, or `dev-server-management`).
|
|
21
|
+
4. Pull targeted implementation guidance with `get_skill` (typically `deployment`, `debugging`, or `dev-server-management`).
|
|
23
22
|
|
|
24
|
-
##
|
|
23
|
+
## MDS Routing Guardrails
|
|
25
24
|
|
|
26
|
-
- Treat
|
|
25
|
+
- Treat a request to run MDS Doctor as a request for the MDS MCP tool, not as a request to run app-local npm scripts.
|
|
27
26
|
- Do not run `npm run mds:doctor`, `npm run doctor`, or other project package scripts as the MDS Doctor path unless the user explicitly asks for app scripts.
|
|
28
27
|
- Never invoke `@mrdj/cli`; that package name is wrong. The published CLI package is `@mr.dj2u/cli` and its executable is `mds`.
|
|
29
28
|
|
|
30
29
|
## CLI / Manual Fallback
|
|
31
30
|
|
|
32
31
|
1. If MCP is not configured, install it manually:
|
|
33
|
-
- `mds mcp install --client
|
|
32
|
+
- `mds mcp install --client <client> --scope project`
|
|
34
33
|
2. Direct CLI alternatives:
|
|
35
34
|
- `mds doctor <projectPath>`
|
|
36
35
|
- `mds doctor <projectPath> --ci`
|
|
@@ -41,5 +40,4 @@ Run MDS Doctor as the primary health check for an Expo project.
|
|
|
41
40
|
## Verification And Output
|
|
42
41
|
|
|
43
42
|
- Re-run Doctor after each fix batch.
|
|
44
|
-
- Keep the response concise and user-facing; do not surface internal tool chatter or intermediate file reads.
|
|
45
43
|
- Output: check summary, blocking errors first, and the exact command used for re-check.
|