@polymorphism-tech/morph-spec 4.13.0 → 4.14.0
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/CLAUDE.md +7 -7
- package/README.md +9 -7
- package/claude-plugin.json +1 -1
- package/docs/CHEATSHEET.md +6 -7
- package/docs/QUICKSTART.md +1 -1
- package/framework/agents.json +1084 -1040
- package/framework/commands/morph-apply.md +0 -2
- package/framework/commands/morph-preflight.md +192 -247
- package/framework/commands/morph-proposal.md +210 -238
- package/framework/commands/morph-status.md +72 -92
- package/framework/phases.json +162 -162
- package/framework/skills/level-1-workflows/morph-phase-codebase-analysis/SKILL.md +1 -1
- package/framework/skills/level-1-workflows/morph-phase-design/SKILL.md +2 -2
- package/framework/skills/level-1-workflows/morph-phase-implement/SKILL.md +1 -1
- package/framework/skills/level-1-workflows/morph-phase-implement/prompts/code-quality-reviewer-prompt.md +1 -1
- package/framework/skills/level-1-workflows/morph-phase-plan/SKILL.md +1 -1
- package/framework/skills/level-1-workflows/morph-phase-tasks/SKILL.md +1 -1
- package/framework/skills/level-1-workflows/morph-phase-tasks/references/task-planning-patterns.md +143 -170
- package/framework/skills/level-1-workflows/morph-phase-uiux/SKILL.md +1 -1
- package/framework/skills/level-1-workflows/morph-scope-escalation/SKILL.md +1 -1
- package/package.json +1 -1
- package/src/utils/agents-installer.js +40 -10
package/CLAUDE.md
CHANGED
|
@@ -51,16 +51,16 @@ No build step — pure ESM JavaScript, runs directly via Node.js 18+.
|
|
|
51
51
|
- `installers/` — Agents, skills, hooks installers for target projects
|
|
52
52
|
- **`src/utils/`** — Shared utilities (logger, banner, file-copier, claude-settings-manager, etc.)
|
|
53
53
|
- **`framework/`** — Metadata installed into target projects (READ-ONLY at runtime):
|
|
54
|
-
- `agents.json` (v4.0.0
|
|
55
|
-
- `phases.json` (
|
|
56
|
-
- `standards/STANDARDS.json`
|
|
57
|
-
- `hooks/claude-code/` — Hook scripts (
|
|
54
|
+
- `agents.json` (v4.0.0)
|
|
55
|
+
- `phases.json` (7 phases incl. sync)
|
|
56
|
+
- `standards/STANDARDS.json`
|
|
57
|
+
- `hooks/claude-code/` — Hook scripts (fail-open design)
|
|
58
58
|
- `skills/` — Morph skills (level-0-meta + level-1-workflows)
|
|
59
59
|
- `templates/` — Handlebars templates for code generation
|
|
60
60
|
|
|
61
61
|
### Key Architectural Patterns
|
|
62
62
|
|
|
63
|
-
**Dual-layer phase tracking:** Phase is derived from filesystem (`derivePhase()` scans for highest-numbered phase folder) — state.json only overrides for lightweight phases (
|
|
63
|
+
**Dual-layer phase tracking:** Phase is derived from filesystem (`derivePhase()` scans for highest-numbered phase folder) — state.json only overrides for lightweight phases (sync).
|
|
64
64
|
|
|
65
65
|
**Output schema as single source of truth:** `src/core/paths/output-schema.js` defines all output types. Run `npm run generate` after modifying it to update derived reference files.
|
|
66
66
|
|
|
@@ -70,12 +70,12 @@ No build step — pure ESM JavaScript, runs directly via Node.js 18+.
|
|
|
70
70
|
|
|
71
71
|
**Atomic state writes:** `state-manager.js` writes to a process-ID temp file then renames, preventing corruption from concurrent CLI invocations.
|
|
72
72
|
|
|
73
|
-
**Stack-aware filtering:** Assets declare `stacks: ['dotnet'
|
|
73
|
+
**Stack-aware filtering:** Assets declare `stacks: ['dotnet']` in YAML frontmatter. `setup-infra.js` reads `config.json → project.stack`, splits into tags, and installs only matching assets. `stacks: ['*']` = universal.
|
|
74
74
|
|
|
75
75
|
### Phase Sequence
|
|
76
76
|
|
|
77
77
|
```
|
|
78
|
-
proposal →
|
|
78
|
+
proposal → [uiux] → design → plan → tasks → implement → [sync]
|
|
79
79
|
```
|
|
80
80
|
|
|
81
81
|
Phases in brackets are optional. Approval gates exist at: proposal, design, plan, tasks, uiux.
|
package/README.md
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
> Spec-driven development framework for multi-stack projects. Turns feature requests into implementation-ready code through structured, AI-orchestrated phases.
|
|
4
4
|
|
|
5
5
|
**Package:** `@polymorphism-tech/morph-spec`
|
|
6
|
-
**Version:** 4.
|
|
6
|
+
**Version:** 4.14.0
|
|
7
7
|
**Requires:** Node.js 18+, Claude Code
|
|
8
8
|
|
|
9
9
|
---
|
|
@@ -88,7 +88,7 @@ your-project/
|
|
|
88
88
|
Features move through structured phases. Some are optional depending on feature type.
|
|
89
89
|
|
|
90
90
|
```
|
|
91
|
-
proposal →
|
|
91
|
+
proposal → [uiux] → design → plan → tasks → implement → [sync]
|
|
92
92
|
```
|
|
93
93
|
|
|
94
94
|
Phases in brackets are optional. `uiux` applies to UI-heavy features. `sync` is a post-implementation reconciliation step.
|
|
@@ -101,14 +101,16 @@ Phases in brackets are optional. `uiux` applies to UI-heavy features. `sync` is
|
|
|
101
101
|
| Proposal | `0-proposal/` | `proposal.md` |
|
|
102
102
|
| UI/UX | `1-ui/` | `design-system.md`, `mockups.md`, `components.md`, `flows.md` |
|
|
103
103
|
| Design | `2-design/` | `spec.md`, `contracts.cs`, `decisions.md` |
|
|
104
|
-
|
|
|
105
|
-
|
|
|
104
|
+
| Plan | `3-plan/` | `plan.md` |
|
|
105
|
+
| Tasks | `4-tasks/` | `tasks.md` |
|
|
106
|
+
| Implement | `5-implement/` | `recap.md` |
|
|
106
107
|
|
|
107
108
|
|
|
108
109
|
### Approval gates
|
|
109
110
|
|
|
110
|
-
- **Design gate** — Spec must be approved before moving to
|
|
111
|
-
- **
|
|
111
|
+
- **Design gate** — Spec must be approved before moving to Plan.
|
|
112
|
+
- **Plan gate** — Plan must be approved before moving to Tasks.
|
|
113
|
+
- **Tasks gate** — Task list must be approved before implementation starts.
|
|
112
114
|
|
|
113
115
|
Check gate status:
|
|
114
116
|
|
|
@@ -362,4 +364,4 @@ Code generated by morph-spec (contracts, templates, implementation output) belon
|
|
|
362
364
|
|
|
363
365
|
---
|
|
364
366
|
|
|
365
|
-
*morph-spec v4.
|
|
367
|
+
*morph-spec v4.14.0 by [Polymorphism Tech](https://polymorphism.tech)*
|
package/claude-plugin.json
CHANGED
package/docs/CHEATSHEET.md
CHANGED
|
@@ -17,7 +17,7 @@ morph-spec --version
|
|
|
17
17
|
## Phase workflow
|
|
18
18
|
|
|
19
19
|
```
|
|
20
|
-
proposal →
|
|
20
|
+
proposal → [uiux] → design → plan → tasks → implement → [sync]
|
|
21
21
|
```
|
|
22
22
|
|
|
23
23
|
Phases in brackets are optional.
|
|
@@ -25,13 +25,12 @@ Phases in brackets are optional.
|
|
|
25
25
|
| Phase | Directory | Output files | Gate |
|
|
26
26
|
|-------|-----------|--------------|------|
|
|
27
27
|
| proposal | `0-proposal/` | `proposal.md` | ✅ Approval |
|
|
28
|
-
| setup | *(no output)* | context loaded | — |
|
|
29
28
|
| uiux *(optional)* | `1-ui/` | `design-system.md`, `mockups.md`, `components.md`, `flows.md` | ✅ Approval |
|
|
30
29
|
| design | `2-design/` | `spec.md`, `contracts.cs`, `decisions.md` | ✅ Approval |
|
|
31
|
-
|
|
|
32
|
-
| tasks | `
|
|
33
|
-
| implement | `
|
|
34
|
-
| sync *(optional)* |
|
|
30
|
+
| plan | `3-plan/` | `plan.md` | ✅ Approval |
|
|
31
|
+
| tasks | `4-tasks/` | `tasks.md` | ✅ Approval |
|
|
32
|
+
| implement | `5-implement/` | code + `recap.md` | — |
|
|
33
|
+
| sync *(optional)* | — | standards updated | — |
|
|
35
34
|
|
|
36
35
|
---
|
|
37
36
|
|
|
@@ -197,4 +196,4 @@ These files are never edited directly. Use CLI commands or `morph-spec update` i
|
|
|
197
196
|
|
|
198
197
|
---
|
|
199
198
|
|
|
200
|
-
*morph-spec v4.
|
|
199
|
+
*morph-spec v4.14.0 by Polymorphism Tech*
|
package/docs/QUICKSTART.md
CHANGED