make-it-done 0.1.0

package/bin/install.js

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+
+import { cpSync, mkdirSync, writeFileSync, readFileSync, existsSync, rmSync } from 'fs'
+import { resolve, dirname } from 'path'
+import { homedir } from 'os'
+import { fileURLToPath } from 'url'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+
+const args = process.argv.slice(2)
+const command = args[0] || 'interactive'
+
+async function main() {
+  // For now, only support Claude Code
+  const runtime = args.includes('--claude') ? 'claude' : 'claude'
+  const location = args.includes('--global') ? 'global' : args.includes('--local') ? 'local' : 'global'
+
+  if (args.includes('--uninstall')) {
+    uninstall(runtime, location)
+    return
+  }
+
+  if (args.includes('--update')) {
+    uninstall(runtime, location)
+  }
+
+  install(runtime, location)
+}
+
+function install(runtime, location) {
+  const baseDir = location === 'global' ? resolve(homedir(), '.claude') : resolve(process.cwd(), '.claude')
+
+  // Ensure base directory exists
+  mkdirSync(baseDir, { recursive: true })
+
+  const sourceDir = resolve(__dirname, '..')
+  const targetMakeitdoneDir = resolve(baseDir, 'makeitdone')
+  const targetCommandsDir = resolve(baseDir, 'commands', 'mid')
+  const targetAgentsDir = resolve(baseDir, 'agents')
+
+  try {
+    // Copy makeitdone framework directory
+    const makeitdoneSource = resolve(sourceDir, 'makeitdone')
+    if (existsSync(makeitdoneSource)) {
+      cpSync(makeitdoneSource, targetMakeitdoneDir, { recursive: true, force: true })
+      console.log(`✅ Installed makeitdone framework to ${targetMakeitdoneDir}`)
+    }
+
+    // Copy commands directory
+    const commandsSource = resolve(sourceDir, 'commands', 'mid')
+    if (existsSync(commandsSource)) {
+      mkdirSync(targetCommandsDir, { recursive: true })
+      cpSync(commandsSource, targetCommandsDir, { recursive: true, force: true })
+      console.log(`✅ Installed commands to ${targetCommandsDir}`)
+    }
+
+    // Copy agents directory
+    const agentsSource = resolve(sourceDir, 'agents')
+    if (existsSync(agentsSource)) {
+      mkdirSync(targetAgentsDir, { recursive: true })
+      cpSync(agentsSource, targetAgentsDir, { recursive: true, force: true })
+      console.log(`✅ Installed agents to ${targetAgentsDir}`)
+    }
+
+    // Write install receipt
+    const receipt = {
+      version: getPackageVersion(),
+      installedAt: new Date().toISOString(),
+      runtime,
+      location,
+      baseDir
+    }
+    writeFileSync(
+      resolve(targetMakeitdoneDir, '.install.json'),
+      JSON.stringify(receipt, null, 2)
+    )
+
+    console.log(`\n✨ makeitdone installed successfully!`)
+    console.log(`   Framework: ${targetMakeitdoneDir}`)
+    console.log(`   Commands: ${targetCommandsDir}`)
+    console.log(`   Agents: ${targetAgentsDir}`)
+    console.log(`\nYou can now use: /mid:init, /mid:plan, /mid:do, etc.`)
+  } catch (error) {
+    console.error(`❌ Installation failed:`, error instanceof Error ? error.message : String(error))
+    process.exit(1)
+  }
+}
+
+function uninstall(runtime, location) {
+  const baseDir = location === 'global' ? resolve(homedir(), '.claude') : resolve(process.cwd(), '.claude')
+
+  const dirs = [
+    resolve(baseDir, 'makeitdone'),
+    resolve(baseDir, 'commands', 'mid'),
+    resolve(baseDir, 'agents')
+  ]
+
+  for (const dir of dirs) {
+    if (existsSync(dir)) {
+      rmSync(dir, { recursive: true, force: true })
+      console.log(`✅ Removed ${dir}`)
+    }
+  }
+
+  console.log(`\n✨ makeitdone uninstalled`)
+}
+
+function getPackageVersion() {
+  try {
+    const pkgPath = resolve(__dirname, '..', 'package.json')
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'))
+    return pkg.version || '0.1.0'
+  } catch {
+    return '0.1.0'
+  }
+}
+
+main().catch(error => {
+  console.error('Error:', error)
+  process.exit(1)
+})

package/commands/mid/debug.md

@@ -0,0 +1,19 @@
+---
+name: mid:debug
+description: Debug phase execution issues
+argument-hint: "[--phase <N>] [--plan <N>]"
+allowed-tools:
+  - Read
+  - Bash
+  - Grep
+  - Glob
+  - Agent
+---
+
+# Debug Phase
+
+@/Users/ismailalam/Development/my/makeitdone/workflows/debug.md
+
+<context>
+arguments: $ARGUMENTS
+</context>

package/commands/mid/do.md

@@ -0,0 +1,24 @@
+---
+name: mid:do
+description: Execute phase plans with wave-based parallelization
+argument-hint: "<phase-number> [--wave N] [--interactive]"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - Grep
+  - Glob
+  - Task
+  - AskUserQuestion
+  - Agent
+---
+
+# Execute Phase
+
+@/Users/ismailalam/Development/my/makeitdone/workflows/execute.md
+
+<context>
+phase: $ARGUMENTS
+mode: execute
+</context>

package/commands/mid/help.md

