Skip to content

Kits

A kit is a set of template files that define a project's AI development workflow. When you run mold new or mold init, the selected kit determines which files are created.

Built-in kits

Original

The default kit. Provides a standard Claude Code workflow with markdown-based task tracking.

Files generated:

  • CLAUDE.md -- project instructions for Claude Code
  • .claude/settings.json -- Claude Code settings with allowed commands
  • docs/TODO.md -- markdown task list
  • .repomixignore -- files excluded from Repomix context
  • repomix.config.json -- Repomix configuration
  • .claude/commands/review.md -- /review slash command
  • .claude/commands/test.md -- /test slash command
  • .claude/commands/doc.md -- /doc slash command
  • .claude/commands/refactor.md -- /refactor slash command

Select it: mold new my-app (default) or mold new my-app --kit original

Beads

Git-backed issue tracking via the bd CLI. Designed for developers who want structured issue management stored in their git history.

Files generated:

  • CLAUDE.md -- project instructions for Claude Code
  • .claude/settings.json -- Claude Code settings
  • .repomixignore -- Repomix exclusions
  • repomix.config.json -- Repomix configuration
  • .claude/commands/feature.md -- /feature slash command
  • .claude/commands/fix.md -- /fix slash command
  • .claude/commands/review.md -- /review slash command
  • .claude/commands/session-start.md -- /session-start slash command
  • .claude/commands/session-end.md -- /session-end slash command

Select it: mold new my-app --beads or mold new my-app --kit beads

Forge

Product lifecycle orchestration -- AI-powered workflow from ideation to launch. Provides a structured forge/ directory with eight lifecycle phases, each containing guided templates for taking a product from idea to post-launch iteration.

Files generated:

  • CLAUDE.md -- project instructions for Claude Code
  • ARCHITECTURE.md -- stack-aware architecture document
  • FORGE-GUIDE.md -- guide to the forge lifecycle workflow
  • .claude/commands/ideate.md -- /ideate slash command
  • .claude/commands/research.md -- /research slash command
  • .claude/commands/define.md -- /define slash command
  • .claude/commands/design.md -- /design slash command
  • .claude/commands/develop.md -- /develop slash command
  • .claude/commands/test.md -- /test slash command
  • .claude/commands/launch.md -- /launch slash command
  • .claude/commands/iterate.md -- /iterate slash command
  • .claude/commands/delegate.md -- /delegate slash command
  • .claude/commands/status.md -- /status slash command
  • .claude/commands/session-start.md -- /session-start slash command
  • .claude/commands/session-end.md -- /session-end slash command
  • forge/FORGE.md -- lifecycle overview and status tracker
  • forge/01-ideation/ -- idea capture and screening
  • forge/02-research/ -- market analysis, competitive landscape, user personas
  • forge/03-product-definition/ -- PRD, MVP scope, roadmap
  • forge/04-design/ -- architecture, API design, tech stack, wireframes
  • forge/05-development/ -- sprint backlog, decisions, changelog
  • forge/06-testing/ -- test plan, bug tracker, security review
  • forge/07-launch/ -- deployment plan, go-to-market, launch checklist
  • forge/08-post-launch/ -- metrics, feedback log, iteration backlog

Forge enables beads issue tracking by default. Use --no-beads to disable it.

Select it: mold new my-product --kit forge

Without beads: mold new my-product --kit forge --no-beads

Custom kits

You can create your own kits with custom template files. See mold kit for registration and management.

A custom kit is a directory containing:

  1. kit.toml -- metadata file (required): 

    name = "my-kit"
description = "My custom project template"

  2. Template files -- any files you want rendered into new projects. Templates support Go text/template syntax with variables like {{ .ProjectName }}, {{ .Author }}, and {{ .TechStack }}.

Registering a custom kit

mold kit add ~/my-kits/react-kit

Using a custom kit

mold new my-app --kit react-kit

Setting as default

mold config set default-kit react-kit

All kits include

Regardless of which kit you choose, all built-in kits generate:

  • CLAUDE.md with project instructions
  • .claude/settings.json with allowed commands
  • .repomixignore and repomix.config.json for Repomix
  • Claude Code slash commands

The difference is in the workflow philosophy: Original uses markdown TODOs, Beads uses git-backed issue tracking, and Forge provides a full product lifecycle with eight guided phases.