@mr.dj2u/cli 0.1.3 → 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.
Files changed (84) hide show
  1. package/bundles/claude-code/.claude-plugin/plugin.json +20 -12
  2. package/bundles/claude-code/.mcp.json +11 -8
  3. package/bundles/claude-code/README.md +31 -11
  4. package/bundles/claude-code/commands/continue-development.md +9 -1
  5. package/bundles/claude-code/commands/create-expo-super-stack.md +1 -1
  6. package/bundles/claude-code/commands/fix-seo.md +1 -1
  7. package/bundles/claude-code/commands/prepare-deploy.md +2 -4
  8. package/bundles/claude-code/commands/project-research-plan.md +1 -1
  9. package/bundles/claude-code/commands/push-merge-loop.md +25 -0
  10. package/bundles/claude-code/commands/review-expo-project.md +3 -6
  11. package/bundles/claude-code/commands/run-doctor.md +10 -4
  12. package/bundles/claude-code/commands/wrap-up.md +67 -0
  13. package/bundles/claude-code/skills/continue-development/SKILL.md +9 -1
  14. package/bundles/claude-code/skills/create-expo-super-stack/SKILL.md +1 -1
  15. package/bundles/claude-code/skills/dev-server-management/SKILL.md +1 -1
  16. package/bundles/claude-code/skills/fix-seo/SKILL.md +1 -1
  17. package/bundles/claude-code/skills/prepare-deploy/SKILL.md +2 -4
  18. package/bundles/claude-code/skills/project-research-plan/SKILL.md +1 -1
  19. package/bundles/claude-code/skills/push-merge-loop/SKILL.md +30 -0
  20. package/bundles/claude-code/skills/review-expo-project/SKILL.md +3 -6
  21. package/bundles/claude-code/skills/run-doctor/SKILL.md +10 -4
  22. package/bundles/claude-code/skills/wrap-up/SKILL.md +72 -0
  23. package/bundles/codex/.codex-plugin/plugin.json +4 -4
  24. package/bundles/codex/.mcp.json +1 -1
  25. package/bundles/codex/README.md +1 -1
  26. package/bundles/codex/commands/continue-development.md +9 -1
  27. package/bundles/codex/commands/create-expo-super-stack.md +1 -1
  28. package/bundles/codex/commands/fix-seo.md +1 -1
  29. package/bundles/codex/commands/prepare-deploy.md +2 -4
  30. package/bundles/codex/commands/project-research-plan.md +1 -1
  31. package/bundles/codex/commands/push-merge-loop.md +24 -0
  32. package/bundles/codex/commands/review-expo-project.md +3 -6
  33. package/bundles/codex/commands/run-doctor.md +10 -4
  34. package/bundles/codex/commands/wrap-up.md +67 -0
  35. package/bundles/codex/skills/workflow-continue-development/SKILL.md +47 -0
  36. package/bundles/codex/skills/workflow-create-expo-super-stack/SKILL.md +42 -0
  37. package/bundles/codex/skills/workflow-fix-seo/SKILL.md +41 -0
  38. package/bundles/codex/skills/workflow-prepare-deploy/SKILL.md +41 -0
  39. package/bundles/codex/skills/workflow-project-research-plan/SKILL.md +41 -0
  40. package/bundles/codex/skills/workflow-push-merge-loop/SKILL.md +36 -0
  41. package/bundles/codex/skills/workflow-review-expo-project/SKILL.md +41 -0
  42. package/bundles/codex/skills/workflow-run-doctor/SKILL.md +50 -0
  43. package/bundles/codex/skills/workflow-wrap-up/SKILL.md +79 -0
  44. package/bundles/vscode-copilot/.github/prompts/continue-development.prompt.md +9 -1
  45. package/bundles/vscode-copilot/.github/prompts/create-expo-super-stack.prompt.md +1 -1
  46. package/bundles/vscode-copilot/.github/prompts/fix-seo.prompt.md +1 -1
  47. package/bundles/vscode-copilot/.github/prompts/prepare-deploy.prompt.md +2 -4
  48. package/bundles/vscode-copilot/.github/prompts/project-research-plan.prompt.md +1 -1
  49. package/bundles/vscode-copilot/.github/prompts/push-merge-loop.prompt.md +30 -0
  50. package/bundles/vscode-copilot/.github/prompts/review-expo-project.prompt.md +3 -6
  51. package/bundles/vscode-copilot/.github/prompts/run-doctor.prompt.md +10 -4
  52. package/bundles/vscode-copilot/.github/prompts/wrap-up.prompt.md +72 -0
  53. package/bundles/vscode-copilot/.vscode/mcp.json +1 -1
  54. package/bundles/vscode-copilot/user/.copilot/skills/workflow-continue-development/SKILL.md +9 -1
  55. package/bundles/vscode-copilot/user/.copilot/skills/workflow-create-expo-super-stack/SKILL.md +1 -1
  56. package/bundles/vscode-copilot/user/.copilot/skills/workflow-fix-seo/SKILL.md +1 -1
  57. package/bundles/vscode-copilot/user/.copilot/skills/workflow-prepare-deploy/SKILL.md +2 -4
  58. package/bundles/vscode-copilot/user/.copilot/skills/workflow-project-research-plan/SKILL.md +1 -1
  59. package/bundles/vscode-copilot/user/.copilot/skills/workflow-push-merge-loop/SKILL.md +30 -0
  60. package/bundles/vscode-copilot/user/.copilot/skills/workflow-review-expo-project/SKILL.md +3 -6
  61. package/bundles/vscode-copilot/user/.copilot/skills/workflow-run-doctor/SKILL.md +10 -4
  62. package/bundles/vscode-copilot/user/.copilot/skills/workflow-wrap-up/SKILL.md +72 -0
  63. package/dist/cli.js +9 -1
  64. package/dist/cli.js.map +1 -1
  65. package/dist/commands/agent.d.ts.map +1 -1
  66. package/dist/commands/agent.js +77 -11
  67. package/dist/commands/agent.js.map +1 -1
  68. package/dist/commands/continue.d.ts +1 -1
  69. package/dist/commands/continue.d.ts.map +1 -1
  70. package/dist/commands/continue.js +21 -0
  71. package/dist/commands/continue.js.map +1 -1
  72. package/dist/commands/mcp-install.d.ts +7 -0
  73. package/dist/commands/mcp-install.d.ts.map +1 -1
  74. package/dist/commands/mcp-install.js +13 -1
  75. package/dist/commands/mcp-install.js.map +1 -1
  76. package/dist/commands/onboard.d.ts +27 -1
  77. package/dist/commands/onboard.d.ts.map +1 -1
  78. package/dist/commands/onboard.js +214 -23
  79. package/dist/commands/onboard.js.map +1 -1
  80. package/dist/project-memory.d.ts +1 -0
  81. package/dist/project-memory.d.ts.map +1 -1
  82. package/dist/project-memory.js +35 -26
  83. package/dist/project-memory.js.map +1 -1
  84. package/package.json +65 -66
