~/.weave/                    # Global config root
├── config.weave             # Global agent/category/workflow definitions
└── prompts/                 # Global prompt files
    └── my-agent.md

.weave/                      # Project config root
├── config.weave             # Project agent/category/workflow definitions
├── prompts/                 # Project prompt files
│   ├── loom.md
│   ├── shuttle.md
│   └── custom-agent.md
├── plans/                   # Plan files (created by Pattern agent)
└── workflows/               # Additional workflow files (optional)

┌─────────────────────────────────────────────────────────────┐
│  Layer 1 (lowest priority)  —  Built-ins                    │
│    packages/config/src/builtins.ts — BUILTIN_WEAVE_SOURCE   │
│                                                             │
│  Layer 2                    —  Global                       │
│    ~/.weave/config.weave                                    │
│                                                             │
│  Layer 3 (highest priority) —  Project                      │
│    <projectRoot>/.weave/config.weave                        │
└─────────────────────────────────────────────────────────────┘

agent loom {
  temperature 0.5
}

agent shuttle {
  description "Shuttle (Domain Specialist)"
  prompt_file "shuttle.md"
  models ["claude-sonnet-4-5"]
  mode subagent
  temperature 0.2

  tool_policy {
    read allow
    write allow
    execute allow
    delegate deny
    network ask
  }
}

agent shuttle {
  temperature 0.1
  models ["gpt-4o", "claude-sonnet-4-5"]

  tool_policy {
    network deny
  }
}

agent shuttle {
  description "Shuttle (Domain Specialist)"
  prompt_file "shuttle.md"
  models ["gpt-4o", "claude-sonnet-4-5"]  # Array union-merge: project first
  mode subagent
  temperature 0.1                          # Scalar override

  tool_policy {                            # Object deep-merge
    read allow
    write allow
    execute allow
    delegate deny
    network deny                           # Overridden from project
  }
}

# This is a comment
agent my-agent {
  description "My custom agent"
  prompt """
    You are a helpful assistant.
    You answer questions concisely.
  """
  models ["claude-sonnet-4-5", "gpt-4o"]
  mode subagent
  temperature 0.3

  tool_policy {
    read allow
    write deny
  }
}

agent loom {
  description "Loom (Main Orchestrator)"
  prompt_file "loom.md"
  models ["claude-sonnet-4-5", "gpt-4o"]
  mode primary
  temperature 0.1
  variant "preview"

  tool_policy {
    read allow
    write allow
    execute allow
    delegate allow
    network ask
  }

  triggers [
    { domain "Orchestration" trigger "Complex multi-step tasks" routing_hint "Use for work spanning multiple files or components" }
    { domain "Architecture" trigger "System design and planning" routing_hint "Use when design decisions need to be made before implementation" }
  ]

  skills ["tdd", "code-review"]
}

# Minimal agent with inline prompt
agent my-helper {
  prompt "You are a helpful assistant that answers questions concisely."
  models ["claude-sonnet-4-5"]
  mode subagent
  temperature 0.3
}

tool_policy {
  read    allow
  write   allow
  execute allow
  delegate deny
  network ask
}

agent warp {
  description "Warp (Security Reviewer)"
  prompt_file "warp.md"
  models ["claude-sonnet-4-5"]
  mode subagent

  review_models ["openai/gpt-4o", "anthropic/claude-opus-4-5"]
}

category backend {
  description "Backend APIs, services, persistence"
  models ["anthropic/claude-sonnet-4-5"]
  patterns ["src/api/**", "src/server/**", "src/db/**", "**/*.go"]
  prompt_append "Focus on API contracts, data integrity, and backwards compatibility."
  temperature 0.2

  tool_policy {
    read allow
    write allow
    delegate deny
  }
}

category frontend {
  description "Frontend UI, styling, accessibility"
  models ["openai/gpt-5"]
  patterns ["src/components/**", "src/pages/**", "**/*.tsx", "**/*.css"]
  prompt_append "Preserve accessibility, responsive behavior, and design-system consistency."
}

