siesa-agents 1.3.0 → 1.5.0

package/.bmad-core/checklists/backend-checklist.md

@@ -1,143 +0,0 @@
-# Backend Development Checklist
-
-## Architecture & Structure
-- [ ] Hexagonal architecture layers properly separated (domain, application, infrastructure)
-- [ ] Domain layer contains only business entities and rules
-- [ ] Application layer manages use cases and orchestration
-- [ ] Infrastructure layer handles external concerns (database, HTTP, messaging)
-- [ ] Primary and secondary ports clearly defined
-- [ ] Dependencies point inward toward domain core
-- [ ] No circular dependencies between layers
-
-## Domain-Driven Design
-- [ ] Bounded contexts properly identified and separated
-- [ ] Domain entities follow DDD patterns
-- [ ] Value objects used for type safety and validation
-- [ ] Aggregates maintain consistency boundaries
-- [ ] Domain events properly implemented
-- [ ] Domain services handle complex business logic
-- [ ] Ubiquitous language used throughout codebase
-
-## NestJS & TypeScript
-- [ ] NestJS 10+ with TypeScript strict mode
-- [ ] Dependency injection properly configured
-- [ ] All classes and methods have proper type definitions
-- [ ] No usage of `any` type
-- [ ] Decorators used appropriately (@Injectable, @Controller, etc.)
-- [ ] Module organization follows domain boundaries
-- [ ] Guards and interceptors properly implemented
-
-## Database & Prisma
-- [ ] Prisma schema properly defined
-- [ ] No raw SQL queries - all operations through Prisma
-- [ ] Database migrations created and tested
-- [ ] Proper indexing for performance
-- [ ] Foreign key relationships properly defined
-- [ ] Connection pooling configured
-- [ ] Transaction handling for complex operations
-
-## Use Cases & Business Logic
-- [ ] Use cases follow single responsibility principle
-- [ ] Input validation using class-validator
-- [ ] Business rules enforced in domain layer
-- [ ] Error handling comprehensive and consistent
-- [ ] Command/Query separation implemented
-- [ ] Use cases are testable with mocked dependencies
-
-## Repository Pattern
-- [ ] Repository interfaces defined in application layer
-- [ ] Repository implementations in infrastructure layer
-- [ ] Repository methods return domain entities
-- [ ] Proper abstraction of data access concerns
-- [ ] Repository tests with test database
-- [ ] Prisma transformations to/from domain entities
-
-## API Design
-- [ ] REST endpoints follow RESTful conventions
-- [ ] Request/response DTOs properly defined
-- [ ] Swagger/OpenAPI documentation complete
-- [ ] Proper HTTP status codes returned
-- [ ] Input validation on all endpoints
-- [ ] Error responses properly formatted
-
-## Testing
-- [ ] Unit tests for all domain entities
-- [ ] Use case tests with mocked dependencies
-- [ ] Integration tests for repositories
-- [ ] E2E tests for critical workflows
-- [ ] Test coverage meets minimum threshold (80%)
-- [ ] Tests follow AAA pattern (Arrange, Act, Assert)
-
-## Security
-- [ ] Authentication implemented (JWT/OAuth)
-- [ ] Authorization guards protect endpoints
-- [ ] Input validation prevents injection attacks
-- [ ] Sensitive data properly encrypted
-- [ ] Environment variables for secrets
-- [ ] CORS properly configured
-- [ ] Rate limiting implemented
-
-## Performance
-- [ ] Database queries optimized
-- [ ] Proper indexing strategy
-- [ ] Caching implemented where appropriate
-- [ ] Pagination for large datasets
-- [ ] Connection pooling configured
-- [ ] Memory usage optimized
-
-## Monitoring & Logging
-- [ ] Structured logging with Winston
-- [ ] Health check endpoints implemented
-- [ ] Error tracking and alerting
-- [ ] Performance monitoring
-- [ ] Audit logging for sensitive operations
-- [ ] Log rotation configured
-
-## MonoRepo & Shared Libraries
-- [ ] Nx workspace properly configured
-- [ ] Shared libraries properly structured
-- [ ] Dependencies between apps and libs correct
-- [ ] Build system optimized
-- [ ] Shared code doesn't violate domain boundaries
-- [ ] Library versioning strategy defined
-
-## Microservices (if applicable)
-- [ ] Service boundaries align with business domains
-- [ ] Inter-service communication via events/messages
-- [ ] Each service has independent database
-- [ ] Service discovery and configuration
-- [ ] Circuit breaker pattern for resilience
-- [ ] Distributed tracing implemented
-
-## Development Workflow
-- [ ] Git hooks for pre-commit validation
-- [ ] Code formatting with Prettier
-- [ ] Linting rules enforced
-- [ ] TypeScript compilation successful
-- [ ] All tests passing
-- [ ] No security vulnerabilities
-- [ ] Documentation up to date
-
-## Environment Configuration
-- [ ] Environment-specific configurations
-- [ ] Secrets management properly implemented
-- [ ] Database connection strings secure
-- [ ] Feature flags for conditional logic
-- [ ] Configuration validation on startup
-- [ ] Docker configuration if applicable
-
-## Error Handling
-- [ ] Custom exception classes for domain errors
-- [ ] Global exception filter implemented
-- [ ] Proper error logging without sensitive data
-- [ ] User-friendly error messages
-- [ ] Error response consistency
-- [ ] Graceful degradation for external service failures
-
-## Event Handling
-- [ ] Domain events properly published
-- [ ] Event handlers are idempotent
-- [ ] Event sourcing if applicable
-- [ ] Message queue integration
-- [ ] Dead letter queue handling
-- [ ] Event schema versioning

