agentic-sdlc 1.5.1 → 1.8.1

package/.agent/templates/observer-report.md

@@ -0,0 +1,131 @@
+# Observer Compliance Report
+
+**Report ID:** `[AUTO-GENERATED]`  
+**Generated:** `[TIMESTAMP]`  
+**Agent:** `[AGENT_NAME]`  
+**Task:** `[TASK_ID]`
+
+---
+
+## Executive Summary
+
+**Compliance Score:** `[0-100]` / 100  
+**Status:** ✅ PASS | ⚠️ WARNING | ❌ FAIL  
+**Violations Found:** `[NUMBER]`  
+**Auto-Corrected:** `[NUMBER]`  
+**Requires Attention:** `[NUMBER]`
+
+---
+
+## Rule Compliance Check
+
+### Code Quality Rules
+
+| Rule | Status | Details |
+|------|--------|---------|
+| Linting passed | ✅ / ❌ | `[Details]` |
+| Code style follows conventions | ✅ / ❌ | `[Details]` |
+| Cyclomatic complexity < 10 | ✅ / ❌ | `[Details]` |
+| Nesting depth < 4 | ✅ / ❌ | `[Details]` |
+| Function length < 50 lines | ✅ / ❌ | `[Details]` |
+
+### Naming Conventions
+
+| Rule | Status | Details |
+|------|--------|---------|
+| Files use snake_case | ✅ / ❌ | `[Details]` |
+| Classes use PascalCase | ✅ / ❌ | `[Details]` |
+| Variables use camelCase | ✅ / ❌ | `[Details]` |
+| Constants use UPPER_CASE | ✅ / ❌ | `[Details]` |
+
+### Template Compliance
+
+| Rule | Status | Details |
+|------|--------|---------|
+| Used correct template | ✅ / ❌ | `[Template name]` |
+| All required sections present | ✅ / ❌ | `[Missing sections]` |
+| YAML frontmatter valid | ✅ / ❌ | `[Errors]` |
+
+### Workflow Steps
+
+| Rule | Status | Details |
+|------|--------|---------|
+| Followed all mandatory steps | ✅ / ❌ | `[Skipped steps]` |
+| Pre-flight checklist completed | ✅ / ❌ | `[Details]` |
+| Enforcement gates passed | ✅ / ❌ | `[Failed gates]` |
+
+---
+
+## Violations Detected
+
+### Critical Violations (Require Immediate Action)
+
+#### Violation #1
+- **Type:** `[Code Quality / Naming / Template / Workflow]`
+- **Severity:** CRITICAL
+- **Rule:** `[Rule name]`
+- **Location:** `[file:line]`
+- **Description:** `[What was violated]`
+- **Impact:** `[Why this matters]`
+- **Recommendation:** `[How to fix]`
+
+### Warning Violations (Should Be Fixed)
+
+#### Violation #2
+- **Type:** `[Type]`
+- **Severity:** WARNING
+- **Rule:** `[Rule name]`
+- **Location:** `[file:line]`
+- **Description:** `[What was violated]`
+- **Recommendation:** `[How to fix]`
+
+### Auto-Corrected Violations
+
+#### Violation #3
+- **Type:** `[Type]`
+- **Severity:** INFO
+- **Rule:** `[Rule name]`
+- **Location:** `[file:line]`
+- **Description:** `[What was violated]`
+- **Action Taken:** `[What Observer did to fix it]`
+
+---
+
+## Compliance Trends
+
+**Previous Reports:**
+- 2 days ago: 85/100
+- 1 day ago: 90/100
+- Today: `[SCORE]`/100
+
+**Trend:** ⬆️ Improving | ➡️ Stable | ⬇️ Declining
+
+---
+
+## Recommendations
+
+### Immediate Actions Required
+1. `[Action 1]`
+2. `[Action 2]`
+
+### Suggested Improvements
+1. `[Suggestion 1]`
+2. `[Suggestion 2]`
+
+### Learning Opportunities
+- Consider updating rule: `[Rule name]` based on this pattern
+- Add to anti-patterns KB: `[Pattern description]`
+
+---
+
+## Next Steps
+
+- [ ] Fix critical violations
+- [ ] Review warning violations
+- [ ] Update auto-correction rules if needed
+- [ ] Sync learnings to Neo4j
+
+---
+
+**Observer Agent:** v1.0.0  
+**Report Generated At:** `[TIMESTAMP]`

