istd-init 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Theerasak Duangkaew
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,56 @@
+# istd-init
+
+> One-command BMAD-METHOD project initializer
+
+Initialize any folder as a BMAD-powered project with a single command.
+
+## Quick Start
+
+```bash
+mkdir my-project
+cd my-project
+npx istd-init
+```
+
+That's it. BMAD is installed, git is initialized, README is created.
+
+## Usage
+
+```bash
+# Interactive mode (asks questions)
+npx istd-init
+
+# Quick mode (uses defaults)
+npx istd-init --yes
+
+# Skip specific steps
+npx istd-init --no-git --no-readme
+```
+
+## Options
+
+| Flag | Description |
+|------|-------------|
+| `-y, --yes` | Skip all prompts, use defaults |
+| `--no-bmad` | Skip BMAD installation |
+| `--no-git` | Skip git initialization |
+| `--no-readme` | Skip README creation |
+| `-h, --help` | Show help |
+| `-v, --version` | Show version |
+
+## What Gets Installed
+
+- **BMAD-METHOD** with modules: `bmm`, `bmb`, `cis` (configurable)
+- **`.gitignore`** with sensible defaults
+- **`README.md`** template
+- **Git repo** initialized on `main` branch
+
+## Requirements
+
+- Node.js 20+
+- Git
+- An AI IDE (Claude Code recommended)
+
+## License
+
+MIT © Theerasak Duangkaew

