shipquick 1.0.0 → 2.0.0

package/content/.windsurf/workflows/bmad-bmm-create-prd.md

@@ -0,0 +1,10 @@
+---
+description: 'Create a comprehensive PRD (Product Requirements Document) through structured workflow facilitation'
+auto_execution_mode: "iterate"
+---
+
+# create-prd
+
+Read the entire workflow file at {project-root}/_bmad/bmm/workflows/2-plan-workflows/create-prd/workflow-create-prd.md
+
+Follow all instructions in the workflow file exactly as written.

package/content/.windsurf/workflows/bmad-bmm-create-product-brief.md

@@ -0,0 +1,10 @@
+---
+description: 'Create comprehensive product briefs through collaborative step-by-step discovery as creative Business Analyst working with the user as peers.'
+auto_execution_mode: "iterate"
+---
+
+# create-product-brief
+
+Read the entire workflow file at {project-root}/_bmad/bmm/workflows/1-analysis/create-product-brief/workflow.md
+
+Follow all instructions in the workflow file exactly as written.

package/content/.windsurf/workflows/bmad-bmm-create-story.md

@@ -0,0 +1,15 @@
+---
+name: 'create-story'
+description: 'Create the next user story from epics+stories with enhanced context analysis and direct ready-for-dev marking'
+disable-model-invocation: true
+---
+
+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>

package/content/.windsurf/workflows/bmad-bmm-create-ux-design.md

@@ -0,0 +1,10 @@
+---
+description: 'Work with a peer UX Design expert to plan your applications UX patterns, look and feel.'
+auto_execution_mode: "iterate"
+---
+
+# create-ux-design
+
+Read the entire workflow file at {project-root}/_bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md
+
+Follow all instructions in the workflow file exactly as written.

package/content/.windsurf/workflows/bmad-bmm-dev-story.md

@@ -0,0 +1,15 @@
+---
+name: 'dev-story'
+description: 'Execute a story by implementing tasks/subtasks, writing tests, validating, and updating the story file per acceptance criteria'
+disable-model-invocation: true
+---
+
+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>

package/content/.windsurf/workflows/bmad-bmm-document-project.md

@@ -0,0 +1,15 @@
+---
+name: 'document-project'
+description: 'Analyzes and documents brownfield projects by scanning codebase, architecture, and patterns to create comprehensive reference documentation for AI-assisted development'
+disable-model-invocation: true
+---
+
+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>

package/content/.windsurf/workflows/bmad-bmm-domain-research.md

@@ -0,0 +1,10 @@
+---
+description: 'Conduct domain research covering industry analysis, regulations, technology trends, and ecosystem dynamics using current web data and verified sources.'
+auto_execution_mode: "iterate"
+---
+
+# domain-research
+
+Read the entire workflow file at {project-root}/_bmad/bmm/workflows/1-analysis/research/workflow-domain-research.md
+
+Follow all instructions in the workflow file exactly as written.

package/content/.windsurf/workflows/bmad-bmm-edit-prd.md

@@ -0,0 +1,10 @@
+---
+description: 'Edit and improve an existing PRD - enhance clarity, completeness, and quality'
+auto_execution_mode: "iterate"
+---
+
+# edit-prd
+
+Read the entire workflow file at {project-root}/_bmad/bmm/workflows/2-plan-workflows/create-prd/workflow-edit-prd.md
+
+Follow all instructions in the workflow file exactly as written.

package/content/.windsurf/workflows/bmad-bmm-generate-project-context.md

@@ -0,0 +1,10 @@
+---
+description: 'Creates a concise project-context.md file with critical rules and patterns that AI agents must follow when implementing code. Optimized for LLM context efficiency.'
+auto_execution_mode: "iterate"
+---
+
+# generate-project-context
+
+Read the entire workflow file at {project-root}/_bmad/bmm/workflows/generate-project-context/workflow.md
+
+Follow all instructions in the workflow file exactly as written.