package/.bmad-core/checklists/change-checklist.md

@@ -1,184 +0,0 @@
-<!-- Powered by BMAD™ Core -->
-
-# Change Navigation Checklist
-
-**Purpose:** To systematically guide the selected Agent and user through the analysis and planning required when a significant change (pivot, tech issue, missing requirement, failed story) is identified during the BMad workflow.
-
-**Instructions:** Review each item with the user. Mark `[x]` for completed/confirmed, `[N/A]` if not applicable, or add notes for discussion points.
-
-[[LLM: INITIALIZATION INSTRUCTIONS - CHANGE NAVIGATION
-
-Changes during development are inevitable, but how we handle them determines project success or failure.
-
-Before proceeding, understand:
-
-1. This checklist is for SIGNIFICANT changes that affect the project direction
-2. Minor adjustments within a story don't require this process
-3. The goal is to minimize wasted work while adapting to new realities
-4. User buy-in is critical - they must understand and approve changes
-
-Required context:
-
-- The triggering story or issue
-- Current project state (completed stories, current epic)
-- Access to PRD, architecture, and other key documents
-- Understanding of remaining work planned
-
-APPROACH:
-This is an interactive process with the user. Work through each section together, discussing implications and options. The user makes final decisions, but provide expert guidance on technical feasibility and impact.
-
-REMEMBER: Changes are opportunities to improve, not failures. Handle them professionally and constructively.]]
-
----
-
-## 1. Understand the Trigger & Context
-
-[[LLM: Start by fully understanding what went wrong and why. Don't jump to solutions yet. Ask probing questions:
-
-- What exactly happened that triggered this review?
-- Is this a one-time issue or symptomatic of a larger problem?
-- Could this have been anticipated earlier?
-- What assumptions were incorrect?
-
-Be specific and factual, not blame-oriented.]]
-
-- [ ] **Identify Triggering Story:** Clearly identify the story (or stories) that revealed the issue.
-- [ ] **Define the Issue:** Articulate the core problem precisely.
-  - [ ] Is it a technical limitation/dead-end?
-  - [ ] Is it a newly discovered requirement?
-  - [ ] Is it a fundamental misunderstanding of existing requirements?
-  - [ ] Is it a necessary pivot based on feedback or new information?
-  - [ ] Is it a failed/abandoned story needing a new approach?
-- [ ] **Assess Initial Impact:** Describe the immediate observed consequences (e.g., blocked progress, incorrect functionality, non-viable tech).
-- [ ] **Gather Evidence:** Note any specific logs, error messages, user feedback, or analysis that supports the issue definition.
-
-## 2. Epic Impact Assessment
-
-[[LLM: Changes ripple through the project structure. Systematically evaluate:
-
-1. Can we salvage the current epic with modifications?
-2. Do future epics still make sense given this change?
-3. Are we creating or eliminating dependencies?
-4. Does the epic sequence need reordering?
-
-Think about both immediate and downstream effects.]]
-
-- [ ] **Analyze Current Epic:**
-  - [ ] Can the current epic containing the trigger story still be completed?
-  - [ ] Does the current epic need modification (story changes, additions, removals)?
-  - [ ] Should the current epic be abandoned or fundamentally redefined?
-- [ ] **Analyze Future Epics:**
-  - [ ] Review all remaining planned epics.
-  - [ ] Does the issue require changes to planned stories in future epics?
-  - [ ] Does the issue invalidate any future epics?
-  - [ ] Does the issue necessitate the creation of entirely new epics?
-  - [ ] Should the order/priority of future epics be changed?
-- [ ] **Summarize Epic Impact:** Briefly document the overall effect on the project's epic structure and flow.
-
-## 3. Artifact Conflict & Impact Analysis
-
-[[LLM: Documentation drives development in BMad. Check each artifact:
-
-1. Does this change invalidate documented decisions?
-2. Are architectural assumptions still valid?
-3. Do user flows need rethinking?
-4. Are technical constraints different than documented?
-
-Be thorough - missed conflicts cause future problems.]]
-
-- [ ] **Review PRD:**
-  - [ ] Does the issue conflict with the core goals or requirements stated in the PRD?
-  - [ ] Does the PRD need clarification or updates based on the new understanding?
-- [ ] **Review Architecture Document:**
-  - [ ] Does the issue conflict with the documented architecture (components, patterns, tech choices)?
-  - [ ] Are specific components/diagrams/sections impacted?
-  - [ ] Does the technology list need updating?
-  - [ ] Do data models or schemas need revision?
-  - [ ] Are external API integrations affected?
-- [ ] **Review Frontend Spec (if applicable):**
-  - [ ] Does the issue conflict with the FE architecture, component library choice, or UI/UX design?
-  - [ ] Are specific FE components or user flows impacted?
-- [ ] **Review Other Artifacts (if applicable):**
-  - [ ] Consider impact on deployment scripts, IaC, monitoring setup, etc.
-- [ ] **Summarize Artifact Impact:** List all artifacts requiring updates and the nature of the changes needed.
-
-## 4. Path Forward Evaluation
-
-[[LLM: Present options clearly with pros/cons. For each path:
-
-1. What's the effort required?
-2. What work gets thrown away?
-3. What risks are we taking?
-4. How does this affect timeline?
-5. Is this sustainable long-term?
-
-Be honest about trade-offs. There's rarely a perfect solution.]]
-
-- [ ] **Option 1: Direct Adjustment / Integration:**
-  - [ ] Can the issue be addressed by modifying/adding future stories within the existing plan?
-  - [ ] Define the scope and nature of these adjustments.
-  - [ ] Assess feasibility, effort, and risks of this path.
-- [ ] **Option 2: Potential Rollback:**
-  - [ ] Would reverting completed stories significantly simplify addressing the issue?
-  - [ ] Identify specific stories/commits to consider for rollback.
-  - [ ] Assess the effort required for rollback.
-  - [ ] Assess the impact of rollback (lost work, data implications).
-  - [ ] Compare the net benefit/cost vs. Direct Adjustment.
-- [ ] **Option 3: PRD MVP Review & Potential Re-scoping:**
-  - [ ] Is the original PRD MVP still achievable given the issue and constraints?
-  - [ ] Does the MVP scope need reduction (removing features/epics)?
-  - [ ] Do the core MVP goals need modification?
-  - [ ] Are alternative approaches needed to meet the original MVP intent?
-  - [ ] **Extreme Case:** Does the issue necessitate a fundamental replan or potentially a new PRD V2 (to be handled by PM)?
-- [ ] **Select Recommended Path:** Based on the evaluation, agree on the most viable path forward.
-
-## 5. Sprint Change Proposal Components
-
-[[LLM: The proposal must be actionable and clear. Ensure:
-
-1. The issue is explained in plain language
-2. Impacts are quantified where possible
-3. The recommended path has clear rationale
-4. Next steps are specific and assigned
-5. Success criteria for the change are defined
-
-This proposal guides all subsequent work.]]
-
-(Ensure all agreed-upon points from previous sections are captured in the proposal)
-
-- [ ] **Identified Issue Summary:** Clear, concise problem statement.
-- [ ] **Epic Impact Summary:** How epics are affected.
-- [ ] **Artifact Adjustment Needs:** List of documents to change.
-- [ ] **Recommended Path Forward:** Chosen solution with rationale.
-- [ ] **PRD MVP Impact:** Changes to scope/goals (if any).
-- [ ] **High-Level Action Plan:** Next steps for stories/updates.
-- [ ] **Agent Handoff Plan:** Identify roles needed (PM, Arch, Design Arch, PO).
-
-## 6. Final Review & Handoff
-
-[[LLM: Changes require coordination. Before concluding:
-
-1. Is the user fully aligned with the plan?
-2. Do all stakeholders understand the impacts?
-3. Are handoffs to other agents clear?
-4. Is there a rollback plan if the change fails?
-5. How will we validate the change worked?
-
-Get explicit approval - implicit agreement causes problems.
-
-FINAL REPORT:
-After completing the checklist, provide a concise summary:
-
-- What changed and why
-- What we're doing about it
-- Who needs to do what
-- When we'll know if it worked
-
-Keep it action-oriented and forward-looking.]]
-
-- [ ] **Review Checklist:** Confirm all relevant items were discussed.
-- [ ] **Review Sprint Change Proposal:** Ensure it accurately reflects the discussion and decisions.
-- [ ] **User Approval:** Obtain explicit user approval for the proposal.
-- [ ] **Confirm Next Steps:** Reiterate the handoff plan and the next actions to be taken by specific agents.
-
----

package/.bmad-core/checklists/frontend-checklist.md

@@ -1,106 +0,0 @@
-# Frontend Development Checklist
-
-## Architecture & Structure
-- [ ] Clean Architecture layers properly separated (domain, application, infrastructure, presentation)
-- [ ] Domain layer contains only business entities and rules
-- [ ] Application layer manages use cases and orchestration
-- [ ] Infrastructure layer handles external concerns (API, storage, etc.)
-- [ ] Presentation layer contains only UI components and pages
-- [ ] No circular dependencies between layers
-- [ ] Dependency inversion principle followed
-
-## TypeScript & Code Quality
-- [ ] Strict TypeScript configuration enabled
-- [ ] All components have proper type definitions
-- [ ] No usage of `any` type
-- [ ] Props interfaces properly defined
-- [ ] Custom hooks have proper typing
-- [ ] API responses are properly typed
-- [ ] State management stores have type safety
-
-## Component Standards
-- [ ] Components follow single responsibility principle
-- [ ] Proper use of React.memo for performance
-- [ ] Components are composable and reusable
-- [ ] Props are properly documented with JSDoc
-- [ ] Default props are defined where appropriate
-- [ ] Components handle loading and error states
-
-## State Management
-- [ ] Zustand stores follow DDD patterns
-- [ ] Global vs local state properly separated
-- [ ] Actions call use cases from application layer
-- [ ] State updates are immutable
-- [ ] Store subscriptions are optimized
-
-## Styling & UI
-- [ ] TailwindCSS used consistently
-- [ ] Shadcn/ui components properly configured
-- [ ] Responsive design implemented
-- [ ] Design system patterns followed
-- [ ] Color scheme and theme support
-- [ ] Loading states have proper UI feedback
-
-## Performance
-- [ ] Components are lazily loaded where appropriate
-- [ ] Images are optimized and properly sized
-- [ ] Bundle size is within acceptable limits
-- [ ] React.memo used strategically
-- [ ] Expensive operations are memoized
-- [ ] Infinite scrolls or virtual lists for large datasets
-
-## Accessibility
-- [ ] ARIA labels and roles properly implemented
-- [ ] Keyboard navigation works correctly
-- [ ] Color contrast meets WCAG 2.1 AA standards
-- [ ] Screen reader compatibility tested
-- [ ] Focus management implemented
-- [ ] Form validation errors are accessible
-
-## Testing
-- [ ] Unit tests for all custom hooks
-- [ ] Component tests cover user interactions
-- [ ] Integration tests for feature workflows
-- [ ] Accessibility tests using jest-axe
-- [ ] Test coverage meets minimum threshold (80%)
-- [ ] Edge cases and error scenarios tested
-
-## API Integration
-- [ ] HTTP client properly configured
-- [ ] Error handling for network failures
-- [ ] Request/response interceptors for auth
-- [ ] API types match backend specifications
-- [ ] Loading states during API calls
-- [ ] Proper error messages displayed to users
-
-## PWA Features (if enabled)
-- [ ] Service worker configured correctly
-- [ ] Offline functionality works
-- [ ] App manifest is valid
-- [ ] Cache strategies implemented
-- [ ] App can be installed on devices
-- [ ] Push notifications work (if required)
-
-## Security
-- [ ] No secrets or API keys in frontend code
-- [ ] XSS prevention measures implemented
-- [ ] CSRF protection where needed
-- [ ] Secure authentication flow
-- [ ] Input validation and sanitization
-- [ ] Safe handling of user data
-
-## Development Experience
-- [ ] Hot reloading works correctly
-- [ ] TypeScript compilation is fast
-- [ ] Linting rules are enforced
-- [ ] Code formatting is consistent
-- [ ] Development tools are configured
-- [ ] Environment-specific configurations work
-
-## Documentation
-- [ ] README with setup instructions
-- [ ] Component documentation exists
-- [ ] API integration documented
-- [ ] Deployment guide available
-- [ ] Architecture decisions recorded
-- [ ] Troubleshooting guide provided