@uoyo/mvtt 2.0.0-beta.1 → 2.0.0-beta.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 (46) hide show
  1. package/README.md +194 -193
  2. package/dist/commands/migrate.d.ts +0 -2
  3. package/dist/commands/migrate.d.ts.map +1 -1
  4. package/dist/commands/migrate.js +0 -45
  5. package/dist/commands/migrate.js.map +1 -1
  6. package/package.json +1 -1
  7. package/registry.yaml +6 -0
  8. package/sources/sections/output-language-constraint.md +11 -11
  9. package/sources/sections/session-update.md +47 -47
  10. package/sources/skills/mvt-analyze/business.md +7 -7
  11. package/sources/skills/mvt-analyze-code/manifest.yaml +96 -96
  12. package/sources/skills/mvt-bug-detect/business.md +101 -0
  13. package/sources/skills/mvt-bug-detect/manifest.yaml +84 -0
  14. package/sources/skills/mvt-check-context/manifest.yaml +63 -63
  15. package/sources/skills/mvt-config/manifest.yaml +96 -96
  16. package/sources/skills/mvt-create-skill/business.md +81 -74
  17. package/sources/skills/mvt-create-skill/manifest.yaml +91 -95
  18. package/sources/skills/mvt-design/manifest.yaml +96 -96
  19. package/sources/skills/mvt-fix/business.md +37 -8
  20. package/sources/skills/mvt-fix/manifest.yaml +85 -72
  21. package/sources/skills/mvt-help/manifest.yaml +67 -67
  22. package/sources/skills/mvt-implement/manifest.yaml +80 -80
  23. package/sources/skills/mvt-init/manifest.yaml +101 -101
  24. package/sources/skills/mvt-manage-context/business.md +175 -175
  25. package/sources/skills/mvt-manage-context/manifest.yaml +123 -123
  26. package/sources/skills/mvt-plan-dev/manifest.yaml +91 -91
  27. package/sources/skills/mvt-quick-dev/manifest.yaml +69 -69
  28. package/sources/skills/mvt-refactor/manifest.yaml +86 -86
  29. package/sources/skills/mvt-resume/manifest.yaml +71 -71
  30. package/sources/skills/mvt-review/manifest.yaml +87 -87
  31. package/sources/skills/mvt-status/manifest.yaml +66 -66
  32. package/sources/skills/mvt-sync-context/business.md +150 -150
  33. package/sources/skills/mvt-sync-context/manifest.yaml +96 -96
  34. package/sources/skills/mvt-template/manifest.yaml +63 -63
  35. package/sources/skills/mvt-test/manifest.yaml +102 -102
  36. package/sources/skills/mvt-update-plan/business.md +72 -72
  37. package/sources/skills/mvt-update-plan/manifest.yaml +132 -132
  38. package/sources/templates/analyze-output/body.md +15 -15
  39. package/sources/templates/design-output/body.md +17 -17
  40. package/sources/templates/implement-output/body.md +11 -11
  41. package/sources/templates/review-output/body.md +11 -11
  42. package/sources/templates/test-output/body.md +7 -7
  43. package/dist/fs/protection.d.ts +0 -15
  44. package/dist/fs/protection.d.ts.map +0 -1
  45. package/dist/fs/protection.js +0 -16
  46. package/dist/fs/protection.js.map +0 -1
