Add comprehensive async collaboration system for PRD/Epic development:
PRD & Epic Crowdsourcing:
- Create, open feedback rounds, synthesize, and sign-off workflows
- LLM-powered synthesis engine for conflict resolution
- Configurable sign-off thresholds (count, percentage, required approvers)
- Unified "my-tasks" view across PRDs and Epics
Story Coordination:
- Story locking/checkout for preventing concurrent work
- Lock status and unlock workflows
- Available stories view with lock status
Multi-Channel Notifications:
- GitHub @mentions, Slack webhooks, Email (SMTP/SendGrid/SES)
- Event-driven notifications for feedback/signoff requests
- Priority-based retry logic for urgent notifications
Cache System Extensions:
- PRD and Epic document caching with metadata migration
- Staleness detection and atomic file operations
- User task queries and extended statistics
GitHub integration is optional (disabled by default) - existing local-only
projects continue to work unchanged.
Includes 673 passing tests with comprehensive coverage for all new modules.
Note: Library files use CommonJS for Node.js compatibility. ESLint rules
for ES modules may need configuration adjustment.
- Add deployment-aware handler generation (filters web-only/ide-only commands)
- Remove unused run-workflow handler type (ghost handler cleanup)
- Implement missing validate-workflow and data handler generation
- Update schema validation to support exactly 6 active handler types
- Clean up activation templates and web bundler logic
- Prevent generation of unused handler instructions for better performance
- All 62 tests pass with backward compatibility maintained
Introduce automated validation for agent YAML files using Zod to ensure
schema compliance across all agent definitions. This feature validates
17 agent files across core and module directories, catching structural
errors and maintaining consistency.
Schema Validation (tools/schema/agent.js):
- Zod-based schema validating metadata, persona, menu, prompts, and critical actions
- Module-aware validation: module field required for src/modules/**/agents/,
optional for src/core/agents/
- Enforces kebab-case unique triggers and at least one command target per menu item
- Validates persona.principles as array (not string)
- Comprehensive refinements for data integrity
CLI Validator (tools/validate-agent-schema.js):
- Scans src/{core,modules/*}/agents/*.agent.yaml
- Parses with js-yaml and validates using Zod schema
- Reports detailed errors with file paths and field paths
- Exits 1 on failures, 0 on success
- Accepts optional project_root parameter for testing
Testing (679 lines across 3 test files):
- test/test-cli-integration.sh: CLI behavior and error handling tests
- test/unit-test-schema.js: Direct schema validation unit tests
- test/test-agent-schema.js: Comprehensive fixture-based tests
- 50 test fixtures covering valid and invalid scenarios
- ESLint configured to support CommonJS test files
- Prettier configured to ignore intentionally broken fixtures
CI Integration (.github/workflows/lint.yaml):
- Renamed from format-check.yaml to lint.yaml
- Added schema-validation job running npm run validate:schemas
- Runs in parallel with prettier and eslint jobs
- Validates on all pull requests
Data Cleanup:
- Fixed src/core/agents/bmad-master.agent.yaml: converted persona.principles
from string to array format
Documentation:
- Updated schema-classification.md with validation section
- Documents validator usage, enforcement rules, and CI integration
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-authored-by: Claude <noreply@anthropic.com>
Jonah Schulte
Brian Madison
Alex Verkhovsky