abelworkflow 0.9.2 → 1.0.0

package/skills/confidence-check/SKILL.md

@@ -1,34 +0,0 @@
----
-name: confidence-check
-description: Pre-implementation confidence assessment (≥90% required). Use before starting any implementation to verify readiness with duplicate check, architecture compliance, official docs verification, OSS references, and root cause identification.
----
-
-# Confidence Check
-
-Run this BEFORE implementing to prevent wrong-direction work. Requires ≥90% confidence to proceed.
-
-## When to Use
-
-- Before writing or modifying any implementation code
-- Before applying a fix to verify root cause
-- When user asks to "check confidence" or "assess readiness"
-
-## Assessment (5 checks)
-
-| Check | Weight | How |
-|---|---|---|
-| No duplicate implementations | 25% | Grep/Glob for similar code |
-| Architecture compliance | 25% | Read CLAUDE.md / AGENTS.md |
-| Official docs verified | 20% | Context7 or WebFetch |
-| OSS reference found | 15% | WebSearch / GitHub |
-| Root cause identified | 15% | Analyze errors and logs |
-
-## Thresholds
-
-- **≥90%**: Proceed with implementation
-- **70–89%**: Continue investigation, do not implement yet
-- **<70%**: Stop and request more context
-
-## Output
-
-Print the checklist with pass/fail markers, the total score, and the recommended action.

package/skills/confidence-check/confidence.ts

