autoworkflow 1.1.0 → 2.0.0

package/.vscode/settings.json

@@ -0,0 +1,69 @@
+{
+  // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  // AutoWorkflow VS Code Settings
+  // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  // Editor settings
+  "editor.formatOnSave": true,
+  "editor.codeActionsOnSave": {
+    "source.fixAll.eslint": "explicit",
+    "source.organizeImports": "explicit"
+  },
+  "editor.defaultFormatter": "esbenp.prettier-vscode",
+
+  // TypeScript settings
+  "typescript.tsdk": "node_modules/typescript/lib",
+  "typescript.enablePromptUseWorkspaceTsdk": true,
+  "typescript.validate.enable": true,
+  "typescript.suggestionActions.enabled": true,
+
+  // Terminal environment
+  "terminal.integrated.env.osx": {
+    "AUTOWORKFLOW": "true"
+  },
+  "terminal.integrated.env.linux": {
+    "AUTOWORKFLOW": "true"
+  },
+  "terminal.integrated.env.windows": {
+    "AUTOWORKFLOW": "true"
+  },
+
+  // File associations
+  "files.associations": {
+    "*.css": "tailwindcss"
+  },
+
+  // Tailwind CSS
+  "tailwindCSS.experimental.classRegex": [
+    ["clsx\\(([^)]*)\\)", "(?:'|\"|`)([^']*)(?:'|\"|`)"],
+    ["cn\\(([^)]*)\\)", "(?:'|\"|`)([^']*)(?:'|\"|`)"]
+  ],
+
+  // Search exclusions
+  "search.exclude": {
+    "**/node_modules": true,
+    "**/dist": true,
+    "**/coverage": true
+  },
+
+  // File exclusions from explorer
+  "files.exclude": {
+    "**/node_modules": true,
+    "**/.git": true
+  },
+
+  // Read-only patterns
+  "files.readonlyInclude": {
+    "**/node_modules/**": true
+  },
+
+  // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  // AutoWorkflow Specific Settings
+  // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  // Ensure key files are always visible
+  "explorer.autoReveal": true,
+
+  // Recommended extensions notification
+  "extensions.ignoreRecommendations": false
+}

package/.vscode/tasks.json

@@ -0,0 +1,161 @@
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "AutoWorkflow: Verify",
+      "detail": "Run TypeScript + ESLint verification",
+      "type": "shell",
+      "command": "npm run verify",
+      "group": {
+        "kind": "build",
+        "isDefault": true
+      },
+      "presentation": {
+        "reveal": "always",
+        "panel": "shared",
+        "clear": true
+      },
+      "problemMatcher": ["$tsc", "$eslint-stylish"]
+    },
+    {
+      "label": "AutoWorkflow: TypeCheck",
+      "detail": "Run TypeScript check only",
+      "type": "shell",
+      "command": "npm run typecheck",
+      "group": "build",
+      "presentation": {
+        "reveal": "always",
+        "panel": "shared"
+      },
+      "problemMatcher": "$tsc"
+    },
+    {
+      "label": "AutoWorkflow: Lint",
+      "detail": "Run ESLint check only",
+      "type": "shell",
+      "command": "npm run lint",
+      "group": "build",
+      "presentation": {
+        "reveal": "always",
+        "panel": "shared"
+      },
+      "problemMatcher": "$eslint-stylish"
+    },
+    {
+      "label": "AutoWorkflow: Lint Fix",
+      "detail": "Run ESLint with auto-fix",
+      "type": "shell",
+      "command": "npm run lint:fix",
+      "group": "build",
+      "presentation": {
+        "reveal": "always",
+        "panel": "shared"
+      },
+      "problemMatcher": "$eslint-stylish"
+    },
+    {
+      "label": "AutoWorkflow: Audit UI",
+      "detail": "Check for orphan features (backend without UI)",
+      "type": "shell",
+      "command": "npm run audit:ui",
+      "group": "test",
+      "presentation": {
+        "reveal": "always",
+        "panel": "shared"
+      },
+      "problemMatcher": []
+    },
+    {
+      "label": "AutoWorkflow: Audit Cycles",
+      "detail": "Check for circular dependencies",
+      "type": "shell",
+      "command": "npm run audit:cycles",
+      "group": "test",
+      "presentation": {
+        "reveal": "always",
+        "panel": "shared"
+      },
+      "problemMatcher": []
+    },
+    {
+      "label": "AutoWorkflow: Audit All",
+      "detail": "Run all audit checks",
+      "type": "shell",
+      "command": "npm run audit:ui && npm run audit:cycles",
+      "group": "test",
+      "presentation": {
+        "reveal": "always",
+        "panel": "shared"
+      },
+      "problemMatcher": []
+    },
+    {
+      "label": "AutoWorkflow: Format",
+      "detail": "Format all files with Prettier",
+      "type": "shell",
+      "command": "npm run format",
+      "group": "build",
+      "presentation": {
+        "reveal": "always",
+        "panel": "shared"
+      },
+      "problemMatcher": []
+    },
+    {
+      "label": "AutoWorkflow: Test",
+      "detail": "Run tests",
+      "type": "shell",
+      "command": "npm run test",
+      "group": "test",
+      "presentation": {
+        "reveal": "always",
+        "panel": "shared"
+      },
+      "problemMatcher": []
+    },
+    {
+      "label": "AutoWorkflow: Dev Server",
+      "detail": "Start development server",
+      "type": "shell",
+      "command": "npm run dev",
+      "group": "build",
+      "isBackground": true,
+      "presentation": {
+        "reveal": "always",
+        "panel": "dedicated"
+      },
+      "problemMatcher": []
+    },
+    {
+      "label": "AutoWorkflow: Full Check",
+      "detail": "Verify + Audit (pre-commit equivalent)",
+      "type": "shell",
+      "command": "npm run verify && npm run audit:ui && npm run audit:cycles",
+      "group": "test",
+      "presentation": {
+        "reveal": "always",
+        "panel": "shared"
+      },
+      "problemMatcher": ["$tsc", "$eslint-stylish"]
+    },
+    {
+      "label": "AutoWorkflow: Commit",
+      "detail": "Verify and commit with conventional message",
+      "type": "shell",
+      "command": "npm run verify && git add -A && git commit -m '${input:commitMessage}'",
+      "group": "build",
+      "presentation": {
+        "reveal": "always",
+        "panel": "shared"
+      },
+      "problemMatcher": "$tsc"
+    }
+  ],
+  "inputs": [
+    {
+      "id": "commitMessage",
+      "type": "promptString",
+      "description": "Commit message (format: type(scope): description)"
+    }
+  ]
+}

