# imisbahk/mstack architecture

> Architecture diagram of the GitHub repository imisbahk/mstack, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/imisbahk/mstack
- Repository: https://github.com/imisbahk/mstack

## Overview

mstack is a product-engineering method distributed through a CLI that initializes a repository, then plans and installs consistent AI-agent resources across detected coding environments. Its workflow also supports runtime inspection, validation, snapshots, capability packs, and task recipes. The graph combines documented user flows with source-indexed calls; several runtime and diagnostic internals were not sampled, so those relationships are limited to explicit documentation or indexed references.

Main entry points: [`packages/cli/src/program.ts`](https://github.com/imisbahk/mstack/blob/main/packages/cli/src/program.ts) (Command router), [`packages/cli/src/commands/ai.ts`](https://github.com/imisbahk/mstack/blob/main/packages/cli/src/commands/ai.ts) (AI setup), [`packages/ai-integrations/src/runtime`](https://github.com/imisbahk/mstack/tree/main/packages/ai-integrations/src/runtime) (Runtime resources), [`packages/cli/src/commands/init.ts`](https://github.com/imisbahk/mstack/blob/main/packages/cli/src/commands/init.ts) (Repository init)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI workflows"]
  node_program["Command router<br/>[program.ts]"]
  node_init["Repository init<br/>[init.ts]"]
  node_ai_setup["AI setup<br/>[ai.ts]"]
  node_catalog["Resource catalog<br/>[catalog.ts]"]
  node_packs["Capability packs<br/>[builtins.ts]"]
  node_tasks["Task recipes<br/>[tasks.ts]"]
end

subgraph group_integration["Runtime installation"]
  node_runtime_detection["Runtime detection<br/>[runtimes.ts]"]
  node_registry["Environment adapters<br/>[index.ts]"]
  node_planning["Install planning<br/>[planner.ts]"]
  node_validation_core["Spec validation<br/>[validation.ts]"]
  node_installer["Safe installer<br/>[installer.ts]"]
  node_reconciliation["State reconciliation<br/>[reconciliation.ts]"]
end

subgraph group_resources["Agent resources"]
  node_agents["Specialist agents<br/>[agents.ts]"]
  node_prompts["Prompt library<br/>[prompts.ts]"]
  node_skills["Skill library<br/>[skills.ts]"]
  node_runtime_catalog["Runtime resources"]
end

subgraph group_project["Project support"]
  node_project_checks["Project checks<br/>[doctor.ts]"]
  node_validation["Validation<br/>[validate.ts]"]
  node_snapshot["Context snapshot<br/>[snapshot.ts]"]
  node_status["Install status<br/>[status.ts]"]
  node_config["Project configuration<br/>[config.ts]"]
  node_scaffold["Planning scaffold<br/>[scaffold.ts]"]
end

node_engineer(("Engineer"))
node_repository_files[("Repository files")]
node_coding_tools["Coding environments"]

node_engineer -->|"runs commands"| node_program
node_program -->|"dispatches init"| node_init
node_program -->|"dispatches setup"| node_ai_setup
node_program -->|"dispatches catalog"| node_catalog
node_program -->|"dispatches tasks"| node_tasks
node_program -->|"dispatches doctor"| node_project_checks
node_program -->|"dispatches validate"| node_validation
node_program -->|"dispatches snapshot"| node_snapshot
node_program -->|"dispatches status"| node_status
node_init -->|"creates planning docs"| node_scaffold
node_init -->|"sets configuration"| node_config
node_ai_setup -->|"detects environments"| node_runtime_detection
node_ai_setup -->|"loads adapters"| node_registry
node_ai_setup -->|"creates install plan"| node_planning
node_ai_setup -->|"applies approved plan"| node_installer
node_ai_setup -->|"reads preferences"| node_config
node_planning -->|"validates specification"| node_validation_core
node_installer -->|"reconciles changes"| node_reconciliation
node_reconciliation -->|"updates managed files"| node_repository_files
node_installer -.->|"writes installed resources"| node_repository_files
node_runtime_catalog -->|"exports agents"| node_agents
node_runtime_catalog -->|"exports prompts"| node_prompts
node_runtime_catalog -->|"exports skills"| node_skills
node_runtime_catalog -.->|"supports environments"| node_coding_tools
node_catalog -.->|"lists resources"| node_runtime_catalog
node_packs -->|"bundles specialists"| node_agents
node_tasks -->|"loads task recipes"| node_packs
node_project_checks -.->|"inspects project"| node_repository_files
node_validation -.->|"checks documentation"| node_repository_files
node_snapshot -.->|"summarizes readiness"| node_repository_files
node_status -.->|"reports installation"| node_repository_files

click node_program "https://github.com/imisbahk/mstack/blob/main/packages/cli/src/program.ts"
click node_init "https://github.com/imisbahk/mstack/blob/main/packages/cli/src/commands/init.ts"
click node_ai_setup "https://github.com/imisbahk/mstack/blob/main/packages/cli/src/commands/ai.ts"
click node_catalog "https://github.com/imisbahk/mstack/blob/main/packages/cli/src/commands/catalog.ts"
click node_packs "https://github.com/imisbahk/mstack/blob/main/packages/cli/src/packs/builtins.ts"
click node_tasks "https://github.com/imisbahk/mstack/blob/main/packages/cli/src/commands/tasks.ts"
click node_project_checks "https://github.com/imisbahk/mstack/blob/main/packages/cli/src/commands/doctor.ts"
click node_validation "https://github.com/imisbahk/mstack/blob/main/packages/cli/src/commands/validate.ts"
click node_snapshot "https://github.com/imisbahk/mstack/blob/main/packages/cli/src/commands/snapshot.ts"
click node_status "https://github.com/imisbahk/mstack/blob/main/packages/cli/src/commands/status.ts"
click node_config "https://github.com/imisbahk/mstack/blob/main/packages/cli/src/services/config.ts"
click node_scaffold "https://github.com/imisbahk/mstack/blob/main/packages/cli/src/services/scaffold.ts"
click node_runtime_detection "https://github.com/imisbahk/mstack/blob/main/packages/cli/src/services/runtimes.ts"
click node_registry "https://github.com/imisbahk/mstack/blob/main/packages/ai-integrations/src/adapters/index.ts"
click node_planning "https://github.com/imisbahk/mstack/blob/main/packages/ai-integrations/src/core/planner.ts"
click node_validation_core "https://github.com/imisbahk/mstack/blob/main/packages/ai-integrations/src/core/validation.ts"
click node_installer "https://github.com/imisbahk/mstack/blob/main/packages/ai-integrations/src/core/installer.ts"
click node_reconciliation "https://github.com/imisbahk/mstack/blob/main/packages/ai-integrations/src/core/reconciliation.ts"
click node_agents "https://github.com/imisbahk/mstack/blob/main/packages/ai-integrations/src/runtime/agents.ts"
click node_prompts "https://github.com/imisbahk/mstack/blob/main/packages/ai-integrations/src/runtime/prompts.ts"
click node_skills "https://github.com/imisbahk/mstack/blob/main/packages/ai-integrations/src/runtime/skills.ts"
click node_runtime_catalog "https://github.com/imisbahk/mstack/tree/main/packages/ai-integrations/src/runtime"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_program,node_init,node_ai_setup,node_catalog,node_packs,node_tasks toneBlue
class node_runtime_detection,node_registry,node_planning,node_validation_core,node_installer,node_reconciliation,node_repository_files toneAmber
class node_agents,node_prompts,node_skills,node_runtime_catalog toneMint
class node_project_checks,node_validation,node_snapshot,node_status,node_config,node_scaffold toneRose
class node_engineer,node_coding_tools toneIndigo
```

## Components

### CLI workflows

- [Command router](https://github.com/imisbahk/mstack/blob/main/packages/cli/src/program.ts): `packages/cli/src/program.ts`
- [Repository init](https://github.com/imisbahk/mstack/blob/main/packages/cli/src/commands/init.ts): `packages/cli/src/commands/init.ts`
- [AI setup](https://github.com/imisbahk/mstack/blob/main/packages/cli/src/commands/ai.ts): `packages/cli/src/commands/ai.ts`
- [Resource catalog](https://github.com/imisbahk/mstack/blob/main/packages/cli/src/commands/catalog.ts): `packages/cli/src/commands/catalog.ts`
- [Capability packs](https://github.com/imisbahk/mstack/blob/main/packages/cli/src/packs/builtins.ts): `packages/cli/src/packs/builtins.ts`
- [Task recipes](https://github.com/imisbahk/mstack/blob/main/packages/cli/src/commands/tasks.ts): `packages/cli/src/commands/tasks.ts`

### Runtime installation

- [Runtime detection](https://github.com/imisbahk/mstack/blob/main/packages/cli/src/services/runtimes.ts): `packages/cli/src/services/runtimes.ts`
- [Environment adapters](https://github.com/imisbahk/mstack/blob/main/packages/ai-integrations/src/adapters/index.ts): `packages/ai-integrations/src/adapters/index.ts`
- [Install planning](https://github.com/imisbahk/mstack/blob/main/packages/ai-integrations/src/core/planner.ts): `packages/ai-integrations/src/core/planner.ts`
- [Spec validation](https://github.com/imisbahk/mstack/blob/main/packages/ai-integrations/src/core/validation.ts): `packages/ai-integrations/src/core/validation.ts`
- [Safe installer](https://github.com/imisbahk/mstack/blob/main/packages/ai-integrations/src/core/installer.ts): `packages/ai-integrations/src/core/installer.ts`
- [State reconciliation](https://github.com/imisbahk/mstack/blob/main/packages/ai-integrations/src/core/reconciliation.ts): `packages/ai-integrations/src/core/reconciliation.ts`

### Agent resources

- [Specialist agents](https://github.com/imisbahk/mstack/blob/main/packages/ai-integrations/src/runtime/agents.ts): `packages/ai-integrations/src/runtime/agents.ts`
- [Prompt library](https://github.com/imisbahk/mstack/blob/main/packages/ai-integrations/src/runtime/prompts.ts): `packages/ai-integrations/src/runtime/prompts.ts`
- [Skill library](https://github.com/imisbahk/mstack/blob/main/packages/ai-integrations/src/runtime/skills.ts): `packages/ai-integrations/src/runtime/skills.ts`
- [Runtime resources](https://github.com/imisbahk/mstack/tree/main/packages/ai-integrations/src/runtime): `packages/ai-integrations/src/runtime`

### Project support

- [Project checks](https://github.com/imisbahk/mstack/blob/main/packages/cli/src/commands/doctor.ts): `packages/cli/src/commands/doctor.ts`
- [Validation](https://github.com/imisbahk/mstack/blob/main/packages/cli/src/commands/validate.ts): `packages/cli/src/commands/validate.ts`
- [Context snapshot](https://github.com/imisbahk/mstack/blob/main/packages/cli/src/commands/snapshot.ts): `packages/cli/src/commands/snapshot.ts`
- [Install status](https://github.com/imisbahk/mstack/blob/main/packages/cli/src/commands/status.ts): `packages/cli/src/commands/status.ts`
- [Project configuration](https://github.com/imisbahk/mstack/blob/main/packages/cli/src/services/config.ts): `packages/cli/src/services/config.ts`
- [Planning scaffold](https://github.com/imisbahk/mstack/blob/main/packages/cli/src/services/scaffold.ts): `packages/cli/src/services/scaffold.ts`

### Other components

- **Engineer**
- **Repository files**
- **Coding environments**

## Connections

- Engineer → Command router: runs commands (evidence: `README.md`)
- Command router → Repository init: dispatches init (evidence: `packages/cli/src/program.ts`)
- Command router → AI setup: dispatches setup (evidence: `packages/cli/src/program.ts`)
- Command router → Resource catalog: dispatches catalog (evidence: `packages/cli/src/program.ts`)
- Command router → Task recipes: dispatches tasks (evidence: `packages/cli/src/program.ts`)
- Command router → Project checks: dispatches doctor (evidence: `packages/cli/src/program.ts`)
- Command router → Validation: dispatches validate (evidence: `packages/cli/src/program.ts`)
- Command router → Context snapshot: dispatches snapshot (evidence: `packages/cli/src/program.ts`)
- Command router → Install status: dispatches status (evidence: `packages/cli/src/program.ts`)
- Repository init → Planning scaffold: creates planning docs (evidence: `packages/cli/src/commands/init.ts`)
- Repository init → Project configuration: sets configuration (evidence: `packages/cli/src/commands/init.ts`)
- AI setup → Runtime detection: detects environments (evidence: `packages/cli/src/commands/ai.ts`)
- AI setup → Environment adapters: loads adapters (evidence: `packages/cli/src/commands/ai.ts`)
- AI setup → Install planning: creates install plan (evidence: `packages/cli/src/commands/ai.ts`)
- AI setup → Safe installer: applies approved plan (evidence: `packages/cli/src/commands/ai.ts`)
- AI setup → Project configuration: reads preferences (evidence: `packages/cli/src/commands/ai.ts`)
- Install planning → Spec validation: validates specification (evidence: `packages/ai-integrations/src/core/planner.ts`)
- Safe installer → State reconciliation: reconciles changes (evidence: `packages/ai-integrations/src/core/installer.ts`)
- State reconciliation → Repository files: updates managed files (evidence: `packages/ai-integrations/src/core/reconciliation.ts`)
- Safe installer → Repository files: writes installed resources
- Runtime resources → Specialist agents: exports agents (evidence: `packages/ai-integrations/src/runtime/index.ts`)
- Runtime resources → Prompt library: exports prompts (evidence: `packages/ai-integrations/src/runtime/index.ts`)
- Runtime resources → Skill library: exports skills (evidence: `packages/ai-integrations/src/runtime/index.ts`)
- Runtime resources → Coding environments: supports environments (evidence: `README.md`)
- Resource catalog → Runtime resources: lists resources (evidence: `README.md`)
- Capability packs → Specialist agents: bundles specialists (evidence: `packages/cli/src/packs/builtins.ts`)
- Task recipes → Capability packs: loads task recipes (evidence: `packages/cli/src/commands/tasks.ts`)
- Project checks → Repository files: inspects project
- Validation → Repository files: checks documentation
- Context snapshot → Repository files: summarizes readiness (evidence: `README.md`)
- Install status → Repository files: reports installation (evidence: `README.md`)
