agentic-sdlc 1.6.0 → 1.8.1

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]`

package/.agent/templates/system-health-report.md

@@ -0,0 +1,330 @@
+# System Health Report
+
+**Report ID:** `[AUTO-GENERATED]`  
+**Generated:** `[TIMESTAMP]`  
+**System Version:** `[VERSION]`
+
+---
+
+## Executive Summary
+
+**Overall Health Score:** `[0-100]` / 100  
+**Status:** 🟢 HEALTHY | 🟡 WARNING | 🔴 CRITICAL  
+**Issues Found:** `[COUNT]`  
+**Components Checked:** `[COUNT]`
+
+---
+
+## Component Health Check
+
+| Component | Status | Score | Last Check |
+|-----------|--------|-------|------------|
+| Layer 1 (Core) | 🟢 / 🟡 / 🔴 | `[0-100]` | `[TIME]` |
+| Layer 2 (Intelligence) | 🟢 / 🟡 / 🔴 | `[0-100]` | `[TIME]` |
+| Layer 3 (Infrastructure) | 🟢 / 🟡 / 🔴 | `[0-100]` | `[TIME]` |
+| Knowledge Base | 🟢 / 🟡 / 🔴 | `[0-100]` | `[TIME]` |
+| Neo4j Graph | 🟢 / 🟡 / 🔴 | `[0-100]` | `[TIME]` |
+| MCP Connectors | 🟢 / 🟡 / 🔴 | `[0-100]` | `[TIME]` |
+
+---
+
+## Missing Components
+
+### Documentation Gaps
+- **Missing:** `[COUNT]` files without documentation
+- **Critical Files:**
+  - `[file1.ext]` - No header comments
+  - `[file2.ext]` - No README
+  - `[file3.ext]` - Missing API docs
+
+**Recommendation:** Add documentation for high-priority files first
+
+### Test Coverage Gaps
+- **Overall Coverage:** `[X]%` (Target: 80%+)
+- **Files with No Tests:**
+  - `[file1.ext]`
+  - `[file2.ext]`
+  - `[file3.ext]`
+
+**Recommendation:** Focus on core business logic first
+
+### Missing Artifacts
+- **Sprint Plan:** Missing for Sprint `[N]`
+- **Walkthroughs:** `[COUNT]` completed tasks without walkthrough
+- **Architecture Docs:** `[Component]` not documented
+
+**Recommendation:** Document recent completions immediately
+
+---
+
+## Improvements Needed
+
+### Low-Quality Code (Judge Score < 70)
+
+#### File: `[file1.ext]`
+- **Quality Score:** `[SCORE]` / 100
+- **Issues:**
+  - High complexity (cyclomatic: `[VALUE]`)
+  - Poor naming
+  - No tests
+- **Priority:** High | Medium | Low
+- **Recommendation:** `[Specific actions]`
+
+#### File: `[file2.ext]`
+- **Quality Score:** `[SCORE]` / 100
+- **Issues:** `[Description]`
+- **Recommendation:** `[Actions]`
+
+### Architecture Debt
+- **Issue:** `[Description]`
+  - **Location:** `[Component/files]`
+  - **Impact:** `[Impact description]`
+  - **Recommendation:** `[How to address]`
+  - **Effort:** Low | Medium | High
+
+### Performance Bottlenecks
+- **Function:** `[function_name]` in `[file.ext]`
+  - **Issue:** O(n²) complexity
+  - **Impact:** Slow for large datasets
+  - **Recommendation:** Use hash map instead of nested loops
+  - **Priority:** High | Medium | Low
+
+---
+
+## Obsolete Code
+
+### Unused Files
+- `[file1.ext]` - Last used: `[DATE]` (> 90 days ago)
+- `[file2.ext]` - No imports/references found
+- `[file3.ext]` - Replaced by `[new_file.ext]`
+
+**Recommendation:** Review and delete if confirmed unused
+
+### Deprecated Functions
+- `[old_function]` in `[file.ext]`
+  - **Deprecated Since:** `[DATE]`
+  - **Replacement:** `[new_function]`
+  - **Still Used In:** `[X]` files
+  - **Recommendation:** Migrate to new function
+
+### Dead Code Paths
+- `[code_block]` in `[file.ext:line]`
+  - **Reason:** Unreachable code
+  - **Recommendation:** Remove
+
+---
+
+## Compliance Trends
+
+### Observer Violation Rate
+**Current Period:** `[START]` to `[END]`
+
+| Period | Violations | Compliance % | Trend |
+|--------|------------|--------------|-------|
+| 2 weeks ago | `[COUNT]` | `[X]%` | - |
+| 1 week ago | `[COUNT]` | `[X]%` | ⬆️/⬇️/➡️ |
+| This week | `[COUNT]` | `[X]%` | ⬆️/⬇️/➡️ |
+
+**Overall Trend:** ⬆️ Improving | ➡️ Stable | ⬇️ Declining
+
+### Most Common Violations
+1. `[Violation type]` - `[COUNT]` occurrences
+2. `[Violation type]` - `[COUNT]` occurrences
+3. `[Violation type]` - `[COUNT]` occurrences
+
+**Recommendation:** Focus on top 3 violations for maximum impact
+
+---
+
+## Test Coverage Analysis
+
+### Overall Coverage
+- **Unit Tests:** `[X]%` (Target: 80%+)
+- **Integration Tests:** `[X]%` (Target: 60%+)
+- **E2E Tests:** `[X]%` (Target: 40%+)
+
+### Coverage by Component
+| Component | Coverage | Status | Priority |
+|-----------|----------|--------|----------|
+| `[Component 1]` | `[X]%` | 🟢/🟡/🔴 | High/Med/Low |
+| `[Component 2]` | `[X]%` | 🟢/🟡/🔴 | High/Med/Low |
+
+### Critical Paths Without Tests
+1. `[Critical path 1]`
+   - **Risk:** High | Medium | Low
+   - **Recommendation:** Add tests immediately
+
+2. `[Critical path 2]`
+   - **Details:** `[Description]`
+
+---
+
+## Performance Metrics
+
+### Response Times
+| Endpoint/Function | Avg | P95 | P99 | Status |
+|-------------------|-----|-----|-----|--------|
+| `[endpoint1]` | `[X]ms` | `[X]ms` | `[X]ms` | 🟢/🟡/🔴 |
+| `[endpoint2]` | `[X]ms` | `[X]ms` | `[X]ms` | 🟢/🟡/🔴 |
+
+**Targets:**
+- Avg < 200ms: 🟢
+- Avg < 500ms: 🟡  
+- Avg > 500ms: 🔴
+
+### Memory Usage
+- **Current:** `[X]MB`
+- **Peak:** `[X]MB`
+- **Trend:** ⬆️ Increasing | ➡️ Stable | ⬇️ Decreasing
+
+**Memory Leaks Detected:** `[COUNT]`
+- `[Location 1]` - `[Description]`
+
+### Database Performance
+- **Slow Queries:** `[COUNT]`
+- **N+1 Queries:** `[COUNT]`
+- **Missing Indexes:** `[COUNT]`
+
+**Top Slow Query:**
+```sql
+[QUERY]
+```
+**Recommendation:** `[Optimization suggestion]`
+
+---
+
+## Security Health
+
+### Known Vulnerabilities
+- **Critical:** `[COUNT]`
+- **High:** `[COUNT]`
+- **Medium:** `[COUNT]`
+- **Low:** `[COUNT]`
+
+### Vulnerabilities Details
+1. **CVE-XXXX-XXXXX** in `[dependency]`
+   - **Severity:** Critical | High | Medium | Low
+   - **Impact:** `[Description]`
+   - **Fix:** Update to version `[X.Y.Z]`
+
+### Security Best Practices Compliance
+- **Input Validation:** `[X]%` covered
+- **SQL Injection Protection:** `[X]%` covered
+- **XSS Protection:** `[X]%` covered
+- **Authentication:** Implemented | Partial | Missing
+- **Authorization:** Implemented | Partial | Missing
+
+---
+
+## Knowledge Base Health
+
+### KB Statistics
+- **Total Entries:** `[COUNT]`
+- **Entries Added (Last 30 days):** `[COUNT]`
+- **Orphan Entries:** `[COUNT]` (not linked from anywhere)
+- **Stale Entries:** `[COUNT]` (> 180 days old, no updates)
+
+### KB Quality
+- **Well-Documented:** `[X]%`
+- **Missing Tags:** `[COUNT]` entries
+- **Missing Examples:** `[COUNT]` entries
+- **Broken Links:** `[COUNT]`
+
+**Recommendation:** Review and update stale entries
+
+---
+
+## Neo4j Graph Health
+
+### Graph Statistics
+- **Total Nodes:** `[COUNT]`
+- **Total Relationships:** `[COUNT]`
+- **Orphan Nodes:** `[COUNT]` (no relationships)
+- **Last Sync:** `[TIMESTAMP]`
+
+### Graph Quality
+- **Schema Compliance:** `[X]%`
+- **Data Completeness:** `[X]%`
+- **Relationship Accuracy:** `[X]%`
+
+**Recommendation:** Sync and cleanup recommended
+
+---
+
+## Improvement Actions
+
+### Critical (Do Immediately)
+1. **`[Action 1]`**
+   - **Issue:** `[Description]`
+   - **Impact:** High | Medium | Low
+   - **Effort:** `[TIME]` hours
+   - **Owner:** `[Team/Role]`
+
+2. **`[Action 2]`**
+   - **Details:** `[Description]`
+
+### High Priority (This Week)
+1. `[Action 1]`
+2. `[Action 2]`
+3. `[Action 3]`
+
+### Medium Priority (This Sprint)
+1. `[Action 1]`
+2. `[Action 2]`
+
+### Low Priority (Backlog)
+1. `[Action 1]`
+2. `[Action 2]`
+
+---
+
+## Maintenance Schedule
+
+### Daily
+- [ ] Check Observer compliance report
+- [ ] Review new violations
+- [ ] Monitor performance metrics
+
+### Weekly  
+- [ ] Review this health report
+- [ ] Address critical issues
+- [ ] Update KB with new learnings
+- [ ] Sync to Neo4j
+
+### Monthly
+- [ ] Comprehensive code quality review
+- [ ] Security audit
+- [ ] Documentation update sprint
+- [ ] Performance optimization sprint
+
+---
+
+## Trend Analysis
+
+### Health Score Trend
+| Period | Score | Change |
+|--------|-------|--------|
+| 3 months ago | `[SCORE]` | - |
+| 2 months ago | `[SCORE]` | `[+/-X]` |
+| 1 month ago | `[SCORE]` | `[+/-X]` |
+| Today | `[SCORE]` | `[+/-X]` |
+
+**Trend:** ⬆️ Improving | ➡️ Stable | ⬇️ Declining
+
+### Issue Resolution Rate
+- **New Issues:** `[COUNT]` per week
+- **Resolved Issues:** `[COUNT]` per week
+- **Net Change:** `[+/-X]` per week
+
+---
+
+## Next Health Check
+
+**Scheduled For:** `[DATE]`  
+**Focus Areas:** `[Based on this report's findings]`
+
+---
+
+**Monitor Agent:** v1.0.0  
+**Health Check Duration:** `[X]` seconds  
+**Report Generated At:** `[TIMESTAMP]`

package/.agent/workflows/ab.md

@@ -0,0 +1,101 @@
+---
+description: Intelligence - A/B Test - Generate Alternatives
+---
+
+# /ab - A/B Testing for Decisions
+
+## ⚠️ PURPOSE
+Generate and compare alternative approaches for any decision, architecture choice, or implementation strategy.
+
+// turbo-all
+
+## Quick Commands
+
+```bash
+# Generate A/B alternatives for a decision
+python tools/intelligence/ab_test/ab_tester.py --prompt "implement user authentication"
+
+# Compare two specific options
+python tools/intelligence/ab_test/ab_tester.py --compare "JWT tokens" "Session cookies"
+
+# Get recommendation based on context
+python tools/core/brain/brain_cli.py ab-test "Should we use JWT or Session Auth?"
+```
+
+## When to Use
+
+- Before major architectural decisions
+- When choosing between technologies
+- For implementation strategy choices
+- During design phase
+
+## Workflow Steps
+
+### 1. Define the Decision
+Clearly state the decision or choice you need to make.
+
+### 2. Generate Alternatives
+```bash
+python tools/intelligence/ab_test/ab_tester.py --prompt "[your decision]"
+```
+This will:
+- Generate 2 alternative approaches
+- Search KB for past similar solutions
+- Score each option
+
+### 3. Review Comparison Report
+Check the generated report at `docs/reports/ab_tests/YYYY-MM-DD-[topic].md`
+
+### 4. Make Decision
+Based on:
+- Time estimate
+- Complexity score
+- Reliability rating
+- Maintainability score
+
+### 5. Document Choice
+```bash
+# Record the decision
+python tools/core/brain/brain_cli.py learn "Chose [Option] for [Decision] because [Reason]"
+```
+
+## Output
+
+The A/B test generates a comparison report:
+
+```markdown
+# A/B Test: [Decision]
+
+## Option A: [Name]
+- **Pros:** ...
+- **Cons:** ...
+- **Time Estimate:** ...
+- **Complexity:** X/10
+
+## Option B: [Name]
+- **Pros:** ...
+- **Cons:** ...
+- **Time Estimate:** ...
+- **Complexity:** X/10
+
+## Recommendation
+[Based on scoring...]
+```
+
+## Integration
+
+- **@SA** - Architecture decisions
+- **@PM** - Technology choices
+- **/explore** - Deep investigation
+- **/planning** - Planning phase decisions
+
+#ab-test #decisions #alternatives #comparison
+
+## ⏭️ Next Steps
+- **If Decision Made:** Proceed with `/cycle` or `/orchestrator`
+- **If More Research Needed:** Trigger `/explore`
+
+---
+
+## ENFORCEMENT REMINDER
+Document A/B test results for future reference.