@mr.dj2u/knowledge 0.1.7 → 0.1.8

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 (59) hide show
  1. package/dist/content/checklists/push-merge-loop.md +17 -17
  2. package/dist/content/checklists/unified-agent-bundle-validation.md +9 -9
  3. package/dist/content/examples/push-merge-loop.md +14 -14
  4. package/dist/content/examples/unified-agent-bundle-bootstrap.md +8 -8
  5. package/dist/content/guides/post-create-onboarding.md +140 -140
  6. package/dist/content/patterns/api/api-routes.md +313 -313
  7. package/dist/content/patterns/api/error-handling.md +310 -310
  8. package/dist/content/patterns/database/drizzle-schema.md +279 -279
  9. package/dist/content/patterns/database/migrations.md +364 -364
  10. package/dist/content/patterns/database/query-organization.md +536 -536
  11. package/dist/content/patterns/database/relations.md +449 -449
  12. package/dist/content/patterns/deployment/build-configuration.md +440 -440
  13. package/dist/content/patterns/deployment/ci-cd-patterns.md +447 -447
  14. package/dist/content/patterns/deployment/environment-config.md +379 -379
  15. package/dist/content/patterns/deployment/hosting-setup.md +424 -424
  16. package/dist/content/patterns/project/configuration-patterns.md +459 -459
  17. package/dist/content/patterns/project/documentation-org.md +506 -506
  18. package/dist/content/patterns/project/folder-structure.md +397 -397
  19. package/dist/content/patterns/project/library-exports.md +464 -464
  20. package/dist/content/patterns/project/monorepo-structure.md +500 -500
  21. package/dist/content/patterns/routing/dynamic-routes.md +220 -220
  22. package/dist/content/patterns/routing/file-based-routing.md +185 -185
  23. package/dist/content/patterns/routing/route-groups.md +428 -428
  24. package/dist/content/patterns/state/persistence-middleware.md +520 -520
  25. package/dist/content/patterns/state/selector-hooks.md +537 -537
  26. package/dist/content/patterns/state/store-organization.md +538 -538
  27. package/dist/content/patterns/state/zustand-patterns.md +347 -347
  28. package/dist/content/patterns/styling/component-styling.md +467 -467
  29. package/dist/content/patterns/styling/responsive-patterns.md +397 -397
  30. package/dist/content/patterns/styling/theme-configuration.md +425 -425
  31. package/dist/content/patterns/styling/uniwind-setup.md +411 -411
  32. package/dist/content/prompts/continue-development.md +35 -35
  33. package/dist/content/prompts/fix-seo.md +29 -29
  34. package/dist/content/prompts/onboard-new-expo-app.md +11 -11
  35. package/dist/content/prompts/prepare-deploy.md +29 -29
  36. package/dist/content/prompts/project-research-plan.md +29 -29
  37. package/dist/content/prompts/push-merge-loop.md +25 -25
  38. package/dist/content/prompts/review-expo-project.md +29 -29
  39. package/dist/content/prompts/run-doctor.md +38 -38
  40. package/dist/content/prompts/wrap-up.md +67 -67
  41. package/dist/content/reference/create-expo-stack-uniwind.md +29 -29
  42. package/dist/content/reference/mcp-sdk-transport.md +30 -30
  43. package/dist/content/reference/reference-repo-evacuation.md +31 -31
  44. package/dist/content/skills/api-routes.md +33 -33
  45. package/dist/content/skills/continue-development.md +32 -32
  46. package/dist/content/skills/debugging.md +32 -32
  47. package/dist/content/skills/deployment.md +32 -32
  48. package/dist/content/skills/dev-server-management.md +32 -32
  49. package/dist/content/skills/env-vars.md +32 -32
  50. package/dist/content/skills/expo-router-architecture.md +33 -33
  51. package/dist/content/skills/expo-ssr-safety.md +32 -32
  52. package/dist/content/skills/plugin-creation.md +41 -41
  53. package/dist/content/skills/production-server-patterns.md +31 -31
  54. package/dist/content/skills/project-onboarding.md +31 -31
  55. package/dist/content/skills/research-plan-intake.md +32 -32
  56. package/dist/content/skills/seo-metadata.md +31 -31
  57. package/dist/content/skills/super-stack-startup.md +34 -34
  58. package/dist/content/skills/uniwind-theming.md +32 -32
  59. package/package.json +6 -1
