How imisbahk/mstack works
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: program.ts Command router · ai.ts AI setup · runtime Runtime resources · init.ts Repository init
Components 25
CLI workflows
- Command router
packages/cli/src/program.ts - Repository init
packages/cli/src/commands/init.ts - AI setup
packages/cli/src/commands/ai.ts - Resource catalog
packages/cli/src/commands/catalog.ts - Capability packs
packages/cli/src/packs/builtins.ts - Task recipes
packages/cli/src/commands/tasks.ts
Runtime installation
- Runtime detection
packages/cli/src/services/runtimes.ts - Environment adapters
packages/ai-integrations/src/adapters/index.ts - Install planning
packages/ai-integrations/src/core/planner.ts - Spec validation
packages/ai-integrations/src/core/validation.ts - Safe installer
packages/ai-integrations/src/core/installer.ts - State reconciliation
packages/ai-integrations/src/core/reconciliation.ts
Agent resources
- Specialist agents
packages/ai-integrations/src/runtime/agents.ts - Prompt library
packages/ai-integrations/src/runtime/prompts.ts - Skill library
packages/ai-integrations/src/runtime/skills.ts - Runtime resources
packages/ai-integrations/src/runtime
Project support
- Project checks
packages/cli/src/commands/doctor.ts - Validation
packages/cli/src/commands/validate.ts - Context snapshot
packages/cli/src/commands/snapshot.ts - Install status
packages/cli/src/commands/status.ts - Project configuration
packages/cli/src/services/config.ts - Planning scaffold
packages/cli/src/services/scaffold.ts
Other components
- Engineer
- Repository files
- Coding environments
Connections 31
- Engineer → Command router: runs commands
README.md - Command router → Repository init: dispatches init
packages/cli/src/program.ts - Command router → AI setup: dispatches setup
packages/cli/src/program.ts - Command router → Resource catalog: dispatches catalog
packages/cli/src/program.ts - Command router → Task recipes: dispatches tasks
packages/cli/src/program.ts - Command router → Project checks: dispatches doctor
packages/cli/src/program.ts - Command router → Validation: dispatches validate
packages/cli/src/program.ts - Command router → Context snapshot: dispatches snapshot
packages/cli/src/program.ts - Command router → Install status: dispatches status
packages/cli/src/program.ts - Repository init → Planning scaffold: creates planning docs
packages/cli/src/commands/init.ts - Repository init → Project configuration: sets configuration
packages/cli/src/commands/init.ts - AI setup → Runtime detection: detects environments
packages/cli/src/commands/ai.ts - AI setup → Environment adapters: loads adapters
packages/cli/src/commands/ai.ts - AI setup → Install planning: creates install plan
packages/cli/src/commands/ai.ts - AI setup → Safe installer: applies approved plan
packages/cli/src/commands/ai.ts - AI setup → Project configuration: reads preferences
packages/cli/src/commands/ai.ts - Install planning → Spec validation: validates specification
packages/ai-integrations/src/core/planner.ts - Safe installer → State reconciliation: reconciles changes
packages/ai-integrations/src/core/installer.ts - State reconciliation → Repository files: updates managed files
packages/ai-integrations/src/core/reconciliation.ts - Safe installer → Repository files: writes installed resources
- Runtime resources → Specialist agents: exports agents
packages/ai-integrations/src/runtime/index.ts - Runtime resources → Prompt library: exports prompts
packages/ai-integrations/src/runtime/index.ts - Runtime resources → Skill library: exports skills
packages/ai-integrations/src/runtime/index.ts - Runtime resources → Coding environments: supports environments
README.md - Resource catalog → Runtime resources: lists resources
README.md - Capability packs → Specialist agents: bundles specialists
packages/cli/src/packs/builtins.ts - Task recipes → Capability packs: loads task recipes
packages/cli/src/commands/tasks.ts - Project checks → Repository files: inspects project
- Validation → Repository files: checks documentation
- Context snapshot → Repository files: summarizes readiness
README.md - Install status → Repository files: reports installation
README.md