@uoyo/mvtt 2.0.0-beta.0 → 2.0.0-beta.1

package/sources/templates/analyze-output/body.md

@@ -1,38 +1,15 @@
-## Requirements Analysis: {Feature Name}
+# Requirements Analysis: {Feature Name}
 
-### Feature Overview
-{1-2 paragraph summary of the feature}
+## Feature Overview
 
-### Actors
-| Actor | Type | Description |
-|-------|------|-------------|
-| {actor} | {primary/secondary/system} | {description} |
+## Actors
 
-### Requirements
-| ID | Requirement | Priority | Category |
-|----|-------------|----------|----------|
-| REQ-001 | {requirement} | {P0/P1/P2} | {functional/non-functional} |
+## Requirements
 
-### Domain Concepts
-| Concept | Type | Description |
-|---------|------|-------------|
-| {concept} | {Entity/Value Object/Service} | {description} |
+## Domain Concepts
 
-### Business Rules
-| ID | Rule | Condition | Action |
-|----|------|-----------|--------|
-| BR-001 | {rule_name} | {when} | {then} |
+## Business Rules
 
-### Ambiguities & Questions
-| # | Question | Impact | Blocking? |
-|---|----------|--------|-----------|
-| Q1 | {question} | {what_it_affects} | {Yes/No} |
+## Ambiguities & Questions
 
-### Change Tracking
-- **Change ID**: {YYYYMMDD-slug}
-- **Artifact**: `.ai-agents/workspace/artifacts/{change-id}/analysis.md`
-
----
-**Suggested Next Steps**:
-- `/mvt-design` to create architecture based on this analysis
-- Address blocking questions before proceeding
+## Change Tracking

package/sources/templates/analyze-output/manifest.yaml

@@ -1,11 +1,11 @@
-name: analyze-output
-output: .ai-agents/skills/_templates/analyze-output.md
-
-frontmatter:
-  id: analyze-output
-  version: "1.0"
-  skill: mvt-analyze
-
-sections:
-  - type: file
-    source: ./body.md
+name: analyze-output
+output: .ai-agents/skills/_templates/analyze-output.md
+
+frontmatter:
+  id: analyze-output
+  version: "1.0"
+  skill: mvt-analyze
+
+sections:
+  - type: file
+    source: ./body.md

package/sources/templates/design-output/body.md

@@ -1,50 +1,17 @@
-## Architecture Design: {Feature Name}
-
-### Overview
-{1-2 paragraph summary of the architecture}
-
-### Architecture Decision Records
-| ID | Decision | Rationale | Alternatives Considered |
-|----|----------|-----------|------------------------|
-| ADR-001 | {decision} | {rationale} | {alternatives} |
-
-### Module Design
-| Module | Responsibility | Layer | Dependencies |
-|--------|---------------|-------|--------------|
-| {module} | {responsibility} | {Domain/Application/Infrastructure/Interface} | {deps} |
-
-### Key Interfaces
-```{language}
-// {InterfaceName}
-{interface_definition}
-```
-
-### Data Flow
-```mermaid
-sequenceDiagram
-    participant C as Client
-    participant S as Service
-    participant R as Repository
-    C->>S: request
-    S->>R: query
-    R-->>S: result
-    S-->>C: response
-```
-
-### File Structure
-| File | Action | Description |
-|------|--------|-------------|
-| `{path}` | {Create/Modify} | {description} |
-
-### Implementation Guidelines
-- {guideline_1}
-- {guideline_2}
-
-### Change Tracking
-- **Change ID**: {change-id}
-- **Artifact**: `.ai-agents/workspace/artifacts/{change-id}/design.md`
-
----
-**Suggested Next Steps**:
-- `/mvt-implement` to start implementing this design
-- Refine specific modules if needed
+# Architecture Design: {Feature Name}
+
+## Overview
+
+## Architecture Decision Records
+
+## Module Design
+
+## Key Interfaces
+
+## Data Flow
+
+## File Structure
+
+## Implementation Guidelines
+
+## Change Tracking

package/sources/templates/design-output/manifest.yaml

@@ -1,11 +1,11 @@
-name: design-output
-output: .ai-agents/skills/_templates/design-output.md
-
-frontmatter:
-  id: design-output
-  version: "1.0"
-  skill: mvt-design
-
-sections:
-  - type: file
-    source: ./body.md
+name: design-output
+output: .ai-agents/skills/_templates/design-output.md
+
+frontmatter:
+  id: design-output
+  version: "1.0"
+  skill: mvt-design
+
+sections:
+  - type: file
+    source: ./body.md

package/sources/templates/implement-output/body.md

@@ -1,32 +1,11 @@
-## Implementation: {Feature Name}
+# Implementation: {Feature Name}
 
-### Implementation Plan
-| # | Step | Files | Status |
-|---|------|-------|--------|
-| 1 | {step} | `{files}` | {pending/done} |
+## Implementation Plan
 