package/CLAUDE.md

@@ -0,0 +1,344 @@
+# AutoWorkflow - System Prompt Layer
+
+> **This file is the ENTRY POINT.** Claude MUST read this at the start of EVERY task.
+
+---
+
+## Session Start - FIRST THING
+
+**Before ANY work, run this check:**
+
+```
+1. Check if instructions/BLUEPRINT.md exists
+2. If NO  → Run ONE audit → Update BOTH AI_RULES.md & BLUEPRINT.md
+3. If YES → Read both files and proceed
+```
+
+### No Blueprint? Single Audit → Dual Output
+
+```
+⚠️ No BLUEPRINT.md found in this project.
+
+I'll run ONE audit to update TWO files:
+
+📄 AI_RULES.md → Tech Stack & File Structure (HOW to code)
+📘 BLUEPRINT.md → Features, Routes, APIs (WHAT exists)
+
+Running project audit now...
+```
+
+### Single Audit Architecture
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    ONE AUDIT SCAN                            │
+│                                                              │
+│  $ cat package.json        → Detect tech stack              │
+│  $ find src -type d        → Map file structure             │
+│  $ ls src/pages/           → Discover routes                │
+│  $ ls src/components/      → List components                │
+│  $ find src/api/           → Find API endpoints             │
+│  $ cat prisma/schema.prisma → Database models               │
+│  $ grep -r "fetch\|/api/"  → Map connections                │
+│                                                              │
+└─────────────────────────┬────────────────────────────────────┘
+                          │
+            ┌─────────────┴─────────────┐
+            ▼                           ▼
+   ┌─────────────────┐        ┌─────────────────┐
+   │  AI_RULES.md    │        │  BLUEPRINT.md   │
+   │  (Update)       │        │  (Generate)     │
+   │                 │        │                 │
+   │  ## Tech Stack  │        │  ## Features    │
+   │  - Framework: X │        │  - Feature 1 ✅ │
+   │  - Styling: Y   │        │  - Feature 2 ⚠️ │
+   │  - Database: Z  │        │                 │
+   │                 │        │  ## Routes      │
+   │  ## File Struct │        │  - / → Home     │
+   │  src/           │        │  - /about → ... │
+   │  ├── components │        │                 │
+   │  ├── pages      │        │  ## APIs        │
+   │  └── ...        │        │  - GET /api/x   │
+   └─────────────────┘        └─────────────────┘
+```
+
+**This prevents double audit runs - ONE scan updates BOTH files.**
+
+### Audit Output Format
+
+After scanning, present BOTH updates together:
+
+```
+## 🔍 Audit Complete - Proposed Updates
+
+### 📄 AI_RULES.md Updates
+
+**Tech Stack** (will update):
+- Framework: [detected]
+- Styling: [detected]
+- Database: [detected]
+
+**File Structure** (will update):
+src/
+├── [directories found]
+└── [file counts]
+
+---
+
+### 📘 BLUEPRINT.md (will create)
+
+**Features Discovered:**
+| Feature | Frontend | Backend | Route | Status |
+|---------|----------|---------|-------|--------|
+| Auth | LoginForm.tsx | /api/auth | /login | ✅ |
+| Dashboard | Dashboard.tsx | /api/stats | /dashboard | ✅ |
+| Settings | ❌ None | /api/settings | ❌ None | ⚠️ ORPHAN |
+
+**⚠️ Issues Found:**
+- Orphan API: /api/settings (no UI)
+
+---
+
+**Should I save these updates?**
+- AI_RULES.md → Update Tech Stack & File Structure sections
+- BLUEPRINT.md → Create with discovered features
+
+(yes/no/edit first)
+```
+
+See `system/triggers.md#on:blueprint_missing` for trigger details.
+
+---
+
+## System Architecture
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    THIS FILE (Entry Point)                   │
+│              Load on every task, route to system             │
+└───────────────────────────┬─────────────────────────────────┘
+                            │
+                            ▼
+┌─────────────────────────────────────────────────────────────┐
+│                    system/ (Control Layer)                   │
+│                                                              │
+│  triggers.md  │  loops.md  │  gates.md  │  router.md        │
+│  (events)     │  (cycles)  │  (blocks)  │  (routing)        │
+└───────────────────────────┬─────────────────────────────────┘
+                            │
+                            ▼
+┌─────────────────────────────────────────────────────────────┐
+│                 instructions/ (Content Layer)                │
+│                                                              │
+│  CLAUDE.md    │  AI_RULES.md  │  BLUEPRINT.md               │
+│  (workflow)   │  (standards)   │  (project spec)             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## On Task Start - MANDATORY
+
+When you receive ANY task, you MUST:
+
+### 1. Route the Task
+Read `system/router.md` to classify:
+- Is this a feature, fix, refactor, query, etc.?
+- What workflow applies?
+- What gates are required?
+
+### 2. Load Control Systems
+- `system/triggers.md` - Event handling
+- `system/loops.md` - Verification cycles
+- `system/gates.md` - Blocking checkpoints
+
+### 3. Load Instructions
+- `instructions/CLAUDE.md` - Workflow steps
+- `instructions/AI_RULES.md` - Coding standards
+- `instructions/BLUEPRINT.md` - Project requirements
+
+---
+
+## Workflow Overview
+
+```
+ANALYZE → PLAN → CONFIRM → IMPLEMENT → VERIFY → AUDIT → COMMIT → UPDATE
+   │        │       │          │          │        │        │        │
+   ▼        ▼       ▼          ▼          ▼        ▼        ▼        ▼
+ Read    Design   Wait for   Write     Run npm   Check   Create   Update
+ files   approach approval   code      verify   orphans  commit  BLUEPRINT
+```
+
+### Conditional Flows
+
+```
+Session Start:
+┌─────────────────────────────────────────────────┐
+│ Check BLUEPRINT.md exists?                       │
+├─────────────────────────────────────────────────┤
+│ NO  → Run /audit project → Generate both files  │
+│ YES → Read AI_RULES.md + BLUEPRINT.md → Proceed │
+└─────────────────────────────────────────────────┘
+
+After Commit:
+┌─────────────────────────────────────────────────┐
+│ Was new feature/route/API added?                 │
+├─────────────────────────────────────────────────┤
+│ YES → Prompt to update BLUEPRINT.md             │
+│ NO  → Skip update phase                          │
+└─────────────────────────────────────────────────┘
+```
+
+---
+
+## Hard Rules (NEVER Bypass)
+
+### Blocking Gates
+| Gate | When | Blocks If |
+|------|------|-----------|
+| `plan_approval_gate` | Before implement | User hasn't approved |
+| `verify_gate` | After implement | TypeScript/ESLint errors |
+| `audit_gate` | Before commit (features) | Orphan features or cycles |
+| `pre_commit_gate` | Before commit | TODO/FIXME, console.log, etc. |
+
+### Blocking Rules
+- **No orphan features** - Backend MUST have UI
+- **No TODO/FIXME** - Complete the work
+- **No console.log** - No debug logs in code
+- **No circular deps** - Clean architecture
+- **Conventional commits** - type(scope): description
+
+---
+
+## Available Commands
+
+| Command | Purpose |
+|---------|---------|
+| `/analyze [task]` | Analyze codebase for a task |
+| `/plan [task]` | Create implementation plan |
+| `/build [feature]` | Full workflow for features |
+| `/verify` | Run TypeScript + ESLint |
+| `/fix` | Fix verification errors |
+| `/audit` | Run UI + cycle audits |
+| `/audit project` | Full project scan → update BLUEPRINT.md |
+| `/suggest [task]` | Generate suggestions |
+| `/commit [msg]` | Pre-commit check + commit |
+
+---
+
+## Quick Reference
+
+### Session Start
+```
+Check BLUEPRINT.md exists?
+├── NO  → Run /audit project → Update AI_RULES.md + Create BLUEPRINT.md
+└── YES → Read both → Proceed
+```
+
+### For Features
+```
+/build [description]
+→ Runs: ANALYZE → PLAN+SUGGEST → CONFIRM → IMPLEMENT → VERIFY → AUDIT → COMMIT → UPDATE
+```
+
+### For Fixes
+```
+/analyze [issue] → /plan → [approval] → implement → /verify → /commit
+```
+
+### For Questions
+```
+/analyze [question]
+→ Returns information, no implementation
+```
+
+---
+
+## File Map
+
+```
+@autoworkflow/
+├── CLAUDE.md                 ← YOU ARE HERE (Entry Point)
+│
+├── system/                   ← Control Layer
+│   ├── triggers.md           Event → Action mappings
+│   ├── loops.md              Repeat-until definitions
+│   ├── gates.md              Blocking checkpoints
+│   └── router.md             Task type routing
+│
+├── instructions/             ← Content Layer
+│   ├── CLAUDE.md             Workflow steps
+│   ├── AI_RULES.md           Coding standards
+│   └── BLUEPRINT.md          Project specification
+│
+├── scripts/                  ← Automation Scripts
+│   ├── setup.sh              One-command project setup
+│   ├── autoworkflow.sh       CLI orchestrator
+│   ├── run-verification.sh   Verification with output
+│   ├── ensure-no-errors.sh   Pre-commit check
+│   └── check-ui-enforcement.sh  Orphan feature detection
+│
+├── hooks/                    ← Git Hooks
+│   ├── pre-commit            Blocks bad commits
+│   └── commit-msg            Validates commit format
+│
+├── .claude/                  ← Claude Code Integration
+│   ├── settings.json         Settings + instructions
+│   └── commands/             Slash command definitions
+│       ├── analyze.md
+│       ├── plan.md
+│       ├── build.md
+│       ├── verify.md
+│       ├── fix.md
+│       ├── audit.md
+│       ├── suggest.md
+│       └── commit.md
+│
+├── .vscode/                  ← VS Code Integration
+│   ├── settings.json         Editor settings
+│   ├── tasks.json            Runnable tasks
+│   └── extensions.json       Recommended extensions
+│
+├── .prettierrc               ← Prettier config
+├── eslint.config.example.js  ← ESLint reference
+└── tsconfig.example.json     ← TypeScript reference
+```
+
+---
+
+## Enforcement Summary
+
+**Claude is the PRIMARY enforcement engine.** These files control behavior:
+
+1. **system/triggers.md** - WHEN to act
+2. **system/loops.md** - HOW to repeat until success
+3. **system/gates.md** - WHAT blocks progress
+4. **system/router.md** - WHERE to route tasks
+5. **instructions/CLAUDE.md** - THE workflow to follow
+6. **instructions/AI_RULES.md** - THE standards to meet
+
+**Backup enforcement via automation:**
+
+7. **hooks/pre-commit** - Blocks commits with errors (git hook)
+8. **hooks/commit-msg** - Validates commit format (git hook)
+9. **scripts/check-ui-enforcement.sh** - Detects orphan features
+10. **scripts/autoworkflow.sh** - CLI for manual workflow runs
+
+Claude follows the instructions. Hooks catch anything that slips through.
+
+---
+
+## Start Here
+
+For every task:
+1. Read this file (done)
+2. Check if `instructions/BLUEPRINT.md` exists
+   - If NO → Run `/audit project` first
+   - If YES → Read it and proceed
+3. Read `system/router.md` to classify task
+4. Follow the appropriate workflow
+5. Never skip gates
+6. Complete features fully
+7. Update BLUEPRINT.md after adding features
+
+**VERIFY ALWAYS. CHECK BLUEPRINT. NO ORPHANS. ONE AUDIT → TWO FILES.**