@jstn-sdk/ma 0.1.0 → 0.1.2

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 (43) hide show
  1. package/.codex/prompts/enforcement.md +1 -1
  2. package/.codex/prompts/onboarding.md +5 -5
  3. package/README.md +29 -29
  4. package/bin/ma.js +13 -1
  5. package/docs/README.md +2 -1
  6. package/docs/getting-started.md +10 -8
  7. package/docs/installed-sdk.md +60 -0
  8. package/docs/onboarding.md +3 -3
  9. package/docs/qa/{release-readiness-0.1.0.md → release-readiness-0.1.2.md} +25 -8
  10. package/docs/release-spec.md +9 -9
  11. package/docs/skills.md +31 -3
  12. package/package.json +5 -4
  13. package/plugins/meta-architect/.app.json +1 -1
  14. package/plugins/meta-architect/.codex-plugin/plugin.json +2 -2
  15. package/plugins/meta-architect/.mcp.json +1 -1
  16. package/plugins/meta-architect/README.md +2 -2
  17. package/plugins/meta-architect/skills/arch/agents/openai.yaml +2 -2
  18. package/plugins/meta-architect/skills/build/agents/openai.yaml +2 -2
  19. package/plugins/meta-architect/skills/flow/agents/openai.yaml +2 -2
  20. package/plugins/meta-architect/skills/meta-architect/agents/openai.yaml +2 -2
  21. package/plugins/meta-architect/skills/meta-architect/references/core-release-rules.md +1 -1
  22. package/plugins/meta-architect/skills/sage/agents/openai.yaml +2 -2
  23. package/plugins/meta-architect/skills/vet/agents/openai.yaml +2 -2
  24. package/plugins/meta-architect/skills/vibe/agents/openai.yaml +2 -2
  25. package/scripts/postinstall.js +7 -3
  26. package/skills/arch/agents/openai.yaml +2 -2
  27. package/skills/build/agents/openai.yaml +2 -2
  28. package/skills/flow/agents/openai.yaml +2 -2
  29. package/skills/meta-architect/agents/openai.yaml +2 -2
  30. package/skills/meta-architect/references/core-release-rules.md +1 -1
  31. package/skills/sage/agents/openai.yaml +2 -2
  32. package/skills/vet/agents/openai.yaml +2 -2
  33. package/skills/vibe/agents/openai.yaml +2 -2
  34. package/src/launcher.js +3 -2
  35. package/src/mcp-live-client.js +1 -1
  36. package/src/runtime-artifacts.js +2 -2
  37. package/src/skill-installer.js +151 -2
  38. package/src/skills.js +3 -3
  39. package/templates/AGENTS.md +130 -0
  40. package/templates/catalog-manifest.json +22 -0
  41. package/templates/model-instructions/core.md +39 -0
  42. package/templates/model-instructions/release.md +41 -0
  43. package/templates/model-instructions/security.md +22 -0
@@ -19,7 +19,7 @@ Your purpose is to turn project ideas into evidence-backed architecture, validat
19
19
  Treat Meta-Architect as two layers:
20
20
 
21
21
  - **Kernel**
22
- - CLI runtime
22
+ - helper runtime
23
23
  - gate enforcement
24
24
  - decision and release state
25
25
  - MCP evidence binding
@@ -1,10 +1,10 @@
1
1
  # Onboarding
2
2
 
3
- Meta-Architect is a skills-first orchestration layer with a strict kernel.
3
+ Meta-Architect is a skills-first system for Codex with a strict kernel.
4
4
 
5
5
  ## What is implemented
6
6
 
7
- The primary runtime surface is `ma --madmax --high` plus:
7
+ The primary product surface is the in-session skill flow:
8
8
  - `$arch`
9
9
  - `$sage`
10
10
  - `$flow`
@@ -12,7 +12,7 @@ The primary runtime surface is `ma --madmax --high` plus:
12
12
  - `$vibe`
13
13
  - `$build`
14
14
 
15
- Repo-local helper commands remain available through:
15
+ Secondary helper commands remain available through:
16
16
  - `ma init`
17
17
  - `ma idea`
18
18
  - `ma skills`
@@ -32,10 +32,10 @@ Repo-local helper commands remain available through:
32
32
  2. Read `docs/getting-started.md`
