Initialize a Project

Monday Morning stores all project state inside a .mm/ directory at the root of your repository. Run mm init to create this structure.

Initialize

Navigate to your project root and run:

cd /path/to/your/project
mm init

The command is idempotent — it never overwrites existing files. You can run it multiple times safely.

What gets created

mm init generates the following directory structure:

• Directory.mm/

  • config.json — Project configuration
  • Directoryspecs/ — Feature specifications (the unit of work)

    • …
  • Directorytasks/ — Standalone tasks and dashboard

    • tasks.md — Tasks dashboard
  • Directoryissues/ — Bug and problem tracking

    • issues.md — Issues dashboard
  • Directorynotes/ — Decisions, meeting notes, context

    • notes.md — Notes dashboard
  • Directoryfeatures/ — Feature groupings

    • …
  • Directorydocs/ — Living reference documents

    • …
  • Directoryproduct/ — Mission, roadmap, tech stack

    • …
  • Directoryproposals/ — Ideas before they become specs

    • …
  • Directorysession/ — Session context for AI agents

    • …
  • Directorystandards/ — Coding standards and conventions

    • …
• Directory.claude/

  • Directorycommands/mm/ — Monday Morning workflow commands

    • …
  • Directoryagents/mm/ — AI agent definitions

    • …
  • Directoryskills/ — Reusable skill definitions

    • …

config.json

The project configuration file stores metadata about your project:

{
  "project": "my-project",
  "version": "0.4.0",
  "created": "2026-03-31 10:00",
  "updated": "2026-03-31 10:00"
}

Field	Description
project	The project name, derived from the directory name.
version	The Monday Morning framework version that initialized this project.
created	Timestamp when the project was initialized.
updated	Timestamp of the last update.

Dashboard Files

Each tracking directory gets a dashboard file (e.g., tasks.md, issues.md, notes.md). These dashboards act as indexes — they link to individual entity files and organize them by status.

For example, tasks/tasks.md contains sections for Active, Backlog, and Completed tasks, each linking to individual task files.

Version Control

The .mm/ directory is designed to be committed to version control. This means:

• Your project context travels with your code.
• Team members see the same specs, tasks, and issues.
• AI agents on any machine can read the same structured context.

Tip

If you want to keep some files private (e.g., session context), add specific paths to .gitignore:

.mm/session/

Re-running init

If Monday Morning ships new directories or dashboard files in a future version, run mm init again to add them. Existing files are never modified or overwritten.

Next Steps

• The .mm/ Data Model — Understand each entity type and file format.
• Your First Workflow — Create a spec and start tracking work.