@@ -1,12 +1,20 @@
1
- {
2
- "name": "mds-dev-suite",
3
- "description": "Expo project intelligence for Claude Code: Doctor diagnostics, architecture skills, MCP tools, custom MDS agent, and project-memory commands for Expo Router apps.",
4
- "version": "0.1.0",
5
- "author": {
6
- "name": "David Grimsley",
7
- "url": "https://github.com/DavidJGrimsley"
8
- },
9
- "homepage": "https://github.com/DavidJGrimsley/mds-dev-suite",
10
- "repository": "https://github.com/DavidJGrimsley/mds-dev-suite",
11
- "license": "MIT"
12
- }
1
+ {
2
+ "name": "mr-djs-dev-suite",
3
+ "displayName": "Mr. DJ's Dev Suite",
4
+ "version": "0.1.6",
5
+ "description": "MCP-first Expo review, Doctor, onboarding, deployment readiness, and project continuation workflows for Claude Code.",
6
+ "author": {
7
+ "name": "DJ Grimsley",
8
+ "url": "https://davidjgrimsley.com"
9
+ },
10
+ "homepage": "https://github.com/DavidJGrimsley/mrdj-dev-suite",
11
+ "repository": "https://github.com/DavidJGrimsley/mrdj-dev-suite",
12
+ "license": "MIT",
13
+ "keywords": [
14
+ "expo",
15
+ "react-native",
16
+ "mcp",
17
+ "doctor",
18
+ "claude-code"
19
+ ]
20
+ }
@@ -1,8 +1,11 @@
1
- {
2
- "mcpServers": {
3
- "mds-dev-suite": {
4
- "command": "npx",
5
- "args": ["-y", "@mr.dj2u/mcp-server"]
6
- }
7
- }
8
- }
1
+ {
2
+ "mcpServers": {
3
+ "mr-djs-dev-suite": {
4
+ "command": "npx",
5
+ "args": [
6
+ "-y",
7
+ "@mr.dj2u/mcp-server@0.1.2"
8
+ ]
9
+ }
10
+ }
11
+ }
@@ -1,34 +1,54 @@
1
1
  # Mr. DJ's Dev Suite - Claude Code Plugin