33
33
  3. Read `docs/release-spec.md`
34
34
  4. Read `docs/skills.md`
35
- 5. Start with `ma --madmax --high` and use `$arch` before assuming the workflow is ready
35
+ 5. Start Codex context if needed, then use `$arch` before assuming the workflow is ready
36
36
 
37
37
  ## What not to do
38
38
 
39
39
  - Do not edit `.ma/release.json` or `.ma/decisions.json` manually to bypass the gate model.
40
- - Do not treat `.ma/logs/` or `.ma/state/` as source.
40
+ - Do not treat `.ma` support files as public source.
41
41
  - Do not claim release channels succeeded without proof.
package/README.md CHANGED
@@ -1,8 +1,8 @@
1
1
  <div align="center">
2
2
  <img src="./docs/assets/meta-architect-logo.svg" alt="Meta-Architect logo" width="1024" height="240">
3
- <p>Production-grade skills package and CLI for programmatic architecture, evidence-backed OSS selection, gate-driven review, and release-minded build unlocking.</p>
3
+ <p>Production-grade Codex skills and plugin package for architecture, evidence-backed OSS selection, gate-driven review, and release-minded build guidance.</p>
4
4
  <p>
5
- <img src="https://img.shields.io/npm/v/%40jstn-sdk%2Fmeta-architect" alt="npm version">
5
+ <img src="https://img.shields.io/npm/v/%40jstn-sdk%2Fma" alt="npm version">
6
6
  <img src="https://img.shields.io/badge/node-%3E%3D20-339933" alt="Node.js 20+">
7
7
  <img src="https://img.shields.io/github/v/release/JustineDevs/meta-architect" alt="GitHub release">
8
8
  <img src="https://img.shields.io/badge/license-MIT-16A34A" alt="MIT License">
@@ -10,9 +10,9 @@
10
10
  </div>
11
11
 
12
12
  > [!IMPORTANT]
13
- > Meta-Architect `v0.1.0` is a production-grade skills line.
13
+ > Meta-Architect `v0.1.2` is a production-grade skills line.
14
14
  > It is not a lightweight demo branch.
15
- > From `v0.1.0` onward, the package is expected to ship with stable skill contracts, deterministic packaging, explicit release gates, and honest install and publish surfaces.
15
+ > From `v0.1.2` onward, the package is expected to ship with stable skill contracts, deterministic packaging, explicit release gates, and honest install and publish surfaces.
16
16
 
17
17
  ## Overview
18
18
 
@@ -35,8 +35,8 @@ It adds:
35
35
  <td><code>@jstn-sdk/ma</code></td>
36
36
  </tr>
37
37
  <tr>
38
- <td><strong>CLI commands</strong></td>
39
- <td><code>ma</code>, <code>meta-architect</code></td>
38
+ <td><strong>Helper command</strong></td>
39
+ <td><code>ma</code> (secondary support surface)</td>
40
40
  </tr>
41
41
  <tr>
42
42
  <td><strong>Runtime</strong></td>
@@ -44,7 +44,7 @@ It adds:
44
44
  </tr>
45
45
  <tr>
46
46
  <td><strong>Release line</strong></td>
47
- <td><code>v0.1.0</code></td>
47
+ <td><code>v0.1.2</code></td>
48
48
  </tr>
49
49
  <tr>
50
50
  <td><strong>License</strong></td>
@@ -58,7 +58,7 @@ It adds:
58
58
  - npm `>=10`
59
59
  - Git
60
60
  - an MCP-capable coding runtime
61
- - OpenAI Codex CLI for the recommended package-first path
61
+ - Codex for the recommended package-first path
62
62
  - macOS, Linux, or WSL2 recommended
63
63
 
64
64
  > [!TIP]
@@ -68,13 +68,13 @@ It adds:
68
68
 
69
69
  Meta-Architect is intended to be consumed as an installed package, not primarily as a git clone.
70
70
 
71
- Default operator path:
71
+ Primary product path:
72
72
 