@@ -0,0 +1,77 @@
+---
+name: mid:help
+description: Show makeitdone help and command reference
+argument-hint: "[command]"
+allowed-tools:
+  - Read
+---
+
+# makeitdone Help
+
+## Available Commands
+
+| Command | Purpose |
+|---------|---------|
+| `/mid:init` | Initialize a new makeitdone project |
+| `/mid:plan` | Create or update roadmap and phase plans |
+| `/mid:do` | Execute phase plans with parallelization |
+| `/mid:next` | Move to next phase and verify completion |
+| `/mid:verify` | Verify phase against acceptance criteria |
+| `/mid:status` | Show current project status |
+| `/mid:report` | Generate comprehensive project report |
+| `/mid:debug` | Debug phase execution issues |
+| `/mid:quick` | Quick task execution without full structure |
+| `/mid:help` | Show this help (you are here) |
+
+## Core Concepts
+
+**Phases**: Discrete, time-boxed units of work organized by milestone. Each phase contains multiple plans.
+
+**Plans**: Individual tasks within a phase, executed in waves for parallelization.
+
+**State**: Lives in `.planning/STATE.md` frontmatter (< 100 lines). Tracks current phase, wave progress, completion status.
+
+**Roadmap**: Lives in `.planning/ROADMAP.md`. Lists all phases with status and description.
+
+**Workflows**: Large orchestration files in `~/.claude/makeitdone/workflows/` that delegate to agents and steps.
+
+## Quick Start
+
+```bash
+# 1. Initialize project
+/mid:init
+
+# 2. Create roadmap
+/mid:plan --mode roadmap
+
+# 3. Plan first phase
+/mid:plan --mode phase --phase 1
+
+# 4. Execute phase
+/mid:do 1
+
+# 5. Check status
+/mid:status
+
+# 6. Move to next
+/mid:next
+```
+
+## Configuration
+
+Project config lives in `.planning/config.json`:
+- `model_profile`: budget | balanced | quality
+- `context_window`: Token budget (default 200000)
+- `parallelization`: true | false
+
+## Token Optimization
+
+makeitdone uses **TOON** (Token-Oriented Object Notation) for all JSON payloads, achieving ~40% token reduction. All workflow and agent interactions automatically convert to TOON for maximum efficiency.
+
+For details: `~/.claude/makeitdone/bin/mid-tools.cjs --help`
+
+## Need More Help?
+
+- Project spec: `.planning/PROJECT.md`
+- Requirements: `.planning/REQUIREMENTS.md`
+- Phase plans: `.planning/phases/{N}-*/PLAN.md`

package/commands/mid/init.md

@@ -0,0 +1,18 @@
+---
+name: mid:init
+description: Initialize a new makeitdone project
+argument-hint: "[--name <project-name>] [--type <type>]"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - AskUserQuestion
+---
+
+# Initialize makeitdone Project
+
+@/Users/ismailalam/Development/my/makeitdone/workflows/init.md
+
+<context>
+arguments: $ARGUMENTS
+</context>

package/commands/mid/next.md

@@ -0,0 +1,18 @@
+---
+name: mid:next
+description: Move to next phase and verify completion
+argument-hint: "[--phase <N>]"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Agent
+---
+
+# Move to Next Phase
+
+@/Users/ismailalam/Development/my/makeitdone/workflows/next.md
+
+<context>
+arguments: $ARGUMENTS
+</context>

package/commands/mid/plan.md

@@ -0,0 +1,21 @@
+---
+name: mid:plan
+description: Create or update roadmap and phase plans
+argument-hint: "[--mode <roadmap|phase|gap>] [--phase <N>]"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Grep
+  - Glob
+  - AskUserQuestion
+  - Agent
+---
+
+# Plan Phase
+
+@/Users/ismailalam/Development/my/makeitdone/workflows/plan.md
+
+<context>
+arguments: $ARGUMENTS
+</context>

package/commands/mid/quick.md

@@ -0,0 +1,24 @@
+---
+name: mid:quick
+description: Quick execution without full phase structure
+argument-hint: "<task-description> [--verify] [--interactive]"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - Grep
+  - Glob
+  - Task
+  - AskUserQuestion
+  - Agent
+---
+
+# Quick Task Execution
+
+@/Users/ismailalam/Development/my/makeitdone/workflows/quick.md
+
+<context>
+task: $ARGUMENTS
+mode: quick
+</context>

package/commands/mid/report.md

@@ -0,0 +1,16 @@
+---
+name: mid:report
+description: Generate comprehensive project report
+argument-hint: "[--phase <N>] [--detail <brief|full>]"
+allowed-tools:
+  - Read
+  - Bash
+---
+
+# Generate Report
+
+@/Users/ismailalam/Development/my/makeitdone/workflows/report.md
+
+<context>
+arguments: $ARGUMENTS
+</context>

package/commands/mid/status.md

@@ -0,0 +1,16 @@
+---
+name: mid:status
+description: Show current project status and phase progress
+argument-hint: "[--phase <N>] [--format <text|json|toon>]"
+allowed-tools:
+  - Read
+  - Bash
+---
+
+# Project Status
+
+@/Users/ismailalam/Development/my/makeitdone/workflows/status.md
+
+<context>
+arguments: $ARGUMENTS
+</context>

package/commands/mid/verify.md

@@ -0,0 +1,19 @@
+---
+name: mid:verify
+description: Verify phase completion against acceptance criteria
+argument-hint: "[--phase <N>] [--mode <integration|security|ui|audit>]"
+allowed-tools:
+  - Read
+  - Bash
+  - Grep
+  - Glob
+  - Agent
+---
+
+# Verify Phase
+
+@/Users/ismailalam/Development/my/makeitdone/workflows/verify.md
+
+<context>
+arguments: $ARGUMENTS
+</context>