package/bin/cli.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+
+import { run } from '../src/index.js';
+
+run(process.argv.slice(2)).catch((err) => {
+  console.error('\n❌ Error:', err.message);
+  if (process.env.DEBUG) {
+    console.error(err.stack);
+  }
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "istd-init",
+  "version": "0.1.0",
+  "description": "Initialize a project with BMAD-METHOD pre-configured in one command",
+  "type": "module",
+  "bin": {
+    "istd-init": "./bin/cli.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "bmad",
+    "bmad-method",
+    "init",
+    "scaffold",
+    "cli",
+    "ai-agile"
+  ],
+  "author": "Theerasak Duangkaew",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/iAmStarter/istd-init.git"
+  },
+  "bugs": {
+    "url": "https://github.com/iAmStarter/istd-init/issues"
+  },
+  "homepage": "https://github.com/iAmStarter/istd-init#readme",
+  "dependencies": {
+    "execa": "^9.5.1",
+    "ora": "^8.1.1",
+    "picocolors": "^1.1.1",
+    "prompts": "^2.4.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/checks.js

@@ -0,0 +1,44 @@
+import { execa } from 'execa';
+import { ui } from './ui.js';
+
+async function checkNode() {
+  const major = parseInt(process.versions.node.split('.')[0], 10);
+  if (major < 20) {
+    throw new Error(
+      `Node.js 20+ is required. You have v${process.versions.node}.\n` +
+        `   Install from: https://nodejs.org`
+    );
+  }
+}
+
+async function checkGit() {
+  try {
+    await execa('git', ['--version']);
+  } catch {
+    throw new Error(
+      'Git is required but not found.\n' +
+        '   Install from: https://git-scm.com'
+    );
+  }
+}
+
+async function checkNpx() {
+  try {
+    await execa('npx', ['--version']);
+  } catch {
+    throw new Error('npx not found. It should come with Node.js.');
+  }
+}
+
+export async function checkEnvironment() {
+  const spinner = ui.spinner('Checking environment...').start();
+  try {
+    await checkNode();
+    await checkGit();
+    await checkNpx();
+    spinner.succeed('  Environment OK');
+  } catch (err) {
+    spinner.fail('  Environment check failed');
+    throw err;
+  }
+}

package/src/index.js

@@ -0,0 +1,130 @@
+import { checkEnvironment } from './checks.js';
+import { askQuestions } from './prompts.js';
+import { installBmad } from './installers/bmad.js';
+import { initGit, isGitRepo } from './installers/git.js';
+import { createGitignore, createReadme } from './installers/files.js';
+import { ui } from './ui.js';
+
+const VERSION = '0.1.0';
+
+function parseArgs(args) {
+  const opts = {
+    yes: false,
+    skipBmad: false,
+    skipGit: false,
+    skipReadme: false,
+    help: false,
+    version: false,
+  };
+
+  for (const arg of args) {
+    switch (arg) {
+      case '-y':
+      case '--yes':
+        opts.yes = true;
+        break;
+      case '--no-bmad':
+        opts.skipBmad = true;
+        break;
+      case '--no-git':
+        opts.skipGit = true;
+        break;
+      case '--no-readme':
+        opts.skipReadme = true;
+        break;
+      case '-h':
+      case '--help':
+        opts.help = true;
+        break;
+      case '-v':
+      case '--version':
+        opts.version = true;
+        break;
+    }
+  }
+
+  return opts;
+}
+
+function showHelp() {
+  console.log(`
+${ui.bold('istd-init')} v${VERSION}
+
+Initialize a project with BMAD-METHOD pre-configured.
+
+${ui.bold('Usage:')}
+  npx istd-init [options]
+
+${ui.bold('Options:')}
+  -y, --yes           Skip all prompts, use defaults
+  --no-bmad           Skip BMAD installation
+  --no-git            Skip git initialization
+  --no-readme         Skip README creation
+  -h, --help          Show this help
+  -v, --version       Show version
+
+${ui.bold('Examples:')}
+  ${ui.dim('# Interactive mode')}
+  npx istd-init
+
+  ${ui.dim('# Quick setup with defaults')}
+  npx istd-init --yes
+
+  ${ui.dim('# BMAD only, no git/readme')}
+  npx istd-init -y --no-git --no-readme
+`);
+}
+
+export async function run(args) {
+  const opts = parseArgs(args);
+
+  if (opts.help) {
+    showHelp();
+    return;
+  }
+
+  if (opts.version) {
+    console.log(`v${VERSION}`);
+    return;
+  }
+
+  // Header
+  ui.header('🚀 istd-init', 'Initialize project with BMAD-METHOD');
+
+  // 1. Environment checks
+  await checkEnvironment();
+
+  // 2. Show current directory info
+  const cwd = process.cwd();
+  ui.info(`📁 Working directory: ${ui.cyan(cwd)}`);
+
+  // 3. Get user preferences
+  const config = await askQuestions(opts);
+
+  // 4. Install BMAD
+  if (!opts.skipBmad) {
+    await installBmad(config);
+  } else {
+    ui.skip('BMAD installation skipped');
+  }
+
+  // 5. Create README
+  if (!opts.skipReadme) {
+    await createReadme(config);
+  }
+
+  // 6. Create .gitignore
+  await createGitignore();
+
+  // 7. Init git
+  if (!opts.skipGit) {
+    if (await isGitRepo()) {
+      ui.skip('Git repo already exists');
+    } else {
+      await initGit();
+    }
+  }
+
+  // 8. Success message
+  ui.success(config);
+}

package/src/installers/bmad.js

@@ -0,0 +1,33 @@
+import { execa } from 'execa';
+import { ui } from '../ui.js';
+
+export async function installBmad(config) {
+  const spinner = ui.spinner('Installing BMAD-METHOD (this may take a minute)...').start();
+
+  try {
+    const args = [
+      'bmad-method',
+      'install',
+      '--yes',
+      '--modules',
+      config.modules.join(','),
+      '--tools',
+      'claude-code',
+    ];
+
+    if (config.userName) {
+      args.push('--user-name', config.userName);
+    }
+
+    await execa('npx', args, {
+      stdio: process.env.DEBUG ? 'inherit' : 'pipe',
+    });
+
+    spinner.succeed(`  BMAD installed (${config.modules.join(', ')})`);
+  } catch (err) {
+    spinner.fail('  BMAD installation failed');
+    throw new Error(
+      `BMAD install failed. Run with DEBUG=1 to see details.\n   ${err.message}`
+    );
+  }
+}

package/src/installers/files.js

@@ -0,0 +1,117 @@
+import { writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { ui } from '../ui.js';
+
+const GITIGNORE_CONTENT = `# Dependencies
+node_modules/
+.pnp
+.pnp.js
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Build output
+dist/
+build/
+out/
+*.log
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+.DS_Store
+Thumbs.db
+
+# BMAD - keep _bmad/ committed (config), ignore output cache only if you want
+# _bmad-output/.cache/
+
+# OS
+.DS_Store
+Thumbs.db
+`;
+
+export async function createGitignore() {
+  const path = join(process.cwd(), '.gitignore');
+  if (existsSync(path)) {
+    ui.skip('.gitignore already exists');
+    return;
+  }
+  await writeFile(path, GITIGNORE_CONTENT);
+  ui.ok('.gitignore created');
+}
+
+export async function createReadme(config) {
+  const path = join(process.cwd(), 'README.md');
+  if (existsSync(path)) {
+    ui.skip('README.md already exists');
+    return;
+  }
+
+  const content = `# ${config.projectName}
+
+> Built with [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) — AI-driven agile development
+
+## Getting Started
+
+### Prerequisites
+
+- Node.js 20+
+- [Claude Code](https://claude.com/claude-code) (or another supported AI IDE)
+
+### Installation
+
+\`\`\`bash
+# Clone & enter
+git clone <your-repo-url>
+cd ${config.projectName}
+
+# (BMAD is already configured in this repo via _bmad/ folder)
+\`\`\`
+
+### Using BMAD
+
+Open Claude Code in this folder, then type:
+
+\`\`\`
+bmad-help
+\`\`\`
+
+BMAD-Help will inspect your project and tell you exactly what to do next.
+
+## Project Structure
+
+\`\`\`
+${config.projectName}/
+├── _bmad/                  # BMAD configuration & runtime
+├── _bmad-output/           # Generated artifacts (PRD, architecture, stories)
+│   └── planning-artifacts/
+├── .claude/                # Claude Code slash commands
+└── README.md
+\`\`\`
+
+## Development Workflow
+
+1. **Plan** — \`bmad-create-prd\` → produces PRD.md
+2. **Design** — \`bmad-create-architecture\` → produces architecture.md
+3. **Break down** — \`bmad-create-epics-and-stories\` → produces epics
+4. **Build** — \`bmad-create-story\` → \`bmad-dev-story\` → \`bmad-code-review\`
+
+See [BMAD docs](https://docs.bmad-method.org/) for full reference.
+
+## Modules Installed
+
+${config.modules.map((m) => `- \`${m}\``).join('\n')}
+
+## License
+
+MIT
+`;
+
+  await writeFile(path, content);
+  ui.ok('README.md created');
+}

package/src/installers/git.js

@@ -0,0 +1,20 @@
+import { execa } from 'execa';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { ui } from '../ui.js';
+
+export async function isGitRepo() {
+  return existsSync(join(process.cwd(), '.git'));
+}
+
+export async function initGit() {
+  const spinner = ui.spinner('Initializing git repository...').start();
+  try {
+    await execa('git', ['init']);
+    await execa('git', ['branch', '-M', 'main']);
+    spinner.succeed('  Git initialized (branch: main)');
+  } catch (err) {
+    spinner.fail('  Git init failed');
+    throw err;
+  }
+}

package/src/prompts.js

@@ -0,0 +1,69 @@
+import prompts from 'prompts';
+import { basename } from 'node:path';
+import { ui } from './ui.js';
+
+const DEFAULT_MODULES = ['bmm', 'bmb', 'cis'];
+const ALL_MODULES = [
+  { title: 'bmm - BMad Method (core, required)', value: 'bmm', selected: true, disabled: true },
+  { title: 'bmb - BMad Builder', value: 'bmb', selected: true },
+  { title: 'cis - Creative Intelligence Suite', value: 'cis', selected: true },
+  { title: 'gds - Game Dev Studio', value: 'gds', selected: false },
+  { title: 'tea - Test Architect', value: 'tea', selected: false },
+];
+
+export async function askQuestions(opts) {
+  const folderName = basename(process.cwd());
+
+  // --yes mode: ใช้ defaults ทั้งหมด
+  if (opts.yes) {
+    ui.step(`Using defaults (--yes mode)`);
+    return {
+      projectName: folderName,
+      modules: DEFAULT_MODULES,
+      userName: process.env.USER || process.env.USERNAME || 'Developer',
+    };
+  }
+
+  // Interactive mode
+  const responses = await prompts(
+    [
+      {
+        type: 'text',
+        name: 'projectName',
+        message: 'Project name:',
+        initial: folderName,
+        validate: (v) =>
+          v.length > 0 && /^[a-zA-Z0-9-_]+$/.test(v)
+            ? true
+            : 'Use only letters, numbers, dash, underscore',
+      },
+      {
+        type: 'text',
+        name: 'userName',
+        message: 'Your name (for BMAD config):',
+        initial: process.env.USER || process.env.USERNAME || '',
+      },
+      {
+        type: 'multiselect',
+        name: 'modules',
+        message: 'BMAD modules to install:',
+        choices: ALL_MODULES,
+        instructions: false,
+        hint: 'Space to toggle, Enter to confirm',
+      },
+    ],
+    {
+      onCancel: () => {
+        ui.warn('Cancelled by user');
+        process.exit(0);
+      },
+    }
+  );
+
+  // ensure bmm is always included
+  if (!responses.modules.includes('bmm')) {
+    responses.modules.unshift('bmm');
+  }
+
+  return responses;
+}

package/src/ui.js

@@ -0,0 +1,70 @@
+import pc from 'picocolors';
+import ora from 'ora';
+
+export const ui = {
+  // Colors
+  bold: pc.bold,
+  cyan: pc.cyan,
+  green: pc.green,
+  yellow: pc.yellow,
+  red: pc.red,
+  dim: pc.dim,
+  gray: pc.gray,
+
+  // Headers
+  header(title, subtitle) {
+    console.log('');
+    console.log(pc.bold(pc.cyan(`  ${title}`)));
+    if (subtitle) {
+      console.log(pc.dim(`  ${subtitle}`));
+    }
+    console.log('');
+  },
+
+  // Status messages
+  info(msg) {
+    console.log(`  ${msg}`);
+  },
+
+  step(msg) {
+    console.log(`  ${pc.cyan('→')} ${msg}`);
+  },
+
+  ok(msg) {
+    console.log(`  ${pc.green('✓')} ${msg}`);
+  },
+
+  skip(msg) {
+    console.log(`  ${pc.gray('○')} ${pc.dim(msg)}`);
+  },
+
+  warn(msg) {
+    console.log(`  ${pc.yellow('⚠')} ${msg}`);
+  },
+
+  error(msg) {
+    console.log(`  ${pc.red('✗')} ${msg}`);
+  },
+
+  // Spinner
+  spinner(text) {
+    return ora({ text: `  ${text}`, spinner: 'dots' });
+  },
+
+  // Final success message
+  success(config) {
+    console.log('');
+    console.log(pc.green(pc.bold('  ✨ All done!')));
+    console.log('');
+    console.log(pc.bold('  Next steps:'));
+    console.log('');
+    console.log(`    ${pc.cyan('1.')} Open Claude Code in this folder:`);
+    console.log(`       ${pc.dim('$')} ${pc.bold('claude')}`);
+    console.log('');
+    console.log(`    ${pc.cyan('2.')} Inside Claude Code, type:`);
+    console.log(`       ${pc.bold('bmad-help')}`);
+    console.log('');
+    console.log(`    ${pc.cyan('3.')} Start building! 🎉`);
+    console.log('');
+  },
+};