73
73
  ```bash
74
74
  # Install
75
75
  npm i -g @openai/codex@latest @jstn-sdk/ma@latest
76
76
 
77
- # Launch
77
+ # Start Codex context if needed
78
78
  ma --madmax --high
79
79
 
80
80
  # Remove Meta-Architect only
@@ -86,11 +86,10 @@ npm uninstall -g @jstn-sdk/ma @openai/codex
86
86
 
87
87
  What this assumes:
88
88
 
89
- - Codex CLI is installed globally
90
- - Meta-Architect is installed globally as a package
89
+ - Codex is installed globally
90
+ - Meta-Architect is installed globally as the skills/plugin package
91
91
  - Meta-Architect installs its published skill surface into the active Codex home
92
- - `ma` launches Codex with the Meta-Architect workflow posture already attached
93
- - you will operate through the skill-driven workflow inside the Codex session
92
+ - the product experience happens through the skill workflow inside Codex
94
93
 
95
94
  > [!IMPORTANT]
96
95
  > The recommended default flow is package-first.
@@ -133,10 +132,9 @@ npm uninstall -g @jstn-sdk/ma @openai/codex
133
132
 
134
133
  This gives you:
135
134
 
136
- - `ma`
137
- - `meta-architect`
138
135
  - the installed Meta-Architect skill surface
139
- - the canonical Meta-Architect runtime entrypoints inside a Codex session
136
+ - the canonical Meta-Architect skill entrypoints inside a Codex session
137
+ - the optional `ma` helper command when a guided start is useful
140
138
 
141
139
  ### Contributor setup: source checkout
142
140
 
@@ -153,7 +151,7 @@ npm link
153
151
 
154
152
  ## Quick Start
155
153
 
156
- ### 1. Launch the runtime
154
+ ### 1. Start Codex context if needed
157
155
 
158
156
  ```bash
159
157
  ma --madmax --high
@@ -195,7 +193,7 @@ Required output:
195
193
  5. Data model and storage choices
196
194
  6. Auth/security considerations
197
195
  7. DX/UX considerations
198
- 8. Delivery plan for v0.1.0
196
+ 8. Delivery plan for v0.1.2
199
197
  9. Risks and trade-offs
200
198
  10. Decision log
201
199
  11. Exact next trigger to run after this
@@ -215,7 +213,7 @@ $build
215
213
 
216
214
  See [example/usage-workflow.md](./example/usage-workflow.md) for the full prompt templates for each step.
217
215
 
218
- ### 4. Secondary maintenance path
216
+ ### 4. Secondary helper path
219
217
 
220
218
  If you are working from a repository directly and need scaffolded local support files, use:
221
219
 
@@ -311,10 +309,10 @@ git worktree add ../api feature/api
311
309
 
312
310
  ### 7. Simple command guide
313
311
 
314
- There are two different ways to use Meta-Architect.
312
+ Meta-Architect has two surfaces.
315
313
 
316
- 1. Terminal commands
317
- 2. In-session skills
314
+ - terminal helper commands
315
+ - in-session skills
318
316
 
319
317
  Terminal commands are normal shell commands you run in the terminal:
320
318
 
