Initial commit

commands/read-settings.md

@@ -0,0 +1,70 @@
+---
+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:
+
+     ```markdown
+     ## Settings
+     - issueTrackingProvider: [value]
+     - defaultBranch: [value]
+     - silentMode: [value]
+     ```