package/.agent/templates/quality-score-report.md

@@ -0,0 +1,197 @@
+# Quality Score Report
+
+**Report ID:** `[AUTO-GENERATED]`  
+**Generated:** `[TIMESTAMP]`  
+**Target:** `[FILE_PATH or REPORT_PATH]`  
+**Type:** Code | Report | Documentation
+
+---
+
+## Executive Summary
+
+**Overall Quality Score:** `[0-100]` / 100  
+**Grade:** A+ | A | B | C | D | F  
+**Status:** ✅ PASS | ⚠️ NEEDS IMPROVEMENT | ❌ FAIL
+
+---
+
+## Score Breakdown
+
+### For Code Files
+
+#### Complexity Score: `[0-100]` / 100
+- **Cyclomatic Complexity:** `[VALUE]` (Target: < 10)
+- **Nesting Depth:** `[VALUE]` (Target: < 4)
+- **Function Length:** `[VALUE]` lines (Target: < 50)
+- **Class Size:** `[VALUE]` lines (Target: < 300)
+
+**Grade:** A+ (90-100) | A (80-89) | B (70-79) | C (60-69) | D (50-59) | F (< 50)
+
+#### Readability Score: `[0-100]` / 100
+- **Naming Quality:** Clear | Acceptable | Needs Improvement
+- **Comment Coverage:** `[VALUE]%` (Target: > 10%)
+- **Code Structure:** Excellent | Good | Fair | Poor
+- **Consistency:** `[VALUE]%` (Target: > 90%)
+
+**Grade:** A+ | A | B | C | D | F
+
+#### Security Score: `[0-100]` / 100
+- **Known Vulnerabilities:** `[COUNT]`
+- **Security Best Practices:** `[COMPLIANCE]%`
+- **Input Validation:** Present | Missing
+- **Error Handling:** Robust | Basic | Insufficient
+
+**Grade:** A+ | A | B | C | D | F
+
+#### Performance Score: `[0-100]` / 100
+- **Algorithmic Efficiency:** O(`[COMPLEXITY]`)
+- **Memory Usage:** Optimal | Acceptable | High
+- **Database Queries:** Optimized | N+1 Issues | Inefficient
+- **Caching Strategy:** Present | Missing
+
+**Grade:** A+ | A | B | C | D | F
+
+#### Maintainability Score: `[0-100]` / 100
+- **Modularity:** Excellent | Good | Fair | Poor
+- **DRY Principle:** `[COMPLIANCE]%`
+- **SOLID Principles:** `[COMPLIANCE]%`
+- **Test Coverage:** `[VALUE]%` (Target: > 80%)
+
+**Grade:** A+ | A | B | C | D | F
+
+---
+
+### For Reports/Documentation
+
+#### Completeness Score: `[0-100]` / 100
+- **Required Sections Present:** `[COUNT/TOTAL]`
+- **Missing Sections:** `[LIST]`
+- **YAML Frontmatter:** Valid | Invalid | Missing
+- **Template Compliance:** `[COMPLIANCE]%`
+
+**Grade:** A+ | A | B | C | D | F
+
+#### Clarity Score: `[0-100]` / 100
+- **Writing Quality:** Excellent | Good | Fair | Poor
+- **Structure:** Logical | Acceptable | Confusing
+- **Technical Accuracy:** `[COMPLIANCE]%`
+- **Readability Level:** `[GRADE_LEVEL]`
+
+**Grade:** A+ | A | B | C | D | F
+
+#### Accuracy Score: `[0-100]` / 100
+- **Factual Errors:** `[COUNT]`
+- **Technical Correctness:** `[COMPLIANCE]%`
+- **Data Consistency:** Consistent | Some Issues | Inconsistent
+- **References:** Complete | Partial | Missing
+
+**Grade:** A+ | A | B | C | D | F
+
+#### Actionability Score: `[0-100]` / 100
+- **Clear Next Steps:** Present | Vague | Missing
+- **Specific Recommendations:** `[COUNT]`
+- **Implementation Guidance:** Detailed | Basic | Absent
+- **Decision Support:** Strong | Adequate | Weak
+
+**Grade:** A+ | A | B | C | D | F
+
+---
+
+## Detailed Findings
+
+### Strengths 💪
+1. `[Strength 1]`
+2. `[Strength 2]`
+3. `[Strength 3]`
+
+### Weaknesses ⚠️
+1. `[Weakness 1]`
+   - **Impact:** `[Description]`
+   - **Recommendation:** `[How to fix]`
+
+2. `[Weakness 2]`
+   - **Impact:** `[Description]`
+   - **Recommendation:** `[How to fix]`
+
+### Critical Issues 🚨
+1. `[Critical Issue 1]`
+   - **Severity:** CRITICAL
+   - **Impact:** `[Description]`
+   - **Required Action:** `[What must be done]`
+
+---
+
+## Comparison with Standards
+
+| Metric | Current | Target | Status |
+|--------|---------|--------|---------|
+| Overall Score | `[VALUE]` | 80 | ✅ / ❌ |
+| Complexity | `[VALUE]` | < 10 | ✅ / ❌ |
+| Test Coverage | `[VALUE]%` | > 80% | ✅ / ❌ |
+| Security | `[VALUE]` | 90 | ✅ / ❌ |
+| Maintainability | `[VALUE]` | 80 | ✅ / ❌ |
+
+---
+
+## Historical Trend
+
+**Score Over Time:**
+- 2 weeks ago: `[SCORE]`
+- 1 week ago: `[SCORE]`
+- Today: `[SCORE]`
+
+**Trend:** ⬆️ Improving | ➡️ Stable | ⬇️ Declining
+
+**Improvement Rate:** `[+/- X points]` per week
+
+---
+
+## Improvement Recommendations
+
+### High Priority (Fix Immediately)
+1. `[Recommendation 1]`
+   - **Category:** `[Complexity/Security/etc.]`
+   - **Expected Impact:** `[+X points]`
+   - **Effort:** Low | Medium | High
+
+2. `[Recommendation 2]`
+   - **Category:** `[Category]`
+   - **Expected Impact:** `[+X points]`
+   - **Effort:** Low | Medium | High
+
+### Medium Priority (Fix Soon)
+1. `[Recommendation 1]`
+2. `[Recommendation 2]`
+
+### Low Priority (Nice to Have)
+1. `[Recommendation 1]`
+2. `[Recommendation 2]`
+
+---
+
+## Learning Opportunities
+
+**Patterns to Replicate:**
+- `[Good pattern 1]` - Should be added to KB
+
+**Anti-Patterns to Avoid:**
+- `[Bad pattern 1]` - Should be documented as anti-pattern
+
+**Skills to Develop:**
+- `[Skill 1]` - Recommended learning path: `[Link to Neo4j path]`
+
+---
+
+## Next Steps
+
+- [ ] Address critical issues
+- [ ] Implement high-priority recommendations
+- [ ] Re-run quality check after fixes
+- [ ] Update KB with learnings
+- [ ] Sync to Neo4j
+
+---
+
+**Judge Agent:** v1.0.0  
+**Scoring Algorithm:** v2.0  
+**Report Generated At:** `[TIMESTAMP]`