@@ -338,8 +336,8 @@ $build
338
336
  ```
339
337
 
340
338
  Plain-language difference:
341
- - `ma ...` = terminal helper commands
342
- - `$...` = in-session skill prompts
339
+ - `ma ...` = helper commands in the terminal
340
+ - `$...` = the product experience inside Codex
343
341
 
344
342
  What `ma setup` and `ma init` do:
345
343
  - both currently do the same thing
@@ -348,9 +346,10 @@ What `ma setup` and `ma init` do:
348
346
  - they do not run the skill workflow by themselves
349
347
 
350
348
  What to use when:
351
- - use `ma --madmax --high` or `ma` to enter Codex
349
+ - use Codex and run the skills in-session
352
350
  - use `$arch -> $sage -> $flow -> $vet -> $vibe -> $build` inside the Codex session
353
351
  - use `ma setup` or `ma init` only when you want local scaffolding or scripted helper automation from the terminal
352
+ - use `ma sdk-path` when you need the exact installed support-bundle path for packaged prompts, MCP files, sprint files, scripts, plugin metadata, or templates
354
353
 
355
354
  ## Core Maintainers
356
355
 
@@ -405,7 +404,7 @@ Meta-Architect has two related but different distribution surfaces.
405
404
 
406
405
  | Surface | Purpose | Produced by |
407
406
  | --- | --- | --- |
408
- | npm package | public package containing CLI, docs, scripts, and canonical skills | `npm publish` or `npm pack` |
407
+ | npm package | public package containing the installable Meta-Architect skills/plugin system, docs, scripts, and canonical skills | `npm publish` or `npm pack` |
409
408
  | skills bundle | narrower tarball containing `skills/` only | `npm run skills:pack` |
410
409
 
411
410
  Required packaging commands:
@@ -424,7 +423,7 @@ Pre-publish rules:
424
423
  - `npm run skills:validate` must pass
425
424
  - `dist/meta-architect-skills.tgz` must exist
426
425
  - `npm pack --dry-run` must show only intended public files
427
- - docs must match real CLI and release behavior
426
+ - docs must match the real skills/plugin and release behavior
428
427
 
429
428
  Release lane discipline:
430
429
  - stable versions publish to npm `latest`
@@ -512,12 +511,13 @@ Provenance note:
512
511
  | --- | --- |
513
512
  | [Getting Started](./docs/getting-started.md) | end-to-end local onboarding |
514
513
  | [Skills Reference](./docs/skills.md) | trigger-by-trigger contract guide |
514
+ | [Installed Support Bundle](./docs/installed-sdk.md) | standard packaged asset path for skills and helper flows |
515
515
  | [Skills Publishing](./docs/skills-publishing.md) | source-to-package pipeline |
516
516
  | [MCP Setup](./docs/mcp-setup.md) | evidence endpoint policy |
517
517
  | [Plugin README](./plugins/meta-architect/README.md) | plugin distribution surface |
518
518
  | [Collaborative Whiteboard Mission](./missions/collaborative-whiteboard/mission.md) | concrete scenario walkthrough |
519
519
  | [Release Spec](./docs/release-spec.md) | release and gate policy |
520
- | [Release Readiness](./docs/qa/release-readiness-0.1.0.md) | QA evidence for the `v0.1.0` line |
520
+ | [Release Readiness](./docs/qa/release-readiness-0.1.2.md) | QA evidence for the `v0.1.2` line |
521
521
 
522
522
  ## Release Hygiene
523
523
 
package/bin/ma.js CHANGED
@@ -15,6 +15,11 @@ import {
15
15
  } from "../src/policy.js";
16
16
  import { loadReleaseState } from "../src/release-state.js";
17
17
  import { writeBuildPlanArtifact } from "../src/runtime-artifacts.js";
18
+ import {
19
+ ensureSkillsInstalled,
20
+ ensureSupportBundleInstalled,
21
+ getSupportBundleRoot,
22
+ } from "../src/skill-installer.js";
18
23
  import {
19
24
  listSkills,
20
25
  runArch,
@@ -28,12 +33,13 @@ import {
28
33
  import { syncStatusUpdates } from "../src/state-sync.js";
29
34
 
30
35
  function printUsage() {
31
- console.error("Usage:");
36
+ console.error("Secondary helper commands:");
32
37
  console.error(" ma");
33
38
  console.error(" ma setup");
34
39
  console.error(" ma init");
35
40
  console.error(' ma idea "..."');
36
41
  console.error(" ma skills");
42
+ console.error(" ma sdk-path");
37
43
  console.error(" ma status");
38
44
  console.error(" ma run $arch|$sage|$flow|$vet|$vibe|$build");
39
45
  console.error(" ma merge <source-branch> <target-branch>");
@@ -198,6 +204,7 @@ async function main() {
198
204
  const arg = rest[0];
199
205
 
200
206
  if (shouldDelegateToCodex(args)) {
207
+ await Promise.all([ensureSkillsInstalled(), ensureSupportBundleInstalled()]);
201
208
  process.exitCode = runCodex(args);
202
209
  return;
203
210
  }
@@ -236,6 +243,11 @@ async function main() {
236
243
  return;
237
244
  }
238
245
 
246
+ if (command === "sdk-path") {
247
+ process.stdout.write(`${getSupportBundleRoot()}\n`);
248
+ return;
249
+ }
250
+
239
251
  if (command === "status") {
240
252
  const releaseState = await loadReleaseState();
241
253
  printStatus(releaseState);
package/docs/README.md CHANGED
@@ -7,6 +7,7 @@ Meta-Architect documentation is organized by operator task.
7
7
  - [Getting Started](./getting-started.md)
8
8
  - [Release Spec](./release-spec.md)
9
9
  - [Skills Reference](./skills.md)
10
+ - [Installed Support Bundle](./installed-sdk.md)
10
11
 
11
12
  ## Packaging and installation
12
13
 
@@ -16,7 +17,7 @@ Meta-Architect documentation is organized by operator task.
16
17
 
17
18
  ## QA and readiness
18
19
 
19
- - [Release Readiness 0.1.0](./qa/release-readiness-0.1.0.md)
20
+ - [Release Readiness 0.1.2](./qa/release-readiness-0.1.2.md)
20
21
 
21
22
  ## Repo structure references
22
23
 
@@ -1,11 +1,11 @@
1
1
  # Getting Started
2
2
 
3
- This guide takes a new user from clone to a green-gated Meta-Architect workflow on a real project.
3
+ This guide takes Meta-Architect from install to a green-gated skill workflow on a real project.
4
4
 
5
5
  ## Goal
6
6
 
7
7
  By the end of this guide you should be able to:
8
- - install Meta-Architect locally
8
+ - install Meta-Architect
9
9
  - configure MCP/GitMCP sources
10
10
  - run the full architecture-to-build sequence
11
11
  - understand how each gate moves
@@ -38,7 +38,7 @@ npm uninstall -g @jstn-sdk/ma
38
38
  npm uninstall -g @jstn-sdk/ma @openai/codex
39
39
  ```
