autoworkflow 1.1.0 → 1.2.0

package/lib/index.js

@@ -5,5 +5,5 @@
  */
 
 module.exports = {
-  version: '1.1.0',
+  version: '1.2.0',
 };

package/lib/install.js

@@ -200,19 +200,40 @@ function createClaudeMd(projectRoot) {
     return;
   }
 
-  const claudeContent = `# CLAUDE.md - AI Workflow Instructions
+  const claudeContent = `# CLAUDE.md - Agentic Workflow
 
-> **MANDATORY**: Follow this workflow for ALL coding tasks.
+> **MANDATORY**: Follow this workflow for ALL coding tasks. No exceptions.
 
-## Workflow
+## Workflow (REQUIRED)
 
 \`\`\`
-1. ANALYZE   → Read relevant files first
-2. PLAN      → Show plan + suggestions
-3. CONFIRM   → "Should I proceed?" (wait for approval)
-4. IMPLEMENT → Make changes (after approval)
-5. VERIFY    → Run checks (autoworkflow handles this on commit)
-6. COMMIT    → Conventional commit format required
+┌─────────────────────────────────────────────────────────────────┐
+│                     AGENTIC WORKFLOW                            │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  1. ANALYZE   ──►  Read relevant files first                    │
+│       │                                                         │
+│       ▼                                                         │
+│  2. PLAN      ──►  Show plan + suggestions (3-tier)             │
+│       │                                                         │
+│       ▼                                                         │
+│  3. CONFIRM   ──►  "Should I proceed?" (WAIT for approval)      │
+│       │                                                         │
+│       ▼                                                         │
+│  4. IMPLEMENT ──►  Make changes (after approval only)           │
+│       │                                                         │
+│       ▼                                                         │
+│  5. VERIFY    ──►  npm run typecheck 2>&1 || true               │
+│       │                                                         │
+│       ├──► PASS ──► Continue to step 6                          │
+│       │                                                         │
+│       └──► FAIL ──► Fix errors → Re-verify (max 5 attempts)     │
+│                                                                 │
+│       ▼                                                         │
+│  6. COMMIT    ──►  git commit -m "type: description"            │
+│                    (autoworkflow runs all checks automatically) │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
 \`\`\`
 
 ---
@@ -232,9 +253,9 @@ These rules are **automatically enforced** on every commit:
 
 ---
 
-## Suggestions System
+## Suggestions System (3-Tier)
 
-For EVERY new feature, include suggestions after your plan:
+For EVERY new feature or significant change, include a **Suggestions** section after your plan:
 
 \`\`\`
 💡 **Suggestions for Feature Completeness:**
@@ -246,36 +267,132 @@ For EVERY new feature, include suggestions after your plan:
 
 🟡 **Recommended** (improves quality):
 - [ ] Handle edge case: [scenario]
-- [ ] Add accessibility: [aria labels]
+- [ ] Add accessibility: [aria labels, keyboard nav]
+- [ ] Empty state handling
 
 🟢 **Optional** (nice to have):
-- [ ] Add tests
-- [ ] Performance optimization
+- [ ] Add tests for [component/function]
+- [ ] Performance optimization: [specific]
+- [ ] Add analytics tracking
 
-**Which suggestions should I include?** (all/required/none)
+**Which suggestions should I include?** (all/required/none/1,2,4)
 \`\`\`
 
+### When to Show Suggestions
+
+| Task Type | Show Suggestions? |
+|-----------|-------------------|
+| New feature | ✅ Always |
+| New component | ✅ Always |
+| New page/route | ✅ Always |
+| Bug fix | ⚠️ Only if reveals missing handling |
+| Refactor | ⚠️ Only if scope expands |
+| Style changes | ❌ Skip |
+| Config changes | ❌ Skip |
+
+### Suggestion Checklist Reference
+
+**Functionality:**
+- [ ] Error states (API failures, network errors)
+- [ ] Loading states (spinners, skeletons)
+- [ ] Empty states (no data)
+- [ ] Success feedback (toasts, confirmations)
+
+**Edge Cases:**
+- [ ] Null/undefined data
+- [ ] Empty arrays/strings
+- [ ] Maximum limits (text length, file size)
+- [ ] Concurrent actions (double-click, race conditions)
+
+**User Experience:**
+- [ ] Form validation (client + server)
+- [ ] Keyboard navigation
+- [ ] Mobile responsiveness
+- [ ] Disabled states
+
 ---
 
 ## Confirmation Checkpoints
 
-### Before Implementation
+### Checkpoint 1: Plan + Suggestions (BEFORE implementing)
+
 \`\`\`
 ## Task: [description]
 
-### Plan
+### 1. Analysis
+[findings from codebase]
+
+### 2. Plan
+📋 **Proposed changes:**
 1. [Change 1]
 2. [Change 2]
 
-💡 Suggestions: [list]
+💡 **Suggestions for Feature Completeness:**
+
+🔴 **Required:**
+- [ ] Add error handling for API failure
+- [ ] Add loading state while fetching
+
+🟡 **Recommended:**
+- [ ] Add empty state when no results
+- [ ] Add keyboard shortcut
+
+🟢 **Optional:**
+- [ ] Add unit tests
+
+**Should I proceed?**
+**Which suggestions to include?** (all/required/none/1,2,4)
+\`\`\`
+
+### Checkpoint 2: Before Destructive Actions
 
+\`\`\`
+⚠️ **Warning:** This will [describe impact].
+Files affected: [list]
 **Should I proceed?**
 \`\`\`
 
-### Before Commit
+### Checkpoint 3: Before Commit
+
+\`\`\`
+✅ Verification passed.
+**Should I commit with message: "[message]"?**
+\`\`\`
+
+---
+
+## Verification Protocol
+
+### After EVERY Change
+
+\`\`\`bash
+npm run typecheck 2>&1 || true
+\`\`\`
+
+### Error Resolution (Max 5 Attempts)
+
+\`\`\`
+┌─────────────────────────────────────────────────────────────────┐
+│  VERIFICATION FAILED - Attempt [X/5]                            │
+├─────────────────────────────────────────────────────────────────┤
+│  Error: [error message]                                         │
+│  File:  [file path]                                             │
+│  Line:  [line number]                                           │
+├─────────────────────────────────────────────────────────────────┤
+│  Fix Applied: [what was changed]                                │
+│  Re-running verification...                                     │
+└─────────────────────────────────────────────────────────────────┘
 \`\`\`
-✅ All checks will run automatically via autoworkflow.
-**Should I commit with message: "type: description"?**
+
+### If 5 Attempts Fail
+
+\`\`\`
+❌ VERIFICATION FAILED after 5 attempts.
+Remaining errors:
+1. [error 1]
+2. [error 2]
+
+**Need guidance on:** [specific question about the error]
 \`\`\`
 
 ---
@@ -288,21 +405,49 @@ Must follow conventional commits:
 # Valid formats
 feat: add user authentication
 fix(api): resolve timeout issue
-docs: update readme
+docs: update installation guide
 
 # Types: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert
 \`\`\`
 
 ---
 
-## Rules
+## Anti-Patterns (NEVER DO)
+
+| ❌ Don't | ✅ Do Instead |
+|----------|---------------|
+| Implement without plan | Show plan + suggestions first |
+| Leave TODO comments | Complete the work or create issue |
+| Use console.log | Remove or use proper logging |
+| Skip verification | Always run \`npm run typecheck\` |
+| Batch multiple features | Complete one feature fully first |
+| Commit with errors | Fix all errors before commit |
+| Guess at solutions | Ask for clarification |
+
+---
+
+## Quick Reference
+
+**For new features:**
+\`\`\`
+Analyze → Plan + Suggestions → Confirm → Implement → Verify → Commit
+\`\`\`
+
+**For bug fixes:**
+\`\`\`
+Analyze → Plan → Confirm → Implement → Verify → Commit
+\`\`\`
+
+**Commands:**
+\`\`\`bash
+npm run typecheck    # Verify (REQUIRED after changes)
+npx autoworkflow run # Run all enforcement checks
+npx autoworkflow list # Show rule status
+\`\`\`
+
+---
 
-1. **Ask before implementing** - Plan first, wait for approval
-2. **No console.log** - Use proper logging or remove
-3. **No TODO comments** - Complete the work or create an issue
-4. **Fix all errors** - TypeScript and ESLint must pass
-5. **One feature at a time** - Complete fully before next
-6. **Use conventional commits** - type(scope): description
+**VERIFY ALWAYS. SUGGEST COMPLETENESS. ASK BEFORE ACTIONS.**
 `;
 
   fs.writeFileSync(claudePath, claudeContent);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autoworkflow",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Automatic code quality enforcement with fix loops, configurable rules, and Git hook integration",
   "keywords": [
     "git-hooks",