@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.
- 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 +9 -1
- 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 +10 -4
- package/bundles/claude-code/commands/wrap-up.md +67 -0
- package/bundles/claude-code/skills/continue-development/SKILL.md +9 -1
- 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 +10 -4
- package/bundles/claude-code/skills/wrap-up/SKILL.md +72 -0
- package/bundles/codex/.codex-plugin/plugin.json +4 -4
- package/bundles/codex/.mcp.json +1 -1
- package/bundles/codex/README.md +1 -1
- package/bundles/codex/commands/continue-development.md +9 -1
- 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 +10 -4
- package/bundles/codex/commands/wrap-up.md +67 -0
- package/bundles/codex/skills/workflow-continue-development/SKILL.md +47 -0
- package/bundles/codex/skills/workflow-create-expo-super-stack/SKILL.md +42 -0
- package/bundles/codex/skills/workflow-fix-seo/SKILL.md +41 -0
- package/bundles/codex/skills/workflow-prepare-deploy/SKILL.md +41 -0
- package/bundles/codex/skills/workflow-project-research-plan/SKILL.md +41 -0
- package/bundles/codex/skills/workflow-push-merge-loop/SKILL.md +36 -0
- package/bundles/codex/skills/workflow-review-expo-project/SKILL.md +41 -0
- package/bundles/codex/skills/workflow-run-doctor/SKILL.md +50 -0
- package/bundles/codex/skills/workflow-wrap-up/SKILL.md +79 -0
- package/bundles/vscode-copilot/.github/prompts/continue-development.prompt.md +9 -1
- 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 +10 -4
- package/bundles/vscode-copilot/.github/prompts/wrap-up.prompt.md +72 -0
- package/bundles/vscode-copilot/.vscode/mcp.json +1 -1
- package/bundles/vscode-copilot/user/.copilot/skills/workflow-continue-development/SKILL.md +9 -1
- 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 +10 -4
- 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/agent.d.ts.map +1 -1
- package/dist/commands/agent.js +77 -11
- package/dist/commands/agent.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/mcp-install.d.ts +7 -0
- package/dist/commands/mcp-install.d.ts.map +1 -1
- package/dist/commands/mcp-install.js +13 -1
- package/dist/commands/mcp-install.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 +35 -26
- package/dist/project-memory.js.map +1 -1
- package/package.json +65 -66
|
@@ -1,12 +1,20 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "
|
|
3
|
-
"
|
|
4
|
-
"version": "0.1.
|
|
5
|
-
"
|
|
6
|
-
|
|
7
|
-
"
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
"
|
|
11
|
-
"
|
|
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
|
-
"
|
|
4
|
-
"command": "npx",
|
|
5
|
-
"args": [
|
|
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
|
-
|
|
|
10
|
-
| `.mcp.json` |
|
|
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` |
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
32
|
+
mds agent verify --client claude --scope user
|
|
29
33
|
```
|
|
30
34
|
|
|
31
|
-
After install, restart Claude Code or
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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,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.
|
|
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,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.
|
|
17
|
-
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
+
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.
|
|
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,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.
|
|
22
|
-
|
|
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
|
|
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
|
+
"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/
|
|
10
|
-
"repository": "https://github.com/DavidJGrimsley/
|
|
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/
|
|
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.",
|