generate-claude-md

Generate CLAUDE.md

Generate or update a project's CLAUDE.md by rendering the Digital Service Orchestra template with project-specific command values from .claude/dso-config.conf.

Usage

/dso:generate-claude-md              # Generate CLAUDE.md for current directory
/dso:generate-claude-md [project-dir] # Generate for a specific project directory

---

Steps

Step 1: Read Config

Load the project's command values via read-config.sh (located at .claude/scripts/dso read-config.sh):

PLUGIN_SCRIPTS="${CLAUDE_PLUGIN_ROOT}/scripts"

VALIDATE_CMD=$(bash "$PLUGIN_SCRIPTS/read-config.sh" commands.validate)  # shim-exempt: internal orchestration script
FORMAT_CMD=$(bash "$PLUGIN_SCRIPTS/read-config.sh" commands.format)  # shim-exempt: internal orchestration script
TEST_CMD=$(bash "$PLUGIN_SCRIPTS/read-config.sh" commands.test)  # shim-exempt: internal orchestration script
LINT_CMD=$(bash "$PLUGIN_SCRIPTS/read-config.sh" commands.lint)  # shim-exempt: internal orchestration script

Resolution order used by read-config.sh:

1. .claude/dso-config.conf at $(pwd)/.claude/dso-config.conf (project root — canonical path)
2. Make target fallback: if config is absent or key is empty, fall back to make <target> convention
3. Skip with warning if neither config nor make target found

Step 2: Load Template

Read the CLAUDE.md template from the plugin:

TEMPLATE_FILE="${CLAUDE_PLUGIN_ROOT}/templates/CLAUDE.md.template"
TEMPLATE_CONTENT=$(cat "$TEMPLATE_FILE")

Step 3: Substitute Placeholders

Replace {{key}} placeholders with resolved config values using sed or bash parameter expansion:

GENERATED=$(echo "$TEMPLATE_CONTENT" \
  | sed "s|{{commands.validate}}|${VALIDATE_CMD}|g" \
  | sed "s|{{commands.format}}|${FORMAT_CMD}|g" \
  | sed "s|{{commands.test}}|${TEST_CMD}|g" \
  | sed "s|{{commands.lint}}|${LINT_CMD}|g")

All placeholder tokens use the {{commands.validate}}, {{commands.format}}, {{commands.test}}, and {{commands.lint}} format (mustache-style double braces).