40
40
 
41
- That is the default operator posture. `ma` is the Meta-Architect launcher for a Codex session, and the rest of this guide should match the in-session workflow shape in [example/usage-workflow.md](../example/usage-workflow.md).
41
+ That is the default product path. The product experience is the in-session skill workflow in [example/usage-workflow.md](../example/usage-workflow.md). The `ma` command is only a helper for starting or supporting that flow.
42
42
 
43
43
  ## 2. Real usage workflow
44
44
 
@@ -74,7 +74,7 @@ Required output:
74
74
  5. Data model and storage choices
75
75
  6. Auth/security considerations
76
76
  7. DX/UX considerations
77
- 8. Delivery plan for v0.1.0
77
+ 8. Delivery plan for v0.1.2
78
78
  9. Risks and trade-offs
79
79
  10. Decision log
80
80
  11. Exact next trigger to run after this
@@ -102,8 +102,7 @@ npm link
102
102
  ```
103
103
 
104
104
  Why `npm link` matters:
105
- - the docs use the `ma` command directly
106
- - `npm link` makes the local CLI available without requiring a global publish step
105
+ - it makes the local helper command available without requiring a global publish step
107
106
 
108
107
  ## 4. Secondary repository setup flow
109
108
 
@@ -122,7 +121,7 @@ Expected effects:
122
121
  - `.codex/prompts/` exists
123
122
  - local `.ma/skills/`, `.ma/evidence/`, `.ma/context/`, `.ma/specs/`, `.ma/plans/`, and `.ma/runbook.md` are seeded
124
123
  - `mcp/`, `docs/`, and `sprint/` surfaces exist
125
- - `ma` launches the local Codex CLI when run with no arguments
124
+ - `ma` opens Codex with the Meta-Architect helper posture when run with no arguments
126
125
 
127
126
  Expected output:
128
127
 
@@ -142,7 +141,7 @@ ready: docs/qa
142
141
  ready: sprint
143
142
  ```
144
143
 
145
- This setup path is secondary to the canonical `ma --madmax --high` runtime launch. Use it when you need local repo scaffolding.
144
+ This setup path is secondary to the canonical in-session skill workflow. Use it when you need local repo scaffolding.
146
145
 
147
146
  ## 4.1 Understand the two surfaces
148
147
 
@@ -156,6 +155,7 @@ Terminal commands are normal shell commands:
156
155
  ```bash
157
156
  ma setup
158
157
  ma init
158
+ ma sdk-path
159
159
  ma status
160
160
  ma run '$arch'
161
161
  ```
@@ -180,6 +180,8 @@ Easy rule:
180
180
  - they prepare context, specs, plans, evidence, and runbook files
