agentic-sdlc 1.6.0 → 1.8.1

package/.agent/templates/Specification-Template.md

@@ -0,0 +1,38 @@
+# Specification: [Feature Name]
+
+## 1. Problem Statement
+**Context:** [Brief background]
+**Problem:** [What specific problem are we solving?]
+**Goal:** [What is the desired outcome?]
+
+## 2. User Stories
+| Actor | I want to... | So that... | Priority |
+|-------|--------------|------------|----------|
+| User | [Action] | [Benefit] | P0/P1 |
+| Admin | [Action] | [Benefit] | P2 |
+
+## 3. Functional Requirements
+### 3.1 Core Capabilities
+- [ ] System MUST ...
+- [ ] System SHOULD ...
+
+### 3.2 Inputs & Outputs
+- **Input:** [Data/Action]
+- **Output:** [Data/Response]
+
+## 4. User Experience (Flow)
+1. **Trigger:** [Start event]
+2. **Step 1:** [User action]
+3. **Step 2:** [System response]
+4. **End State:** [Final outcome]
+
+## 5. Non-Functional Requirements
+- **Performance:** [Latency/Throughput goals]
+- **Security:** [Auth/Permissions]
+- **Compatibility:** [Browsers/OS]
+
+## 6. Questions & Assumptions
+- [?] [Question 1]
+- [!] [Assumption 1]
+
+#specification #requirements

package/.agent/templates/ab-comparison-report.md

@@ -0,0 +1,175 @@
+# A/B Comparison Report
+
+**Report ID:** `[AUTO-GENERATED]`  
+**Generated:** `[TIMESTAMP]`  
+**Prompt:** `[USER_PROMPT]`
+
+---
+
+## Executive Summary
+
+**Decision Context:** `[Brief description of what needs to be decided]`
+
+**Recommendation:** Option A | Option B | Tie
+
+**Confidence Level:** High | Medium | Low
+
+---
+
+## Alternative A: `[APPROACH_NAME]`
+
+### Description
+`[Detailed description of Alternative A]`
+
+### Implementation Approach
+```
+[Step-by-step approach for Alternative A]
+1. Step 1
+2. Step 2
+3. ...
+```
+
+### Pros
+- ✅ `[Advantage 1]`
+- ✅ `[Advantage 2]`
+- ✅ `[Advantage 3]`
+
+### Cons
+- ❌ `[Disadvantage 1]`
+- ❌ `[Disadvantage 2]`
+
+### Scores (0-100)
+
+| Dimension | Score | Justification |
+|-----------|-------|---------------|
+| **Time to Implement** | `[0-100]` | `[Why this score]` |
+| **Complexity** | `[0-100]` | `[Why this score]` |
+| **Reliability** | `[0-100]` | `[Why this score]` |
+| **Maintainability** | `[0-100]` | `[Why this score]` |
+| **Scalability** | `[0-100]` | `[Why this score]` |
+| **Cost** | `[0-100]` | `[Why this score]` |
+
+**Total Score:** `[AVERAGE]` / 100
+
+### Past Similar Solutions
+`[KB search results - what we've done before that's similar]`
+- Solution 1: `[Link to KB entry]`
+- Solution 2: `[Link to KB entry]`
+
+### Related Technologies (Neo4j)
+`[Technologies/skills from Neo4j graph]`
+- Tech 1: `[Relationship]`
+- Tech 2: `[Relationship]`
+
+---
+
+## Alternative B: `[APPROACH_NAME]`
+
+### Description
+`[Detailed description of Alternative B]`
+
+### Implementation Approach
+```
+[Step-by-step approach for Alternative B]
+1. Step 1
+2. Step 2
+3. ...
+```
+
+### Pros
+- ✅ `[Advantage 1]`
+- ✅ `[Advantage 2]`
+- ✅ `[Advantage 3]`
+
+### Cons
+- ❌ `[Disadvantage 1]`
+- ❌ `[Disadvantage 2]`
+
+### Scores (0-100)
+
+| Dimension | Score | Justification |
+|-----------|-------|---------------|
+| **Time to Implement** | `[0-100]` | `[Why this score]` |
+| **Complexity** | `[0-100]` | `[Why this score]` |
+| **Reliability** | `[0-100]` | `[Why this score]` |
+| **Maintainability** | `[0-100]` | `[Why this score]` |
+| **Scalability** | `[0-100]` | `[Why this score]` |
+| **Cost** | `[0-100]` | `[Why this score]` |
+
+**Total Score:** `[AVERAGE]` / 100
+
+### Past Similar Solutions
+`[KB search results]`
+- Solution 1: `[Link to KB entry]`
+- Solution 2: `[Link to KB entry]`
+
+### Related Technologies (Neo4j)
+`[Technologies/skills from Neo4j graph]`
+- Tech 1: `[Relationship]`
+- Tech 2: `[Relationship]`
+
+---
+
+## Side-by-Side Comparison
+
+| Aspect | Alternative A | Alternative B | Winner |
+|--------|---------------|---------------|---------|
+| Time to Implement | `[Score]` | `[Score]` | A / B / Tie |
+| Complexity | `[Score]` | `[Score]` | A / B / Tie |
+| Reliability | `[Score]` | `[Score]` | A / B / Tie |
+| Maintainability | `[Score]` | `[Score]` | A / B / Tie |
+| Scalability | `[Score]` | `[Score]` | A / B / Tie |
+| Cost | `[Score]` | `[Score]` | A / B / Tie |
+| **Overall** | `[Total]` | `[Total]` | **A / B / Tie** |
+
+---
+
+## Recommendation
+
+### Preferred Option: `[A or B]`
+
+**Rationale:**
+`[Detailed explanation of why this option is recommended]`
+
+**When to Choose Alternative A:**
+- Scenario 1: `[Description]`
+- Scenario 2: `[Description]`
+
+**When to Choose Alternative B:**
+- Scenario 1: `[Description]`
+- Scenario 2: `[Description]`
+
+**Risk Factors:**
+- Risk 1: `[Description and mitigation]`
+- Risk 2: `[Description and mitigation]`
+
+---
+
+## Research Sources
+
+### Knowledge Base Entries Used
+- `[KB entry 1]` - `[Relevance]`
+- `[KB entry 2]` - `[Relevance]`
+
+### Neo4j Graph Insights
+- `[Graph insight 1]`
+- `[Graph insight 2]`
+
+### External Research (MCP)
+- `[External source 1]`
+- `[External source 2]`
+
+---
+
+## Next Steps
+
+- [ ] Review both alternatives with stakeholders
+- [ ] Make final decision
+- [ ] Create implementation plan for chosen option
+- [ ] Record decision in KB for future reference
+
+---
+
+**A/B Test Agent:** v1.0.0  
+**Judge Score:** `[If this report was scored]` / 100  
+**Report Generated At:** `[TIMESTAMP]`

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