2
2
 
3
- Gives Claude Code native MDS behavior for Expo projects: MCP tools, a custom `mds` agent, slash commands, generated skills, and project instructions.
3
+ Gives Claude Code native MDS behavior for Expo projects: MCP tools, a custom `mds` agent, slash commands, generated skills, and install-time project instructions.
4
4
 
5
5
  ## What's Included
6
6
 
7
7
  | Path | Purpose |
8
8
  |------|---------|
9
- | `CLAUDE.md` | Instructions merged into project `CLAUDE.md` or user `~/.claude/CLAUDE.md` |
10
- | `.mcp.json` | Pre-configured MCP server example for `mr-djs-dev-suite` |
9
+ | `.claude-plugin/plugin.json` | Claude plugin identity and display metadata |
10
+ | `.mcp.json` | Plugin MCP server config for `mr-djs-dev-suite` |
11
+ | `settings.json` | Enables the plugin's `mds` agent by default when installed as a Claude plugin |
11
12
  | `agents/mds.md` | Claude Code custom agent for MDS workflows |
12
- | `commands/*.md` | Slash command markdown files copied to `.claude/commands/` |
13
+ | `commands/*.md` | Flat command files; plugin install exposes namespaced commands |
13
14
  | `skills/*/SKILL.md` | Build-generated skills sourced from `packages/knowledge` |
15
+ | `CLAUDE.md` | Instructions merged only by `mds agent install --client claude` |
14
16
 
15
- ## One-Command Install
17
+ Claude Code plugin installs do not load a plugin-root `CLAUDE.md` as context. The packaged plugin behavior lives in `agents/`, `skills/`, `commands/`, `.mcp.json`, and `settings.json`; the CLI installer also merges `CLAUDE.md` into the target project or user profile for standalone `.claude` installs.
16
18
 
17
- Project scope installs MCP, instructions, the custom agent, slash commands, and generated skills into one Expo app:
19
+ ## Recommended Install
20
+
21
+ Project scope installs MCP, instructions, the custom agent, short slash commands, and generated skills into one Expo app:
18
22
 
19
23
  ```sh
20
24
  mds agent install --client claude --scope project --target /path/to/your/expo-app
21
- mds agent verify --client claude --target /path/to/your/expo-app
25
+ mds agent verify --client claude --scope project --target /path/to/your/expo-app
22
26
  ```
23
27
 
24
28
  User scope installs MCP plus reusable assets into `~/.claude`:
25
29
 
26
30
  ```sh
27
31
  mds agent install --client claude --scope user
28
- mds agent install --client claude --scope user --dry-run
32
+ mds agent verify --client claude --scope user
29
33
  ```
30
34
 
31
- After install, restart Claude Code or reopen the workspace, run `/mcp`, and confirm `mr-djs-dev-suite` is listed. Then use the `mds` agent or slash commands such as `/run-doctor`, `/review-expo-project`, and `/prepare-deploy`.
35
+ After install, restart Claude Code or run `/reload-plugins`, then run `/mcp` and confirm `mr-djs-dev-suite` is listed. Use the `mds` agent or short commands such as `/run-doctor`, `/continue-development`, `/review-expo-project`, and `/prepare-deploy`.
36
+
37
+ ## True Claude Plugin Test
38
+
39
+ When loaded with Claude's plugin system, command names are namespaced by plugin name:
40
+
41
+ ```sh
42
+ claude --plugin-dir ./plugins/claude-code
43
+ ```
44
+
45
+ Then test:
46
+
47
+ ```text
48
+ /mr-djs-dev-suite:run-doctor
49
+ /mr-djs-dev-suite:continue-development
50
+ /mr-djs-dev-suite:prepare-deploy
51
+ ```
32
52
 
