docs: clarify dev auto customization comments

Replace internal merge jargon and stale workflow comments with plain descriptions of the customization file behavior.
This commit is contained in:
Alex Verkhovsky 2026-06-23 04:48:16 -07:00
parent 682a2005af
commit 76d4154fca
1 changed files with 15 additions and 21 deletions

View File

@ -1,39 +1,33 @@
# DO NOT EDIT -- overwritten on every update. # DO NOT EDIT -- overwritten on every update.
# #
# Workflow customization surface for bmad-dev-auto. Mirrors the # Default customization values for bmad-dev-auto.
# agent customization shape under the [workflow] namespace. # Override in _bmad/custom/bmad-dev-auto.toml or
# _bmad/custom/bmad-dev-auto.user.toml.
#
# Merge rules:
# - Strings replace the default.
# - Lists append to the default list.
# - Tables merge key by key.
[workflow] [workflow]
# --- Configurable below. Overrides merge per BMad structural rules: --- # Extra instructions to run before config is loaded.
# scalars: override wins • arrays (persistent_facts, activation_steps_*): append
# arrays-of-tables with `code`/`id`: replace matching items, append new ones.
# Steps to run before the standard activation (config load).
# Overrides append. Use for pre-flight loads, compliance checks, etc.
activation_steps_prepend = [] activation_steps_prepend = []
# Steps to run after config load but before the workflow begins. # Extra instructions to run after config is loaded and before step 01.
# Overrides append. Use for context-heavy setup.
activation_steps_append = [] activation_steps_append = []
# Persistent facts the workflow keeps in mind for the whole run # Facts kept in context for the whole run.
# (standards, compliance constraints, stylistic guardrails). # Entries are literal text or file references prefixed with "file:".
# Distinct from the runtime memory sidecar — these are static context # File entries may use globs and are loaded during activation.
# loaded on activation. Overrides append.
#
# Each entry is either:
# - a literal sentence, e.g. "All stories must include testable acceptance criteria."
# - a file reference prefixed with `file:`, e.g. "file:{project-root}/docs/standards.md"
# (glob patterns are supported; the file's contents are loaded and treated as facts).
persistent_facts = [ persistent_facts = [
"file:{project-root}/**/project-context.md", "file:{project-root}/**/project-context.md",
] ]
# Scalar: final instruction run by HALT on every terminal path. Override wins. # Instruction run by HALT after writing the terminal result.
# Leave empty for no custom terminal behavior. # Empty means no extra terminal behavior.
on_complete = "" on_complete = ""