devflow-kit 0.3.1 → 0.3.3

package/src/claude/agents/devflow/audit-architecture.md

@@ -81,4 +81,70 @@ For each finding, include:
 - Example implementations
 - Migration strategies for large changes
 
-Focus on structural issues that affect long-term maintainability and team productivity.
+Focus on structural issues that affect long-term maintainability and team productivity.
+
+## Report Storage
+
+**IMPORTANT**: When invoked by `/code-review`, save your audit report to the standardized location:
+
+```bash
+# Expect these variables from the orchestrator:
+# - CURRENT_BRANCH: Current git branch name
+# - AUDIT_BASE_DIR: Base directory (.docs/audits/${CURRENT_BRANCH})
+# - TIMESTAMP: Timestamp for report filename
+
+# Save report to:
+REPORT_FILE="${AUDIT_BASE_DIR}/architecture-report.${TIMESTAMP}.md"
+
+# Create report
+cat > "$REPORT_FILE" <<'EOF'
+# Architecture Audit Report
+
+**Branch**: ${CURRENT_BRANCH}
+**Date**: $(date +%Y-%m-%d)
+**Time**: $(date +%H:%M:%S)
+**Auditor**: DevFlow Architecture Agent
+
+---
+
+## Executive Summary
+
+{Brief summary of architectural quality}
+
+---
+
+## Critical Issues
+
+{CRITICAL severity fundamental architectural flaws}
+
+---
+
+## High Priority Issues
+
+{HIGH severity significant design issues}
+
+---
+
+## Medium Priority Issues
+
+{MEDIUM severity pattern inconsistencies}
+
+---
+
+## Low Priority Issues
+
+{LOW severity minor organizational improvements}
+
+---
+
+## Architecture Score: {X}/10
+
+**Recommendation**: {BLOCK MERGE | REVIEW REQUIRED | APPROVED WITH CONDITIONS | APPROVED}
+
+EOF
+
+echo "✅ Architecture audit report saved to: $REPORT_FILE"
+```
+
+**If invoked standalone** (not by /code-review), use a simpler path:
+- `.docs/audits/standalone/architecture-report.${TIMESTAMP}.md`

package/src/claude/agents/devflow/audit-complexity.md

@@ -99,4 +99,70 @@ For each finding, include:
 - Example improvements
 - Estimated effort for fixes
 
-Focus on complexity issues that significantly impact code maintainability, readability, and development velocity.
+Focus on complexity issues that significantly impact code maintainability, readability, and development velocity.
+
+## Report Storage
+
+**IMPORTANT**: When invoked by `/code-review`, save your audit report to the standardized location:
+
+```bash
+# Expect these variables from the orchestrator:
+# - CURRENT_BRANCH: Current git branch name
+# - AUDIT_BASE_DIR: Base directory (.docs/audits/${CURRENT_BRANCH})
+# - TIMESTAMP: Timestamp for report filename
+
+# Save report to:
+REPORT_FILE="${AUDIT_BASE_DIR}/complexity-report.${TIMESTAMP}.md"
+
+# Create report
+cat > "$REPORT_FILE" <<'EOF'
+# Complexity Audit Report
+
+**Branch**: ${CURRENT_BRANCH}
+**Date**: $(date +%Y-%m-%d)
+**Time**: $(date +%H:%M:%S)
+**Auditor**: DevFlow Complexity Agent
+
+---
+
+## Executive Summary
+
+{Brief summary of complexity and maintainability}
+
+---
+
+## Critical Issues
+
+{CRITICAL severity extremely complex code hampering development}
+
+---
+
+## High Priority Issues
+
+{HIGH severity significant complexity issues}
+
+---
+
+## Medium Priority Issues
+
+{MEDIUM severity moderate complexity improvements needed}
+
+---
+
+## Low Priority Issues
+
+{LOW severity minor complexity optimizations}
+
+---
+
+## Maintainability Score: {X}/10
+
+**Recommendation**: {BLOCK MERGE | REVIEW REQUIRED | APPROVED WITH CONDITIONS | APPROVED}
+
+EOF
+
+echo "✅ Complexity audit report saved to: $REPORT_FILE"
+```
+
+**If invoked standalone** (not by /code-review), use a simpler path:
+- `.docs/audits/standalone/complexity-report.${TIMESTAMP}.md`

package/src/claude/agents/devflow/audit-database.md

@@ -104,4 +104,70 @@ For each finding, include:
 - Migration considerations
 - Monitoring suggestions
 
