Skip to content

CONFIGURATION.md

Latest commit

 

History

History
117 lines (81 loc) · 3.41 KB

CONFIGURATION.md

File metadata and controls

117 lines (81 loc) · 3.41 KB
Raw

Configuration

NomadWorks reads repository-local configuration from .nomadworks/nomadworks.yaml.

This file is typically created during the PMA-led repository setup flow.

Minimal config

enabled: true
team_mode: full

defaults:
  # provider: openai
  # model: gpt-5.4

features:
  debug_dumps: true
  codemap_verification: true

policies:
  extract_defaults: none

agents:
  product_manager:
    enabled: true

Top-level sections

  • enabled: Turns the NomadWorks agent set on for the repository.
  • team_mode: The supported team preset. Use mini for PMA + BA + Tech Lead only, or full for the complete collective. If omitted in an existing repository, NomadWorks defaults to full.
  • defaults: Shared defaults for providers, models, permissions, and other agent config fields.
  • features: Plugin feature flags such as debug dumps and validation behavior.
  • policies: Policy extraction controls for generated reference policy files.
  • agents: Per-agent enablement and config overrides from nomadworks.yaml.

Supported team modes

mini

  • Enabled by default: product_manager, business_analyst, tech_lead
  • Intended for: tiny and standard tasks in simple repositories
  • Not supported: complex work and workflow_runner

full

  • Enables the full NomadWorks Collective by default
  • Intended for: repositories that need the complete role set, including workflow_runner
  • Supports: tiny, standard, and complex

Common uses

Override a model for one agent

agents:
  developer:
    provider: openai
    model: gpt-5.4

Disable an optional agent in a repo

agents:
  ui_ux_designer:
    enabled: false

Mandatory agents cannot be disabled:

  • product_manager
  • business_analyst
  • tech_lead

Extend agent tools

agents:
  workflow_runner:
    tools_add:
      - nomadworks_validate

Generate bundled policy references

policies:
  extract_defaults: all

This writes the bundled default policy files to .nomadworks/generated/policies/ for reference. Those generated files are not used directly at runtime. To customize one, copy it into .nomadworks/policies/ and edit the copy.

Add repository-specific agent instructions

Create .nomadworks/agent-additions/<agent>.md to append repository-specific instructions to a bundled or custom agent prompt.

Add repository-local agents or override a bundled base prompt

Create .nomadworks/agents/<agent>.md to:

  • replace the bundled base prompt for an existing agent, or
  • define a brand new custom repository agent

Operational notes

  • The product_manager agent becomes the default primary agent when NomadWorks is enabled.
  • Repository-local full agent definitions can live in .nomadworks/agents/.
  • Repository-local additive agent instructions can live in .nomadworks/agent-additions/.
  • Repository-local policy overrides can live in .nomadworks/policies/.
  • Generated reference policy files are written to .nomadworks/generated/policies/ when policies.extract_defaults is set to all.
  • Final agent prompts are dumped to .nomadworks/generated/agents/ when features.debug_dumps is enabled.

Feature flags

  • features.keep_builtin_agents: when true, NomadWorks will not disable agents that OpenCode already registered, including built-in agents such as build, plan, general, and explore. NomadWorks will still set product_manager as the default agent.