@cluesmith/codev 1.1.0 → 1.2.0

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

@@ -1,207 +0,0 @@
-# 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

@@ -1,140 +0,0 @@
-# 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]