@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.
- package/.codex/prompts/enforcement.md +1 -1
- package/.codex/prompts/onboarding.md +5 -5
- package/README.md +29 -29
- package/bin/ma.js +13 -1
- package/docs/README.md +2 -1
- package/docs/getting-started.md +10 -8
- package/docs/installed-sdk.md +60 -0
- package/docs/onboarding.md +3 -3
- package/docs/qa/{release-readiness-0.1.0.md → release-readiness-0.1.2.md} +25 -8
- package/docs/release-spec.md +9 -9
- package/docs/skills.md +31 -3
- package/package.json +5 -4
- package/plugins/meta-architect/.app.json +1 -1
- package/plugins/meta-architect/.codex-plugin/plugin.json +2 -2
- package/plugins/meta-architect/.mcp.json +1 -1
- package/plugins/meta-architect/README.md +2 -2
- package/plugins/meta-architect/skills/arch/agents/openai.yaml +2 -2
- package/plugins/meta-architect/skills/build/agents/openai.yaml +2 -2
- package/plugins/meta-architect/skills/flow/agents/openai.yaml +2 -2
- package/plugins/meta-architect/skills/meta-architect/agents/openai.yaml +2 -2
- package/plugins/meta-architect/skills/meta-architect/references/core-release-rules.md +1 -1
- package/plugins/meta-architect/skills/sage/agents/openai.yaml +2 -2
- package/plugins/meta-architect/skills/vet/agents/openai.yaml +2 -2
- package/plugins/meta-architect/skills/vibe/agents/openai.yaml +2 -2
- package/scripts/postinstall.js +7 -3
- package/skills/arch/agents/openai.yaml +2 -2
- package/skills/build/agents/openai.yaml +2 -2
- package/skills/flow/agents/openai.yaml +2 -2
- package/skills/meta-architect/agents/openai.yaml +2 -2
- package/skills/meta-architect/references/core-release-rules.md +1 -1
- package/skills/sage/agents/openai.yaml +2 -2
- package/skills/vet/agents/openai.yaml +2 -2
- package/skills/vibe/agents/openai.yaml +2 -2
- package/src/launcher.js +3 -2
- package/src/mcp-live-client.js +1 -1
- package/src/runtime-artifacts.js +2 -2
- package/src/skill-installer.js +151 -2
- package/src/skills.js +3 -3
- package/templates/AGENTS.md +130 -0
- package/templates/catalog-manifest.json +22 -0
- package/templates/model-instructions/core.md +39 -0
- package/templates/model-instructions/release.md +41 -0
- package/templates/model-instructions/security.md +22 -0
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
# Onboarding
|
|
2
2
|
|
|
3
|
-
Meta-Architect is a skills-first
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
|
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%
|
|
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.
|
|
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.
|
|
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>
|
|
39
|
-
<td><code>ma</code
|
|
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.
|
|
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
|
-
-
|
|
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
|
-
|
|
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
|
-
#
|
|
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
|
|
90
|
-
- Meta-Architect is installed globally as
|
|
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
|
-
-
|
|
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
|
|
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.
|
|
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.
|
|
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
|
|
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
|
-
|
|
312
|
+
Meta-Architect has two surfaces.
|
|
315
313
|
|
|
316
|
-
|
|
317
|
-
|
|
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 ...` =
|
|
342
|
-
- `$...` =
|
|
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
|
|
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
|
|
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
|
|
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.
|
|
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("
|
|
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.
|
|
20
|
+
- [Release Readiness 0.1.2](./qa/release-readiness-0.1.2.md)
|
|
20
21
|
|
|
21
22
|
## Repo structure references
|
|
22
23
|
|
package/docs/getting-started.md
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
# Getting Started
|
|
2
2
|
|
|
3
|
-
This guide takes
|
|
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
|
|
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
|
|
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.
|
|
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
|
-
-
|
|
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`
|
|
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
|
|
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.
|
package/docs/onboarding.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Onboarding
|
|
2
2
|
|
|
3
|
-
This is the shortest
|
|
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
|
|
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
|
-
#
|
|
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.
|
|
1
|
+
# Release Readiness 0.1.2
|
|
2
2
|
|
|
3
3
|
## Production bar
|
|
4
4
|
|
|
5
|
-
`v0.1.
|
|
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.
|
|
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.
|
|
13
|
-
- npm registry state: pending
|
|
14
|
-
- publishability note:
|
|
15
|
-
- git tag: `v0.1.
|
|
16
|
-
- GitHub release:
|
|
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
|
|
package/docs/release-spec.md
CHANGED
|
@@ -1,18 +1,18 @@
|
|
|
1
|
-
# v0.1.
|
|
1
|
+
# v0.1.2 Requirements & Rules
|
|
2
2
|
|
|
3
3
|
## Production definition
|
|
4
4
|
|
|
5
|
-
Meta-Architect `v0.1.
|
|
5
|
+
Meta-Architect `v0.1.2` is production only when:
|
|
6
6
|
1. the package/install surface works
|
|
7
|
-
2. the
|
|
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.
|
|
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.
|
|
53
|
-
- git tag `v0.1.
|
|
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.
|
|
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.
|
|
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,
|
|
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
|
-
#
|
|
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
|
|
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.
|
|
4
|
-
"description": "Codex-native
|
|
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
|
-
"
|
|
25
|
-
"
|
|
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.
|
|
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.
|
|
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": "
|
|
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
|
}
|