@@ -1,35 +1,35 @@
1
- # /continue-development
2
-
3
- Resume work on an onboarded project by following MDS phase order from `project/todo.md`.
4
-
5
- ## Arguments
6
-
7
- - `projectPath`: onboarded app path (default: current directory).
8
-
9
- ## MCP-First Workflow
10
-
11
- 1. Confirm the `mr-djs-dev-suite` MCP server is available.
12
- 2. Call `continue_project` first to get the active-phase brief.
13
- 3. Pull `get_skill` for `continue-development` to enforce phase-first sequencing.
14
- 4. If blockers appear, use `doctor_scan_project` and `doctor_explain_result` for targeted remediation before feature work.
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
-
22
- ## CLI / Manual Fallback
23
-
24
- 1. If MCP is not configured, install it manually:
25
- - `mds mcp install --client <client> --scope project`
26
- 2. Direct CLI flow:
27
- - `mds continue <projectPath>`
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>`
31
-
32
- ## Verification And Output
33
-
34
- - Confirm the chosen task belongs to the active phase or has an explicit deferral note.
35
- - Output: selected next task, blockers, and validation commands to run after implementation.
1
+ # /continue-development
2
+
3
+ Resume work on an onboarded project by following MDS phase order from `project/todo.md`.
4
+
5
+ ## Arguments
6
+
7
+ - `projectPath`: onboarded app path (default: current directory).
8
+
9
+ ## MCP-First Workflow
10
+
11
+ 1. Confirm the `mr-djs-dev-suite` MCP server is available.
12
+ 2. Call `continue_project` first to get the active-phase brief.
13
+ 3. Pull `get_skill` for `continue-development` to enforce phase-first sequencing.
14
+ 4. If blockers appear, use `doctor_scan_project` and `doctor_explain_result` for targeted remediation before feature work.
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
+
22
+ ## CLI / Manual Fallback
23
+
24
+ 1. If MCP is not configured, install it manually:
25
+ - `mds mcp install --client <client> --scope project`
26
+ 2. Direct CLI flow:
27
+ - `mds continue <projectPath>`
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>`
31
+
32
+ ## Verification And Output
33
+
34
+ - Confirm the chosen task belongs to the active phase or has an explicit deferral note.
35
+ - Output: selected next task, blockers, and validation commands to run after implementation.
@@ -1,29 +1,29 @@
1
- # /fix-seo
2
-
3
- Apply SEO metadata fixes for Expo web routes with MCP guidance and post-fix verification.
4
-
5
- ## Arguments
6
-
7
- - `projectPath`: Expo project path (default: current directory).
8
- - `routeOrFile`: optional route/file focus for targeted checks.
9
-
10
- ## MCP-First Workflow
11
-
12
- 1. Confirm the `mr-djs-dev-suite` MCP server is available.
13
- 2. Pull `get_skill` for `seo-metadata`.
14
- 3. Optionally run `doctor_scan_file` for focused route files, then `doctor_scan_project` for full checks.
15
- 4. Use `knowledge_list_resources` (`kind: "rule"`) to ensure canonical/indexing strategy is complete.
16
- 5. Implement metadata, canonical, robots, and sitemap corrections in route ownership boundaries.
17
-
18
- ## CLI / Manual Fallback
19
-
20
- 1. If MCP is not configured, install it manually:
21
- - `mds mcp install --client <client> --scope project`
22
- 2. Direct CLI checks:
23
- - `mds doctor <projectPath> --ci`
24
- - Run project-specific web build/preview commands to verify metadata output.
25
-
26
- ## Verification And Output
27
-
28
- - Confirm canonical tags, social metadata, and sitemap/robots behavior on affected routes.
29
- - Output: changed files, resolved SEO gaps, and any remaining manual verification steps.
1
+ # /fix-seo
2
+
3
+ Apply SEO metadata fixes for Expo web routes with MCP guidance and post-fix verification.
4
+
5
+ ## Arguments
6
+
7
+ - `projectPath`: Expo project path (default: current directory).
8
+ - `routeOrFile`: optional route/file focus for targeted checks.
9
+
10
+ ## MCP-First Workflow
11
+
12
+ 1. Confirm the `mr-djs-dev-suite` MCP server is available.
13
+ 2. Pull `get_skill` for `seo-metadata`.
14
+ 3. Optionally run `doctor_scan_file` for focused route files, then `doctor_scan_project` for full checks.
15
+ 4. Use `knowledge_list_resources` (`kind: "rule"`) to ensure canonical/indexing strategy is complete.
16
+ 5. Implement metadata, canonical, robots, and sitemap corrections in route ownership boundaries.
17
+
18
+ ## CLI / Manual Fallback
19
+
20
+ 1. If MCP is not configured, install it manually:
21
+ - `mds mcp install --client <client> --scope project`
22
+ 2. Direct CLI checks:
23
+ - `mds doctor <projectPath> --ci`
24
+ - Run project-specific web build/preview commands to verify metadata output.
25
+
26
+ ## Verification And Output
27
+
28
+ - Confirm canonical tags, social metadata, and sitemap/robots behavior on affected routes.
29
+ - Output: changed files, resolved SEO gaps, and any remaining manual verification steps.
@@ -1,11 +1,11 @@
1
- # /onboard-new-expo-app
2
-
3
- Run onboarding intake for an existing Expo app folder.
4
-
5
- ## Arguments
6
-
7
- - `projectPath`: existing Expo app path (default: current directory).
8
-
9
- ## MCP Prompt Notes
10
-
11
- This canonical spec backs the `onboard_new_expo_app` MCP prompt metadata. The runtime onboarding prompt text is generated from the server-side onboarding template so it can include current context and path-dependent instructions.
1
+ # /onboard-new-expo-app
2
+
3
+ Run onboarding intake for an existing Expo app folder.
4
+
5
+ ## Arguments
6
+
7
+ - `projectPath`: existing Expo app path (default: current directory).
8
+
9
+ ## MCP Prompt Notes
10
+
11
+ This canonical spec backs the `onboard_new_expo_app` MCP prompt metadata. The runtime onboarding prompt text is generated from the server-side onboarding template so it can include current context and path-dependent instructions.
@@ -1,29 +1,29 @@
1
- # /prepare-deploy
2
-
3
- Prepare an Expo project for release using deployment-focused skills plus Doctor parity checks.
4
-
5
- ## Arguments
6
-
7
- - `projectPath`: release candidate project path (default: current directory).
8
- - `includeSeo`: whether to include web metadata/indexing checks (default: `true` when web is targeted).
9
-
10
- ## MCP-First Workflow
11
-
12
- 1. Confirm the `mr-djs-dev-suite` MCP server is available.
13
- 2. Run `doctor_scan_project` in `ci` mode for release parity.
14
- 3. Pull `get_skill` for `deployment`; if web is involved also pull `seo-metadata`.
15
- 4. Use `knowledge_list_resources` (`kind: "rule"`) to confirm env hygiene, SSR safety, and metadata requirements.
16
- 5. Produce a release checklist mapped to current failing checks.
17
-
18
- ## CLI / Manual Fallback
19
-
20
- 1. If MCP is not configured, install it manually:
21
- - `mds mcp install --client <client> --scope project`
22
- 2. Direct CLI path:
23
- - `mds doctor <projectPath> --ci`
24
- - Run project scripts: `lint`, `type-check`, `test`, and production build/profile scripts.
25
-
26
- ## Verification And Output
27
-
28
- - Re-run `doctor_scan_project` (or CLI equivalent) until blockers are cleared.
29
- - Output: release readiness status, unresolved blockers, and rollback/readiness notes.
1
+ # /prepare-deploy
2
+
3
+ Prepare an Expo project for release using deployment-focused skills plus Doctor parity checks.
4
+
5
+ ## Arguments
6
+
7
+ - `projectPath`: release candidate project path (default: current directory).
8
+ - `includeSeo`: whether to include web metadata/indexing checks (default: `true` when web is targeted).
9
+
10
+ ## MCP-First Workflow
11
+
12
+ 1. Confirm the `mr-djs-dev-suite` MCP server is available.
13
+ 2. Run `doctor_scan_project` in `ci` mode for release parity.
14
+ 3. Pull `get_skill` for `deployment`; if web is involved also pull `seo-metadata`.
15
+ 4. Use `knowledge_list_resources` (`kind: "rule"`) to confirm env hygiene, SSR safety, and metadata requirements.
16
+ 5. Produce a release checklist mapped to current failing checks.
17
+
18
+ ## CLI / Manual Fallback
19
+
20
+ 1. If MCP is not configured, install it manually:
21
+ - `mds mcp install --client <client> --scope project`
22
+ 2. Direct CLI path:
23
+ - `mds doctor <projectPath> --ci`
24
+ - Run project scripts: `lint`, `type-check`, `test`, and production build/profile scripts.
25
+
26
+ ## Verification And Output
27
+
28
+ - Re-run `doctor_scan_project` (or CLI equivalent) until blockers are cleared.
29
+ - Output: release readiness status, unresolved blockers, and rollback/readiness notes.
@@ -1,29 +1,29 @@
1
- # /project-research-plan
2
-
3
- Turn rough product notes/research into actionable MDS project memory and next-phase plan.
4
-
5
- ## Arguments
6
-
7
- - `projectPath`: target project path (default: current directory).
8
- - `inputs`: attached notes/docs to normalize into canonical memory files.
9
-
10
- ## MCP-First Workflow
11
-
12
- 1. Confirm the `mr-djs-dev-suite` MCP server is available.
13
- 2. Pull `get_skill` for `research-plan-intake` (and `project-onboarding` when onboarding context is mixed in).
14
- 3. Call `knowledge_list_resources` for `guide` and `reference` resources as needed for structure and validation.
15
- 4. Normalize clear context directly; ask focused follow-up only where ambiguity changes implementation direction.
16
- 5. Update project memory files and produce an implementation-ready next-phase plan.
17
-
18
- ## CLI / Manual Fallback
19
-
20
- 1. If MCP is not configured, install it manually:
21
- - `mds mcp install --client <client> --scope project`
22
- 2. Direct CLI fallback:
23
- - Use `mds onboard <projectPath>` for structured intake when memory files are missing.
24
- - Use `mds continue <projectPath>` after memory normalization to select the next task.
25
-
26
- ## Verification And Output
27
-
28
- - Confirm `project/info.md`, `project/style.md`, and `project/todo.md` align with extracted research context.
29
- - Output: resolved unknowns, outstanding questions, and the recommended next implementation slice.
1
+ # /project-research-plan
2
+
3
+ Turn rough product notes/research into actionable MDS project memory and next-phase plan.
4
+
5
+ ## Arguments
6
+
7
+ - `projectPath`: target project path (default: current directory).
8
+ - `inputs`: attached notes/docs to normalize into canonical memory files.
9
+
10
+ ## MCP-First Workflow
11
+
12
+ 1. Confirm the `mr-djs-dev-suite` MCP server is available.
13
+ 2. Pull `get_skill` for `research-plan-intake` (and `project-onboarding` when onboarding context is mixed in).
14
+ 3. Call `knowledge_list_resources` for `guide` and `reference` resources as needed for structure and validation.
15
+ 4. Normalize clear context directly; ask focused follow-up only where ambiguity changes implementation direction.
16
+ 5. Update project memory files and produce an implementation-ready next-phase plan.
17
+
18
+ ## CLI / Manual Fallback
19
+
20
+ 1. If MCP is not configured, install it manually:
21
+ - `mds mcp install --client <client> --scope project`
22
+ 2. Direct CLI fallback:
23
+ - Use `mds onboard <projectPath>` for structured intake when memory files are missing.
24
+ - Use `mds continue <projectPath>` after memory normalization to select the next task.
25
+
26
+ ## Verification And Output
27
+
28
+ - Confirm `project/info.md`, `project/style.md`, and `project/todo.md` align with extracted research context.
29
+ - Output: resolved unknowns, outstanding questions, and the recommended next implementation slice.
@@ -1,25 +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
-
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
+
@@ -1,29 +1,29 @@
1
- # /review-expo-project
2
-
3
- Review an Expo project with MCP-first diagnostics and skill-guided remediation.
4
-
5
- ## Arguments
6
-
7
- - `projectPath`: absolute or relative project path (default: current directory).
8
- - `mode`: Doctor mode (`fast`, `ci`, or `full`; default: `ci`).
9
-
10
- ## MCP-First Workflow
11
-
12
- 1. Confirm the `mr-djs-dev-suite` MCP server is available.
13
- 2. Call `continue_project` to summarize current project state and blockers.
14
- 3. Call `doctor_scan_project` with `projectPath` and `mode`.
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. Call `knowledge_list_resources` with `kind: "guide"` if extra reference context is needed.
17
-
18
- ## CLI / Manual Fallback
19
-
20
- 1. If MCP is not configured, install it manually:
21
- - `mds mcp install --client <client> --scope project`
22
- 2. If MCP still cannot run, use direct CLI flows:
23
- - `mds continue <projectPath>`
24
- - `mds doctor <projectPath> --ci`
25
-
26
- ## Verification And Output
27
-
28
- - Re-run `doctor_scan_project` (or `mds doctor --ci`) after fixes.
29
- - Output: blocker summary, failing checks, recommended next task, and concrete follow-up commands.
1
+ # /review-expo-project
2
+
3
+ Review an Expo project with MCP-first diagnostics and skill-guided remediation.
4
+
5
+ ## Arguments
6
+
7
+ - `projectPath`: absolute or relative project path (default: current directory).
8
+ - `mode`: Doctor mode (`fast`, `ci`, or `full`; default: `ci`).
9
+
10
+ ## MCP-First Workflow
11
+
12
+ 1. Confirm the `mr-djs-dev-suite` MCP server is available.
13
+ 2. Call `continue_project` to summarize current project state and blockers.
14
+ 3. Call `doctor_scan_project` with `projectPath` and `mode`.
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. Call `knowledge_list_resources` with `kind: "guide"` if extra reference context is needed.
17
+
18
+ ## CLI / Manual Fallback
19
+
20
+ 1. If MCP is not configured, install it manually:
21
+ - `mds mcp install --client <client> --scope project`
22
+ 2. If MCP still cannot run, use direct CLI flows:
23
+ - `mds continue <projectPath>`
24
+ - `mds doctor <projectPath> --ci`
25
+
26
+ ## Verification And Output
27
+
28
+ - Re-run `doctor_scan_project` (or `mds doctor --ci`) after fixes.
29
+ - Output: blocker summary, failing checks, recommended next task, and concrete follow-up commands.
@@ -1,38 +1,38 @@
1
- # /run-doctor
2
-
3
- Run MDS Doctor as the primary health check for an Expo project.
4
-
5
- ## Arguments
6
-
7
- - `projectPath`: project root path (default: current directory).
8
- - `mode`: `fast`, `ci`, or `full` (default: `ci`).
9
- - `runScripts`: whether Doctor should execute project scripts (default: `true` for `ci` mode).
10
-
11
- ## MCP-First Workflow
12
-
13
- 1. Confirm the `mr-djs-dev-suite` MCP server is available.
14
- 2. Call `doctor_scan_project` with selected arguments.
15
- 3. For each non-pass result, call `doctor_explain_result`.
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`.
23
-
24
- ## CLI / Manual Fallback
25
-
26
- 1. If MCP is not configured, install it manually:
27
- - `mds mcp install --client <client> --scope project`
28
- 2. Direct CLI alternatives:
29
- - `mds doctor <projectPath>`
30
- - `mds doctor <projectPath> --ci`
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`
34
-
35
- ## Verification And Output
36
-
37
- - Re-run Doctor after each fix batch.
38
- - Output: check summary, blocking errors first, and the exact command used for re-check.
1
+ # /run-doctor
2
+
3
+ Run MDS Doctor as the primary health check for an Expo project.
4
+
5
+ ## Arguments
6
+
7
+ - `projectPath`: project root path (default: current directory).
8
+ - `mode`: `fast`, `ci`, or `full` (default: `ci`).
9
+ - `runScripts`: whether Doctor should execute project scripts (default: `true` for `ci` mode).
10
+
11
+ ## MCP-First Workflow
12
+
13
+ 1. Confirm the `mr-djs-dev-suite` MCP server is available.
14
+ 2. Call `doctor_scan_project` with selected arguments.
15
+ 3. For each non-pass result, call `doctor_explain_result`.
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`.
23
+
24
+ ## CLI / Manual Fallback
25
+
26
+ 1. If MCP is not configured, install it manually:
27
+ - `mds mcp install --client <client> --scope project`
28
+ 2. Direct CLI alternatives:
29
+ - `mds doctor <projectPath>`
30
+ - `mds doctor <projectPath> --ci`
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`
34
+
35
+ ## Verification And Output
36
+
37
+ - Re-run Doctor after each fix batch.
38
+ - Output: check summary, blocking errors first, and the exact command used for re-check.
@@ -1,67 +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.
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.
@@ -1,29 +1,29 @@
1
- # create-expo-stack Uniwind Exploration
2
-
3
- Source: https://github.com/roninoss/create-expo-stack
4
-
5
- ## Findings
6
-
7
- - The project describes itself as an interactive CLI for `rn-new`.
8
- - It already supports multiple styling choices, including NativeWind,
9
- Unistyles, StyleSheets, and Tamagui.
10
- - The README describes a per-file template model: base files live in a base
11
- template folder, while optional package features live in package template
12
- folders and use EJS to patch shared files.
13
-
14
- ## Phase 1 Decision
15
-
16
- A friendly upstream Uniwind contribution should stay small:
17
-
18
- - add Uniwind as another styling option,
19
- - follow the existing package-slice template convention,
20
- - include `web` in Expo Router generated `app.json` platforms when web config
21
- and dependencies are generated,
22
- - add focused Software Mansion core package options where they are not already
23
- covered,
24
- - avoid MDS project memory files, MCP config, agent prompts, or richer
25
- boilerplate,
26
- - keep the deeper post-create setup in `mds onboard` and
27
- `create-expo-super-stack`.
28
-
29
- No local Phase 1 code should depend on the upstream fork or PR existing.
1
+ # create-expo-stack Uniwind Exploration
2
+
3
+ Source: https://github.com/roninoss/create-expo-stack
4
+
5
+ ## Findings
6
+
7
+ - The project describes itself as an interactive CLI for `rn-new`.
8
+ - It already supports multiple styling choices, including NativeWind,
9
+ Unistyles, StyleSheets, and Tamagui.
10
+ - The README describes a per-file template model: base files live in a base
11
+ template folder, while optional package features live in package template
12
+ folders and use EJS to patch shared files.
13
+
14
+ ## Phase 1 Decision
15
+
16
+ A friendly upstream Uniwind contribution should stay small:
17
+
18
+ - add Uniwind as another styling option,
19
+ - follow the existing package-slice template convention,
20
+ - include `web` in Expo Router generated `app.json` platforms when web config
21
+ and dependencies are generated,
22
+ - add focused Software Mansion core package options where they are not already
23
+ covered,
24
+ - avoid MDS project memory files, MCP config, agent prompts, or richer
25
+ boilerplate,
26
+ - keep the deeper post-create setup in `mds onboard` and
27
+ `create-expo-super-stack`.
28
+
29
+ No local Phase 1 code should depend on the upstream fork or PR existing.