package/content/.windsurf/workflows/bmad-bmm-market-research.md

@@ -0,0 +1,10 @@
+---
+description: 'Conduct market research covering market size, growth, competition, and customer insights using current web data and verified sources.'
+auto_execution_mode: "iterate"
+---
+
+# market-research
+
+Read the entire workflow file at {project-root}/_bmad/bmm/workflows/1-analysis/research/workflow-market-research.md
+
+Follow all instructions in the workflow file exactly as written.

package/content/.windsurf/workflows/bmad-bmm-qa-automate.md

@@ -0,0 +1,15 @@
+---
+name: 'qa-automate'
+description: 'Generate tests quickly for existing features using standard test patterns'
+disable-model-invocation: true
+---
+
+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>

package/content/.windsurf/workflows/bmad-bmm-quick-dev.md

@@ -0,0 +1,10 @@
+---
+description: 'Flexible development - execute tech-specs OR direct instructions with optional planning.'
+auto_execution_mode: "iterate"
+---
+
+# quick-dev
+
+Read the entire workflow file at {project-root}/_bmad/bmm/workflows/bmad-quick-flow/quick-dev/workflow.md
+
+Follow all instructions in the workflow file exactly as written.

package/content/.windsurf/workflows/bmad-bmm-quick-spec.md

@@ -0,0 +1,10 @@
+---
+description: 'Conversational spec engineering - ask questions, investigate code, produce implementation-ready tech-spec.'
+auto_execution_mode: "iterate"
+---
+
+# quick-spec
+
+Read the entire workflow file at {project-root}/_bmad/bmm/workflows/bmad-quick-flow/quick-spec/workflow.md
+
+Follow all instructions in the workflow file exactly as written.

package/content/.windsurf/workflows/bmad-bmm-retrospective.md

@@ -0,0 +1,15 @@
+---
+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'
+disable-model-invocation: true
+---
+
+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>

package/content/.windsurf/workflows/bmad-bmm-sprint-planning.md

@@ -0,0 +1,15 @@
+---
+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'
+disable-model-invocation: true
+---
+
+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>

package/content/.windsurf/workflows/bmad-bmm-sprint-status.md

@@ -0,0 +1,15 @@
+---
+name: 'sprint-status'
+description: 'Summarize sprint-status.yaml, surface risks, and route to the right implementation workflow.'
+disable-model-invocation: true
+---
+
+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>

package/content/.windsurf/workflows/bmad-bmm-technical-research.md

@@ -0,0 +1,10 @@
+---
+description: 'Conduct technical research covering technology evaluation, architecture decisions, and implementation approaches using current web data and verified sources.'
+auto_execution_mode: "iterate"
+---
+
+# technical-research
+
+Read the entire workflow file at {project-root}/_bmad/bmm/workflows/1-analysis/research/workflow-technical-research.md
+
+Follow all instructions in the workflow file exactly as written.

package/content/.windsurf/workflows/bmad-bmm-validate-prd.md

@@ -0,0 +1,10 @@
+---
+description: 'Validate an existing PRD against BMAD standards - comprehensive review for completeness, clarity, and quality'
+auto_execution_mode: "iterate"
+---
+
+# validate-prd
+
+Read the entire workflow file at {project-root}/_bmad/bmm/workflows/2-plan-workflows/create-prd/workflow-validate-prd.md
+
+Follow all instructions in the workflow file exactly as written.

package/content/.windsurf/workflows/bmad-brainstorming.md

@@ -0,0 +1,10 @@
+---
+description: 'Facilitate interactive brainstorming sessions using diverse creative techniques and ideation methods'
+auto_execution_mode: "iterate"
+---
+
+# brainstorming
+
+Read the entire workflow file at {project-root}/_bmad/core/workflows/brainstorming/workflow.md
+
+Follow all instructions in the workflow file exactly as written.