@@ -1,276 +0,0 @@
-/**
- * Confidence Check - Pre-implementation confidence assessment
- *
- * Prevents wrong-direction execution by assessing confidence BEFORE starting.
- * Requires ≥90% confidence to proceed with implementation.
- *
- * Token Budget: 100-200 tokens
- * ROI: 25-250x token savings when stopping wrong direction
- *
- * Test Results (2025-10-21):
- * - Precision: 1.000 (no false positives)
- * - Recall: 1.000 (no false negatives)
- * - 8/8 test cases passed
- *
- * Confidence Levels:
- *    - High (≥90%): Root cause identified, solution verified, no duplication, architecture-compliant
- *    - Medium (70-89%): Multiple approaches possible, trade-offs require consideration
- *    - Low (<70%): Investigation incomplete, unclear root cause, missing official docs
- */
-
-import { existsSync } from 'fs';
-import { join, dirname } from 'path';
-
-export interface Context {
-  task?: string;
-  test_file?: string;
-  test_name?: string;
-  markers?: string[];
-  duplicate_check_complete?: boolean;
-  architecture_check_complete?: boolean;
-  official_docs_verified?: boolean;
-  oss_reference_complete?: boolean;
-  root_cause_identified?: boolean;
-  confidence_checks?: string[];
-  [key: string]: any;
-}
-
-/**
- * Pre-implementation confidence assessment
- *
- * Usage:
- *   const checker = new ConfidenceChecker();
- *   const confidence = await checker.assess(context);
- *
- *   if (confidence >= 0.9) {
- *     // High confidence - proceed immediately
- *   } else if (confidence >= 0.7) {
- *     // Medium confidence - present options to user
- *   } else {
- *     // Low confidence - STOP and request clarification
- *   }
- */
-export class ConfidenceChecker {
-  /**
-   * Assess confidence level (0.0 - 1.0)
-   *
-   * Investigation Phase Checks:
-   * 1. No duplicate implementations? (25%)
-   * 2. Architecture compliance? (25%)
-   * 3. Official documentation verified? (20%)
-   * 4. Working OSS implementations referenced? (15%)
-   * 5. Root cause identified? (15%)
-   *
-   * @param context - Task context with investigation flags
-   * @returns Confidence score (0.0 = no confidence, 1.0 = absolute certainty)
-   */
-  async assess(context: Context): Promise<number> {
-    let score = 0.0;
-    const checks: string[] = [];
-
-    // Check 1: No duplicate implementations (25%)
-    if (this.noDuplicates(context)) {
-      score += 0.25;
-      checks.push("✅ No duplicate implementations found");
-    } else {
-      checks.push("❌ Check for existing implementations first");
-    }
-
-    // Check 2: Architecture compliance (25%)
-    if (this.architectureCompliant(context)) {
-      score += 0.25;
-      checks.push("✅ Uses existing tech stack (e.g., Supabase)");
-    } else {
-      checks.push("❌ Verify architecture compliance (avoid reinventing)");
-    }
-
-    // Check 3: Official documentation verified (20%)
-    if (this.hasOfficialDocs(context)) {
-      score += 0.2;
-      checks.push("✅ Official documentation verified");
-    } else {
-      checks.push("❌ Read official docs first");
-    }
-
-    // Check 4: Working OSS implementations referenced (15%)
-    if (this.hasOssReference(context)) {
-      score += 0.15;
-      checks.push("✅ Working OSS implementation found");
-    } else {
-      checks.push("❌ Search for OSS implementations");
-    }
-
-    // Check 5: Root cause identified (15%)
-    if (this.rootCauseIdentified(context)) {
-      score += 0.15;
-      checks.push("✅ Root cause identified");
-    } else {
-      checks.push("❌ Continue investigation to identify root cause");
-    }
-
-    // Store check results for reporting
-    context.confidence_checks = checks;
-
-    // Display checks
-    console.log("📋 Confidence Checks:");
-    checks.forEach(check => console.log(`   ${check}`));
-    console.log("");
-
-    return score;
-  }
-
-  /**
-   * Check if official documentation exists
-   *
-   * Looks for:
-   * - README.md in project
-   * - CLAUDE.md and AGENTS.md with relevant patterns
-   * - docs/ directory with related content
-   */
-  private hasOfficialDocs(context: Context): boolean {
-    // Check context flag first (for testing)
-    if ('official_docs_verified' in context) {
-      return context.official_docs_verified ?? false;
-    }
-
-    // Check for test file path
-    const testFile = context.test_file;
-    if (!testFile) {
-      return false;
-    }
-
-    // Walk up directory tree to find project root (same logic as Python version)
-    let projectRoot = dirname(testFile);
-
-    while (true) {
-      // Check for documentation files
-      if (existsSync(join(projectRoot, 'README.md'))) {
-        return true;
-      }
-      if (existsSync(join(projectRoot, 'CLAUDE.md'))) {
-        return true;
-      }
-      if (existsSync(join(projectRoot, 'AGENTS.md'))) {
-        return true;
-      }
-      if (existsSync(join(projectRoot, 'docs'))) {
-        return true;
-      }
-
-      // Move up one directory
-      const parent = dirname(projectRoot);
-      if (parent === projectRoot) break; // Reached root (same as Python: parent != project_root)
-      projectRoot = parent;
-    }
-
-    return false;
-  }
-
-  /**
-   * Check for duplicate implementations
-   *
-   * Before implementing, verify:
-   * - No existing similar functions/modules (Glob/Grep)
-   * - No helper functions that solve the same problem
-   * - No libraries that provide this functionality
-   *
-   * Returns true if no duplicates found (investigation complete)
-   */
-  private noDuplicates(context: Context): boolean {
-    // This is a placeholder - actual implementation should:
-    // 1. Search codebase with Glob/Grep for similar patterns
-    // 2. Check project dependencies for existing solutions
-    // 3. Verify no helper modules provide this functionality
-    return context.duplicate_check_complete ?? false;
-  }
-
-  /**
-   * Check architecture compliance
-   *
-   * Verify solution uses existing tech stack:
-   * - Supabase project → Use Supabase APIs (not custom API)
-   * - Next.js project → Use Next.js patterns (not custom routing)
-   * - Turborepo → Use workspace patterns (not manual scripts)
-   *
-   * Returns true if solution aligns with project architecture
-   */
-  private architectureCompliant(context: Context): boolean {
-    // This is a placeholder - actual implementation should:
-    // 1. Read CLAUDE.md and AGENTS.md for project tech stack
-    // 2. Verify solution uses existing infrastructure
-    // 3. Check not reinventing provided functionality
-    return context.architecture_check_complete ?? false;
-  }
-
-  /**
-   * Check if working OSS implementations referenced
-   *
-   * Search for:
-   * - Similar open-source solutions
-   * - Reference implementations in popular projects
-   * - Community best practices
-   *
-   * Returns true if OSS reference found and analyzed
-   */
-  private hasOssReference(context: Context): boolean {
-    // This is a placeholder - actual implementation should:
-    // 1. Search GitHub for similar implementations
-    // 2. Read popular OSS projects solving same problem
-    // 3. Verify approach matches community patterns
-    return context.oss_reference_complete ?? false;
-  }
-
-  /**
-   * Check if root cause is identified with high certainty
-   *
-   * Verify:
-   * - Problem source pinpointed (not guessing)
-   * - Solution addresses root cause (not symptoms)
-   * - Fix verified against official docs/OSS patterns
-   *
-   * Returns true if root cause clearly identified
-   */
-  private rootCauseIdentified(context: Context): boolean {
-    // This is a placeholder - actual implementation should:
-    // 1. Verify problem analysis complete
-    // 2. Check solution addresses root cause
-    // 3. Confirm fix aligns with best practices
-    return context.root_cause_identified ?? false;
-  }
-
-  /**
-   * Get recommended action based on confidence level
-   *
-   * @param confidence - Confidence score (0.0 - 1.0)
-   * @returns Recommended action
-   */
-  getRecommendation(confidence: number): string {
-    if (confidence >= 0.9) {
-      return "✅ High confidence (≥90%) - Proceed with implementation";
-    } else if (confidence >= 0.7) {
-      return "⚠️ Medium confidence (70-89%) - Continue investigation, DO NOT implement yet";
-    } else {
-      return "❌ Low confidence (<70%) - STOP and continue investigation loop";
-    }
-  }
-}
-
-/**
- * Legacy function-based API for backward compatibility
- *
- * @deprecated Use ConfidenceChecker class instead
- */
-export async function confidenceCheck(context: Context): Promise<number> {
-  const checker = new ConfidenceChecker();
-  return checker.assess(context);
-}
-
-/**
- * Legacy getRecommendation for backward compatibility
- *
- * @deprecated Use ConfidenceChecker.getRecommendation() instead
- */
-export function getRecommendation(confidence: number): string {
-  const checker = new ConfidenceChecker();
-  return checker.getRecommendation(confidence);
-}