33
53
  ## MCP-Only Fallback
34
54
 
@@ -41,11 +61,11 @@ mds mcp install --client claude --scope user
41
61
 
42
62
  ## Generated Assets
43
63
 
44
- Skills are sourced from `packages/knowledge/src/content/skills/` and generated into `plugins/claude-code/skills/` at build time. Slash commands are copied from `commands-src/` into `commands/` during the same build.
64
+ Skills are sourced from `packages/knowledge/src/content/skills/`. Slash commands and command skills are generated from the canonical prompt specs in `packages/knowledge/src/content/prompts/` plus `buildCommandFiles()` in `packages/knowledge/scripts/generate-codex-plugin.mjs`.
45
65
 
46
66
  ```sh
47
67
  pnpm --filter @mr.dj2u/knowledge build
48
68
  ```
49
69
 
50
- Do not edit generated `commands/` or `skills/` files directly; update the knowledge source or command source and rebuild.
70
+ Do not edit generated `commands/` or `skills/` files directly; update the knowledge source or command generator and rebuild.
51
71
 
@@ -13,13 +13,21 @@ 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
+ ## MDS Routing Guardrails
17
+
18
+ - Treat a request to continue development with MDS as a request for the MDS MCP tool and phase rules first.
19
+ - Do not jump directly into app edits until `continue_project` or the CLI fallback has identified the active phase and blockers.
20
+ - Never invoke `@mrdj/cli`; that package name is wrong. The published CLI package is `@mr.dj2u/cli` and its executable is `mds`.
21
+
16
22
  ## CLI / Manual Fallback
17
23
 
18
24
  1. If MCP is not configured, install it manually:
19
- - `mds mcp install --client codex --scope project`
25
+ - `mds mcp install --client <client> --scope project`
20
26
  2. Direct CLI flow:
21
27
  - `mds continue <projectPath>`
22
28
  - `mds doctor <projectPath>` when blockers are unclear.
29
+ 3. If `mds` is not on PATH, invoke the published CLI by binary name:
30
+ - `npx -y -p @mr.dj2u/cli@latest mds continue <projectPath>`
23
31
 
24
32
  ## Verification And Output
25
33
 
@@ -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 codex --scope project`
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 codex --scope project`
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. Call `generate_deploy_checklist` so SEO, scripts, and release-readiness gaps are reflected in the next steps.
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 codex --scope project`
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 codex --scope project`
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,25 @@
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.
25
+
@@ -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. If the findings affect release readiness, call `generate_deploy_checklist` so the next steps stay checklist-driven instead of PR-driven.
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 codex --scope project`
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
- - If the user is validating an installed agent bundle, include `mds agent verify --client <client> --target <path>` in the follow-up commands.
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,20 +13,26 @@ 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. If the check is release-related or web-facing, call `generate_deploy_checklist` before giving next steps.
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`).
17
+
18
+ ## MDS Routing Guardrails
19
+
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.
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.
22
+ - Never invoke `@mrdj/cli`; that package name is wrong. The published CLI package is `@mr.dj2u/cli` and its executable is `mds`.
18
23
 
19
24
  ## CLI / Manual Fallback
20
25
 
21
26
  1. If MCP is not configured, install it manually:
22
- - `mds mcp install --client codex --scope project`
27
+ - `mds mcp install --client <client> --scope project`
23
28
  2. Direct CLI alternatives:
24
29
  - `mds doctor <projectPath>`
25
30
  - `mds doctor <projectPath> --ci`
26
31
  - `mds doctor <projectPath> --json`
32
+ 3. If `mds` is not on PATH, invoke the published CLI by binary name:
33
+ - `npx -y -p @mr.dj2u/cli@latest mds doctor <projectPath> --ci`
27
34
 
28
35
  ## Verification And Output