package/content/.windsurf/workflows/bmad-editorial-review-prose.md

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

package/content/.windsurf/workflows/bmad-editorial-review-structure.md

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

package/content/.windsurf/workflows/bmad-help.md

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

package/content/.windsurf/workflows/bmad-index-docs.md

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

package/content/.windsurf/workflows/bmad-party-mode.md

@@ -0,0 +1,10 @@
+---
+description: 'Orchestrates group discussions between all installed BMAD agents, enabling natural multi-agent conversations'
+auto_execution_mode: "iterate"
+---
+
+# party-mode
+
+Read the entire workflow file at {project-root}/_bmad/core/workflows/party-mode/workflow.md
+
+Follow all instructions in the workflow file exactly as written.

package/content/.windsurf/workflows/bmad-review-adversarial-general.md

@@ -0,0 +1,10 @@
+---
+name: 'review-adversarial-general'
+description: 'Cynically review content and produce findings'
+---
+
+# review-adversarial-general
+
+Read the entire task file at: {project-root}/_bmad/core/tasks/review-adversarial-general.xml
+
+Follow all instructions in the task file exactly as written.

package/content/.windsurf/workflows/bmad-shard-doc.md

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

package/content/.windsurf/workflows/bmad-tea-teach-me-testing.md

@@ -0,0 +1,10 @@
+---
+description: 'Multi-session learning companion that teaches testing progressively through 7 structured sessions with state persistence'
+auto_execution_mode: "iterate"
+---
+
+# teach-me-testing
+
+Read the entire workflow file at {project-root}/_bmad/tea/workflows/testarch/teach-me-testing/workflow.md
+
+Follow all instructions in the workflow file exactly as written.

package/content/.windsurf/workflows/bmad-tea-testarch-atdd.md

@@ -0,0 +1,15 @@
+---
+name: 'testarch-atdd'
+description: 'Generate failing acceptance tests before implementation using TDD red-green-refactor cycle'
+disable-model-invocation: true
+---
+
+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/tea/workflows/testarch/atdd/workflow.yaml
+3. Pass the yaml path @{project-root}/_bmad/tea/workflows/testarch/atdd/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>

package/content/.windsurf/workflows/bmad-tea-testarch-automate.md

@@ -0,0 +1,15 @@
+---
+name: 'testarch-automate'
+description: 'Expand test automation coverage after implementation or analyze existing codebase to generate comprehensive test suite'
+disable-model-invocation: true
+---
+
+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/tea/workflows/testarch/automate/workflow.yaml
+3. Pass the yaml path @{project-root}/_bmad/tea/workflows/testarch/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>

package/content/.windsurf/workflows/bmad-tea-testarch-ci.md

@@ -0,0 +1,15 @@
+---
+name: 'testarch-ci'
+description: 'Scaffold CI/CD quality pipeline with test execution, burn-in loops, and artifact collection'
+disable-model-invocation: true
+---
+
+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/tea/workflows/testarch/ci/workflow.yaml
+3. Pass the yaml path @{project-root}/_bmad/tea/workflows/testarch/ci/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>

package/content/.windsurf/workflows/bmad-tea-testarch-framework.md

@@ -0,0 +1,15 @@
+---
+name: 'testarch-framework'
+description: 'Initialize production-ready test framework architecture (Playwright or Cypress) with fixtures, helpers, and configuration'
+disable-model-invocation: true
+---
+
+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/tea/workflows/testarch/framework/workflow.yaml
+3. Pass the yaml path @{project-root}/_bmad/tea/workflows/testarch/framework/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>

package/content/.windsurf/workflows/bmad-tea-testarch-nfr.md

@@ -0,0 +1,15 @@
+---
+name: 'testarch-nfr'
+description: 'Assess non-functional requirements (performance, security, reliability, maintainability) before release with evidence-based validation'
+disable-model-invocation: true
+---
+
+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/tea/workflows/testarch/nfr-assess/workflow.yaml
+3. Pass the yaml path @{project-root}/_bmad/tea/workflows/testarch/nfr-assess/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>