package/.agent/templates/self-learning-digest.md

@@ -0,0 +1,268 @@
+# Self-Learning Digest
+
+**Period:** `[START_DATE]` to `[END_DATE]`  
+**Generated:** `[TIMESTAMP]`
+
+---
+
+## Executive Summary
+
+**New Learnings:** `[COUNT]`  
+**Patterns Identified:** `[COUNT]`  
+**Rules Updated:** `[COUNT]`  
+**KB Entries Added:** `[COUNT]`  
+**Neo4j Relationships Created:** `[COUNT]`
+
+---
+
+## Learning Sources
+
+### From Observer Violations
+**Total Violations Analyzed:** `[COUNT]`
+
+#### New Rules Proposed
+1. **Rule:** `[Rule name]`
+   - **Reason:** Violation occurred `[X]` times
+   - **Pattern:** `[Description]`
+   - **Proposed Action:** Add to `.agent/rules/[file].md`
+
+2. **Rule:** `[Rule name]`
+   - **Reason:** `[Description]`
+   - **Proposed Action:** `[Action]`
+
+### From A/B Test Results
+**Total Tests Analyzed:** `[COUNT]`
+
+#### Winning Patterns
+1. **Pattern:** `[Pattern name]`
+   - **Context:** `[When this works best]`
+   - **Success Rate:** `[X]%` (Alternative A chosen `[Y]` times)
+   - **Key Factors:** `[Why it wins]`
+   - **Add to KB:** Yes | No
+
+2. **Pattern:** `[Pattern name]`
+   - **Context:** `[Description]`
+   - **Success Rate:** `[X]%`
+
+### From Judge Scores
+**Total Scores Analyzed:** `[COUNT]`
+
+#### Quality Patterns (High Scores)
+1. **Pattern:** `[What high-quality code/docs have in common]`
+   - **Average Score:** `[SCORE]` / 100
+   - **Common Traits:**
+     - `[Trait 1]`
+     - `[Trait 2]`
+   - **Recommendation:** Replicate this pattern
+
+#### Anti-Patterns (Low Scores)
+1. **Anti-Pattern:** `[What to avoid]`
+   - **Average Score:** `[SCORE]` / 100
+   - **Common Issues:**
+     - `[Issue 1]`
+     - `[Issue 2]`
+   - **Recommendation:** Document as anti-pattern in KB
+
+### From Completed Tasks
+**Total Tasks Analyzed:** `[COUNT]`
+
+#### Reusable Solutions
+1. **Solution:** `[Solution name]`
+   - **Task Type:** `[Type]`
+   - **Success Rate:** `[X]%`
+   - **Implementation:** `[Brief description]`
+   - **Use When:** `[Context]`
+   - **KB Entry:** `[Link or "Created"]`
+
+2. **Solution:** `[Solution name]`
+   - **Details:** `[Description]`
+
+### From Fixed Bugs
+**Total Bugs Analyzed:** `[COUNT]`
+
+#### Error Patterns
+1. **Error:** `[Error type]`
+   - **Frequency:** Occurred `[X]` times
+   - **Root Cause:** `[Description]`
+   - **Resolution Pattern:** `[How it was fixed]`
+   - **Prevention:** `[How to avoid in future]`
+   - **Add to KB:** Yes | No
+
+2. **Error:** `[Error type]`
+   - **Details:** `[Description]`
+
+### From Security Issues
+**Total Security Issues Analyzed:** `[COUNT]`
+
+#### Security Best Practices
+1. **Practice:** `[Practice name]`
+   - **Vulnerability Prevented:** `[Type]`
+   - **Implementation:** `[How to implement]`
+   - **Priority:** Critical | High | Medium | Low
+   - **Add to Rules:** Yes | No
+
+---
+
+## Identified Patterns
+
+### Successful Patterns (Replicate These)
+1. **Pattern Name:** `[Name]`
+   - **Category:** Architecture | Code Quality | Process | Documentation
+   - **Description:** `[What the pattern is]`
+   - **Examples:** `[Where we've seen this work]`
+   - **When to Use:** `[Context]`
+   - **Expected Benefits:** `[Benefits]`
+
+2. **Pattern Name:** `[Name]`
+   - **Details:** `[Description]`
+
+### Anti-Patterns (Avoid These)
+1. **Anti-Pattern Name:** `[Name]`
+   - **Category:** Architecture | Code Quality | Process | Documentation
+   - **Description:** `[What the anti-pattern is]`
+   - **Examples:** `[Where we've seen this fail]`
+   - **Why It Fails:** `[Reason]`
+   - **Better Alternative:** `[What to do instead]`
+
+2. **Anti-Pattern Name:** `[Name]`
+   - **Details:** `[Description]`
+
+---
+
+## Knowledge Base Updates
+
+### New Entries Created
+1. **Entry:** `[Title]`
+   - **Type:** Solution | Bug Fix | Pattern | Anti-Pattern
+   - **Location:** `docs/solutions/[filename].md`
+   - **Tags:** `[tag1, tag2, tag3]`
+   - **Synced to Neo4j:** ✅ | ⏳
+
+2. **Entry:** `[Title]`
+   - **Details:** `[Description]`
+
+### Entries Updated
+1. **Entry:** `[Title]`
+   - **Change:** `[What was updated]`
+   - **Reason:** `[Why it was updated]`
+
+---
+
+## Neo4j Graph Updates
+
+### New Relationships Created
+1. **Relationship:** `(Technology)-[:WORKS_WELL_WITH]->(Technology)`
+   - **Example:** `(React)-[:WORKS_WELL_WITH]->(TypeScript)`
+   - **Confidence:** `[0-100]`
+   - **Based On:** `[X tasks]`
+
+2. **Relationship:** `(Pattern)-[:SOLVES]->(Problem)`
+   - **Example:** `[Description]`
+
+### Skills Graph Enrichment
+- **New Skills Added:** `[COUNT]`
+- **Skill Relationships Updated:** `[COUNT]`
+- **Learning Paths Created:** `[COUNT]`
+
+---
+
+## Recommendations for Rules Updates
+
+### Proposed New Rules
+1. **File:** `.agent/rules/code-quality.md`
+   - **Rule:** `[Rule description]`
+   - **Justification:** Violation/issue occurred `[X]` times
+   - **Priority:** High | Medium | Low
+
+2. **File:** `.agent/rules/naming-conventions.md`
+   - **Rule:** `[Rule description]`
+   - **Justification:** `[Reason]`
+
+### Proposed Rule Modifications
+1. **File:** `.agent/rules/global.md`
+   - **Current Rule:** `[Existing rule]`
+   - **Proposed Change:** `[New version]`
+   - **Reason:** `[Why change is needed]`
+
+---
+
+## Technology Insights
+
+### Technologies Used This Period
+| Technology | Usage Count | Success Rate | Average Quality Score |
+|------------|-------------|--------------|----------------------|
+| `[Tech 1]` | `[COUNT]` | `[X]%` | `[SCORE]` / 100 |
+| `[Tech 2]` | `[COUNT]` | `[X]%` | `[SCORE]` / 100 |
+
+### Recommended Technologies
+- **For `[Use Case]`:** `[Technology]` - Based on `[X]` successful implementations
+- **For `[Use Case]`:** `[Technology]` - Based on high quality scores
+
+### Technologies to Reconsider
+- **`[Technology]`:** Low success rate (`[X]%`) or quality score (`[SCORE]`)
+  - **Recommendation:** `[Find alternative | Improve skills | Avoid for [use case]]`
+
+---
+
+## Team Skill Development
+
+### Skills Improving
+- **`[Skill]`:** Quality score trend `[OLD]` → `[NEW]` (+`[DELTA]` points)
+- **`[Skill]`:** Fewer violations, better patterns
+
+### Skills Needing Focus
+- **`[Skill]`:** Frequent violations or low quality scores
+  - **Recommended Learning Path:** `[Neo4j path link]`
+  - **Practice Tasks:** `[Suggestions]`
+
+---
+
+## Action Items
+
+### Immediate Actions
+- [ ] Update `.agent/rules/[file].md` with new rules
+- [ ] Add `[X]` new KB entries
+- [ ] Sync learnings to Neo4j
+- [ ] Share anti-patterns with team
+
+### This Week
+- [ ] Review and apply winning patterns from A/B tests
+- [ ] Address recurring error patterns
+- [ ] Update skill development plan
+
+### This Month
+- [ ] Comprehensive rules review
+- [ ] KB quality audit
+- [ ] Neo4j graph optimization
+
+---
+
+## Learning Metrics
+
+**Knowledge Growth:**
+- KB Entries: `[OLD_COUNT]` → `[NEW_COUNT]` (+`[DELTA]`)
+- Neo4j Nodes: `[OLD_COUNT]` → `[NEW_COUNT]` (+`[DELTA]`)
+- Patterns Library: `[COUNT]` patterns documented
+
+**Quality Improvement:**
+- Average Code Score: `[OLD]` → `[NEW]` (+`[DELTA]`)
+- Compliance Rate: `[OLD]%` → `[NEW]%` (+`[DELTA]%`)
+- Bug Recurrence: `[OLD]` → `[NEW]` (-`[DELTA]`)
+
+---
+
+## Next Learning Cycle
+
+**Focus Areas:**
+1. `[Area 1]` - Based on `[Data source]`
+2. `[Area 2]` - Based on `[Data source]`
+
+**Expected Outcomes:**
+- `[Outcome 1]`
+- `[Outcome 2]`
+
+---
+
+**Self-Learning Agent:** v1.0.0  
+**Learning Period:** `[DAYS]` days  
+**Report Generated At:** `[TIMESTAMP]`