29
36
 
30
37
  - Re-run Doctor after each fix batch.
31
- - Keep the response concise and user-facing; do not surface internal tool chatter or intermediate file reads.
32
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.
@@ -18,13 +18,21 @@ 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
+ ## MDS Routing Guardrails
22
+
23
+ - Treat a request to continue development with MDS as a request for the MDS MCP tool and phase rules first.
24
+ - Do not jump directly into app edits until `continue_project` or the CLI fallback has identified the active phase and blockers.
25
+ - Never invoke `@mrdj/cli`; that package name is wrong. The published CLI package is `@mr.dj2u/cli` and its executable is `mds`.
26
+
21
27
  ## CLI / Manual Fallback
22
28
 
23
29
  1. If MCP is not configured, install it manually:
24
- - `mds mcp install --client codex --scope project`
30
+ - `mds mcp install --client <client> --scope project`
25
31
  2. Direct CLI flow:
26
32
  - `mds continue <projectPath>`
27
33
  - `mds doctor <projectPath>` when blockers are unclear.
34
+ 3. If `mds` is not on PATH, invoke the published CLI by binary name:
35
+ - `npx -y -p @mr.dj2u/cli@latest mds continue <projectPath>`
28
36
 
29
37
  ## Verification And Output
30
38
 
@@ -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 codex --scope project`
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:
@@ -13,7 +13,7 @@ Use a deterministic reset path first; do not work around unstable server state w
13
13
  ## Checks
14
14
 
15
15
  - Run `mds clear-expo-start` before manual troubleshooting.
16
- - If a conflict remains, run `mds free-port <port...>` for blocked ports.
16
+ - If a conflict remains, run `mds free-port <port...>` for blocked ports.
17
17
  - Confirm Expo/Metro caches are cleared before retrying startup.
18
18
  - Treat fallback to port `8082` as an unresolved state that requires full reset.
19
19
  - Confirm the same recovery scripts are available to teammates and automation.
@@ -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 codex --scope project`
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. Call `generate_deploy_checklist` so SEO, scripts, and release-readiness gaps are reflected in the next steps.
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 codex --scope project`
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 codex --scope project`
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
+ description: Execute the short PR iteration loop for the test branch with strict quality gates.
3
+ disable-model-invocation: true
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. If the findings affect release readiness, call `generate_deploy_checklist` so the next steps stay checklist-driven instead of PR-driven.
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 codex --scope project`
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
- - If the user is validating an installed agent bundle, include `mds agent verify --client <client> --target <path>` in the follow-up commands.
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,20 +18,26 @@ Run MDS Doctor as the primary health check for an Expo project.
18
18
  1. Confirm the `mr-djs-dev-suite` 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. If the check is release-related or web-facing, call `generate_deploy_checklist` before giving next steps.
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`).
22
+
23
+ ## MDS Routing Guardrails
24
+
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.
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.
27
+ - Never invoke `@mrdj/cli`; that package name is wrong. The published CLI package is `@mr.dj2u/cli` and its executable is `mds`.
23
28
 
24
29
  ## CLI / Manual Fallback
25
30
 
26
31
  1. If MCP is not configured, install it manually:
27
- - `mds mcp install --client codex --scope project`
32
+ - `mds mcp install --client <client> --scope project`
28
33
  2. Direct CLI alternatives:
29
34
  - `mds doctor <projectPath>`
30
35
  - `mds doctor <projectPath> --ci`
31
36
  - `mds doctor <projectPath> --json`
37
+ 3. If `mds` is not on PATH, invoke the published CLI by binary name:
38
+ - `npx -y -p @mr.dj2u/cli@latest mds doctor <projectPath> --ci`
32
39
 
33
40
  ## Verification And Output
34
41
 
35
42
  - Re-run Doctor after each fix batch.
36
- - Keep the response concise and user-facing; do not surface internal tool chatter or intermediate file reads.
37
43
  - Output: check summary, blocking errors first, and the exact command used for re-check.
