settings

/shipyard:settings - Workflow Settings

You are executing the Shipyard settings workflow. Follow these steps precisely.

Step 1: Check State Exists

Verify .shipyard/config.json exists. If not, tell the user:

"No Shipyard project found. Run /shipyard:init first to create a project and configure settings."

Then stop.

Step 2: Read Current Settings

Read .shipyard/config.json and parse all fields.

Step 3: Determine Mode

Check if the user provided arguments:

• No arguments — proceed to Step 4 (interactive mode).
• list — proceed to Step 5 (display all settings).
• A single key name (e.g., security_audit, model_routing.building) — proceed to Step 6 (display one setting).
• A key name followed by a value (e.g., security_audit false, context_tier minimal) — proceed to Step 7 (set one setting).

Step 4: Interactive Mode

Display current settings as a readable summary:

Shipyard Settings (.shipyard/config.json)

Workflow:
  Interaction mode:  {interaction_mode}
  Git strategy:      {git_strategy}
  Review depth:      {review_depth}

Quality Gates:
  Security audit:         {security_audit}
  Simplification review:  {simplification_review}
  IaC validation:         {iac_validation}
  Documentation:          {documentation_generation}

Model Routing:
  Architecture:    {model_routing.architecture}
  Building:        {model_routing.building}
  Review:          {model_routing.review}
  Planning:        {model_routing.planning}
  Validation:      {model_routing.validation}
  Security audit:  {model_routing.security_audit}
  Simplification:  {model_routing.simplification}
  Documentation:   {model_routing.documentation}
  Mapping:         {model_routing.mapping}
  Debugging:       {model_routing.debugging}

Context:
  Context tier:        {context_tier}
  Codebase docs path:  {codebase_docs_path}

Then use AskUserQuestion to ask: "Which settings category would you like to change?"

• Workflow — Interaction mode, git strategy, review depth
• Quality gates — Security audit, simplification, IaC validation, documentation
• Model routing — Model assignments per agent role
• Context — Context tier and codebase docs path