autoworkflow 2.0.0 → 2.1.0

package/.claude/commands/init.md

@@ -0,0 +1,142 @@
+# /init - Initialize AutoWorkflow
+
+Set up AutoWorkflow files in the current project.
+
+## Trigger
+- User invokes `/init`
+- User invokes `/init autoworkflow`
+- User says "set up autoworkflow" or "initialize workflow"
+
+## Purpose
+Copy AutoWorkflow files from `node_modules/autoworkflow/` to the project root.
+
+## Workflow
+
+### Step 1: Check if autoworkflow is installed
+```bash
+[ -d node_modules/autoworkflow ] && echo "Found" || echo "Not found"
+```
+
+If not found:
+```
+⚠️ autoworkflow not found in node_modules.
+
+Run this first:
+npm install autoworkflow
+
+Then run /init again.
+```
+
+### Step 2: Check what's already set up
+```bash
+[ -f CLAUDE.md ] && echo "CLAUDE.md exists"
+[ -d system ] && echo "system/ exists"
+[ -d instructions ] && echo "instructions/ exists"
+[ -d .claude ] && echo ".claude/ exists"
+[ -d scripts ] && echo "scripts/ exists"
+[ -d hooks ] && echo "hooks/ exists"
+```
+
+### Step 3: Present setup options
+```
+## AutoWorkflow Setup
+
+**Source:** node_modules/autoworkflow/
+
+### Required Files
+| File/Folder | Status | Action |
+|-------------|--------|--------|
+| CLAUDE.md | ❌ Missing | Will copy |
+| system/ | ❌ Missing | Will copy |
+| instructions/ | ❌ Missing | Will copy |
+| .claude/ | ❌ Missing | Will copy |
+
+### Recommended Files
+| File/Folder | Status | Action |
+|-------------|--------|--------|
+| scripts/ | ❌ Missing | Will copy |
+| hooks/ | ❌ Missing | Will copy |
+
+### Optional Files
+| File/Folder | Status | Action |
+|-------------|--------|--------|
+| .vscode/ | ❌ Missing | Skip (add with --vscode) |
+| .prettierrc | ❌ Missing | Skip (add with --configs) |
+| eslint.config.js | ❌ Missing | Skip (add with --configs) |
+| tsconfig.json | ❌ Missing | Skip (add with --configs) |
+
+---
+
+**Should I set up AutoWorkflow?**
+Options:
+- `yes` - Copy required + recommended
+- `all` - Copy everything including optional
+- `minimal` - Copy required only
+```
+
+### Step 4: Copy files after approval
+```bash
+# Required
+cp node_modules/autoworkflow/CLAUDE.md .
+cp -r node_modules/autoworkflow/system ./system
+cp -r node_modules/autoworkflow/instructions ./instructions
+cp -r node_modules/autoworkflow/.claude ./.claude
+
+# Recommended
+cp -r node_modules/autoworkflow/scripts ./scripts
+cp -r node_modules/autoworkflow/hooks ./hooks
+
+# Optional (if requested)
+cp -r node_modules/autoworkflow/.vscode ./.vscode
+cp node_modules/autoworkflow/.prettierrc .
+cp node_modules/autoworkflow/eslint.config.example.js ./eslint.config.js
+cp node_modules/autoworkflow/tsconfig.example.json ./tsconfig.json
+```
+
+### Step 5: Set up git hooks
+```bash
+npm run setup:hooks
+```
+
+### Step 6: Confirm setup
+```
+## ✅ AutoWorkflow Initialized
+
+**Files copied:**
+- CLAUDE.md (entry point)
+- system/ (triggers, loops, gates, router)
+- instructions/ (workflow, AI rules, blueprint)
+- .claude/ (settings, commands)
+- scripts/ (automation)
+- hooks/ (git hooks)
+
+**Git hooks installed:**
+- pre-commit
+- commit-msg
+
+**Next steps:**
+1. Edit `instructions/AI_RULES.md` with your coding standards
+2. Edit `instructions/BLUEPRINT.md` with your project spec
+3. Start using Claude Code - it will follow the workflow!
+
+Run `/audit project` to auto-generate BLUEPRINT.md from your codebase.
+```
+
+## Arguments
+- `/init` - Standard setup (required + recommended)
+- `/init --all` - Include optional files (.vscode, configs)
+- `/init --minimal` - Required files only
+- `/init --vscode` - Include .vscode settings
+- `/init --configs` - Include config templates
+
+## Examples
+```
+User: /init
+→ Sets up required + recommended files
+
+User: /init --all
+→ Sets up everything including .vscode and configs
+
+User: set up autoworkflow
+→ Same as /init
+```

package/.claude/settings.json

