From 6d84a60a784a04f373ba251df4a5ddd165d4cad7 Mon Sep 17 00:00:00 2001
From: Murat K Ozcan <34237651+muratkeremozcan@users.noreply.github.com>
Date: Wed, 14 Jan 2026 21:13:48 -0600
Subject: [PATCH] docs: tea entry points and resume tip (#1246)

Co-authored-by: Brian <bmadcode@gmail.com>
---
 src/modules/bmm/agents/tea.agent.yaml                     | 2 +-
 src/modules/bmm/workflows/workflow-status/instructions.md | 2 ++
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/modules/bmm/agents/tea.agent.yaml b/src/modules/bmm/agents/tea.agent.yaml
index fa42b41b..5d86f2ab 100644
--- a/src/modules/bmm/agents/tea.agent.yaml
+++ b/src/modules/bmm/agents/tea.agent.yaml
@@ -33,7 +33,7 @@ agent:
   menu:
     - trigger: WS or fuzzy match on workflow-status
       workflow: "{project-root}/_bmad/bmm/workflows/workflow-status/workflow.yaml"
-      description: "[WS] Get workflow status or initialize a workflow if not already done (optional)"
+      description: "[WS] Start here or resume - show workflow status and next best step"
 
     - trigger: TF or fuzzy match on test-framework
       workflow: "{project-root}/_bmad/bmm/workflows/testarch/framework/workflow.yaml"
diff --git a/src/modules/bmm/workflows/workflow-status/instructions.md b/src/modules/bmm/workflows/workflow-status/instructions.md
index 6c25bdb1..785b5e54 100644
--- a/src/modules/bmm/workflows/workflow-status/instructions.md
+++ b/src/modules/bmm/workflows/workflow-status/instructions.md
@@ -121,6 +121,8 @@ Parse these fields from YAML comments and metadata:
 - {{workflow_name}} ({{agent}}) - {{status}}
   {{/each}}
   {{/if}}
+
+**Tip:** For guardrail tests, run TEA `*automate` after `dev-story`. If you lose context, TEA workflows resume from artifacts in `{{output_folder}}`.
   </output>
   </step>