@mr.dj2u/knowledge 0.1.3 → 0.1.5
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/dist/content/guides/post-create-onboarding.md +45 -37
- package/dist/content/patterns/project/configuration-patterns.md +4 -4
- package/dist/content/patterns/project/documentation-org.md +1 -1
- package/dist/content/patterns/project/monorepo-structure.md +1 -1
- package/dist/content/prompts/create-expo-super-stack.md +36 -9
- package/dist/content/skills/super-stack-startup.md +4 -4
- package/package.json +1 -1
|
@@ -42,17 +42,19 @@ mds mcp install --dry-run # preview merge before writing
|
|
|
42
42
|
Restart the host (or run `claude mcp reload`) and the MDS prompts are
|
|
43
43
|
available from any workspace.
|
|
44
44
|
|
|
45
|
-
Two prompts and several callable MDS MCP tools ship with the server:
|
|
46
|
-
|
|
45
|
+
Two prompts and several callable MDS MCP tools ship with the server:
|
|
46
|
+
|
|
47
47
|
- `create_expo_super_stack` — invoke from a **parent folder** (e.g.
|
|
48
48
|
`F:\ReactNativeApps`) when the app folder does not exist yet. This is
|
|
49
|
-
now a thin orchestration prompt:
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
`
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
49
|
+
now a thin orchestration prompt: `mds_runtime_versions` checks for
|
|
50
|
+
stale installs, `create_expo_super_stack_resolve_info` resolves
|
|
51
|
+
project memory in one call when `info.md` is available,
|
|
52
|
+
`create_expo_super_stack_intake_step` is only the manual fallback for
|
|
53
|
+
missing or ambiguous answers, and generation happens through
|
|
54
|
+
`create_expo_super_stack_generate`.
|
|
55
|
+
- `onboard_new_expo_app` — invoke from **inside an existing Expo app
|
|
56
|
+
folder** (a freshly generated one or a year-old project). Runs the
|
|
57
|
+
intake → normalize → plan → scaffold flow.
|
|
56
58
|
|
|
57
59
|
After generation, the user-dev should open the generated app folder
|
|
58
60
|
directly in a new agent session and run `mds continue`. That fresh
|
|
@@ -69,33 +71,39 @@ delete the marker line.
|
|
|
69
71
|
error so the same blocker stops CI and editor surfaces until the user
|
|
70
72
|
fills the section or deletes the marker line.
|
|
71
73
|
|
|
72
|
-
### What's new in the agentic prompts and tools
|
|
73
|
-
|
|
74
|
-
- **PHASE 0 file intake.** The agent offers to digest an existing
|
|
75
|
-
`project/info.md` and `project/style.md` if the user has them already.
|
|
76
|
-
Questions whose answers are unambiguous in the file are skipped; the
|
|
77
|
-
agent asks for clarification only when the file is silent or unclear.
|
|
78
|
-
A reference template URL is mentioned in the prompt; the agent can
|
|
79
|
-
also inline the template on request.
|
|
74
|
+
### What's new in the agentic prompts and tools
|
|
75
|
+
|
|
76
|
+
- **PHASE 0 file intake.** The agent offers to digest an existing
|
|
77
|
+
`project/info.md` and `project/style.md` if the user has them already.
|
|
78
|
+
Questions whose answers are unambiguous in the file are skipped; the
|
|
79
|
+
agent asks for clarification only when the file is silent or unclear.
|
|
80
|
+
A reference template URL is mentioned in the prompt; the agent can
|
|
81
|
+
also inline the template on request.
|
|
82
|
+
- **Shared resolver-first intake.** `create_expo_super_stack_resolve_info`
|
|
83
|
+
parses existing project memory up front, derives app naming details,
|
|
84
|
+
merges explicit overrides, returns missing or ambiguous fields, and
|
|
85
|
+
produces a ready-to-pass generate payload so the user is not forced
|
|
86
|
+
through redundant question-by-question discovery.
|
|
80
87
|
- **Android TV alongside Apple TV.** The platform multi-select now
|
|
81
88
|
includes Android TV. Android TV builds from the same Android target
|
|
82
89
|
with leanback config in `app.json`; Apple TV is a separate tvOS build
|
|
83
90
|
target via `react-native-tvos`. Selecting either records the intent
|
|
84
91
|
in project memory.
|
|
85
|
-
- **Shared CLI-backed intake contract.** The agentic CESS flow now uses
|
|
86
|
-
callable MCP tools backed by the shared `@mr.dj2u/cli` intake
|
|
87
|
-
contract. That keeps the questionnaire, defaults, dependency rules,
|
|
88
|
-
and flag mapping aligned with the published CLI behavior.
|
|
89
|
-
- **No silent defaults.** Guided intake must explicitly collect answers
|
|
90
|
-
or explicitly present visible defaults. If the CESS intake tools are
|
|
91
|
-
unavailable, the agent should stop and tell the user to refresh the
|
|
92
|
-
plugin or MCP install instead of inventing `--mds-yes` defaults.
|
|
92
|
+
- **Shared CLI-backed intake contract.** The agentic CESS flow now uses
|
|
93
|
+
callable MCP tools backed by the shared `@mr.dj2u/cli` intake
|
|
94
|
+
contract. That keeps the questionnaire, defaults, dependency rules,
|
|
95
|
+
and flag mapping aligned with the published CLI behavior.
|
|
96
|
+
- **No silent defaults.** Guided intake must explicitly collect answers
|
|
97
|
+
or explicitly present visible defaults. If the CESS intake tools are
|
|
98
|
+
unavailable, the agent should stop and tell the user to refresh the
|
|
99
|
+
plugin or MCP install instead of inventing `--mds-yes` defaults.
|
|
93
100
|
- **Runtime version diagnostics.** `mds_runtime_versions` reports the
|
|
94
|
-
active MCP server version, CLI version,
|
|
95
|
-
`create-expo-super-stack
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
101
|
+
active MCP server version, CLI version, concrete installed
|
|
102
|
+
`create-expo-super-stack` version, and the published generation path
|
|
103
|
+
in use.
|
|
104
|
+
- **Credits while waiting.** When generation kicks off, the agent
|
|
105
|
+
prints a recognition note for the upstream teams and individuals
|
|
106
|
+
whose work fills the MDS knowledge base.
|
|
99
107
|
- **Success message surfaced.** After a successful run, the agent
|
|
100
108
|
quotes the generator's `MDS onboarding complete` tail block back
|
|
101
109
|
verbatim so the Mr. DJ personal thank-you text appears in chat the same way
|
|
@@ -144,12 +152,12 @@ Copy-Item -Path .\plugins\vscode-copilot\.vscode\* -Destination .\.vscode -Recur
|
|
|
144
152
|
## Install Path & What This MD Is For
|
|
145
153
|
|
|
146
154
|
- This markdown is a human- and agent-facing guide. It documents the onboarding flow and explains what the agent prompts do. It is used as input to the `packages/knowledge` build which generates plugin/agent bundles for Codex, Claude Code, and VS Code Copilot.
|
|
147
|
-
- The agent itself is not this file — it is a runtime that loads generated prompts/skills from the plugin bundles or the MCP server. To activate the agent surfaces you must either:
|
|
148
|
-
- Install the MCP prompts via `mds mcp install --client <client>` (user or project scope), or
|
|
149
|
-
- Copy the generated plugin files from `plugins/vscode-copilot` / `plugins/codex` / `plugins/claude-code` into the target workspace or user profile and restart the corresponding client.
|
|
150
|
-
- If a host keeps using stale prompt or plugin behavior after republish,
|
|
151
|
-
refresh the local plugin cache, reinstall the MDS MCP server, and run
|
|
152
|
-
`mds_runtime_versions` from the host surface to confirm which version
|
|
153
|
-
is actually active.
|
|
155
|
+
- The agent itself is not this file — it is a runtime that loads generated prompts/skills from the plugin bundles or the MCP server. To activate the agent surfaces you must either:
|
|
156
|
+
- Install the MCP prompts via `mds mcp install --client <client>` (user or project scope), or
|
|
157
|
+
- Copy the generated plugin files from `plugins/vscode-copilot` / `plugins/codex` / `plugins/claude-code` into the target workspace or user profile and restart the corresponding client.
|
|
158
|
+
- If a host keeps using stale prompt or plugin behavior after republish,
|
|
159
|
+
refresh the local plugin cache, reinstall the MDS MCP server, and run
|
|
160
|
+
`mds_runtime_versions` from the host surface to confirm which version
|
|
161
|
+
is actually active.
|
|
154
162
|
|
|
155
163
|
If you want, I can: regenerate the VS Code bundle now, copy the assets into the current workspace, and verify Copilot sees the prompts. Say "Do it" and I'll run the build and copy steps for you.
|
|
@@ -51,8 +51,8 @@ Configuration patterns establish consistent strategies for managing app configur
|
|
|
51
51
|
|
|
52
52
|
"platforms": ["ios", "android", "web"],
|
|
53
53
|
|
|
54
|
-
"sdkVersion": "56.0.0",
|
|
55
|
-
"runtimeVersion": "56.0.0",
|
|
54
|
+
"sdkVersion": "56.0.0",
|
|
55
|
+
"runtimeVersion": "56.0.0",
|
|
56
56
|
|
|
57
57
|
"web": {
|
|
58
58
|
"output": "static",
|
|
@@ -178,7 +178,7 @@ export default ({ config }) => {
|
|
|
178
178
|
"dependencies": {
|
|
179
179
|
"react": "^19.0.0",
|
|
180
180
|
"react-native": "^0.83.0",
|
|
181
|
-
"expo": "^56.0.0",
|
|
181
|
+
"expo": "^56.0.0",
|
|
182
182
|
"expo-router": "^3.0.0",
|
|
183
183
|
"zustand": "^4.4.0",
|
|
184
184
|
"drizzle-orm": "^0.30.0",
|
|
@@ -456,4 +456,4 @@ export function useConfig() {
|
|
|
456
456
|
---
|
|
457
457
|
|
|
458
458
|
*Pattern extracted from production repositories: DJsPortfolio, time2pay, not-hot-dog*
|
|
459
|
-
*Examples: app.json, app.config.js, metro.config.js, babel.config.js, tsconfig.json*
|
|
459
|
+
*Examples: app.json, app.config.js, metro.config.js, babel.config.js, tsconfig.json*
|
|
@@ -66,7 +66,7 @@ truth and should not make changes that conflict with those files.
|
|
|
66
66
|
Personal portfolio and project showcase for David J Grimsley.
|
|
67
67
|
|
|
68
68
|
## Core Stack
|
|
69
|
-
- **Framework**: Expo SDK 56 + React Native 0.85
|
|
69
|
+
- **Framework**: Expo SDK 56 + React Native 0.85
|
|
70
70
|
- **Routing**: Expo Router (file-based)
|
|
71
71
|
- **Styling**: Uniwind v1.2.6 + Tailwind v4
|
|
72
72
|
- **State**: Zustand (atomic stores)
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# /create-expo-super-stack
|
|
2
2
|
|
|
3
|
-
Create a new Expo app with the MDS Super Stack flow, using
|
|
3
|
+
Create a new Expo app with the MDS Super Stack flow, using callable MDS MCP tools as the guided intake surface and the Super Stack generator as the scaffold source of truth.
|
|
4
4
|
|
|
5
5
|
## Arguments
|
|
6
6
|
|
|
@@ -9,14 +9,37 @@ Create a new Expo app with the MDS Super Stack flow, using the published CESS CL
|
|
|
9
9
|
|
|
10
10
|
## Required MDS MCP Tool Flow
|
|
11
11
|
|
|
12
|
-
1.
|
|
13
|
-
2.
|
|
14
|
-
3.
|
|
15
|
-
4.
|
|
16
|
-
5.
|
|
17
|
-
6.
|
|
18
|
-
7.
|
|
19
|
-
8.
|
|
12
|
+
1. Call `mds_runtime_versions` first to inspect the active runtime and invocation path.
|
|
13
|
+
2. If the user pasted or attached `info.md` / project memory, call `create_expo_super_stack_resolve_info` once with `parentDir`, `appName`, `infoMarkdown`, optional `styleMarkdown`, and any explicit user overrides.
|
|
14
|
+
3. Treat the resolver `answers` object as the canonical accumulated answers object.
|
|
15
|
+
4. Ask exactly one question per turn only for `missingQuestionIds` or `ambiguousQuestionIds`.
|
|
16
|
+
5. Do not restart intake with one answer at a time after a successful resolve call.
|
|
17
|
+
6. If no `info.md` is available, fall back to `create_expo_super_stack_intake_step` and always pass the full accumulated `answers` object.
|
|
18
|
+
7. When the resolver returns `confirm`, summarize `summaryLines` and ask the user for one final confirmation.
|
|
19
|
+
8. After explicit confirmation, print the waiting message below, then call `create_expo_super_stack_generate` with the resolver `generateInput` and `confirmed: true`.
|
|
20
|
+
|
|
21
|
+
## Waiting Message Before Generate
|
|
22
|
+
|
|
23
|
+
After the user confirms, print this block before running the generator so they have something useful to read while scaffolding runs:
|
|
24
|
+
|
|
25
|
+
Generating now. This typically takes 2-5 minutes. While we wait, let's shout out and recognize how this is working.
|
|
26
|
+
|
|
27
|
+
create-expo-super-stack by Mr. DJ (who also built this agentic flow) wraps create-expo-stack by Roni OSS with major contributions by Dan Stepanov (NativeWind). Big thanks to them and to several other teams and individuals whose work and educational materials fill Mr. DJ's Dev Suite knowledge base:
|
|
28
|
+
|
|
29
|
+
- Expo team (Evan Bacon for Expo Router, Brent Vatne, Charlie Cheever, and the broader Expo crew)
|
|
30
|
+
- React and React Native core teams
|
|
31
|
+
- Software Mansion (Reanimated, Gesture Handler, Screens, Worklets; Krzysztof Magiera and team)
|
|
32
|
+
- Supabase, Drizzle, and Zustand teams
|
|
33
|
+
- Adam Wathan and the Tailwind CSS team (the foundation Uniwind and NativeWind build on)
|
|
34
|
+
- Janic Duplessis for "The real cost of React Native animations: benchmarking every approach"
|
|
35
|
+
- Simon Grimm of Galaxies.dev
|
|
36
|
+
- Beto Adrian Maldonado of codewithbeto.dev
|
|
37
|
+
- Vadim of notJust.dev
|
|
38
|
+
- William Candillon for the React Native animation deep-dive content
|
|
39
|
+
- Catalin Miron for the React Native animation tutorials
|
|
40
|
+
- Infinite Red / Jamon Holmgren for Ignite and the broader RN community
|
|
41
|
+
|
|
42
|
+
Their contributions to the software development community are what fill the pages of Mr. DJ's Dev Suite knowledge base, alongside contributions and organization by Mr. DJ. Please enjoy the experience of the Mr. DJ's Dev Suite plugin as you continue your development.
|
|
20
43
|
|
|
21
44
|
## Failure Behavior
|
|
22
45
|
|
|
@@ -25,8 +48,12 @@ Create a new Expo app with the MDS Super Stack flow, using the published CESS CL
|
|
|
25
48
|
3. Tell the user to refresh or reinstall the MDS plugin/MCP server.
|
|
26
49
|
4. Do not fall back to `--mds-yes` or direct CLI shortcuts unless the user explicitly asked for a fast non-interactive run.
|
|
27
50
|
|
|
51
|
+
Warn only when `mds_runtime_versions.warnings` is non-empty or when the user expected different versions than the runtime reports.
|
|
52
|
+
Do not describe the normal published install path as a fallback, and do not mention `npm exec` or `npx` to the user unless there is an actual runtime problem they need to act on.
|
|
53
|
+
|
|
28
54
|
## Verification And Output
|
|
29
55
|
|
|
30
56
|
- Confirm generated app has `project/info.md`, `project/todo.md`, `project/style.md`, and `project/guidelines.md`.
|
|
31
57
|
- Confirm `project/todo.md` includes the auto-derived roadmap generated from normalized `project/info.md`.
|
|
58
|
+
- If those Super Stack artifacts are missing, treat generation as a failure or partial scaffold and say so clearly instead of presenting it as a normal success.
|
|
32
59
|
- Output: generated app path, onboarding status, and the handoff to open a fresh agent session inside the new app folder and run `mds continue`.
|
|
@@ -17,10 +17,10 @@ Run generator + onboarding as one guided flow, keep agent-facing wording sourced
|
|
|
17
17
|
|
|
18
18
|
## Preferred structure
|
|
19
19
|
|
|
20
|
-
- Keep startup conversation in plain language and summarize choices before execution.
|
|
21
|
-
- Keep generation details in scripts/flags, but keep user-facing flow conversational.
|
|
22
|
-
- Keep post-generation workflow phase-based using the generated `project/todo.md`, and derive that roadmap from normalized `project/info.md` before handoff.
|
|
23
|
-
- Prefer shared knowledge content over duplicating long onboarding prose in plugin or MCP wrappers.
|
|
20
|
+
- Keep startup conversation in plain language and summarize choices before execution.
|
|
21
|
+
- Keep generation details in scripts/flags, but keep user-facing flow conversational.
|
|
22
|
+
- Keep post-generation workflow phase-based using the generated `project/todo.md`, and derive that roadmap from normalized `project/info.md` before handoff.
|
|
23
|
+
- Prefer shared knowledge content over duplicating long onboarding prose in plugin or MCP wrappers.
|
|
24
24
|
|
|
25
25
|
## Example fix
|
|
26
26
|
|