-Focus on database issues that affect data integrity, query performance, or system scalability.
+Focus on database issues that affect data integrity, query performance, or system scalability.
+
+## Report Storage
+
+**IMPORTANT**: When invoked by `/code-review`, save your audit report to the standardized location:
+
+```bash
+# Expect these variables from the orchestrator:
+# - CURRENT_BRANCH: Current git branch name
+# - AUDIT_BASE_DIR: Base directory (.docs/audits/${CURRENT_BRANCH})
+# - TIMESTAMP: Timestamp for report filename
+
+# Save report to:
+REPORT_FILE="${AUDIT_BASE_DIR}/database-report.${TIMESTAMP}.md"
+
+# Create report
+cat > "$REPORT_FILE" <<'EOF'
+# Database Audit Report
+
+**Branch**: ${CURRENT_BRANCH}
+**Date**: $(date +%Y-%m-%d)
+**Time**: $(date +%H:%M:%S)
+**Auditor**: DevFlow Database Agent
+
+---
+
+## Executive Summary
+
+{Brief summary of database design and performance}
+
+---
+
+## Critical Issues
+
+{CRITICAL severity data integrity or severe performance issues}
+
+---
+
+## High Priority Issues
+
+{HIGH severity significant performance or design problems}
+
+---
+
+## Medium Priority Issues
+
+{MEDIUM severity optimization opportunities}
+
+---
+
+## Low Priority Issues
+
+{LOW severity minor improvements}
+
+---
+
+## Database Health Score: {X}/10
+
+**Recommendation**: {BLOCK MERGE | REVIEW REQUIRED | APPROVED WITH CONDITIONS | APPROVED}
+
+EOF
+
+echo "✅ Database audit report saved to: $REPORT_FILE"
+```
+
+**If invoked standalone** (not by /code-review), use a simpler path:
+- `.docs/audits/standalone/database-report.${TIMESTAMP}.md`

package/src/claude/agents/devflow/audit-dependencies.md

@@ -105,4 +105,70 @@ For each finding, include:
 - Alternative package suggestions
 - Update compatibility notes
 
-Focus on dependency issues that pose security, legal, or maintenance risks to the project.
+Focus on dependency issues that pose security, legal, or maintenance risks to the project.
+
+## Report Storage
+
+**IMPORTANT**: When invoked by `/code-review`, save your audit report to the standardized location:
+
+```bash
+# Expect these variables from the orchestrator:
+# - CURRENT_BRANCH: Current git branch name
+# - AUDIT_BASE_DIR: Base directory (.docs/audits/${CURRENT_BRANCH})
+# - TIMESTAMP: Timestamp for report filename
+
+# Save report to:
+REPORT_FILE="${AUDIT_BASE_DIR}/dependencies-report.${TIMESTAMP}.md"
+
+# Create report
+cat > "$REPORT_FILE" <<'EOF'
+# Dependency Audit Report
+
+**Branch**: ${CURRENT_BRANCH}
+**Date**: $(date +%Y-%m-%d)
+**Time**: $(date +%H:%M:%S)
+**Auditor**: DevFlow Dependencies Agent
+
+---
+
+## Executive Summary
+
+{Brief summary of dependency health and security}
+
+---
+
+## Critical Issues
+
+{CRITICAL severity security vulnerabilities requiring immediate action}
+
+---
+
+## High Priority Issues
+
+{HIGH severity significant security or legal risks}
+
+---
+
+## Medium Priority Issues
+
+{MEDIUM severity maintenance or performance concerns}
+
+---
+
+## Low Priority Issues
+
+{LOW severity minor improvements or optimizations}
+
+---
+
+## Dependency Health Score: {X}/10
+
+**Recommendation**: {BLOCK MERGE | REVIEW REQUIRED | APPROVED WITH CONDITIONS | APPROVED}
+
+EOF
+
+echo "✅ Dependency audit report saved to: $REPORT_FILE"
+```
+
+**If invoked standalone** (not by /code-review), use a simpler path:
+- `.docs/audits/standalone/dependencies-report.${TIMESTAMP}.md`

package/src/claude/agents/devflow/audit-documentation.md

@@ -305,3 +305,69 @@ Detect documentation format from language and validate accordingly.
    - Show correct examples
 
 Focus on documentation issues that prevent users from using the software correctly or developers from understanding the codebase.