181
181
  - they do not automatically run the skill workflow
182
182
 
183
+ `ma sdk-path` prints the installed packaged support-bundle root for relevant files such as prompts, MCP files, sprint files, scripts, plugin metadata, and templates.
184
+
183
185
  ## 5. Configure MCP / GitMCP
184
186
 
185
187
  Edit:
@@ -0,0 +1,60 @@
1
+ # Installed Support Bundle
2
+
3
+ Meta-Architect installs two things into the active Codex home:
4
+
5
+ 1. skills under `CODEX_HOME/skills/`
6
+ 2. a support bundle under `CODEX_HOME/meta-architect-sdk/`
7
+
8
+ The support bundle exists so skills and helper paths can use relevant packaged files without guessing where they live.
9
+
10
+ ## Canonical support bundle path
11
+
12
+ Default:
13
+
14
+ ```text
15
+ ~/.codex/meta-architect-sdk/
16
+ ```
17
+
18
+ If `CODEX_HOME` is set, use:
19
+
20
+ ```text
21
+ $CODEX_HOME/meta-architect-sdk/
22
+ ```
23
+
24
+ You can print the exact active path with:
25
+
26
+ ```bash
27
+ ma sdk-path
28
+ ```
29
+
30
+ ## What is installed there
31
+
32
+ - `mcp/`
33
+ - `sprint/`
34
+ - `prompts/`
35
+ - `scripts/`
36
+ - `plugins/meta-architect/`
37
+ - `templates/`
38
+ - `docs/README.md`
39
+ - `asset-manifest.json`
40
+
41
+ ## Why this exists
42
+
43
+ - skills can rely on a standard installed asset root
44
+ - helper paths can repair missing support assets automatically
45
+ - packaged references do not depend on a source checkout
46
+ - the product can use relevant packaged files without path guessing
47
+
48
+ ## Contract
49
+
50
+ When Meta-Architect needs packaged support files, prefer the installed support bundle first.
51
+
52
+ Examples:
53
+ - MCP starter files -> `meta-architect-sdk/mcp/`
54
+ - sprint references -> `meta-architect-sdk/sprint/`
55
+ - Codex prompt assets -> `meta-architect-sdk/prompts/`
56
+ - helper scripts -> `meta-architect-sdk/scripts/`
57
+ - plugin metadata -> `meta-architect-sdk/plugins/meta-architect/`
58
+ - templates -> `meta-architect-sdk/templates/`
59
+
60
+ The in-session skill flow is still primary. This bundle only standardizes packaged asset access.
@@ -1,6 +1,6 @@
1
1
  # Onboarding
2
2
 
3
- This is the shortest operator entrypoint for someone who just opened Meta-Architect and needs the real first-run path.
3
+ This is the shortest entrypoint for the real first-run Meta-Architect path.
4
4
 
5
5
  ## Read first
6
6
 
@@ -10,13 +10,13 @@ This is the shortest operator entrypoint for someone who just opened Meta-Archit
10
10
  4. `docs/release-spec.md`
11
11
  5. `docs/skills-publishing.md`
12
12
 
13
- ## Canonical install and launch
13
+ ## Canonical install and start
14
14
 
