Local Configuration

Project-specific devloop settings via .devloop/local.md (NOT git-tracked).

Format

YAML frontmatter followed by optional markdown notes:

---
git:
  auto-branch: false           # Create branch when plan starts
  branch-pattern: "feat/{slug}" # {slug}, {date}, {user}
  main-branch: main
  pr-on-complete: ask          # ask | always | never

commits:
  style: conventional          # conventional | simple
  scope-from-plan: true
  sign: false

review:
  before-commit: ask           # ask | always | never
  use-plugin: null             # null | code-review | pr-review-toolkit

github:
  link-issues: false           # Enable GH issue linking
  auto-close: ask              # ask | always | never
  comment-on-complete: true
---

Settings Reference

Example Configurations

Minimal (Git-aware)

---
git:
  auto-branch: true
---

Full CI/CD Workflow

---
git:
  auto-branch: true
  pr-on-complete: always
commits:
  style: conventional
  sign: true
review:
  before-commit: always
  use-plugin: pr-review-toolkit
---

Issue-Driven Development

---
git:
  auto-branch: true
  pr-on-complete: always
github:
  link-issues: true
  auto-close: always
  comment-on-complete: true
---

Context & Performance

---
fresh_threshold: 10            # Tasks before suggesting /devloop:fresh (default: 10)
context_threshold: 70          # Exit ralph loop at this context % (default: 70)
---

Plugin Integration

---
plugins:
  superpowers-suggestions: false  # Disable seeAlso to superpowers skills
---

Usage

• Edit .devloop/local.md directly; changes take effect on next command
• Parsed by ${CLAUDE_PLUGIN_ROOT}/scripts/parse-local-config.sh
• Add to .gitignore to keep local-only