@mr.dj2u/knowledge 0.1.2 → 0.1.4
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 +42 -35
- 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 +34 -31
- package/dist/content/skills/super-stack-startup.md +1 -1
- 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
49
|
now a thin orchestration prompt: the real guided intake happens
|
|
50
|
-
through `
|
|
51
|
-
|
|
50
|
+
through `create_expo_super_stack_extract_info` first when project
|
|
51
|
+
memory is available, then `create_expo_super_stack_intake_step` only
|
|
52
|
+
for missing or ambiguous answers, generation happens through
|
|
53
|
+
`create_expo_super_stack_generate`, and diagnostics come from
|
|
52
54
|
`mds_runtime_versions`.
|
|
53
|
-
- `onboard_new_expo_app` — invoke from **inside an existing Expo app
|
|
54
|
-
folder** (a freshly generated one or a year-old project). Runs the
|
|
55
|
-
intake → normalize → plan → scaffold flow.
|
|
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,38 @@ 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 extraction-first intake.** `create_expo_super_stack_extract_info`
|
|
83
|
+
parses existing project memory up front, derives app naming details,
|
|
84
|
+
preserves unmatched notes, and seeds the intake tool so the user is
|
|
85
|
+
not forced through redundant question-by-question discovery.
|
|
80
86
|
- **Android TV alongside Apple TV.** The platform multi-select now
|
|
81
87
|
includes Android TV. Android TV builds from the same Android target
|
|
82
88
|
with leanback config in `app.json`; Apple TV is a separate tvOS build
|
|
83
89
|
target via `react-native-tvos`. Selecting either records the intent
|
|
84
90
|
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.
|
|
91
|
+
- **Shared CLI-backed intake contract.** The agentic CESS flow now uses
|
|
92
|
+
callable MCP tools backed by the shared `@mr.dj2u/cli` intake
|
|
93
|
+
contract. That keeps the questionnaire, defaults, dependency rules,
|
|
94
|
+
and flag mapping aligned with the published CLI behavior.
|
|
95
|
+
- **No silent defaults.** Guided intake must explicitly collect answers
|
|
96
|
+
or explicitly present visible defaults. If the CESS intake tools are
|
|
97
|
+
unavailable, the agent should stop and tell the user to refresh the
|
|
98
|
+
plugin or MCP install instead of inventing `--mds-yes` defaults.
|
|
93
99
|
- **Runtime version diagnostics.** `mds_runtime_versions` reports the
|
|
94
|
-
active MCP server version, CLI version,
|
|
95
|
-
`create-expo-super-stack
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
100
|
+
active MCP server version, CLI version, concrete installed
|
|
101
|
+
`create-expo-super-stack` version, and the published generation path
|
|
102
|
+
in use.
|
|
103
|
+
- **Credits while waiting.** When generation kicks off, the agent
|
|
104
|
+
prints a recognition note for the upstream teams and individuals
|
|
105
|
+
whose work fills the MDS knowledge base.
|
|
99
106
|
- **Success message surfaced.** After a successful run, the agent
|
|
100
107
|
quotes the generator's `MDS onboarding complete` tail block back
|
|
101
108
|
verbatim so the Mr. DJ personal thank-you text appears in chat the same way
|
|
@@ -144,12 +151,12 @@ Copy-Item -Path .\plugins\vscode-copilot\.vscode\* -Destination .\.vscode -Recur
|
|
|
144
151
|
## Install Path & What This MD Is For
|
|
145
152
|
|
|
146
153
|
- 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.
|
|
154
|
+
- 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:
|
|
155
|
+
- Install the MCP prompts via `mds mcp install --client <client>` (user or project scope), or
|
|
156
|
+
- 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.
|
|
157
|
+
- If a host keeps using stale prompt or plugin behavior after republish,
|
|
158
|
+
refresh the local plugin cache, reinstall the MDS MCP server, and run
|
|
159
|
+
`mds_runtime_versions` from the host surface to confirm which version
|
|
160
|
+
is actually active.
|
|
154
161
|
|
|
155
162
|
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,31 +1,34 @@
|
|
|
1
|
-
# /create-expo-super-stack
|
|
2
|
-
|
|
3
|
-
Create a new Expo app with the MDS Super Stack flow, using the published CESS CLI as the execution source of truth and callable MDS MCP tools as the guided intake surface.
|
|
4
|
-
|
|
5
|
-
## Arguments
|
|
6
|
-
|
|
7
|
-
- `parentDir`: folder where the new app directory should be created.
|
|
8
|
-
- `appName`: app folder name.
|
|
9
|
-
|
|
10
|
-
## Required MDS MCP Tool Flow
|
|
11
|
-
|
|
12
|
-
1. Confirm the `mr-djs-dev-suite` MCP server is available.
|
|
13
|
-
2.
|
|
14
|
-
3.
|
|
15
|
-
4.
|
|
16
|
-
5.
|
|
17
|
-
6.
|
|
18
|
-
7.
|
|
19
|
-
8.
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
1
|
+
# /create-expo-super-stack
|
|
2
|
+
|
|
3
|
+
Create a new Expo app with the MDS Super Stack flow, using the published CESS CLI as the execution source of truth and callable MDS MCP tools as the guided intake surface.
|
|
4
|
+
|
|
5
|
+
## Arguments
|
|
6
|
+
|
|
7
|
+
- `parentDir`: folder where the new app directory should be created.
|
|
8
|
+
- `appName`: app folder name.
|
|
9
|
+
|
|
10
|
+
## Required MDS MCP Tool Flow
|
|
11
|
+
|
|
12
|
+
1. Confirm the `mr-djs-dev-suite` MCP server is available.
|
|
13
|
+
2. If the user pasted or attached `info.md` / project memory, call `create_expo_super_stack_extract_info` first.
|
|
14
|
+
3. Seed the returned answers into `create_expo_super_stack_intake_step` and use intake only for missing or ambiguous questions.
|
|
15
|
+
4. Ask exactly one question per turn.
|
|
16
|
+
5. Always show the returned default and options.
|
|
17
|
+
6. Never invent or silently accept defaults on the user's behalf.
|
|
18
|
+
7. If extraction found the app name, do not ask a second display-name question.
|
|
19
|
+
8. When the intake tool returns `confirm`, summarize the returned `summaryLines` and ask the user to confirm.
|
|
20
|
+
9. After explicit confirmation, set `answers.confirmed=true`, call the intake tool again, and proceed only when it returns `ready`.
|
|
21
|
+
10. Then call `create_expo_super_stack_generate` with `confirmed: true`.
|
|
22
|
+
|
|
23
|
+
## Failure Behavior
|
|
24
|
+
|
|
25
|
+
1. If the guided intake or generate tools are unavailable, stop.
|
|
26
|
+
2. Call `mds_runtime_versions` to diagnose stale plugin or MCP installs.
|
|
27
|
+
3. Tell the user to refresh or reinstall the MDS plugin/MCP server.
|
|
28
|
+
4. Do not fall back to `--mds-yes` or direct CLI shortcuts unless the user explicitly asked for a fast non-interactive run.
|
|
29
|
+
|
|
30
|
+
## Verification And Output
|
|
31
|
+
|
|
32
|
+
- Confirm generated app has `project/info.md`, `project/todo.md`, `project/style.md`, and `project/guidelines.md`.
|
|
33
|
+
- Confirm `project/todo.md` includes the auto-derived roadmap generated from normalized `project/info.md`.
|
|
34
|
+
- Output: generated app path, onboarding status, and the handoff to open a fresh agent session inside the new app folder and run `mds continue`.
|
|
@@ -19,7 +19,7 @@ Run generator + onboarding as one guided flow, keep agent-facing wording sourced
|
|
|
19
19
|
|
|
20
20
|
- Keep startup conversation in plain language and summarize choices before execution.
|
|
21
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
|
|
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
23
|
- Prefer shared knowledge content over duplicating long onboarding prose in plugin or MCP wrappers.
|
|
24
24
|
|
|
25
25
|
## Example fix
|