-### Changes
-| File | Action | Description |
-|------|--------|-------------|
-| `{path}` | {Create/Modify/Delete} | {description} |
+## Changes
 
-### Implementation Code
+## Implementation Details
 
-#### {file_path}
-```{language}
-{code}
-```
+## Design Compliance
 
-### Design Compliance
-| Design Requirement | Status | Notes |
-|-------------------|--------|-------|
-| {requirement} | {Compliant/Deviation} | {notes} |
-
-### Change Tracking
-- **Change ID**: {change-id}
-- **Artifact**: `.ai-agents/workspace/artifacts/{change-id}/implementation.md`
-
----
-**Suggested Next Steps**:
-- `/mvt-review` to review the implementation
-- `/mvt-test` to write tests
+## Change Tracking

package/sources/templates/implement-output/manifest.yaml

@@ -1,11 +1,11 @@
-name: implement-output
-output: .ai-agents/skills/_templates/implement-output.md
-
-frontmatter:
-  id: implement-output
-  version: "1.0"
-  skill: mvt-implement
-
-sections:
-  - type: file
-    source: ./body.md
+name: implement-output
+output: .ai-agents/skills/_templates/implement-output.md
+
+frontmatter:
+  id: implement-output
+  version: "1.0"
+  skill: mvt-implement
+
+sections:
+  - type: file
+    source: ./body.md

package/sources/templates/project-context/body.md

@@ -0,0 +1,13 @@
+# Project: {project name}
+
+## Overview
+
+## Core Terms
+
+## Module Structure
+
+## Layer Structure
+
+## Key Business Rules
+
+## API Overview

package/sources/templates/project-context/manifest.yaml

@@ -0,0 +1,12 @@
+name: project-context
+output: .ai-agents/skills/_templates/project-context.md
+
+frontmatter:
+  id: project-context
+  version: "1.0"
+  skill: mvt-analyze-code
+  description: "Project semantic document template -- defines section structure for project-context.md"
+
+sections:
+  - type: file
+    source: ./body.md

package/sources/templates/review-output/body.md

@@ -1,45 +1,11 @@
-## Code Review Report
+# Code Review Report
 
-### Summary
-- **Overall Assessment**: {Good / Needs Work / Critical Issues}
-- **Files Reviewed**: {count}
-- **Critical Issues**: {count}
-- **Warnings**: {count}
-- **Suggestions**: {count}
+## Summary
 
-### Critical Issues
+## Critical Issues
 
-#### C{N}: {Issue Title}
-**File**: `{file}:{line}`
-**Issue**: {description}
-**Suggestion**: {fix_suggestion}
+## Warnings
 
-```{language}
-// Current code
-{problematic_code}
+## Suggestions
 
-// Suggested fix
-{suggested_code}
-```
-
-### Warnings
-
-#### W{N}: {Issue Title}
-**File**: `{file}:{line}`
-**Issue**: {description}
-**Suggestion**: {fix_suggestion}
-
-### Suggestions
-
-#### S{N}: {Suggestion Title}
-**File**: `{file}`
-**Suggestion**: {improvement}
-
-### Highlights
-- {positive_finding_1}
-- {positive_finding_2}
-
----
-**Suggested Next Steps**:
-- `/mvt-fix` to address critical issues
-- `/mvt-test` to add missing tests
+## Highlights

package/sources/templates/review-output/manifest.yaml

@@ -1,11 +1,11 @@
-name: review-output
-output: .ai-agents/skills/_templates/review-output.md
-
-frontmatter:
-  id: review-output
-  version: "1.0"
-  skill: mvt-review
-
-sections:
-  - type: file
-    source: ./body.md
+name: review-output
+output: .ai-agents/skills/_templates/review-output.md
+
+frontmatter:
+  id: review-output
+  version: "1.0"
+  skill: mvt-review
+
+sections:
+  - type: file
+    source: ./body.md

package/sources/templates/test-output/body.md

@@ -1,31 +1,7 @@
-## Test Design: {Feature Name}
+# Test Design: {Feature Name}
 
-### Test Cases
-| ID | Scenario | Input | Expected Output | Type |
-|----|----------|-------|-----------------|------|
-| T1 | {scenario} | {input} | {expected} | {Happy Path / Edge Case / Negative / Security} |
+## Test Cases
 
-### Test Code
+## Test Code
 
-#### {test_file}
-```{language}
-{test_code}
-```
-
-### Coverage Analysis
-| Requirement | Test Coverage | Status |
-|-------------|---------------|--------|
-| REQ-001 | T1, T2 | {Covered / Missing} |
-
-### Coverage by Type
-| Type | Count | Coverage |
-|------|-------|----------|
-| Happy Path | {n} | {pct}% |
-| Edge Case | {n} | {pct}% |
-| Negative | {n} | {pct}% |
-| Security | {n} | {pct}% |
-
----
-**Suggested Next Steps**:
-- Run tests
-- `/mvt-fix` if tests fail
+## Coverage Analysis