15
15
  ```bash
16
16
  # Install
17
17
  npm i -g @openai/codex@latest @jstn-sdk/ma@latest
18
18
 
19
- # Launch
19
+ # Start Codex context if needed
20
20
  ma --madmax --high
21
21
 
22
22
  # Remove Meta-Architect only
@@ -1,19 +1,36 @@
1
- # Release Readiness 0.1.0
1
+ # Release Readiness 0.1.2
2
2
 
3
3
  ## Production bar
4
4
 
5
- `v0.1.0` is treated as production only when:
5
+ `v0.1.2` is treated as production only when:
6
6
  - the package installs cleanly from the canonical public install command
7
7
  - the Codex-hosted runtime path works end to end
8
8
  - the helper flow remains valid for scripted verification
9
- - release docs, package metadata, and workflows all agree on `0.1.0`
9
+ - release docs, package metadata, and workflows all agree on `0.1.2`
10
10
 
11
11
  Target release state:
12
- - npm package: `@jstn-sdk/ma@0.1.0`
13
- - npm registry state: pending manual publish
14
- - publishability note: this renamed package line is intended to publish as `0.1.0`
15
- - git tag: `v0.1.0`
16
- - GitHub release: published at `2026-05-02T10:59:33Z`
12
+ - npm package: `@jstn-sdk/ma@0.1.2`
13
+ - npm registry state: pending publish
14
+ - publishability note: `0.1.1` is already published, so `0.1.2` is the next publishable package line
15
+ - git tag: `v0.1.2`
16
+ - GitHub release: pending publish for `v0.1.2`
17
+
18
+ ## Production checklist
19
+
20
+ - skills-first product identity: PASS
21
+ - package/plugin identity aligned to `@jstn-sdk/ma`: PASS
22
+ - version/tag alignment `0.1.2` / `v0.1.2`: PASS
23
+ - install/uninstall docs aligned: PASS
24
+ - onboarding is concise and sequential: PASS
25
+ - helper command documented as secondary: PASS
26
+ - skills/prompts/manifests aligned: PASS
27
+ - packaging includes required assets: PASS
28
+ - tests pass: PASS
29
+ - package dry-run passes: PASS
30
+ - installed-package behavior passes: PASS
31
+ - workflow/release/provenance docs aligned: PASS
32
+ - no stale package names remain in tracked repo surfaces: PASS
33
+ - no conflicting CLI-first product story remains in tracked product docs: PASS
17
34
 
18
35
  ## Automated checks run
19
36
 
@@ -1,18 +1,18 @@
1
- # v0.1.0 Requirements & Rules
1
+ # v0.1.2 Requirements & Rules
2
2
 
3
3
  ## Production definition
4
4
 
5
- Meta-Architect `v0.1.0` is production only when:
5
+ Meta-Architect `v0.1.2` is production only when:
6
6
  1. the package/install surface works
7
- 2. the runtime workflow from `$arch` through `$build` works
7
+ 2. the in-session skill workflow from `$arch` through `$build` works
8
8
  3. the release evidence matches the actual package and git tag
9
9
 
10
- ## What `v0.1.0` must have
10
+ ## What `v0.1.2` must have
11
11
 
12
12
  ### 1. Canonical package/runtime path
13
13
 
14
14
  - install: `npm i -g @openai/codex@latest @jstn-sdk/ma@latest`
15
- - launch: `ma --madmax --high`
15
+ - optional helper launch: `ma --madmax --high`
16
16
  - uninstall Meta-Architect only: `npm uninstall -g @jstn-sdk/ma`
17
17
  - uninstall Meta-Architect and Codex: `npm uninstall -g @jstn-sdk/ma @openai/codex`
18
18
  - runtime trigger surface:
@@ -49,16 +49,16 @@ Canonical state files:
49
49
 
50
50
  ### 4. Required release evidence
51
51
 
52
- - `package.json` version `0.1.0`
53
- - git tag `v0.1.0`
52
+ - `package.json` version `0.1.2`
53
+ - git tag `v0.1.2`
54
54
  - `RELEASE.md`
55
55
  - `CHANGELOG.md`
56
- - `docs/qa/release-readiness-0.1.0.md`
56
+ - `docs/qa/release-readiness-0.1.2.md`
57
57
  - green `npm run release:check`
58
58
 
59
59
  ### 5. Dist-tag discipline
60
60
 
61
- - stable versions such as `0.1.0` publish to npm `latest`
61
+ - stable versions such as `0.1.2` publish to npm `latest`
62
62
  - prerelease versions such as `0.2.0-beta.1` must publish with explicit tags such as `beta`
63
63
  - recommended alternate lanes are `next`, `beta`, and `canary`
64
64
  - prerelease publication must use `npm publish --tag <lane>`
package/docs/skills.md CHANGED
@@ -10,13 +10,13 @@ Meta-Architect’s canonical Codex runtime surface is:
10
10
 
11
11
  ## Real usage path
12
12
 
13
- Install the package once, launch through `ma`, and use the skills directly in-session.
13
+ Install the package once, start Codex context if needed, and use the skills directly in-session.
14
14
 
15
15
  ```bash
16
16
  # Install
17
17
  npm i -g @openai/codex@latest @jstn-sdk/ma@latest