workflow secure-feature {
  description "Plan, implement, build, and review a feature with security audit"
  version 1

  step plan {
    name "Create implementation plan"
    type autonomous
    agent pattern
    prompt "Create a detailed implementation plan for: {{instance.goal}}"

    completion plan_created {
      plan_name "{{instance.slug}}"
    }

    outputs [
      { name "plan_path" description "Path to the generated plan file" }
    ]
  }

  step review-plan {
    name "Review the plan"
    type interactive
    agent shuttle
    prompt "Review the plan at {{artifacts.plan_path}} for: {{instance.goal}}"
    completion user_confirm
  }

  step implement {
    name "Execute the plan"
    type autonomous
    agent shuttle
    prompt "Execute the plan at {{artifacts.plan_path}} for: {{instance.goal}}"

    completion plan_complete {
      plan_name "{{instance.slug}}"
    }

    inputs [
      { name "plan_path" description "Path to the plan to execute" }
    ]
  }

  step security-review {
    name "Security audit"
    type gate
    agent warp
    prompt "Perform a security audit of all changes for: {{instance.goal}}"
    completion review_verdict
    on_reject pause
  }
}

workflow plan-and-execute {
  extends "plan-and-execute"   # name of the base workflow
  version 1

  # Insert a new step before an existing one
  step spec {
    name "Write spec"
    type autonomous
    agent pattern
    prompt "Write a spec for: {{instance.goal}}"
    completion agent_signal
    insert_before "plan"
  }

  # Replace an existing step by same name
  step implement {
    name "Execute the plan (custom)"
    type autonomous
    agent shuttle
    prompt "Custom implementation prompt"
    completion plan_complete { plan_name "{{instance.slug}}" }
  }
}

extend before-plan ["write-spec", "review-spec"]

disable agents ["warp", "spindle"]
disable hooks ["on-session-idle"]
disable skills ["tdd"]

settings {
  log_level INFO
}

continuation {
  recovery {
    compaction true
  }
  idle {
    enabled true
    work true
    workflow true
  }
}

analytics {
  enabled true
  use_fingerprint false
}

You are {{agent.name}}.

{{#delegation.targets}}
- **{{name}}**{{#description}} — {{description}}{{/description}}
{{/delegation.targets}}

agent shuttle {
  description "Shuttle (Domain Specialist)"
  prompt_file "shuttle.md"
  models ["claude-sonnet-4-5", "gpt-4o"]
  mode subagent
  temperature 0.2
  variant "preview"

  tool_policy {
    read allow
    write allow
    execute allow
    delegate deny
    network ask
  }

  triggers [
    { domain "Implementation" trigger "Focused code changes" routing_hint "Use for bounded, file-scoped work" }
    { domain "Testing" trigger "Test writing and debugging" routing_hint "Use when tests need to be written or fixed" }
  ]

  skills ["tdd", "code-review"]
}

category backend {
  description "Backend APIs, services, persistence"
  models ["anthropic/claude-sonnet-4-5"]
  patterns ["src/api/**", "src/server/**", "src/db/**", "**/*.go"]
  prompt_append """
    Focus on:
    - API contracts and backwards compatibility
    - Data integrity and validation
    - Error handling and logging
    - Performance and scalability
  """
  temperature 0.2

  tool_policy {
    read allow
    write allow
    execute allow
    delegate deny
    network deny
  }
}

workflow feature-with-review {
  description "Plan, implement, test, and review a feature"
  version 1

  step plan {
    name "Create implementation plan"
    type autonomous
    agent pattern
    prompt "Create a detailed implementation plan for: {{instance.goal}}"

    completion plan_created {
      plan_name "{{instance.slug}}"
    }

    outputs [
      { name "plan_path" description "Path to the generated plan file" }
    ]
  }

  step implement {
    name "Execute the plan"
    type autonomous
    agent shuttle
    prompt "Execute the plan at {{artifacts.plan_path}} for: {{instance.goal}}"

    completion plan_complete {
      plan_name "{{instance.slug}}"
    }

    inputs [
      { name "plan_path" description "Path to the plan to execute" }
    ]
  }

  step test {
    name "Run tests"
    type autonomous
    agent shuttle
    prompt "Run all tests and verify they pass for: {{instance.goal}}"
    completion agent_signal
  }

  step review {
    name "Code review"
    type gate
    agent weft
    prompt "Review all changes for: {{instance.goal}}"
    completion review_verdict
    on_reject pause
  }
}

# Disable specific agents
disable agents ["spindle", "warp"]

# Disable specific skills
disable skills ["experimental-feature"]

# Configure logging
settings {
  log_level DEBUG
}

# Configure session continuation
continuation {
  recovery {
    compaction true
  }
  idle {
    enabled true
    work true
    workflow false
  }
}

# Configure analytics
analytics {
  enabled false
  use_fingerprint false
}