ml-setup

Meta-Loop: Project Setup

Scaffold the directory structure and starter files needed for the meta-loop workflow.

Mode: Agent Mode (creates files and directories)

Prerequisites

This command prepares a project to use the Meta-Loop process defined in skills/meta-loop-methodology/SKILL.md.

Run this once after installing the meta-loop plugin. It is safe to re-run — existing files are never overwritten.

---

Phase 1: Check Prerequisites

1. Verify git repo root:

   • Check that .git/ exists in the current directory
   • If not, stop and tell the developer to run from the project root

2. Check for installed skills:

   • Check that .claude/skills/ exists and contains meta-loop skill directories
   • If missing, warn: "Meta-loop skills not found. Run install.sh first, then re-run /ml-setup."

3. Check for installed commands:

   • Check that .claude/commands/ exists and contains ml-wireframe.md, ml-spec.md, ml-impl.md, ml-retain.md
   • If missing, warn: "Meta-loop commands not found. Run install.sh first, then re-run /ml-setup."

If any prerequisite fails, stop and print the warning. Do not continue to Phase 2.

---

Phase 2: Create Directory Structure

Create these directories if they don't already exist. Skip and note any that already exist.

• specs/views/
• supporting-docs/

---

Phase 3: Create Starter Files

Important: Never overwrite an existing file. If a file already exists, skip it and note that it was skipped in the summary.

3.1 CLAUDE.md

Only create if CLAUDE.md does not exist in the project root.

# [App Name]

[Brief description of what this app does.]

## Build Commands

| Command                                                                                                      | Action              |
| ------------------------------------------------------------------------------------------------------------ | ------------------- |
| `xcodebuild -scheme [Scheme] -sdk iphonesimulator build`                                                     | Build for simulator |
| `xcodebuild test -scheme [Scheme] -sdk iphonesimulator -destination 'platform=iOS Simulator,name=iPhone 16'` | Run tests           |

## Project Structure

[Describe your project's file organization here]

## Key Patterns

[Document project-specific patterns, conventions, and architectural decisions here.]

## Meta-Loop Commands

| Command         | Purpose                                     |
| --------------- | ------------------------------------------- |
| `/ml-setup`     | Scaffold project for meta-loop workflow     |
| `/ml-wireframe` | Review wireframe to verify AI understanding |
| `/ml-spec`      | Create specification from wireframe         |
| `/ml-impl`      | Implement from specification                |
| `/ml-retain`    | Capture learnings before clearing context   |

## Meta-Loop Skills

Reference docs are in `.claude/skills/`:
- `meta-loop-methodology/` — Process theory and user guide
- `wireframe-design/` — Wireframe creation tips
- `view-specifications/` — Spec writing guide and template
- `project-structure/` — Directory layout and file responsibilities