gh-hurblat-claude-constructor-plugins-claude-constructor/commands/read-settings.md

name: read-settings description: Read settings and add to state management file argument-hint: [state-management-file-path] [--provider=<linear|jira|prompt>] [--silent=<true|false>] model: claude-haiku-4-5 allowed-tools: Read, Edit, Bash(git symbolic-ref:), Bash(git rev-parse:)

Read Settings Command

Purpose

Read Claude Constructor settings and add them to the state management file. Settings are determined by command arguments or auto-detection. These instructions are read and followed as part of a larger workflow. You MUST follow all workflow steps below, not skipping any step and doing all steps in order.

Arguments

• $1: Path to state management file (required)
• $2+: Optional settings in format --provider=<value> or --silent=<value>

Workflow Steps

1. Parse optional arguments ($2, $3, etc.) to extract settings overrides:

   • Look for --provider=<value> (valid: "linear", "jira", "prompt")
   • Look for --silent=<value> (valid: "true", "false")

2. Determine settings in this priority order:

   Issue Tracking Provider:

   • If --provider=<value> argument provided:
     • Validate it's one of: "linear", "jira", "prompt"
     • If "linear": Check that Linear MCP tools are available (try calling linear:list_teams or similar)
       • If NOT available: FAIL with error: "Provider set to 'linear' but Linear MCP tools are not configured. Please configure Linear MCP or use --provider=prompt"
     • If "jira": Check that Jira MCP tools are available (try calling jira:get_projects or similar)
       • If NOT available: FAIL with error: "Provider set to 'jira' but Jira MCP tools are not configured. Please configure Jira MCP or use --provider=prompt"
     • If "prompt": No validation needed
     • Use the validated provider value
   • Otherwise, auto-detect:
     • If Linear MCP tools are available → "linear"
     • If Jira MCP tools are available → "jira"
     • Otherwise → "prompt"

   Default Branch:

   • Auto-detect by running: git symbolic-ref refs/remotes/origin/HEAD --short
   • Parse the output to extract the branch name after "origin/" (e.g., "origin/main" → "main")
   • If that fails, try: git rev-parse --abbrev-ref origin/HEAD and parse similarly
   • If both fail, default to "main"

   Silent Mode:

   • If --silent=<value> argument provided, use it
   • Otherwise, default to "false"

3. Read the state management file ($1) to check if Settings section already exists

4. If Settings section exists:

   • Update the existing Settings section with the determined values
   • Use Edit tool to replace the Settings section

5. If Settings section does not exist:

   • Add a new Settings section to the state management file using Edit tool

   • Format:

     ## Settings
     - issueTrackingProvider: [value]
     - defaultBranch: [value]
     - silentMode: [value]