Deployment fix for HF

.agent/skills/agent-browser/SKILL.md

@@ -0,0 +1,58 @@
+---
+name: Agent Browser
+description: Automated browser verification using Vercel Agent Browser (Snapshot + Refs workflow)
+---
+
+# Agent Browser Skill
+
+The [Vercel Agent Browser](https://github.com/vercel-labs/agent-browser) is a specialized tool for AI agents that uses a "Snapshot + Refs" workflow to minimize context usage while providing reliable browser automation.
+
+## Setup & Lifecycle
+
+To avoid permission issues and preserve project state, always use a local `AGENT_BROWSER_HOME` directory.
+
+### 1. Installation
+```bash
+npm install agent-browser
+npx agent-browser install
+```
+
+### 2. Start the Daemon
+The daemon manages the Playwright browser instance. Run it in the background:
+```bash
+mkdir -p .agent-browser-home
+AGENT_BROWSER_HOME=$(pwd)/.agent-browser-home node node_modules/agent-browser/dist/daemon.js > daemon.log 2>&1 &
+```
+
+### 3. Cleanup
+Kill the daemon and any child Chromium processes when finished:
+```bash
+kill $(lsof -ti :3000) # Optional: if app needs restart
+ps aux | grep daemon.js | grep -v grep | awk '{print $2}' | xargs kill
+```
+
+## Core Workflow
+
+### Snapshot-Based Interaction
+1. **Open Page**: `AGENT_BROWSER_HOME=$(pwd)/.agent-browser-home ./node_modules/agent-browser/bin/agent-browser-darwin-arm64 open http://localhost:3000`
+2. **Get Interactive Refs**: `AGENT_BROWSER_HOME=$(pwd)/.agent-browser-home ./node_modules/agent-browser/bin/agent-browser-darwin-arm64 snapshot -i`
+3. **Interact by Ref**:
+   - `fill @e1 "Text"`
+   - `click @e4`
+4. **Visual Check**: `AGENT_BROWSER_HOME=$(pwd)/.agent-browser-home ./node_modules/agent-browser/bin/agent-browser-darwin-arm64 screenshot output.png`
+
+## Common Commands Reference
+
+| Command | Usage |
+|---------|-------|
+| `open <url>` | Navigates to a URL |
+| `snapshot -i` | Returns accessibility tree with `@eX` references for interactive elements |
+| `fill <ref/selector> <text>` | Types into an input |
+| `click <ref/selector>` | Clicks an element |
+| `screenshot [name]` | Takes a screenshot |
+| `wait <ms/selector>` | Waits for a condition |
+
+## Best Practices
+- **Better Auth Integration**: Ensure `BETTER_AUTH_URL` and `BETTER_AUTH_SECRET` are set in `.env.local` to prevent redirection warnings/errors during automation.
+- **Port Management**: If the dev server fails to bind to 3000, check `lsof -i :3000` and kill hanging processes.
+- **Darwin Binaries**: On Apple Silicon Mac, use the `agent-browser-darwin-arm64` binary directly from `node_modules/agent-browser/bin/`.

.agent/workflows/bmad-agent-bmad-master.md

@@ -0,0 +1,15 @@
+---
+name: 'bmad-master'
+description: 'bmad-master agent'
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/_bmad/core/agents/bmad-master.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>

.agent/workflows/bmad-agent-bmm-analyst.md

@@ -0,0 +1,15 @@
+---
+name: 'analyst'
+description: 'analyst agent'
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/_bmad/bmm/agents/analyst.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>

.agent/workflows/bmad-agent-bmm-architect.md

@@ -0,0 +1,15 @@
+---
+name: 'architect'
+description: 'architect agent'
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/_bmad/bmm/agents/architect.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>

.agent/workflows/bmad-agent-bmm-dev.md

@@ -0,0 +1,15 @@
+---
+name: 'dev'
+description: 'dev agent'
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/_bmad/bmm/agents/dev.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>

.agent/workflows/bmad-agent-bmm-pm.md

@@ -0,0 +1,15 @@
+---
+name: 'pm'
+description: 'pm agent'
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/_bmad/bmm/agents/pm.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>

.agent/workflows/bmad-agent-bmm-quick-flow-solo-dev.md

@@ -0,0 +1,15 @@
+---
+name: 'quick-flow-solo-dev'
+description: 'quick-flow-solo-dev agent'
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/_bmad/bmm/agents/quick-flow-solo-dev.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>

.agent/workflows/bmad-agent-bmm-quinn.md

@@ -0,0 +1,15 @@
+---
+name: 'quinn'
+description: 'quinn agent'
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/_bmad/bmm/agents/quinn.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>

.agent/workflows/bmad-agent-bmm-sm.md

@@ -0,0 +1,15 @@
+---
+name: 'sm'
+description: 'sm agent'
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/_bmad/bmm/agents/sm.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>

.agent/workflows/bmad-agent-bmm-tech-writer.md

@@ -0,0 +1,15 @@
+---
+name: 'tech-writer'
+description: 'tech-writer agent'
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/_bmad/bmm/agents/tech-writer/tech-writer.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>

.agent/workflows/bmad-agent-bmm-ux-designer.md

@@ -0,0 +1,15 @@
+---
+name: 'ux-designer'
+description: 'ux-designer agent'
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/_bmad/bmm/agents/ux-designer.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>

.agent/workflows/bmad-bmm-check-implementation-readiness.md

@@ -0,0 +1,6 @@
+---
+name: 'check-implementation-readiness'
+description: 'Critical validation workflow that assesses PRD, Architecture, and Epics & Stories for completeness and alignment before implementation. Uses adversarial review approach to find gaps and issues.'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL @{project-root}/_bmad/bmm/workflows/3-solutioning/check-implementation-readiness/workflow.md, READ its entire contents and follow its directions exactly!

.agent/workflows/bmad-bmm-code-review.md

@@ -0,0 +1,14 @@
+---
+name: 'code-review'
+description: 'Perform an ADVERSARIAL Senior Developer code review that finds 3-10 specific problems in every story. Challenges everything: code quality, test coverage, architecture compliance, security, performance. NEVER accepts `looks good` - must find minimum issues and can auto-fix with user approval.'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:
+
+<steps CRITICAL="TRUE">
+1. Always LOAD the FULL @{project-root}/_bmad/core/tasks/workflow.xml
+2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config @{project-root}/_bmad/bmm/workflows/4-implementation/code-review/workflow.yaml
+3. Pass the yaml path @{project-root}/_bmad/bmm/workflows/4-implementation/code-review/workflow.yaml as 'workflow-config' parameter to the workflow.xml instructions
+4. Follow workflow.xml instructions EXACTLY as written to process and follow the specific workflow config and its instructions
+5. Save outputs after EACH section when generating any documents from templates
+</steps>

.agent/workflows/bmad-bmm-correct-course.md

@@ -0,0 +1,14 @@
+---
+name: 'correct-course'
+description: 'Navigate significant changes during sprint execution by analyzing impact, proposing solutions, and routing for implementation'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:
+
+<steps CRITICAL="TRUE">
+1. Always LOAD the FULL @{project-root}/_bmad/core/tasks/workflow.xml
+2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config @{project-root}/_bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml
+3. Pass the yaml path @{project-root}/_bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml as 'workflow-config' parameter to the workflow.xml instructions
+4. Follow workflow.xml instructions EXACTLY as written to process and follow the specific workflow config and its instructions
+5. Save outputs after EACH section when generating any documents from templates
+</steps>

.agent/workflows/bmad-bmm-create-architecture.md

@@ -0,0 +1,6 @@
+---
+name: 'create-architecture'
+description: 'Collaborative architectural decision facilitation for AI-agent consistency. Replaces template-driven architecture with intelligent, adaptive conversation that produces a decision-focused architecture document optimized for preventing agent conflicts.'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL @{project-root}/_bmad/bmm/workflows/3-solutioning/create-architecture/workflow.md, READ its entire contents and follow its directions exactly!

.agent/workflows/bmad-bmm-create-epics-and-stories.md

@@ -0,0 +1,6 @@
+---
+name: 'create-epics-and-stories'
+description: 'Transform PRD requirements and Architecture decisions into comprehensive stories organized by user value. This workflow requires completed PRD + Architecture documents (UX recommended if UI exists) and breaks down requirements into implementation-ready epics and user stories that incorporate all available technical and design context. Creates detailed, actionable stories with complete acceptance criteria for development teams.'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL @{project-root}/_bmad/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md, READ its entire contents and follow its directions exactly!

.agent/workflows/bmad-bmm-create-excalidraw-dataflow.md

@@ -0,0 +1,14 @@
+---
+name: 'create-excalidraw-dataflow'
+description: 'Create data flow diagrams (DFD) in Excalidraw format'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:
+
+<steps CRITICAL="TRUE">
+1. Always LOAD the FULL @{project-root}/_bmad/core/tasks/workflow.xml
+2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config @{project-root}/_bmad/bmm/workflows/excalidraw-diagrams/create-dataflow/workflow.yaml
+3. Pass the yaml path @{project-root}/_bmad/bmm/workflows/excalidraw-diagrams/create-dataflow/workflow.yaml as 'workflow-config' parameter to the workflow.xml instructions
+4. Follow workflow.xml instructions EXACTLY as written to process and follow the specific workflow config and its instructions
+5. Save outputs after EACH section when generating any documents from templates
+</steps>

.agent/workflows/bmad-bmm-create-excalidraw-diagram.md

@@ -0,0 +1,14 @@
+---
+name: 'create-excalidraw-diagram'
+description: 'Create system architecture diagrams, ERDs, UML diagrams, or general technical diagrams in Excalidraw format'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:
+
+<steps CRITICAL="TRUE">
+1. Always LOAD the FULL @{project-root}/_bmad/core/tasks/workflow.xml
+2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config @{project-root}/_bmad/bmm/workflows/excalidraw-diagrams/create-diagram/workflow.yaml
+3. Pass the yaml path @{project-root}/_bmad/bmm/workflows/excalidraw-diagrams/create-diagram/workflow.yaml as 'workflow-config' parameter to the workflow.xml instructions
+4. Follow workflow.xml instructions EXACTLY as written to process and follow the specific workflow config and its instructions
+5. Save outputs after EACH section when generating any documents from templates
+</steps>

.agent/workflows/bmad-bmm-create-excalidraw-flowchart.md

@@ -0,0 +1,14 @@
+---
+name: 'create-excalidraw-flowchart'
+description: 'Create a flowchart visualization in Excalidraw format for processes, pipelines, or logic flows'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:
+
+<steps CRITICAL="TRUE">
+1. Always LOAD the FULL @{project-root}/_bmad/core/tasks/workflow.xml
+2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config @{project-root}/_bmad/bmm/workflows/excalidraw-diagrams/create-flowchart/workflow.yaml
+3. Pass the yaml path @{project-root}/_bmad/bmm/workflows/excalidraw-diagrams/create-flowchart/workflow.yaml as 'workflow-config' parameter to the workflow.xml instructions
+4. Follow workflow.xml instructions EXACTLY as written to process and follow the specific workflow config and its instructions
+5. Save outputs after EACH section when generating any documents from templates
+</steps>

.agent/workflows/bmad-bmm-create-excalidraw-wireframe.md

@@ -0,0 +1,14 @@
+---
+name: 'create-excalidraw-wireframe'
+description: 'Create website or app wireframes in Excalidraw format'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:
+
+<steps CRITICAL="TRUE">
+1. Always LOAD the FULL @{project-root}/_bmad/core/tasks/workflow.xml
+2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config @{project-root}/_bmad/bmm/workflows/excalidraw-diagrams/create-wireframe/workflow.yaml
+3. Pass the yaml path @{project-root}/_bmad/bmm/workflows/excalidraw-diagrams/create-wireframe/workflow.yaml as 'workflow-config' parameter to the workflow.xml instructions
+4. Follow workflow.xml instructions EXACTLY as written to process and follow the specific workflow config and its instructions
+5. Save outputs after EACH section when generating any documents from templates
+</steps>

.agent/workflows/bmad-bmm-create-prd.md

@@ -0,0 +1,6 @@
+---
+name: 'create-prd'
+description: 'PRD tri-modal workflow - Create, Validate, or Edit comprehensive PRDs'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL @{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-prd/workflow.md, READ its entire contents and follow its directions exactly!

.agent/workflows/bmad-bmm-create-product-brief.md

@@ -0,0 +1,6 @@
+---
+name: 'create-product-brief'
+description: 'Create comprehensive product briefs through collaborative step-by-step discovery as creative Business Analyst working with the user as peers.'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL @{project-root}/_bmad/bmm/workflows/1-analysis/create-product-brief/workflow.md, READ its entire contents and follow its directions exactly!

.agent/workflows/bmad-bmm-create-story.md

@@ -0,0 +1,14 @@
+---
+name: 'create-story'
+description: 'Create the next user story from epics+stories with enhanced context analysis and direct ready-for-dev marking'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:
+
+<steps CRITICAL="TRUE">
+1. Always LOAD the FULL @{project-root}/_bmad/core/tasks/workflow.xml
+2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config @{project-root}/_bmad/bmm/workflows/4-implementation/create-story/workflow.yaml
+3. Pass the yaml path @{project-root}/_bmad/bmm/workflows/4-implementation/create-story/workflow.yaml as 'workflow-config' parameter to the workflow.xml instructions
+4. Follow workflow.xml instructions EXACTLY as written to process and follow the specific workflow config and its instructions
+5. Save outputs after EACH section when generating any documents from templates
+</steps>

.agent/workflows/bmad-bmm-create-ux-design.md

@@ -0,0 +1,6 @@
+---
+name: 'create-ux-design'
+description: 'Work with a peer UX Design expert to plan your applications UX patterns, look and feel.'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL @{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md, READ its entire contents and follow its directions exactly!

.agent/workflows/bmad-bmm-dev-story.md

@@ -0,0 +1,14 @@
+---
+name: 'dev-story'
+description: 'Execute a story by implementing tasks/subtasks, writing tests, validating, and updating the story file per acceptance criteria'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:
+
+<steps CRITICAL="TRUE">
+1. Always LOAD the FULL @{project-root}/_bmad/core/tasks/workflow.xml
+2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config @{project-root}/_bmad/bmm/workflows/4-implementation/dev-story/workflow.yaml
+3. Pass the yaml path @{project-root}/_bmad/bmm/workflows/4-implementation/dev-story/workflow.yaml as 'workflow-config' parameter to the workflow.xml instructions
+4. Follow workflow.xml instructions EXACTLY as written to process and follow the specific workflow config and its instructions
+5. Save outputs after EACH section when generating any documents from templates
+</steps>

.agent/workflows/bmad-bmm-document-project.md

@@ -0,0 +1,14 @@
+---
+name: 'document-project'
+description: 'Analyzes and documents brownfield projects by scanning codebase, architecture, and patterns to create comprehensive reference documentation for AI-assisted development'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:
+
+<steps CRITICAL="TRUE">
+1. Always LOAD the FULL @{project-root}/_bmad/core/tasks/workflow.xml
+2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config @{project-root}/_bmad/bmm/workflows/document-project/workflow.yaml
+3. Pass the yaml path @{project-root}/_bmad/bmm/workflows/document-project/workflow.yaml as 'workflow-config' parameter to the workflow.xml instructions
+4. Follow workflow.xml instructions EXACTLY as written to process and follow the specific workflow config and its instructions
+5. Save outputs after EACH section when generating any documents from templates
+</steps>

.agent/workflows/bmad-bmm-qa-automate.md

@@ -0,0 +1,14 @@
+---
+name: 'qa-automate'
+description: 'Generate tests quickly for existing features using standard test patterns'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:
+
+<steps CRITICAL="TRUE">
+1. Always LOAD the FULL @{project-root}/_bmad/core/tasks/workflow.xml
+2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config @{project-root}/_bmad/bmm/workflows/qa/automate/workflow.yaml
+3. Pass the yaml path @{project-root}/_bmad/bmm/workflows/qa/automate/workflow.yaml as 'workflow-config' parameter to the workflow.xml instructions
+4. Follow workflow.xml instructions EXACTLY as written to process and follow the specific workflow config and its instructions
+5. Save outputs after EACH section when generating any documents from templates
+</steps>

.agent/workflows/bmad-bmm-quick-dev.md

@@ -0,0 +1,6 @@
+---
+name: 'quick-dev'
+description: 'Flexible development - execute tech-specs OR direct instructions with optional planning.'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL @{project-root}/_bmad/bmm/workflows/bmad-quick-flow/quick-dev/workflow.md, READ its entire contents and follow its directions exactly!

.agent/workflows/bmad-bmm-quick-spec.md

@@ -0,0 +1,6 @@
+---
+name: 'quick-spec'
+description: 'Conversational spec engineering - ask questions, investigate code, produce implementation-ready tech-spec.'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL @{project-root}/_bmad/bmm/workflows/bmad-quick-flow/quick-spec/workflow.md, READ its entire contents and follow its directions exactly!

.agent/workflows/bmad-bmm-research.md

@@ -0,0 +1,6 @@
+---
+name: 'research'
+description: 'Conduct comprehensive research across multiple domains using current web data and verified sources - Market, Technical, Domain and other research types.'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL @{project-root}/_bmad/bmm/workflows/1-analysis/research/workflow.md, READ its entire contents and follow its directions exactly!

.agent/workflows/bmad-bmm-retrospective.md

@@ -0,0 +1,14 @@
+---
+name: 'retrospective'
+description: 'Run after epic completion to review overall success, extract lessons learned, and explore if new information emerged that might impact the next epic'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:
+
+<steps CRITICAL="TRUE">
+1. Always LOAD the FULL @{project-root}/_bmad/core/tasks/workflow.xml
+2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config @{project-root}/_bmad/bmm/workflows/4-implementation/retrospective/workflow.yaml
+3. Pass the yaml path @{project-root}/_bmad/bmm/workflows/4-implementation/retrospective/workflow.yaml as 'workflow-config' parameter to the workflow.xml instructions
+4. Follow workflow.xml instructions EXACTLY as written to process and follow the specific workflow config and its instructions
+5. Save outputs after EACH section when generating any documents from templates
+</steps>

.agent/workflows/bmad-bmm-sprint-planning.md

@@ -0,0 +1,14 @@
+---
+name: 'sprint-planning'
+description: 'Generate and manage the sprint status tracking file for Phase 4 implementation, extracting all epics and stories from epic files and tracking their status through the development lifecycle'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:
+
+<steps CRITICAL="TRUE">
+1. Always LOAD the FULL @{project-root}/_bmad/core/tasks/workflow.xml
+2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config @{project-root}/_bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml
+3. Pass the yaml path @{project-root}/_bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml as 'workflow-config' parameter to the workflow.xml instructions
+4. Follow workflow.xml instructions EXACTLY as written to process and follow the specific workflow config and its instructions
+5. Save outputs after EACH section when generating any documents from templates
+</steps>

.agent/workflows/bmad-bmm-sprint-status.md

@@ -0,0 +1,14 @@
+---
+name: 'sprint-status'
+description: 'Summarize sprint-status.yaml, surface risks, and route to the right implementation workflow.'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:
+
+<steps CRITICAL="TRUE">
+1. Always LOAD the FULL @{project-root}/_bmad/core/tasks/workflow.xml
+2. READ its entire contents - this is the CORE OS for EXECUTING the specific workflow-config @{project-root}/_bmad/bmm/workflows/4-implementation/sprint-status/workflow.yaml
+3. Pass the yaml path @{project-root}/_bmad/bmm/workflows/4-implementation/sprint-status/workflow.yaml as 'workflow-config' parameter to the workflow.xml instructions
+4. Follow workflow.xml instructions EXACTLY as written to process and follow the specific workflow config and its instructions
+5. Save outputs after EACH section when generating any documents from templates
+</steps>

.agent/workflows/bmad-brainstorming.md

@@ -0,0 +1,6 @@
+---
+name: 'brainstorming'
+description: 'Facilitate interactive brainstorming sessions using diverse creative techniques and ideation methods'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL @{project-root}/_bmad/core/workflows/brainstorming/workflow.md, READ its entire contents and follow its directions exactly!

.agent/workflows/bmad-editorial-review-prose.md

@@ -0,0 +1,9 @@
+---
+description: 'Clinical copy-editor that reviews text for communication issues'
+---
+
+# Editorial Review - Prose
+
+Read the entire task file at: _bmad/core/tasks/editorial-review-prose.xml
+
+Follow all instructions in the task file exactly as written.

.agent/workflows/bmad-editorial-review-structure.md

@@ -0,0 +1,10 @@
+---
+description: 'Structural editor that proposes cuts, reorganization,
+    and simplification while preserving comprehension'
+---
+
+# Editorial Review - Structure
+
+Read the entire task file at: _bmad/core/tasks/editorial-review-structure.xml
+
+Follow all instructions in the task file exactly as written.

.agent/workflows/bmad-help.md

@@ -0,0 +1,9 @@
+---
+description: 'Get unstuck by showing what workflow steps come next or answering questions about what to do'
+---
+
+# help
+
+Read the entire task file at: _bmad/core/tasks/help.md
+
+Follow all instructions in the task file exactly as written.

.agent/workflows/bmad-index-docs.md

@@ -0,0 +1,9 @@
+---
+description: 'Generates or updates an index.md of all documents in the specified directory'
+---
+
+# Index Docs
+
+Read the entire task file at: _bmad/core/tasks/index-docs.xml
+
+Follow all instructions in the task file exactly as written.

.agent/workflows/bmad-party-mode.md

@@ -0,0 +1,6 @@
+---
+name: 'party-mode'
+description: 'Orchestrates group discussions between all installed BMAD agents, enabling natural multi-agent conversations'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL @{project-root}/_bmad/core/workflows/party-mode/workflow.md, READ its entire contents and follow its directions exactly!

.agent/workflows/bmad-review-adversarial-general.md

@@ -0,0 +1,9 @@
+---
+description: 'Cynically review content and produce findings'
+---
+
+# Adversarial Review (General)
+
+Read the entire task file at: _bmad/core/tasks/review-adversarial-general.xml
+
+Follow all instructions in the task file exactly as written.

.agent/workflows/bmad-shard-doc.md

@@ -0,0 +1,9 @@
+---
+description: 'Splits large markdown documents into smaller, organized files based on level 2 (default) sections'
+---
+
+# Shard Document
+
+Read the entire task file at: _bmad/core/tasks/shard-doc.xml
+
+Follow all instructions in the task file exactly as written.

.agent/workflows/browser-verification.md

@@ -0,0 +1,38 @@
+---
+description: Automated browser testing for Vault using Vercel Agent Browser
+---
+
+# Browser Verification Workflow
+
+Use this workflow to perform end-to-end verification of the web application using the specialized `agent-browser` tool.
+
+## Prerequisites
+- App must be running locally (`npm run dev`)
+- `agent-browser` must be installed
+
+## Steps
+
+1. **Start Daemon**
+   ```bash
+   mkdir -p .agent-browser-verification
+   AGENT_BROWSER_HOME=$(pwd)/.agent-browser-verification node node_modules/agent-browser/dist/daemon.js > daemon_v.log 2>&1 &
+   sleep 3
+   ```
+
+2. **Run Verification Sequence**
+   // turbo
+   ```bash
+   # Replace URL and actions as needed for specific stories
+   AGENT_BROWSER_HOME=$(pwd)/.agent-browser-verification ./node_modules/agent-browser/bin/agent-browser-darwin-arm64 open http://localhost:3000
+   AGENT_BROWSER_HOME=$(pwd)/.agent-browser-verification ./node_modules/agent-browser/bin/agent-browser-darwin-arm64 snapshot -i
+   AGENT_BROWSER_HOME=$(pwd)/.agent-browser-verification ./node_modules/agent-browser/bin/agent-browser-darwin-arm64 screenshot homepage_verify.png
+   ```
+
+3. **Cleanup**
+   ```bash
+   ps aux | grep daemon.js | grep -v grep | awk '{print $2}' | xargs kill -9
+   rm -rf .agent-browser-verification
+   ```
+
+## References
+- See [.agent/skills/agent-browser/SKILL.md](file:///Users/vijaykrishnan/Dev/Vault/.agent/skills/agent-browser/SKILL.md) for detailed command reference.

.claude/commands/bmad-agent-bmad-master.md

@@ -0,0 +1,15 @@
+---
+name: 'bmad-master'
+description: 'bmad-master agent'
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/_bmad/core/agents/bmad-master.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>

.claude/commands/bmad-agent-bmm-analyst.md

@@ -0,0 +1,15 @@
+---
+name: 'analyst'
+description: 'analyst agent'
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/_bmad/bmm/agents/analyst.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>

.claude/commands/bmad-agent-bmm-architect.md

@@ -0,0 +1,15 @@
+---
+name: 'architect'
+description: 'architect agent'
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/_bmad/bmm/agents/architect.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>

.claude/commands/bmad-agent-bmm-dev.md

@@ -0,0 +1,15 @@
+---
+name: 'dev'
+description: 'dev agent'
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/_bmad/bmm/agents/dev.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>

.claude/commands/bmad-agent-bmm-pm.md

@@ -0,0 +1,15 @@
+---
+name: 'pm'
+description: 'pm agent'
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/_bmad/bmm/agents/pm.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>

.claude/commands/bmad-agent-bmm-quick-flow-solo-dev.md

@@ -0,0 +1,15 @@
+---
+name: 'quick-flow-solo-dev'
+description: 'quick-flow-solo-dev agent'
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/_bmad/bmm/agents/quick-flow-solo-dev.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>

.claude/commands/bmad-agent-bmm-quinn.md

@@ -0,0 +1,15 @@
+---
+name: 'quinn'
+description: 'quinn agent'
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/_bmad/bmm/agents/quinn.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>

.claude/commands/bmad-agent-bmm-sm.md

@@ -0,0 +1,15 @@
+---
+name: 'sm'
+description: 'sm agent'
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/_bmad/bmm/agents/sm.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>