@@ -5,6 +5,7 @@
   "description": "System prompt layer that controls Claude's workflow with triggers, loops, and gates",
 
   "instructions": [
+    "IF autoworkflow in node_modules but CLAUDE.md missing: suggest running /init",
     "ALWAYS read CLAUDE.md (entry point) at the start of EVERY task",
     "ALWAYS check if instructions/BLUEPRINT.md exists at session start",
     "IF BLUEPRINT.md missing: run /audit project to generate it",
@@ -81,7 +82,8 @@
   },
 
   "triggers": {
-    "on_conversation_start": ["Read CLAUDE.md", "Check BLUEPRINT.md exists", "Route via system/router.md"],
+    "on_conversation_start": ["Check if /init needed", "Read CLAUDE.md", "Check BLUEPRINT.md exists", "Route via system/router.md"],
+    "on_init_needed": ["Notify autoworkflow detected", "Suggest running /init"],
     "on_blueprint_missing": ["Run project audit", "Generate AI_RULES.md + BLUEPRINT.md", "Present for approval"],
     "on_task_start": ["Read CLAUDE.md", "Route via system/router.md"],
     "on_implementation_complete": ["Enter VERIFY phase", "Run verify_loop"],

package/README.md

@@ -1,8 +1,53 @@
 # AutoWorkflow - System Prompt Layer for Claude Code
 
-> **Claude is the enforcement engine.** No scripts, no git hooks - just instructions that Claude follows.
+> **Claude is the enforcement engine.** System prompts control the workflow. Scripts and hooks provide backup enforcement.
 
-A system prompt architecture that controls Claude Code's behavior through triggers, loops, gates, and routing. When you use Claude Code in VS Code with this project, Claude will automatically follow a structured workflow for all coding tasks.
+A system prompt architecture that controls Claude Code's behavior through triggers, loops, gates, and routing. When you use Claude Code in VS Code with this project, Claude automatically follows a structured 9-phase workflow for all coding tasks.
+
+---
+
+## Installation
+
+### Via npm (Recommended)
+
+```bash
+npm install autoworkflow
+```
+
+Then ask Claude to set it up:
+
+```
+/init
+```
+
+Claude will copy all necessary files from `node_modules/autoworkflow/` to your project root.
+
+**Or copy manually:**
+
+```bash
+# Copy all workflow files
+cp -r node_modules/autoworkflow/CLAUDE.md .
+cp -r node_modules/autoworkflow/system ./system
+cp -r node_modules/autoworkflow/instructions ./instructions
+cp -r node_modules/autoworkflow/.claude ./.claude
+cp -r node_modules/autoworkflow/scripts ./scripts
+cp -r node_modules/autoworkflow/hooks ./hooks
+
+# Optional: Copy VS Code settings
+cp -r node_modules/autoworkflow/.vscode ./.vscode
+
+# Optional: Copy config examples
+cp node_modules/autoworkflow/.prettierrc .
+cp node_modules/autoworkflow/eslint.config.example.js ./eslint.config.js
+cp node_modules/autoworkflow/tsconfig.example.json ./tsconfig.json
+
+# Setup git hooks
+npm run setup:hooks
+```
+
+### Manual Installation
+
+Clone or download this repository and copy the files to your project.
 
 ---
 
@@ -29,60 +74,45 @@ A system prompt architecture that controls Claude Code's behavior through trigge
 │                                                              │
 │  CLAUDE.md    │  AI_RULES.md  │  BLUEPRINT.md               │
 │  Workflow     │  Standards     │  Project spec               │
+└───────────────────────────┬─────────────────────────────────┘
+                            │
+                            ▼
+┌─────────────────────────────────────────────────────────────┐
+│              Backup Enforcement (Runtime Layer)              │
+│                                                              │
+│  scripts/     │  hooks/        │  npm scripts               │
+│  Automation   │  Git hooks     │  Verification              │
 └─────────────────────────────────────────────────────────────┘
 ```
 
 ---
 
-## Quick Start
-
-1. **Copy this structure** into your project:
-   ```
-   your-project/
-   ├── CLAUDE.md                 # Entry point
-   ├── system/                   # Control layer
-   │   ├── triggers.md
-   │   ├── loops.md
-   │   ├── gates.md
-   │   └── router.md
-   ├── instructions/             # Content layer
-   │   ├── CLAUDE.md
-   │   ├── AI_RULES.md
-   │   └── BLUEPRINT.md
-   ├── .claude/                  # Claude Code integration
-   │   ├── settings.json
-   │   └── commands/
-   └── .vscode/                  # VS Code integration
-       ├── settings.json
-       ├── tasks.json
-       └── extensions.json
-   ```
-
-2. **Customize the instructions**:
-   - Edit `instructions/AI_RULES.md` with your coding standards
-   - Edit `instructions/BLUEPRINT.md` with your project spec
-
-3. **Use Claude Code** - Claude will automatically follow the workflow!
-
----
-
 ## The Workflow
 
-When you ask Claude to do something, it follows this workflow:
+When you ask Claude to do something, it follows this 9-phase workflow:
 
 ```
-ANALYZE → PLAN → CONFIRM → IMPLEMENT → VERIFY → AUDIT → COMMIT
+ANALYZE → PLAN → CONFIRM → IMPLEMENT → VERIFY → FIX → AUDIT → COMMIT → UPDATE
 ```
 
 | Phase | What Claude Does |
 |-------|------------------|
-| **ANALYZE** | Reads relevant files, understands context |
-| **PLAN** | Designs approach, shows suggestions |
+| **ANALYZE** | Reads relevant files, checks BLUEPRINT.md |
+| **PLAN** | Designs approach, shows categorized suggestions |
 | **CONFIRM** | Waits for your approval |
 | **IMPLEMENT** | Makes changes (only after approval) |
 | **VERIFY** | Runs `npm run verify` (typecheck + lint) |
+| **FIX** | Fixes errors, loops back to VERIFY |
 | **AUDIT** | Checks for orphan features, circular deps |
 | **COMMIT** | Creates conventional commit (after approval) |
+| **UPDATE** | Updates BLUEPRINT.md if new feature/route/API added |
+
+### Session Start
+
+At the start of every session, Claude:
+1. Checks if `instructions/BLUEPRINT.md` exists
+2. If missing → Runs `/audit project` to generate it
+3. If exists → Reads AI_RULES.md + BLUEPRINT.md and proceeds
 
 ---
 
@@ -103,12 +133,14 @@ Claude will STOP and cannot proceed if:
 
 | Command | Purpose |
 |---------|---------|
+| `/init` | Set up AutoWorkflow files from node_modules |
 | `/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 → generates BLUEPRINT.md |
 | `/suggest [task]` | Generate suggestions |
 | `/commit [msg]` | Pre-commit check + commit |
 
@@ -126,10 +158,42 @@ Claude enforces these automatically:
 
 ---
 
+## npm Scripts
+
+### Verification
+```bash
+npm run verify           # TypeScript + ESLint
+npm run typecheck        # TypeScript only
+npm run lint             # ESLint only
+npm run format           # Prettier format
+```
+
+### Audits
+```bash
+npm run audit:ui         # Check orphan features (BLOCKING)
+npm run audit:cycles     # Check circular deps (BLOCKING)
+npm run audit:all        # Run all audits
+```
+
+### Workflow Automation
+```bash
+npm run dyad:status      # Show workflow status
+npm run dyad:verify      # Run verification
+npm run dyad:commit      # Commit with checks
+npm run dyad:full        # Full workflow
+```
+
+### Setup
+```bash
+npm run setup:hooks      # Install git hooks
+```
+
+---
+
 ## File Structure
 
 ```
-@autoworkflow/
+autoworkflow/
 ├── CLAUDE.md                 # Entry point (Claude reads this first)
 │
 ├── system/                   # Control Layer
@@ -139,13 +203,14 @@ Claude enforces these automatically:
 │   └── router.md             # Task type routing
 │
 ├── instructions/             # Content Layer
-│   ├── CLAUDE.md             # Workflow steps
+│   ├── CLAUDE.md             # Workflow steps (9 phases)
 │   ├── AI_RULES.md           # Coding standards
 │   └── BLUEPRINT.md          # Project specification
 │
 ├── .claude/                  # Claude Code Integration
 │   ├── settings.json         # Settings + hard rules
 │   └── commands/             # Slash command definitions
+│       ├── init.md
 │       ├── analyze.md
 │       ├── plan.md
 │       ├── build.md
@@ -155,32 +220,55 @@ Claude enforces these automatically:
 │       ├── suggest.md
 │       └── commit.md
 │
-└── .vscode/                  # VS Code Integration
-    ├── settings.json         # Editor settings
-    ├── tasks.json            # Runnable tasks
-    └── extensions.json       # Recommended extensions
+├── scripts/                  # Automation Scripts
+│   ├── setup.sh              # Initial setup
+│   ├── autoworkflow.sh       # Workflow automation
+│   ├── check-ui-enforcement.sh
+│   ├── run-verification.sh
+│   └── ensure-no-errors.sh
+│
+├── hooks/                    # Git Hooks (backup enforcement)
+│   ├── pre-commit            # Blocks bad commits
+│   └── commit-msg            # Validates commit messages
+│
+├── .vscode/                  # VS Code Integration (optional)
+│   ├── settings.json         # Editor settings
+│   ├── tasks.json            # Runnable tasks
+│   └── extensions.json       # Recommended extensions
+│
+├── .prettierrc               # Prettier config
+├── eslint.config.example.js  # ESLint config template
+└── tsconfig.example.json     # TypeScript config template
 ```
 
 ---
 
 ## Why This Approach?
 
-### Traditional Enforcement
-- Git hooks run scripts
-- Scripts check code
-- Blocks commit on failure
+### Dual Enforcement Strategy
 
-### AutoWorkflow (This Approach)
-- Claude reads instructions
-- Claude follows the workflow
-- Claude enforces rules as it works
-
-**Benefits:**
-- No runtime code to maintain
-- Works in any project (just copy files)
+**Primary: Claude as Enforcement Engine**
+- Claude reads instructions from system prompts
+- Claude follows the 9-phase workflow
+- Claude enforces rules proactively as it works
 - Claude explains what's happening
-- Flexible - Claude can adapt to context
-- Suggestions improve code quality proactively
+
+**Backup: Scripts & Git Hooks**
+- Git hooks catch anything Claude misses
+- Scripts automate verification
+- Pre-commit blocks bad code from reaching the repo
+
+### Benefits
+
+| Feature | Benefit |
+|---------|---------|
+| System prompts | No runtime code to maintain |
+| Portable | Just copy files to any project |
+| Transparent | Claude explains the workflow |
+| Flexible | Claude adapts to context |
+| Suggestions | Proactively improves code quality |
+| Git hooks | Backup enforcement layer |
+| npm scripts | Easy automation |
 
 ---
 
@@ -223,11 +311,25 @@ Edit `system/loops.md` to change retry behavior.
 ## Requirements
 
 - VS Code with Claude Code extension
-- That's it! No npm install needed for the workflow itself.
+- Node.js 18+ (for npm scripts)
+- TypeScript, ESLint, Prettier (for verification)
+
+---
+
+## What Gets Copied
+
+When you install via npm, these files are available to copy:
 
-If you want the verification commands (`npm run verify`, etc.) to work, you'll need:
-- Node.js 18+
-- TypeScript, ESLint, etc. in your project
+| Category | Files | Required? |
+|----------|-------|-----------|
+| Entry point | `CLAUDE.md` | ✅ Yes |
+| Control layer | `system/` | ✅ Yes |
+| Content layer | `instructions/` | ✅ Yes |
+| Claude integration | `.claude/` | ✅ Yes |
+| Automation | `scripts/` | Recommended |
+| Git hooks | `hooks/` | Recommended |
+| VS Code | `.vscode/` | Optional |
+| Configs | `.prettierrc`, `*.example.*` | Optional |
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autoworkflow",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "System prompt layer that controls Claude Code's workflow with triggers, loops, and gates",
   "type": "module",
   "keywords": [

package/system/triggers.md

@@ -11,16 +11,19 @@
 
 **When:** Claude begins a new conversation or task
 **Action:**
-1. Read root `CLAUDE.md` (entry point)
-2. Check if `instructions/BLUEPRINT.md` exists
-3. If NO → Trigger `on:blueprint_missing`
-4. If YES → Load blueprint and proceed
-5. Load `system/router.md` to determine task type
-6. Load `system/gates.md` for blocking rules
-7. Await user request
+1. Check if autoworkflow needs initialization
+2. Read root `CLAUDE.md` (entry point)
+3. Check if `instructions/BLUEPRINT.md` exists
+4. If NO → Trigger `on:blueprint_missing`
+5. If YES → Load blueprint and proceed
+6. Load `system/router.md` to determine task type
+7. Load `system/gates.md` for blocking rules
+8. Await user request
 
 ```
 TRIGGER: conversation_start
+├── Check: node_modules/autoworkflow exists AND CLAUDE.md missing?
+│   └── YES → Trigger: on:init_needed
 ├── Read: CLAUDE.md
 ├── Check: instructions/BLUEPRINT.md exists?
 │   ├── NO  → Trigger: on:blueprint_missing
@@ -32,6 +35,39 @@ TRIGGER: conversation_start
 
 ---
 
+### `on:init_needed`
+
+**When:** autoworkflow is in node_modules but CLAUDE.md is missing
+**Action:**
+1. Notify user that autoworkflow needs setup
+2. Suggest running /init command
+
+```
+TRIGGER: init_needed
+├── Notify: "AutoWorkflow detected but not initialized"
+├── Suggest: "Run /init to set up workflow files"
+└── Await: user response
+```
+
+**Output Format:**
+```
+📦 **AutoWorkflow detected in node_modules**
+
+The workflow files haven't been copied to your project yet.
+
+Run `/init` to set up:
+- CLAUDE.md (entry point)
+- system/ (triggers, loops, gates)
+- instructions/ (workflow, rules, blueprint)
+- .claude/ (commands)
+- scripts/ (automation)
+- hooks/ (git hooks)
+
+Or run `/init --all` to include .vscode and config templates.
+```
+
+---
+
 ### `on:blueprint_missing`
 
 **When:** BLUEPRINT.md does not exist at session start