+
+## Report Storage
+
+**IMPORTANT**: When invoked by `/code-review`, save your audit report to the standardized location:
+
+```bash
+# Expect these variables from the orchestrator:
+# - CURRENT_BRANCH: Current git branch name
+# - AUDIT_BASE_DIR: Base directory (.docs/audits/${CURRENT_BRANCH})
+# - TIMESTAMP: Timestamp for report filename
+
+# Save report to:
+REPORT_FILE="${AUDIT_BASE_DIR}/documentation-report.${TIMESTAMP}.md"
+
+# Create report
+cat > "$REPORT_FILE" <<'EOF'
+# Documentation Audit Report
+
+**Branch**: ${CURRENT_BRANCH}
+**Date**: $(date +%Y-%m-%d)
+**Time**: $(date +%H:%M:%S)
+**Auditor**: DevFlow Documentation Agent
+
+---
+
+## Executive Summary
+
+{Brief summary of documentation quality and alignment}
+
+---
+
+## Critical Issues
+
+{CRITICAL severity documentation contradicts code behavior}
+
+---
+
+## High Priority Issues
+
+{HIGH severity missing docs for public APIs or key features}
+
+---
+
+## Medium Priority Issues
+
+{MEDIUM severity incomplete or unclear documentation}
+
+---
+
+## Low Priority Issues
+
+{LOW severity minor improvements or style issues}
+
+---
+
+## Documentation Quality Score: {X}/10
+
+**Recommendation**: {BLOCK MERGE | REVIEW REQUIRED | APPROVED WITH CONDITIONS | APPROVED}
+
+EOF
+
+echo "✅ Documentation audit report saved to: $REPORT_FILE"
+```
+
+**If invoked standalone** (not by /code-review), use a simpler path:
+- `.docs/audits/standalone/documentation-report.${TIMESTAMP}.md`

package/src/claude/agents/devflow/audit-performance.md

@@ -82,4 +82,70 @@ For each finding, include:
 - Implementation examples
 - Measurement suggestions
 
-Focus on performance issues that will have measurable impact on user experience or system scalability.
+Focus on performance issues that will have measurable impact on user experience or system scalability.
+
+## Report Storage
+
+**IMPORTANT**: When invoked by `/code-review`, save your audit report to the standardized location:
+
+```bash
+# Expect these variables from the orchestrator:
+# - CURRENT_BRANCH: Current git branch name
+# - AUDIT_BASE_DIR: Base directory (.docs/audits/${CURRENT_BRANCH})
+# - TIMESTAMP: Timestamp for report filename
+
+# Save report to:
+REPORT_FILE="${AUDIT_BASE_DIR}/performance-report.${TIMESTAMP}.md"
+
+# Create report
+cat > "$REPORT_FILE" <<'EOF'
+# Performance Audit Report
+
+**Branch**: ${CURRENT_BRANCH}
+**Date**: $(date +%Y-%m-%d)
+**Time**: $(date +%H:%M:%S)
+**Auditor**: DevFlow Performance Agent
+
+---
+
+## Executive Summary
+
+{Brief summary of performance analysis}
+
+---
+
+## Critical Issues
+
+{CRITICAL severity performance bottlenecks}
+
+---
+
+## High Priority Issues
+
+{HIGH severity optimization opportunities}
+
+---
+
+## Medium Priority Issues
+
+{MEDIUM severity performance improvements}
+
+---
+
+## Low Priority Issues
+
+{LOW severity minor optimizations}
+
+---
+
+## Performance Score: {X}/10
+
+**Recommendation**: {BLOCK MERGE | REVIEW REQUIRED | APPROVED WITH CONDITIONS | APPROVED}
+
+EOF
+
+echo "✅ Performance audit report saved to: $REPORT_FILE"
+```
+
+**If invoked standalone** (not by /code-review), use a simpler path:
+- `.docs/audits/standalone/performance-report.${TIMESTAMP}.md`

package/src/claude/agents/devflow/audit-security.md

@@ -72,4 +72,70 @@ For each finding, include:
 - Specific remediation steps
 - Relevant security standards (OWASP, etc.)
 
-Focus on actionable, specific security issues that can be immediately addressed by developers.
+Focus on actionable, specific security issues that can be immediately addressed by developers.
+
+## Report Storage
+
+**IMPORTANT**: When invoked by `/code-review`, save your audit report to the standardized location:
+
+```bash
+# Expect these variables from the orchestrator:
+# - CURRENT_BRANCH: Current git branch name
+# - AUDIT_BASE_DIR: Base directory (.docs/audits/${CURRENT_BRANCH})
+# - TIMESTAMP: Timestamp for report filename
+
+# Save report to:
+REPORT_FILE="${AUDIT_BASE_DIR}/security-report.${TIMESTAMP}.md"
+
+# Create report
+cat > "$REPORT_FILE" <<'EOF'
+# Security Audit Report
+
+**Branch**: ${CURRENT_BRANCH}
+**Date**: $(date +%Y-%m-%d)
+**Time**: $(date +%H:%M:%S)
+**Auditor**: DevFlow Security Agent
+
+---
+
+## Executive Summary
+
+{Brief summary of security posture}
+
+---
+
+## Critical Findings
+
+{CRITICAL severity issues}
+
+---
+
+## High Priority Findings
+
+{HIGH severity issues}
+
+---
+
+## Medium Priority Findings
+
+{MEDIUM severity issues}
+
+---
+
+## Low Priority Findings
+
+{LOW severity issues}
+
+---
+
+## Security Score: {X}/10
+
+**Recommendation**: {BLOCK MERGE | REVIEW REQUIRED | APPROVED WITH CONDITIONS | APPROVED}
+
+EOF
+
+echo "✅ Security audit report saved to: $REPORT_FILE"
+```
+
+**If invoked standalone** (not by /code-review), use a simpler path:
+- `.docs/audits/standalone/security-report.${TIMESTAMP}.md`

