@cluesmith/codev 1.1.0

package/templates/protocols/spider/templates/plan.md

@@ -0,0 +1,169 @@
+# Plan: [Title]
+
+## Metadata
+- **ID**: plan-[YYYY-MM-DD]-[short-name]
+- **Status**: draft
+- **Specification**: [Link to codev/specs/spec-file.md]
+- **Created**: [YYYY-MM-DD]
+
+## Executive Summary
+[Brief overview of the implementation approach chosen and why. Reference the specification's selected approach.]
+
+## Success Metrics
+[Copy from specification and add implementation-specific metrics]
+- [ ] All specification criteria met
+- [ ] Test coverage >90%
+- [ ] Performance benchmarks achieved
+- [ ] Zero critical security issues
+- [ ] Documentation complete
+
+## Phase Breakdown
+
+### Phase 1: [Descriptive Name]
+**Dependencies**: None
+
+#### Objectives
+- [Clear, single objective for this phase]
+- [What value does this phase deliver?]
+
+#### Deliverables
+- [ ] [Specific deliverable 1]
+- [ ] [Specific deliverable 2]
+- [ ] [Tests for this phase]
+- [ ] [Documentation updates]
+
+#### Implementation Details
+[Specific technical approach for this phase. Include:
+- Key files/modules to create or modify
+- Architectural decisions
+- API contracts
+- Data models]
+
+#### Acceptance Criteria
+- [ ] [Testable criterion 1]
+- [ ] [Testable criterion 2]
+- [ ] All tests pass
+- [ ] Code review completed
+
+#### Test Plan
+- **Unit Tests**: [What to test]
+- **Integration Tests**: [What to test]
+- **Manual Testing**: [Scenarios to verify]
+
+#### Rollback Strategy
+[How to revert this phase if issues arise]
+
+#### Risks
+- **Risk**: [Specific risk for this phase]
+  - **Mitigation**: [How to address]
+
+---
+
+### Phase 2: [Descriptive Name]
+**Dependencies**: Phase 1
+
+[Repeat structure for each phase]
+
+---
+
+### Phase 3: [Descriptive Name]
+**Dependencies**: Phase 2
+
+[Continue for all phases]
+
+## Dependency Map
+```
+Phase 1 ──→ Phase 2 ──→ Phase 3
+             ↓
+         Phase 4 (optional)
+```
+
+## Resource Requirements
+### Development Resources
+- **Engineers**: [Expertise needed]
+- **Environment**: [Dev/staging requirements]
+
+### Infrastructure
+- [Database changes]
+- [New services]
+- [Configuration updates]
+- [Monitoring additions]
+
+## Integration Points
+### External Systems
+- **System**: [Name]
+  - **Integration Type**: [API/Database/Message Queue]
+  - **Phase**: [Which phase needs this]
+  - **Fallback**: [What if unavailable]
+
+### Internal Systems
+[Repeat structure]
+
+## Risk Analysis
+### Technical Risks
+| Risk | Probability | Impact | Mitigation | Owner |
+|------|------------|--------|------------|-------|
+| [Risk 1] | L/M/H | L/M/H | [Strategy] | [Name] |
+
+### Schedule Risks
+| Risk | Probability | Impact | Mitigation | Owner |
+|------|------------|--------|------------|-------|
+| [Risk 1] | L/M/H | L/M/H | [Strategy] | [Name] |
+
+## Validation Checkpoints
+1. **After Phase 1**: [What to validate]
+2. **After Phase 2**: [What to validate]
+3. **Before Production**: [Final checks]
+
+## Monitoring and Observability
+### Metrics to Track
+- [Metric 1: Description and threshold]
+- [Metric 2: Description and threshold]
+
+### Logging Requirements
+- [What to log and at what level]
+- [Retention requirements]
+
+### Alerting
+- [Alert condition and severity]
+- [Who to notify]
+
+## Documentation Updates Required
+- [ ] API documentation
+- [ ] Architecture diagrams
+- [ ] Runbooks
+- [ ] User guides
+- [ ] Configuration guides
+
+## Post-Implementation Tasks
+- [ ] Performance validation
+- [ ] Security audit
+- [ ] Load testing
+- [ ] User acceptance testing
+- [ ] Monitoring validation
+
+## Expert Review
+**Date**: [YYYY-MM-DD]
+**Model**: [Model consulted]
+**Key Feedback**:
+- [Feasibility assessment]
+- [Missing considerations]
+- [Risk identification]
+- [Alternative suggestions]
+
+**Plan Adjustments**:
+- [How the plan was modified based on feedback]
+
+## Approval
+- [ ] Technical Lead Review
+- [ ] Engineering Manager Approval
+- [ ] Resource Allocation Confirmed
+- [ ] Expert AI Consultation Complete
+
+## Change Log
+| Date | Change | Reason | Author |
+|------|--------|--------|--------|
+| [Date] | [What changed] | [Why] | [Who] |
+
+## Notes
+[Additional context, assumptions, or considerations]

package/templates/protocols/spider/templates/review.md

@@ -0,0 +1,207 @@
+# Review: [Feature/Project Name]
+
+## Metadata
+- **Date**: [YYYY-MM-DD]
+- **Specification**: [Link to codev/specs/spec-file.md]
+- **Plan**: [Link to codev/plans/plan-file.md]
+
+## Executive Summary
+[Brief overview of what was built, how it went, and key outcomes]
+
+## Specification Compliance
+
+### Success Criteria Assessment
+| Criterion | Status | Evidence | Notes |
+|-----------|--------|----------|-------|
+| [Criterion 1] | ✅/❌/⚠️ | [Link/description] | [Any context] |
+| [Criterion 2] | ✅/❌/⚠️ | [Link/description] | [Any context] |
+| [All tests pass >90% coverage] | ✅/❌/⚠️ | [Coverage report] | [Details] |
+| [Performance benchmarks met] | ✅/❌/⚠️ | [Metrics] | [Details] |
+
+### Deviations from Specification
+| Original Requirement | What Was Built | Reason for Deviation |
+|---------------------|----------------|---------------------|
+| [If any] | [Actual] | [Justification] |
+
+## Plan Execution Review
+
+### Phase Completion
+| Phase | Status | Notes |
+|-------|--------|-------|
+| Phase 1 | Complete | [Context] |
+| Phase 2 | Complete | [Context] |
+
+### Deliverables Checklist
+- [x] All planned features implemented
+- [x] Test coverage achieved
+- [x] Documentation updated
+- [x] Performance requirements met
+- [ ] [Any incomplete items]
+
+## Code Quality Assessment
+
+### Architecture Impact
+- **Positive Changes**: [Improvements made to architecture]
+- **Technical Debt Incurred**: [Any shortcuts taken]
+- **Future Considerations**: [What should be refactored later]
+
+### Code Metrics
+- **Lines of Code**: [Added/Modified/Removed]
+- **Test Coverage**: [Percentage and areas covered]
+- **Code Complexity**: [Cyclomatic complexity if measured]
+- **Documentation Coverage**: [Public APIs documented?]
+
+### Security Review
+- **Vulnerabilities Found**: [None/List]
+- **Security Best Practices**: [Followed/Exceptions]
+- **Sensitive Data Handling**: [Properly secured?]
+
+## Performance Analysis
+
+### Benchmarks
+| Metric | Target | Achieved | Status |
+|--------|--------|----------|---------|
+| Response Time (p95) | <200ms | [Actual] | ✅/❌ |
+| Throughput | 1000 rps | [Actual] | ✅/❌ |
+| Memory Usage | <500MB | [Actual] | ✅/❌ |
+
+### Load Testing Results
+[Summary of load testing outcomes, if performed]
+
+## Testing Summary
+
+### Test Execution
+- **Unit Tests**: [X passed, Y failed]
+- **Integration Tests**: [X passed, Y failed]
+- **E2E Tests**: [X passed, Y failed]
+- **Manual Testing**: [Scenarios tested]
+
+### Issues Found During Testing
+| Issue | Severity | Resolution |
+|-------|----------|------------|
+| [Bug 1] | Critical/High/Medium/Low | [Fixed/Deferred] |
+
+## Lessons Learned
+
+### What Went Well
+1. [Success point 1 - be specific]
+2. [Success point 2 - include why it worked]
+3. [Success point 3 - note for future replication]
+
+### What Was Challenging
+1. [Challenge 1 - describe the issue]
+   - **Root Cause**: [Why it happened]
+   - **Resolution**: [How it was addressed]
+   - **Prevention**: [How to avoid in future]
+
+2. [Challenge 2]
+   - **Root Cause**:
+   - **Resolution**:
+   - **Prevention**:
+
+### What Would You Do Differently
+1. [Improvement 1 - be actionable]
+2. [Improvement 2 - be specific]
+3. [Improvement 3 - be realistic]
+
+## Methodology Feedback
+
+### SP(IDE)R Protocol Effectiveness
+- **Specification Phase**: [Was it thorough enough? Too detailed?]
+- **Planning Phase**: [Were estimates accurate? Phases well-sized?]
+- **Implementation Loop**: [Did IDE cycle work well?]
+- **Review Process**: [Is this review capturing the right information?]
+
+### Suggested Improvements
+1. **Template Updates**: [Any template improvements needed?]
+2. **Process Changes**: [Any step modifications recommended?]
+3. **Tool Needs**: [Any automation opportunities?]
+
+## Resource Analysis
+
+### Time Investment
+- **Planned**: [X person-days]
+- **Actual**: [Y person-days]
+- **Variance Explanation**: [Why different?]
+
+### Team Feedback
+- [Feedback from team members]
+- [Collaboration insights]
+- [Communication effectiveness]
+
+## Follow-Up Actions
+
+### Immediate (This Week)
+- [ ] [Action 1 - owner]
+- [ ] [Action 2 - owner]
+
+### Short-term (This Month)
+- [ ] [Action 1 - owner]
+- [ ] [Action 2 - owner]
+
+### Long-term (Future Consideration)
+- [ ] [Improvement opportunity 1]
+- [ ] [Technical debt to address]
+
+## Risk Retrospective
+
+### Identified Risks That Materialized
+| Risk | Impact | How Handled | Prevention for Future |
+|------|--------|-------------|----------------------|
+| [Risk] | [What happened] | [Resolution] | [Learning] |
+
+### Unforeseen Issues
+| Issue | Impact | How Handled | How to Predict |
+|-------|--------|-------------|----------------|
+| [Issue] | [Impact] | [Resolution] | [Detection method] |
+
+## Documentation Updates
+
+### Completed
+- [x] API documentation updated
+- [x] README updated
+- [x] Architecture diagrams revised
+- [ ] [Pending items]
+
+### Knowledge Transfer
+- **Wiki/Confluence Updates**: [Links]
+- **Team Presentations**: [Scheduled/Completed]
+- **Runbooks Created**: [Links]
+
+## Stakeholder Feedback
+- **Product Owner**: [Feedback]
+- **End Users**: [Feedback if available]
+- **Support Team**: [Readiness assessment]
+
+## Final Recommendations
+
+### For Future Similar Projects
+1. [Recommendation 1]
+2. [Recommendation 2]
+
+### For Methodology Evolution
+1. [Suggestion 1]
+2. [Suggestion 2]
+
+## Conclusion
+[Summary statement about the project success, key achievements, and main learnings]
+
+## Appendix
+
+### Links
+- **Code**: [Repository links, PRs]
+- **Documentation**: [All related docs]
+- **Metrics Dashboards**: [Monitoring links]
+- **Test Reports**: [CI/CD links]
+
+### Expert Consultation Summary
+[If expert AI review was performed post-implementation]
+- **Model**: [Which model]
+- **Feedback**: [Key points]
+- **Incorporated Changes**: [What was acted upon]
+
+## Sign-off
+- [ ] Technical Lead Review
+- [ ] Team Retrospective Completed
+- [ ] Lessons Documented
+- [ ] Methodology Updates Proposed

package/templates/protocols/spider/templates/spec.md

@@ -0,0 +1,140 @@
+# Specification: [Title]
+
+## Metadata
+- **ID**: spec-[YYYY-MM-DD]-[short-name]
+- **Status**: draft
+- **Created**: [YYYY-MM-DD]
+
+## Clarifying Questions Asked
+<!-- Document the questions you asked the user/stakeholder and their answers -->
+[List the questions you asked to understand the problem better and the responses received. This shows the discovery process.]
+
+## Problem Statement
+[Clearly articulate the problem being solved. Include context about why this is important, who is affected, and what the current pain points are.]
+
+## Current State
+[Describe how things work today. What are the limitations? What workarounds exist? Include specific examples.]
+
+## Desired State
+[Describe the ideal solution. How should things work after implementation? What specific improvements will users see?]
+
+## Stakeholders
+- **Primary Users**: [Who will directly use this feature?]
+- **Secondary Users**: [Who else is affected?]
+- **Technical Team**: [Who will implement and maintain this?]
+- **Business Owners**: [Who has decision authority?]
+
+## Success Criteria
+- [ ] [Specific, measurable criterion 1]
+- [ ] [Specific, measurable criterion 2]
+- [ ] [Specific, measurable criterion 3]
+- [ ] All tests pass with >90% coverage
+- [ ] Performance benchmarks met (specify below)
+- [ ] Documentation updated
+
+## Constraints
+### Technical Constraints
+- [Existing system limitations]
+- [Technology stack requirements]
+- [Integration points]
+
+### Business Constraints
+- [Timeline requirements]
+- [Budget considerations]
+- [Compliance requirements]
+
+## Assumptions
+- [List assumptions being made]
+- [Include dependencies on other work]
+- [Note any prerequisites]
+
+## Solution Approaches
+
+### Approach 1: [Name]
+**Description**: [Brief overview of this approach]
+
+**Pros**:
+- [Advantage 1]
+- [Advantage 2]
+
+**Cons**:
+- [Disadvantage 1]
+- [Disadvantage 2]
+
+**Estimated Complexity**: [Low/Medium/High]
+**Risk Level**: [Low/Medium/High]
+
+### Approach 2: [Name]
+[Repeat structure for additional approaches]
+
+[Add as many approaches as appropriate for the problem]
+
+## Open Questions
+
+### Critical (Blocks Progress)
+- [ ] [Question that must be answered before proceeding]
+
+### Important (Affects Design)
+- [ ] [Question that influences technical decisions]
+
+### Nice-to-Know (Optimization)
+- [ ] [Question that could improve the solution]
+
+## Performance Requirements
+- **Response Time**: [e.g., <200ms p95]
+- **Throughput**: [e.g., 1000 requests/second]
+- **Resource Usage**: [e.g., <500MB memory]
+- **Availability**: [e.g., 99.9% uptime]
+
+## Security Considerations
+- [Authentication requirements]
+- [Authorization model]
+- [Data privacy concerns]
+- [Audit requirements]
+
+## Test Scenarios
+### Functional Tests
+1. [Scenario 1: Happy path]
+2. [Scenario 2: Edge case]
+3. [Scenario 3: Error condition]
+
+### Non-Functional Tests
+1. [Performance test scenario]
+2. [Security test scenario]
+3. [Load test scenario]
+
+## Dependencies
+- **External Services**: [List any external APIs or services]
+- **Internal Systems**: [List internal dependencies]
+- **Libraries/Frameworks**: [List required libraries]
+
+## References
+- [Link to relevant documentation in codev/ref/]
+- [Link to related specifications]
+- [Link to architectural diagrams]
+- [Link to research materials]
+
+## Risks and Mitigation
+| Risk | Probability | Impact | Mitigation Strategy |
+|------|------------|--------|-------------------|
+| [Risk 1] | Low/Med/High | Low/Med/High | [How to address] |
+| [Risk 2] | Low/Med/High | Low/Med/High | [How to address] |
+
+## Expert Consultation
+<!-- Only if user requested multi-agent consultation -->
+**Date**: [YYYY-MM-DD]
+**Models Consulted**: [e.g., GPT-5 and Gemini Pro]
+**Sections Updated**:
+- [Section name]: [Brief description of change based on consultation]
+- [Section name]: [Brief description of change based on consultation]
+
+Note: All consultation feedback has been incorporated directly into the relevant sections above.
+
+## Approval
+- [ ] Technical Lead Review
+- [ ] Product Owner Review
+- [ ] Stakeholder Sign-off
+- [ ] Expert AI Consultation Complete
+
+## Notes
+[Any additional context or considerations not covered above]