diff --git a/src/core/tasks/help.md b/src/core/tasks/help.md index 4e060ea1..c3c3fab1 100644 --- a/src/core/tasks/help.md +++ b/src/core/tasks/help.md @@ -54,13 +54,15 @@ Determine what was just completed: 1. **Load catalog** — Load `{project-root}/_bmad/_config/bmad-help.csv` -2. **Resolve output locations** — Scan each folder under `_bmad/` (except `_config`) for `config.yaml`. For each workflow row, resolve its `output-location` variables against that module's config so artifact paths can be searched. +2. **Resolve output locations and config** — Scan each folder under `_bmad/` (except `_config`) for `config.yaml`. For each workflow row, resolve its `output-location` variables against that module's config so artifact paths can be searched. Also extract `communication_language` and `project_knowledge` from each scanned module's config. -3. **Detect active module** — Use MODULE DETECTION above +3. **Ground in project knowledge** — If `project_knowledge` resolves to an existing path, read available documentation files (architecture docs, project overview, tech stack references) for grounding context. Use discovered project facts when composing any project-specific output. Never fabricate project-specific details — if documentation is unavailable, state so. -4. **Analyze input** — Task may provide a workflow name/code, conversational phrase, or nothing. Infer what was just completed using INPUT ANALYSIS above. +4. **Detect active module** — Use MODULE DETECTION above -5. **Present recommendations** — Show next steps based on: +5. **Analyze input** — Task may provide a workflow name/code, conversational phrase, or nothing. Infer what was just completed using INPUT ANALYSIS above. + +6. **Present recommendations** — Show next steps based on: - Completed workflows detected - Phase/sequence ordering (ROUTING RULES) - Artifact presence @@ -74,9 +76,10 @@ Determine what was just completed: - **Agent** title and display name from the CSV (e.g., "🎨 Alex (Designer)") - Brief **description** -6. **Additional guidance to convey**: +7. **Additional guidance to convey**: + - Present all output in `{communication_language}` - Run each workflow in a **fresh context window** - For **validation workflows**: recommend using a different high-quality LLM if available - For conversational requests: match the user's tone while presenting clearly -7. Return to the calling process after presenting recommendations. +8. Return to the calling process after presenting recommendations.