package/src/claude/agents/devflow/audit-tests.md

@@ -452,4 +452,70 @@ For each finding, include:
 - Example implementations
 - Refactoring suggestions
 
-Focus on test issues that affect code confidence, development velocity, and regression detection capabilities.
+Focus on test issues that affect code confidence, development velocity, and regression detection capabilities.
+
+## Report Storage
+
+**IMPORTANT**: When invoked by `/code-review`, save your audit report to the standardized location:
+
+```bash
+# Expect these variables from the orchestrator:
+# - CURRENT_BRANCH: Current git branch name
+# - AUDIT_BASE_DIR: Base directory (.docs/audits/${CURRENT_BRANCH})
+# - TIMESTAMP: Timestamp for report filename
+
+# Save report to:
+REPORT_FILE="${AUDIT_BASE_DIR}/tests-report.${TIMESTAMP}.md"
+
+# Create report
+cat > "$REPORT_FILE" <<'EOF'
+# Test Quality Audit Report
+
+**Branch**: ${CURRENT_BRANCH}
+**Date**: $(date +%Y-%m-%d)
+**Time**: $(date +%H:%M:%S)
+**Auditor**: DevFlow Test Quality Agent
+
+---
+
+## Executive Summary
+
+{Brief summary of test coverage and quality}
+
+---
+
+## Critical Issues
+
+{CRITICAL severity major test gaps or quality issues}
+
+---
+
+## High Priority Issues
+
+{HIGH severity significant testing problems}
+
+---
+
+## Medium Priority Issues
+
+{MEDIUM severity test improvement opportunities}
+
+---
+
+## Low Priority Issues
+
+{LOW severity minor test optimizations}
+
+---
+
+## Test Coverage Score: {X}/10
+
+**Recommendation**: {BLOCK MERGE | REVIEW REQUIRED | APPROVED WITH CONDITIONS | APPROVED}
+
+EOF
+
+echo "✅ Test quality audit report saved to: $REPORT_FILE"
+```
+
+**If invoked standalone** (not by /code-review), use a simpler path:
+- `.docs/audits/standalone/tests-report.${TIMESTAMP}.md`

package/src/claude/agents/devflow/audit-typescript.md

@@ -292,3 +292,69 @@ CHANGED_TS_FILES=$(git diff --name-only --diff-filter=d HEAD | grep -E '\.(ts|ts
 - `3`: Medium severity issues found
 
 Focus on actionable, specific TypeScript issues that improve type safety and code quality.
+
+## Report Storage
+
+**IMPORTANT**: When invoked by `/code-review`, save your audit report to the standardized location:
+
+```bash
+# Expect these variables from the orchestrator:
+# - CURRENT_BRANCH: Current git branch name
+# - AUDIT_BASE_DIR: Base directory (.docs/audits/${CURRENT_BRANCH})
+# - TIMESTAMP: Timestamp for report filename
+
+# Save report to:
+REPORT_FILE="${AUDIT_BASE_DIR}/typescript-report.${TIMESTAMP}.md"
+
+# Create report
+cat > "$REPORT_FILE" <<'EOF'
+# TypeScript Audit Report
+
+**Branch**: ${CURRENT_BRANCH}
+**Date**: $(date +%Y-%m-%d)
+**Time**: $(date +%H:%M:%S)
+**Auditor**: DevFlow TypeScript Agent
+
+---
+
+## Executive Summary
+
+{Brief summary of TypeScript type safety and code quality}
+
+---
+
+## Critical Issues
+
+{CRITICAL severity type safety completely bypassed}
+
+---
+
+## High Priority Issues
+
+{HIGH severity significant type safety or architectural issues}
+
+---
+
+## Medium Priority Issues
+
+{MEDIUM severity moderate code quality issues}
+
+---
+
+## Low Priority Issues
+
+{LOW severity minor improvement opportunities}
+
+---
+
+## Type Safety Score: {X}/10
+
+**Recommendation**: {BLOCK MERGE | REVIEW REQUIRED | APPROVED WITH CONDITIONS | APPROVED}
+
+EOF
+
+echo "✅ TypeScript audit report saved to: $REPORT_FILE"
+```
+
+**If invoked standalone** (not by /code-review), use a simpler path:
+- `.docs/audits/standalone/typescript-report.${TIMESTAMP}.md`