/mvv Command

Generates or updates Mission, Vision, and Values (MVV) statements for a repository by performing ontological analysis and synthesizing identity artifacts.

Usage

/mvv [options] [path]

Arguments

Argument	Description	Default
path	Target repository path	Current directory (.)

Options

Option	Description
--new	Generate new MVV (fails if section exists)
--update	Update existing MVV section
--dry-run	Preview output without modifying files
--force	Overwrite existing MVV without confirmation
--output <file>	Write to custom file instead of CLAUDE.md
--format <fmt>	Output format: markdown (default), json, yaml

Workflow

┌────────────────────────────────────────────────────────────────────────┐
│  /mvv COMMAND WORKFLOW                                                 │
├────────────────────────────────────────────────────────────────────────┤
│                                                                        │
│  1. DISCOVERY                                                          │
│     └─ Scan repository structure, README, existing docs               │
│     └─ Identify technology stack, domain, patterns                    │
│                                                                        │
│  2. ONTOLOGICAL ANALYSIS (skill: ontological-analysis)                │
│     └─ Extract semantic entities from codebase                        │
│     └─ Identify core concepts, relationships, domain language         │
│     └─ Build conceptual model of repository purpose                   │
│                                                                        │
│  3. MVV SYNTHESIS (skill: mvv-synthesis)                              │
│     └─ Derive Mission from repository's primary function              │
│     └─ Derive Vision from evolutionary trajectory                     │
│     └─ Derive Values from code patterns and conventions               │
│                                                                        │
│  4. OUTPUT                                                             │
│     └─ Format MVV section for CLAUDE.md                               │
│     └─ Insert/update in target file                                   │
│     └─ Report changes made                                            │
│                                                                        │
└────────────────────────────────────────────────────────────────────────┘

Examples

Generate MVV for current repository

/mvv

Generate MVV for specific path

/mvv /path/to/my-project

Preview without changes (dry-run)

/mvv --dry-run

Update existing MVV section

/mvv --update

Force overwrite without confirmation

/mvv --force

Output to custom file

/mvv --output ./docs/IDENTITY.md

Export as JSON

/mvv --format json --output ./mvv.json

Output

CLAUDE.md Section Format

The command inserts/updates this section in the target CLAUDE.md:

## Mission, Vision, Values

### Mission
[One-sentence statement of repository's core purpose]

### Vision
[Future state the repository enables or aims toward]

### Values
- **[Value 1]**: [Brief description]
- **[Value 2]**: [Brief description]
- **[Value 3]**: [Brief description]

---
*MVV generated by multi-agent-os | {timestamp}*

JSON Format (--format json)

{
  "mission": "...",
  "vision": "...",
  "values": [
    { "name": "...", "description": "..." }
  ],
  "metadata": {
    "generated_at": "2026-01-08T...",
    "repository": "...",
    "version": "1.0.0"
  }
}

Exit Codes

Code	Meaning
0	Success
1	Repository not found or not a git repo
2	MVV section exists (use --update or --force)
3	Analysis failed (insufficient codebase data)
4	Write permission denied

Related Skills

Skill	Purpose
ontological-analysis	Semantic extraction from codebase
mvv-synthesis	Identity statement generation

Notes

• The command requires read access to repository files for analysis
• For private repositories, ensure proper authentication
• Generated MVV should be reviewed and refined by humans
• The --dry-run option is recommended for first-time use