package/sources/templates/test-output/manifest.yaml

@@ -1,11 +1,11 @@
-name: test-output
-output: .ai-agents/skills/_templates/test-output.md
-
-frontmatter:
-  id: test-output
-  version: "1.0"
-  skill: mvt-test
-
-sections:
-  - type: file
-    source: ./body.md
+name: test-output
+output: .ai-agents/skills/_templates/test-output.md
+
+frontmatter:
+  id: test-output
+  version: "1.0"
+  skill: mvt-test
+
+sections:
+  - type: file
+    source: ./body.md

package/sources/knowledge/core/review-principles.md

@@ -1,51 +0,0 @@
-# Code Review Principles
-
-Actionable checklist for reviewing code quality. Use during `#review` and as reference during `#implement`.
-
-## Naming & Readability
-
-- [ ] Classes/functions named by **what they do**, not how they do it
-- [ ] No abbreviations unless universally understood (e.g., `id`, `url`, `http`)
-- [ ] Boolean variables/methods start with `is`, `has`, `can`, `should`
-- [ ] Collections named as plural nouns; single items as singular
-- [ ] No "Manager", "Helper", "Utils" god-classes — split by responsibility
-
-## Single Responsibility
-
-- [ ] Each class/module has **one reason to change**
-- [ ] Functions do **one thing** and are ≤ 30 lines (guideline, not hard rule)
-- [ ] If you need "and" to describe what a function does → split it
-
-## Dependency Direction
-
-- [ ] Business logic does NOT import framework/infrastructure code
-- [ ] Dependencies point **inward** (infrastructure → application → domain)
-- [ ] External services accessed through **interfaces/abstractions**
-- [ ] No circular dependencies between modules
-
-## Error Handling
-
-- [ ] Errors are handled at the **appropriate level** (not swallowed silently)
-- [ ] Fail fast: validate inputs at entry points
-- [ ] No empty catch blocks
-- [ ] Error messages include **context** (what failed, why, what to do)
-
-## Duplication & Abstraction
-
-- [ ] No copy-paste blocks — extract shared logic into functions
-- [ ] But: don't merge similar-looking code that changes for **different reasons**
-- [ ] Abstractions are justified by **current** requirements, not hypothetical ones
-- [ ] No dead code or commented-out blocks
-
-## State & Side Effects
-
-- [ ] Mutable state is **minimized** and localized
-- [ ] Functions clearly indicate whether they have side effects
-- [ ] No hidden global state mutations
-- [ ] Concurrent access to shared state is protected
-
-## Testing Indicators
-
-- [ ] Public API has clear contracts that are testable
-- [ ] Dependencies are injectable (not hard-coded `new`)
-- [ ] No logic in constructors that makes testing difficult

package/sources/knowledge/patterns/clean-architecture/manifest.yaml

@@ -1,66 +0,0 @@
-id: "clean-architecture"
-type: "pattern"
-name: "Clean Architecture"
-version: "1.0"
-description: "Robert C. Martin's Clean Architecture for testable, maintainable systems"
-
-token_estimate:
-  total: 800
-  breakdown:
-    - file: review-checklist.md
-      tokens: 800
-      load_priority: 1
-      summary: "Clean Architecture compliance checklist"
-
-loading_strategy:
-  level_1_manifest_only:
-    tokens: 150
-    use_case: "Check available Clean Architecture patterns"
-
-  level_2_full:
-    tokens: 800
-    use_case: "Complete Clean Architecture review guidance"
-
-loading:
-  priority: 10
-  auto_load: false
-
-files:
-  - path: "review-checklist.md"
-    description: "Checklist for reviewing code against Clean Architecture"
-    required: true
-    tokens: 800
-
-attributes:
-  terminology:
-    entity: "Entity"
-    use_case: "Use Case"
-    interface_adapter: "Interface Adapter"
-    framework: "Framework"
-    boundary: "Boundary"
-    presenter: "Presenter"
-    controller: "Controller"
-    gateway: "Gateway"
-    request_model: "Request Model"
-    response_model: "Response Model"
-    view_model: "View Model"
-
-  checklist:
-    - "Dependencies point inward"
-    - "Entities are pure business objects"
-    - "Use Cases contain application logic"
-    - "Interfaces defined by inner layer"
-    - "Frameworks are details"
-    - "Database is a detail"
-    - "UI is a detail"
-    - "Testable without external dependencies"
-
-scenarios:
-  - name: "Design application architecture"
-    files: ["overview.md"]
-
-  - name: "Code review"
-    files: ["review-checklist.md"]
-
-  - name: "Understand layer separation"
-    files: ["overview.md"]