18
18
 
19
- # Launch
19
+ # Start Codex context if needed
20
20
  ma --madmax --high
21
21
 
22
22
  # Remove Meta-Architect only
@@ -67,6 +67,34 @@ Important:
67
67
  - they only create local support files
68
68
  - they do not replace the in-session skill flow
69
69
 
70
+ ## Installed support bundle
71
+
72
+ Meta-Architect also installs a standard packaged support bundle for relevant files.
73
+
74
+ Default path:
75
+
76
+ ```text
77
+ ~/.codex/meta-architect-sdk/
78
+ ```
79
+
80
+ Use:
81
+
82
+ ```bash
83
+ ma sdk-path
84
+ ```
85
+
86
+ when you want the exact active path.
87
+
88
+ Relevant packaged assets there include:
89
+ - `mcp/`
90
+ - `sprint/`
91
+ - `prompts/`
92
+ - `scripts/`
93
+ - `plugins/meta-architect/`
94
+ - `templates/`
95
+
96
+ This exists so Meta-Architect can use relevant packaged files without guessing paths.
97
+
70
98
  ## Shared output contract
71
99
 
72
100
  Every skill result must include:
@@ -88,4 +116,4 @@ Every skill result must include:
88
116
 
89
117
  ## Operator note
90
118
 
91
- The runtime trigger surface is primary. The `ma` helper commands exist to launch Codex with Meta-Architect attached and to provide repo-local state automation when scripted verification is needed.
119
+ The in-session skill surface is primary. The `ma` helper commands only exist to start Codex context and to provide repo-local state automation when scripted verification is needed.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@jstn-sdk/ma",
3
- "version": "0.1.0",
4
- "description": "Codex-native runtime layer for architecture, evidence, review, and gated build workflows.",
3
+ "version": "0.1.2",
4
+ "description": "Codex-native skills system for architecture, evidence, review, and gated build guidance.",
5
5
  "license": "MIT",
6
6
  "author": "JustineDevs",
7
7
  "homepage": "https://github.com/JustineDevs/meta-architect#readme",
@@ -21,8 +21,8 @@
21
21
  "ai",
22
22
  "agent",
23
23
  "orchestration",
24
- "cli",
25
- "developer-tools"
24
+ "plugin",
25
+ "workflow-system"
26
26
  ],
27
27
  "type": "module",
28
28
  "main": "index.js",
@@ -37,6 +37,7 @@
37
37
  ".agents/plugins/",
38
38
  "mcp/",
39
39
  "plugins/",
40
+ "templates/",
40
41
  "sprint/",
41
42
  "skills/",
42
43
  "docs/",
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "meta-architect",
3
3
  "displayName": "Meta-Architect",
4
- "version": "0.1.0",
4
+ "version": "0.1.2",
5
5
  "description": "Programmatic architecture and verified engineering skills for Codex-native workflows.",
6
6
  "entry": "./README.md",
7
7
  "skillsDir": "./skills"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "meta-architect",
3
- "version": "0.1.0",
3
+ "version": "0.1.2",
4
4
  "description": "Skills-first workflow layer for Codex with architecture, evidence, review, and gated build guidance.",
5
5
  "author": {
6
6
  "name": "JustineDevs",
@@ -16,7 +16,7 @@
16
16
  "interface": {
17
17
  "displayName": "Meta-Architect",
18
18
  "shortDescription": "Architecture-first skill bundle for Codex workflows.",
19
- "longDescription": "Plugin = Meta-Architect skill discovery plus plugin-scoped MCP and app metadata. Runtime = the ma launcher plus .ma state, release gates, and scripted helper commands when a repository needs local workflow state.",
19
+ "longDescription": "Meta-Architect packages reusable Codex skills plus plugin-scoped MCP and app metadata. The in-session skill workflow is primary. The ma helper command and .ma state only support setup, release gates, and optional local helper automation.",
20
20
  "developerName": "JustineDevs",
21
21
  "category": "Developer Tools"
22
22
  }
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "meta-architect",
3
- "version": "0.1.0",
3
+ "version": "0.1.2",
4
4
  "collections": [
5
5
  "sindresorhus/awesome",
6
6
  "dzharii/awesome-typescript",