@@ -1,96 +1,96 @@
1
- name: mvt-sync-context
2
- output: .claude/skills/mvt-sync-context/SKILL.md
3
-
4
- frontmatter:
5
- name: mvt-sync-context
6
- description: "Aggregate completed change artifacts (analysis/design/implementation) and merge new domain knowledge into project-context.md and project-context.yaml. This skill should be used after one or more changes are completed to keep long-term project knowledge in sync with delivered work."
7
-
8
- sections:
9
- - type: inline
10
- content: |
11
- # MVT Sync Context
12
-
13
- ## Purpose
14
-
15
- Keep `project-context.md` (semantic) and `project-context.yaml` (structural index) in sync with completed work. This is an artifact-driven, incremental synchronization: it reads workspace artifacts of completed changes, classifies new domain knowledge, and merges it into the long-term context. It does NOT scan code for new content; an optional read-only code verification step can validate that artifact-claimed entities exist.
16
-
17
- - type: shared
18
- source: sections/role-header.md
19
- params:
20
- role: Conductor
21
- role_desc: "a Workflow Coordinator"
22
- decision_rules:
23
- - rule: "Completed changes found -> List for user confirmation, then aggregate"
24
- - rule: "No completed changes since last sync -> Report nothing to do"
25
- - rule: "Conflicts with existing project-context.md -> Render conflict table, require user resolution"
26
- - rule: "User opts in to code verification -> Run read-only scan; flag artifact entries that cannot be located"
27
- - rule: "Code-only entities discovered (in code, not in artifacts) -> Do NOT write; recommend /mvt-analyze-code"
28
- - rule: "Artifact references modules/source_paths absent from project-context.yaml -> Propose yaml additions for user confirmation"
29
- boundaries:
30
- - scope: "regenerate project-context.md from full code scan"
31
- skill: "/mvt-analyze-code"
32
- - scope: "archive completed change artifacts"
33
- skill: "/mvt-cleanup"
34
- - scope: "manage shared / per-skill knowledge files"
35
- skill: "/mvt-manage-context"
36
-
37
- - type: inline
38
- content: |
39
- ### When to Use
40
- - After one or more changes are marked `completed` and you want to fold their knowledge into long-term context
41
- - BEFORE running `/mvt-cleanup` (sync first, archive after)
42
- - When `project-context.md` looks behind delivered work but you do not want to pay a full `/mvt-analyze-code` regeneration
43
-
44
- ### When NOT to Use
45
- - For deletions, renames, or module deprecations -> use `/mvt-analyze-code` (full ground-truth rebuild)
46
- - To pick up code changes never recorded as MVTT changes -> use `/mvt-analyze-code`
47
- - To clean / archive workspace -> use `/mvt-cleanup`
48
-
49
- - type: shared
50
- source: sections/activation-load-context.md
51
- params:
52
- extended_context:
53
- - ".ai-agents/workspace/artifacts/{change-id}/ -- Source artifacts for completed changes"
54
- - ".ai-agents/knowledge/project/_generated/project-context.md -- Current semantic context (merge target)"
55
- - ".ai-agents/workspace/project-context.yaml -- Current structural index (merge target)"
56
-
57
- - type: shared
58
- source: sections/activation-load-config.md
59
-
60
- - type: shared
61
- source: sections/output-language-constraint.md
62
-
63
- - type: shared
64
- source: sections/activation-preflight.md
65
- params:
66
- checks:
67
- - order: "1"
68
- field: "session.initialized_at"
69
- level: "BLOCK"
70
- message: "Session not initialized. Run `/mvt-init` first."
71
- - order: "2"
72
- field: ".ai-agents/knowledge/project/_generated/project-context.md exists"
73
- level: "BLOCK"
74
- message: "project-context.md not found. Run `/mvt-analyze-code` to create the initial document; this skill only handles incremental updates."
75
-
76
- - type: file
77
- source: ./business.md
78
-
79
- - type: shared
80
- source: sections/session-update.md
81
-
82
- - type: shared
83
- source: sections/footer-next-steps.md
84
- params:
85
- current_skill: mvt-sync-context
86
- conditional_suggestions:
87
- conditions:
88
- - condition: "merge applied successfully"
89
- primary: "mvt-cleanup"
90
- primary_desc: "Archive aggregated change artifacts now that knowledge is sync'd"
91
- - condition: "code verification flagged code-only entities"
92
- primary: "mvt-analyze-code"
93
- primary_desc: "Regenerate project-context.md from full code scan"
94
- - condition: "default"
95
- primary: "mvt-check-context"
96
- primary_desc: "Audit token cost and overall context health"
1
+ name: mvt-sync-context
2
+ output: .claude/skills/mvt-sync-context/SKILL.md
3
+
4
+ frontmatter:
5
+ name: mvt-sync-context
6
+ description: "Aggregate completed change artifacts (analysis/design/implementation) and merge new domain knowledge into project-context.md and project-context.yaml. This skill should be used after one or more changes are completed to keep long-term project knowledge in sync with delivered work."
7
+
8
+ sections:
9
+ - type: inline
10
+ content: |
11
+ # MVT Sync Context
12
+
13
+ ## Purpose
14
+
15
+ Keep `project-context.md` (semantic) and `project-context.yaml` (structural index) in sync with completed work. This is an artifact-driven, incremental synchronization: it reads workspace artifacts of completed changes, classifies new domain knowledge, and merges it into the long-term context. It does NOT scan code for new content; an optional read-only code verification step can validate that artifact-claimed entities exist.
16
+
17
+ - type: shared
18
+ source: sections/role-header.md
19
+ params:
20
+ role: Conductor
21
+ role_desc: "a Workflow Coordinator"
22
+ decision_rules:
23
+ - rule: "Completed changes found -> List for user confirmation, then aggregate"
24
+ - rule: "No completed changes since last sync -> Report nothing to do"
25
+ - rule: "Conflicts with existing project-context.md -> Render conflict table, require user resolution"
26
+ - rule: "User opts in to code verification -> Run read-only scan; flag artifact entries that cannot be located"
27
+ - rule: "Code-only entities discovered (in code, not in artifacts) -> Do NOT write; recommend /mvt-analyze-code"
28
+ - rule: "Artifact references modules/source_paths absent from project-context.yaml -> Propose yaml additions for user confirmation"
29
+ boundaries:
30
+ - scope: "regenerate project-context.md from full code scan"
31
+ skill: "/mvt-analyze-code"
32
+ - scope: "archive completed change artifacts"
33
+ skill: "/mvt-cleanup"
34
+ - scope: "manage shared / per-skill knowledge files"
35
+ skill: "/mvt-manage-context"
36
+
37
+ - type: inline
38
+ content: |
39
+ ### When to Use
40
+ - After one or more changes are marked `completed` and you want to fold their knowledge into long-term context
41
+ - BEFORE running `/mvt-cleanup` (sync first, archive after)
42
+ - When `project-context.md` looks behind delivered work but you do not want to pay a full `/mvt-analyze-code` regeneration
43
+
44
+ ### When NOT to Use
45
+ - For deletions, renames, or module deprecations -> use `/mvt-analyze-code` (full ground-truth rebuild)
46
+ - To pick up code changes never recorded as MVTT changes -> use `/mvt-analyze-code`
47
+ - To clean / archive workspace -> use `/mvt-cleanup`
48
+
49
+ - type: shared
50
+ source: sections/activation-load-context.md
51
+ params:
52
+ extended_context:
53
+ - ".ai-agents/workspace/artifacts/{change-id}/ -- Source artifacts for completed changes"
54
+ - ".ai-agents/knowledge/project/_generated/project-context.md -- Current semantic context (merge target)"
55
+ - ".ai-agents/workspace/project-context.yaml -- Current structural index (merge target)"
56
+
57
+ - type: shared
58
+ source: sections/activation-load-config.md
59
+
60
+ - type: shared
61
+ source: sections/output-language-constraint.md
62
+
63
+ - type: shared
64
+ source: sections/activation-preflight.md
65
+ params:
66
+ checks:
67
+ - order: "1"
68
+ field: "session.initialized_at"
69
+ level: "BLOCK"
70
+ message: "Session not initialized. Run `/mvt-init` first."
71
+ - order: "2"
72
+ field: ".ai-agents/knowledge/project/_generated/project-context.md exists"
73
+ level: "BLOCK"
74
+ message: "project-context.md not found. Run `/mvt-analyze-code` to create the initial document; this skill only handles incremental updates."
75
+
76
+ - type: file
77
+ source: ./business.md
78
+
79
+ - type: shared
80
+ source: sections/session-update.md
81
+
82
+ - type: shared
83
+ source: sections/footer-next-steps.md
84
+ params:
85
+ current_skill: mvt-sync-context
86
+ conditional_suggestions:
87
+ conditions:
88
+ - condition: "merge applied successfully"
89
+ primary: "mvt-cleanup"
90
+ primary_desc: "Archive aggregated change artifacts now that knowledge is sync'd"
91
+ - condition: "code verification flagged code-only entities"
92
+ primary: "mvt-analyze-code"
93
+ primary_desc: "Regenerate project-context.md from full code scan"
94
+ - condition: "default"
95
+ primary: "mvt-check-context"
96
+ primary_desc: "Audit token cost and overall context health"
@@ -1,63 +1,63 @@
1
- name: mvt-template
2
- output: .claude/skills/mvt-template/SKILL.md
3
-
4
- frontmatter:
5
- name: mvt-template
6
- description: "View, customize, and manage output templates for MVTT skills. This skill should be used when user wants to inspect available templates, create custom template versions, reset customizations, or export templates."
7
-
8
- sections:
9
- - type: inline
10
- content: |
11
- # MVT Custom Template
12
-
13
- ## Purpose
14
-
15
- View, customize, and manage MVTT output templates. Inspect default templates, create custom versions that override defaults, reset customizations, and export templates.
16
-
17
- - type: shared
18
- source: sections/role-header.md
19
- params:
20
- role: Conductor
21
- role_desc: "a Workflow Coordinator"
22
- decision_rules:
23
- - rule: "No arguments -> Show template list with status"
24
- - rule: "User selects \"view\" -> Display full template content (custom version if exists)"
25
- - rule: "User selects \"customize\" -> Guide through modification process"
26
- - rule: "User selects \"reset\" -> Delete custom version, restore default"
27
- - rule: "User selects \"export\" -> Output template to specified location"
28
- - rule: "Custom template must preserve frontmatter format"
29
- boundaries:
30
- - scope: "modify default templates in `_templates/` root"
31
- skill: "(Only create/modify in `custom/`)"
32
- - scope: "modify skill logic"
33
- skill: "(Only change output formatting)"
34
-
35
- - type: shared
36
- source: sections/activation-load-context.md
37
- params:
38
- extended_context:
39
- - "Scan `.ai-agents/skills/_templates/custom/` for existing customizations"
40
-
41
- - type: shared
42
- source: sections/activation-load-config.md
43
-
44
- - type: shared
45
- source: sections/output-language-constraint.md
46
-
47
- - type: inline
48
- content: |
49
- ### Step 3: Pre-flight Checks
50
- - No blocking checks required.
51
-
52
- - type: file
53
- source: ./business.md
54
-
55
- - type: shared
56
- source: sections/session-update.md
57
- params:
58
- read_only: true
59
-
60
- - type: shared
61
- source: sections/footer-next-steps.md
62
- params:
63
- current_skill: mvt-template
1
+ name: mvt-template
2
+ output: .claude/skills/mvt-template/SKILL.md
3
+
4
+ frontmatter:
5
+ name: mvt-template
6
+ description: "View, customize, and manage output templates for MVTT skills. This skill should be used when user wants to inspect available templates, create custom template versions, reset customizations, or export templates."
7
+
8
+ sections:
9
+ - type: inline
10
+ content: |
11
+ # MVT Custom Template
12
+
13
+ ## Purpose
14
+
15
+ View, customize, and manage MVTT output templates. Inspect default templates, create custom versions that override defaults, reset customizations, and export templates.
16
+
17
+ - type: shared
18
+ source: sections/role-header.md
19
+ params:
20
+ role: Conductor
21
+ role_desc: "a Workflow Coordinator"
22
+ decision_rules:
23
+ - rule: "No arguments -> Show template list with status"
24
+ - rule: "User selects \"view\" -> Display full template content (custom version if exists)"
25
+ - rule: "User selects \"customize\" -> Guide through modification process"
26
+ - rule: "User selects \"reset\" -> Delete custom version, restore default"
27
+ - rule: "User selects \"export\" -> Output template to specified location"
28
+ - rule: "Custom template must preserve frontmatter format"
29
+ boundaries:
30
+ - scope: "modify default templates in `_templates/` root"
31
+ skill: "(Only create/modify in `custom/`)"
32
+ - scope: "modify skill logic"
33
+ skill: "(Only change output formatting)"
34
+
35
+ - type: shared
36
+ source: sections/activation-load-context.md
37
+ params:
38
+ extended_context:
39
+ - "Scan `.ai-agents/skills/_templates/custom/` for existing customizations"
40
+
41
+ - type: shared
42
+ source: sections/activation-load-config.md
43
+
44
+ - type: shared
45
+ source: sections/output-language-constraint.md
46
+
47
+ - type: inline
48
+ content: |
49
+ ### Step 3: Pre-flight Checks
50
+ - No blocking checks required.
51
+
52
+ - type: file
53
+ source: ./business.md
54
+
55
+ - type: shared
56
+ source: sections/session-update.md
57
+ params:
58
+ read_only: true
59
+
60
+ - type: shared
61
+ source: sections/footer-next-steps.md
62
+ params:
63
+ current_skill: mvt-template
@@ -1,102 +1,102 @@
1
- name: mvt-test
2
- output: .claude/skills/mvt-test/SKILL.md
3
-
4
- frontmatter:
5
- name: mvt-test
6
- description: "Generate and design tests to validate implementations. This skill should be used when user wants to write tests, validate code, generate test cases, or analyze test coverage."
7
-
8
- sections:
9
- - type: inline
10
- content: |
11
- # MVT Test
12
-
13
- ## Purpose
14
-
15
- Design and write tests to validate implementations against requirements and business rules. Ensure code works correctly with comprehensive coverage of happy paths, edge cases, and error scenarios.
16
-
17
- - type: shared
18
- source: sections/role-header.md
19
- params:
20
- role: Tester
21
- role_desc: "a Quality Assurance Specialist"
22
- decision_rules:
23
- - rule: "Happy path works -> Add edge case and boundary tests"
24
- - rule: "Bug found during testing -> Document with reproduction steps, suggest `/mvt-fix`"
25
- - rule: "Coverage gap found -> Add tests focused on that area"
26
- - rule: "Flaky test detected -> Flag for investigation"
27
- - rule: "Test requires external service -> Use mocks/stubs, document the dependency"
28
- - rule: "Security constraints in requirements -> Add security-focused test cases"
29
- - rule: "Existing tests conflict with new implementation -> Flag the conflict"
30
- boundaries:
31
- - scope: "modify the code being tested"
32
- skill: "/mvt-fix"
33
- - scope: "make architecture decisions"
34
- skill: "(Test against existing design)"
35
- - scope: "skip edge cases or negative tests"
36
- skill: "(Never)"
37
-
38
- - type: inline
39
- content: |
40
- ## Variants
41
-
42
- | Variant | Description |
43
- |---------|-------------|
44
- | `/mvt-test` | Generate tests for recent implementation |
45
- | `/mvt-test {feature}` | Generate tests for specific feature |
46
- | `/mvt-test --coverage` | Generate tests with coverage analysis |
47
-
48
- - type: shared
49
- source: sections/activation-load-context.md
50
- params:
51
- extended_context:
52
- - "Implementation files to be tested"
53
-
54
- - type: shared
55
- source: sections/activation-load-config.md
56
-
57
- - type: shared
58
- source: sections/output-language-constraint.md
59
-
60
- - type: shared
61
- source: sections/activation-preflight.md
62
- params:
63
- checks:
64
- - order: "1"
65
- field: "session.initialized_at"
66
- level: "WARN"
67
- message: "Session not initialized. Run `/mvt-init` first."
68
- - order: "2"
69
- field: "no implementation files"
70
- level: "WARN"
71
- message: "No implementation found. Run `/mvt-implement` first."
72
-
73
- - type: inline
74
- content: |
75
- ## Test Case Types
76
-
77
- | Type | Description | Priority |
78
- |------|-------------|----------|
79
- | Happy Path | Normal successful flow | High |
80
- | Edge Case | Boundary conditions | High |
81
- | Negative | Invalid inputs, errors | High |
82
- | Security | Authentication, injection | Medium |
83
- | Performance | Load, stress | Low |
84
-
85
- - type: file
86
- source: ./business.md
87
-
88
- - type: inline
89
- content: |
90
- ## Artifact Structure
91
- Read the document structure template from: `.ai-agents/skills/_templates/test-output.md`
92
- If a custom version exists at `.ai-agents/skills/_templates/custom/test-output.md`, use the custom version instead.
93
- The template defines section headings only. Generate content for each section based on test design results.
94
- Write the artifact to: `.ai-agents/workspace/artifacts/{change-id}/tests/test-design.md`
95
-
96
- - type: shared
97
- source: sections/session-update.md
98
-
99
- - type: shared
100
- source: sections/footer-next-steps.md
101
- params:
102
- current_skill: mvt-test
1
+ name: mvt-test
2
+ output: .claude/skills/mvt-test/SKILL.md
3
+
4
+ frontmatter:
5
+ name: mvt-test
6
+ description: "Generate and design tests to validate implementations. This skill should be used when user wants to write tests, validate code, generate test cases, or analyze test coverage."
7
+
8
+ sections:
9
+ - type: inline
10
+ content: |
11
+ # MVT Test
12
+
13
+ ## Purpose
14
+
15
+ Design and write tests to validate implementations against requirements and business rules. Ensure code works correctly with comprehensive coverage of happy paths, edge cases, and error scenarios.
16
+
17
+ - type: shared
18
+ source: sections/role-header.md
19
+ params:
20
+ role: Tester
21
+ role_desc: "a Quality Assurance Specialist"
22
+ decision_rules:
23
+ - rule: "Happy path works -> Add edge case and boundary tests"
24
+ - rule: "Bug found during testing -> Document with reproduction steps, suggest `/mvt-fix`"
25
+ - rule: "Coverage gap found -> Add tests focused on that area"
26
+ - rule: "Flaky test detected -> Flag for investigation"
27
+ - rule: "Test requires external service -> Use mocks/stubs, document the dependency"
28
+ - rule: "Security constraints in requirements -> Add security-focused test cases"
29
+ - rule: "Existing tests conflict with new implementation -> Flag the conflict"
30
+ boundaries:
31
+ - scope: "modify the code being tested"
32
+ skill: "/mvt-fix"
33
+ - scope: "make architecture decisions"
34
+ skill: "(Test against existing design)"
35
+ - scope: "skip edge cases or negative tests"
36
+ skill: "(Never)"
37
+
38
+ - type: inline
39
+ content: |
40
+ ## Variants
41
+
42
+ | Variant | Description |
43
+ |---------|-------------|
44
+ | `/mvt-test` | Generate tests for recent implementation |
45
+ | `/mvt-test {feature}` | Generate tests for specific feature |
46
+ | `/mvt-test --coverage` | Generate tests with coverage analysis |
47
+
48
+ - type: shared
49
+ source: sections/activation-load-context.md
50
+ params:
51
+ extended_context:
52
+ - "Implementation files to be tested"
53
+
54
+ - type: shared
55
+ source: sections/activation-load-config.md
56
+
57
+ - type: shared
58
+ source: sections/output-language-constraint.md
59
+
60
+ - type: shared
61
+ source: sections/activation-preflight.md
62
+ params:
63
+ checks:
64
+ - order: "1"
65
+ field: "session.initialized_at"
66
+ level: "WARN"
67
+ message: "Session not initialized. Run `/mvt-init` first."
68
+ - order: "2"
69
+ field: "no implementation files"
70
+ level: "WARN"
71
+ message: "No implementation found. Run `/mvt-implement` first."
72
+
73
+ - type: inline
74
+ content: |
75
+ ## Test Case Types
76
+
77
+ | Type | Description | Priority |
78
+ |------|-------------|----------|
79
+ | Happy Path | Normal successful flow | High |
80
+ | Edge Case | Boundary conditions | High |
81
+ | Negative | Invalid inputs, errors | High |
82
+ | Security | Authentication, injection | Medium |
83
+ | Performance | Load, stress | Low |
84
+
85
+ - type: file
86
+ source: ./business.md
87
+
88
+ - type: inline
89
+ content: |
90
+ ## Artifact Structure
91
+ Read the document structure template from: `.ai-agents/skills/_templates/test-output.md`
92
+ If a custom version exists at `.ai-agents/skills/_templates/custom/test-output.md`, use the custom version instead.
93
+ The template defines section headings only. Generate content for each section based on test design results.
94
+ Write the artifact to: `.ai-agents/workspace/artifacts/{change-id}/tests/test-design.md`
95
+
96
+ - type: shared
97
+ source: sections/session-update.md
98
+
99
+ - type: shared
100
+ source: sections/footer-next-steps.md
101
+ params:
102
+ current_skill: mvt-test