package/content/.windsurf/workflows/bmad-tea-testarch-test-design.md

@@ -0,0 +1,15 @@
+---
+name: 'testarch-test-design'
+description: 'Dual-mode workflow: (1) System-level testability review in Solutioning phase, or (2) Epic-level test planning in Implementation phase. Auto-detects mode based on project phase.'
+disable-model-invocation: true
+---
+
+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/tea/workflows/testarch/test-design/workflow.yaml
+3. Pass the yaml path @{project-root}/_bmad/tea/workflows/testarch/test-design/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>

package/content/.windsurf/workflows/bmad-tea-testarch-test-review.md

@@ -0,0 +1,15 @@
+---
+name: 'testarch-test-review'
+description: 'Review test quality using comprehensive knowledge base and best practices validation'
+disable-model-invocation: true
+---
+
+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/tea/workflows/testarch/test-review/workflow.yaml
+3. Pass the yaml path @{project-root}/_bmad/tea/workflows/testarch/test-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>

package/content/.windsurf/workflows/bmad-tea-testarch-trace.md

@@ -0,0 +1,15 @@
+---
+name: 'testarch-trace'
+description: 'Generate requirements-to-tests traceability matrix, analyze coverage, and make quality gate decision (PASS/CONCERNS/FAIL/WAIVED)'
+disable-model-invocation: true
+---
+
+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/tea/workflows/testarch/trace/workflow.yaml
+3. Pass the yaml path @{project-root}/_bmad/tea/workflows/testarch/trace/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>

package/content/AGENTS.md

@@ -0,0 +1,40 @@
+# Agent Instructions
+
+This project uses **bd** (beads) for issue tracking. Run `bd onboard` to get started.
+
+## Quick Reference
+
+```bash
+bd ready              # Find available work
+bd show <id>          # View issue details
+bd update <id> --status in_progress  # Claim work
+bd close <id>         # Complete work
+bd sync               # Sync with git
+```
+
+## Landing the Plane (Session Completion)
+
+**When ending a work session**, you MUST complete ALL steps below. Work is NOT complete until `git push` succeeds.
+
+**MANDATORY WORKFLOW:**
+
+1. **File issues for remaining work** - Create issues for anything that needs follow-up
+2. **Run quality gates** (if code changed) - Tests, linters, builds
+3. **Update issue status** - Close finished work, update in-progress items
+4. **PUSH TO REMOTE** - This is MANDATORY:
+   ```bash
+   git pull --rebase
+   bd sync
+   git push
+   git status  # MUST show "up to date with origin"
+   ```
+5. **Clean up** - Clear stashes, prune remote branches
+6. **Verify** - All changes committed AND pushed
+7. **Hand off** - Provide context for next session
+
+**CRITICAL RULES:**
+- Work is NOT complete until `git push` succeeds
+- NEVER stop before pushing - that leaves work stranded locally
+- NEVER say "ready to push when you are" - YOU must push
+- If push fails, resolve and retry until it succeeds
+

package/content/Gemini.md

@@ -0,0 +1,20 @@
+# Gemini Learning & Mistake Protocol
+
+- Every time a mistake is made, it MUST be documented here using the following template to ensure zero repetition.
+- Use 'bd' for task tracking and memory management.
+
+## 📋 Mistake Documentation Template
+
+```markdown
+### [Complexity/Category]: [Short Description]
+
+- **Root Cause**: [Detailed explanation of why the error occurred]
+- **Correction**: [The specific code or config change that fixed it]
+- **Prevention Action**: [Actionable checklist or rule to follow in the future]
+```
+
+---
+
+## 🚫 Mistakes That Must NEVER Repeat
+
+<!-- Document mistakes below using the template above -->