@@ -0,0 +1,72 @@
1
+ ---
2
+ description: Run the post-testing release wrap-up flow: final local checks, git inclusion confirmation, PR loop, and merge handling.
3
+ disable-model-invocation: true
4
+ ---
5
+
6
+ # /wrap-up
7
+
8
+ Run the post-testing release wrap-up flow: final local checks, git inclusion confirmation, PR loop, and merge handling.
9
+
10
+ ## Goal
11
+
12
+ When the developer says testing is complete, finish the handoff safely by:
13
+
14
+ 1. Marking completed todo items.
15
+ 2. Running `mds doctor --ci`.
16
+ 3. Reviewing `git status` and confirming intentionally excluded files.
17
+ 4. Running the publish/PR/check loop.
18
+ 5. Handling merge according to policy defaults and repo overrides.
19
+
20
+ ## Required Flow Order
21
+
22
+ 1. Update `project/todo.md` only for tasks clearly completed in this session.
23
+ 2. Run `mds doctor --ci` before any git mutation.
24
+ 3. Review `git status --short` and list changed files.
25
+ 4. Confirm any intentionally omitted files with the developer before staging.
26
+ 5. Publish through GitHub flow (branch push + PR).
27
+ 6. Poll checks and unresolved feedback.
28
+ 7. Fix failures locally, rerun Doctor, push updates, and poll again.
29
+ 8. Repeat up to 5 cycles total.
30
+
31
+ ## GitHub Skill Routing
32
+
33
+ Use GitHub workflows in this order when available:
34
+
35
+ 1. `github` for repo/PR context and routing.
36
+ 2. `yeet` for commit/push/open-or-update PR flow.
37
+ 3. `gh-fix-ci` for failed checks/log inspection and CI-driven fix loops.
38
+ 4. `gh-address-comments` when unresolved review threads are blocking merge.
39
+
40
+ ## Merge Policy
41
+
42
+ Evaluate policy in this order:
43
+
44
+ 1. Explicit user instruction in the current session.
45
+ 2. Optional repo config at `project/release-policy.json`.
46
+ 3. Defaults if config is absent.
47
+
48
+ Supported repo config shape:
49
+
50
+ ```json
51
+ {
52
+ "wrapUp": {
53
+ "autoMergeTest": true,
54
+ "autoMergeMain": false
55
+ }
56
+ }
57
+ ```
58
+
59
+ Default behavior:
60
+
61
+ - Auto-merge to `test`: enabled.
62
+ - Per-repo override: allowed.
63
+ - Auto-merge to `main`: never allowed.
64
+
65
+ If the workflow targets `main` directly (no `test` branch flow), stop before merge and tell the developer to merge manually.
66
+
67
+ ## Guardrails
68
+
69
+ - Never auto-merge to `main`.
70
+ - Do not skip `mds doctor --ci` between fix cycles.
71
+ - Do not assume omitted files are intentional; confirm them.
72
+ - If checks or blocking threads still fail after 5 cycles, stop and request human help with a concise blocker summary.
@@ -1,13 +1,13 @@
1
1
  {
2
2
  "name": "mr-djs-dev-suite",
3
- "version": "0.1.3",
3
+ "version": "0.1.6",
4
4
  "description": "MDS Expo development workflows for review, onboarding, deployment readiness, and project continuation.",
5
5
  "author": {
6
6
  "name": "DJ Grimsley",
7
7
  "url": "https://davidjgrimsley.com"
8
8
  },
9
- "homepage": "https://github.com/DavidJGrimsley/mr-djs-dev-suite",
10
- "repository": "https://github.com/DavidJGrimsley/mr-djs-dev-suite",
9
+ "homepage": "https://github.com/DavidJGrimsley/mrdj-dev-suite",
10
+ "repository": "https://github.com/DavidJGrimsley/mrdj-dev-suite",
11
11
  "license": "MIT",
12
12
  "keywords": [
13
13
  "expo",
@@ -30,7 +30,7 @@
30
30
  "Read",
31
31
  "Write"
32
32
  ],
33
- "websiteURL": "https://github.com/DavidJGrimsley/mr-djs-dev-suite",
33
+ "websiteURL": "https://github.com/DavidJGrimsley/mrdj-dev-suite",
34
34
  "defaultPrompt": [
35
35
  "Review my Expo project and give me the next safe implementation steps.",
36
36
  "Run a deployment-readiness check with Doctor and fix blockers first.",