ai-eng-system 0.2.1 → 0.2.2

package/README.md

@@ -65,6 +65,8 @@ See [docs/spec-driven-workflow.md](./docs/spec-driven-workflow.md) for complete
 
 > **🔄 Ralph Wiggum**: Add `--ralph` flag to any phase command for persistent iteration. Perfect for complex tasks requiring multiple refinement cycles. [Learn more →](./docs/ralph-wiggum-integration-complete.md)
 
+> **🛠️ Fixed (v0.2.2)**: Ralph Wiggum now runs continuously without stopping between phases. Full backward compatibility maintained. [Fix details →](./docs/ralph-wiggum-autonomous-looping-fix.md)
+
 ### Additional Commands (13 total)
 - `/ai-eng/optimize` - Prompt enhancement (+45% quality)
 - `/ai-eng/deploy` - Pre-deployment checklists

package/dist/.claude-plugin/commands/ralph-wiggum.md

@@ -85,6 +85,7 @@ I bet you can't manage continuous iteration across all workflow phases without g
 | `--dry-run` | boolean | false | Show plan without executing |
 | `--resume` | boolean | false | Resume from last checkpoint |
 | `--parallel` | boolean | false | Run phases in parallel where safe |
+| `--refine-each-phase` | boolean | false | Re-invoke prompt-refinement at each phase (interactive mode) |
 
 **Default Completion Promise:**
 ```
@@ -95,6 +96,18 @@ I bet you can't manage continuous iteration across all workflow phases without g
 
 Load `skills/prompt-refinement/SKILL.md` and use phase: `plan` to transform your prompt into structured TCRO format (Task, Context, Requirements, Output). Ask clarifying questions if feature description, acceptance criteria, technical approach, or quality gates are unclear.
 
+**Store the refined output as `$REFINED_CONTEXT`** - this will be used for ALL subsequent phases without re-invoking prompt-refinement.
+
+### Autonomous Execution Model
+
+After Phase 0 completes:
+1. **Context is locked**: The refined TCRO applies to ALL subsequent phases
+2. **No re-refinement**: Do NOT invoke prompt-refinement again (unless `--refine-each-phase` is set)
+3. **Continuous execution**: Proceed through phases without pausing for user input
+4. **Checkpoints are optional**: Only pause if `--checkpoint` flag is explicitly set
+
+This enables overnight/unattended execution as intended by the Ralph Wiggum pattern.
+
 ## Phase 1: Git Setup
 
 ### 1.1 Create Feature Branch
@@ -137,7 +150,7 @@ This is the core Ralph Wiggum pattern - continuous iteration until completion.
 
 **Goal**: Gather context, patterns, and technical guidance
 
-**Load Ralph Wiggum skill**: `skills/workflow/ralph-wiggum/SKILL.md`
+**Context**: Use `$REFINED_CONTEXT` from Phase 0. Do NOT re-invoke prompt-refinement unless `--refine-each-phase` is set.
 
 **Execute**:
 ```bash
@@ -157,11 +170,13 @@ This is the core Ralph Wiggum pattern - continuous iteration until completion.
 
 **Checkpoint** (if `--checkpoint=all`): Pause and ask for approval before proceeding
 
+**→ CONTINUE**: Immediately proceed to Phase 2.3 (Specify) without waiting for user input.
+
 ### 2.3 Specify Phase (if not skipped)
 
 **Goal**: Create detailed specification with user stories and acceptance criteria
 
-**Load Ralph Wiggum skill**: `skills/workflow/ralph-wiggum/SKILL.md`
+**Context**: Use `$REFINED_CONTEXT` from Phase 0. Do NOT re-invoke prompt-refinement unless `--refine-each-phase` is set.
 
 **Execute**:
 ```bash
@@ -186,11 +201,13 @@ This is the core Ralph Wiggum pattern - continuous iteration until completion.
 
 **Checkpoint** (if `--checkpoint=all`): Pause and ask for approval
 
+**→ CONTINUE**: Immediately proceed to Phase 2.4 (Plan) without waiting for user input.
+
 ### 2.4 Plan Phase (if not skipped)
 
 **Goal**: Create implementation plan with tasks and dependencies
 
-**Load Ralph Wiggum skill**: `skills/workflow/ralph-wiggum/SKILL.md`
+**Context**: Use `$REFINED_CONTEXT` from Phase 0. Do NOT re-invoke prompt-refinement unless `--refine-each-phase` is set.
 
 **Execute**:
 ```bash
@@ -215,11 +232,13 @@ This is the core Ralph Wiggum pattern - continuous iteration until completion.
 
 **Checkpoint** (if `--checkpoint=all`): Pause and ask for approval
 
+**→ CONTINUE**: Immediately proceed to Phase 2.5 (Work) without waiting for user input.
+
 ### 2.5 Work Phase
 
 **Goal**: Implement feature with TDD, quality gates, and iterative refinement
 
-**Load Ralph Wiggum skill**: `skills/workflow/ralph-wiggum/SKILL.md`
+**Context**: Use `$REFINED_CONTEXT` from Phase 0. Do NOT re-invoke prompt-refinement unless `--refine-each-phase` is set.
 
 **Execute**:
 ```bash
@@ -248,11 +267,13 @@ npm test && npm run lint && npm run build
 
 **Checkpoint** (if `--checkpoint=all` or `--checkpoint=review`): Pause and ask for approval
 
+**→ CONTINUE**: Immediately proceed to Phase 2.6 (Review) without waiting for user input.
+
 ### 2.6 Review Phase
 
 **Goal**: Comprehensive multi-perspective code review
 
-**Load Ralph Wiggum skill**: `skills/workflow/ralph-wiggum/SKILL.md`
+**Context**: Use `$REFINED_CONTEXT` from Phase 0. Do NOT re-invoke prompt-refinement unless `--refine-each-phase` is set.
 
 **Execute**:
 ```bash
@@ -271,6 +292,8 @@ npm test && npm run lint && npm run build
 
 **Checkpoint** (if `--checkpoint=all` or `--checkpoint=review`): Pause and ask for approval
 
+**→ CONTINUE**: Immediately proceed to Phase 3 (Gap Analysis) without waiting for user input.
+
 ## Phase 3: Gap Analysis
 
 ### 3.1 Analyze Review Findings
@@ -354,6 +377,12 @@ Based on gap analysis from 3.1:
   "max_cycles": 5,
   "current_phase": "WORK",
   "completed_phases": ["RESEARCH", "SPECIFY", "PLAN"],
+  "refined_context": {
+    "task": "Specific, actionable task statement",
+    "context": "Broader system, goals, constraints from CLAUDE.md",
+    "requirements": ["Must-have requirement 1", "Must-have requirement 2"],
+    "output": "What should be delivered (working code, tests, docs, PR)"
+  },
   "artifacts": {
     "research": "docs/research/2026-01-05-user-authentication.md",
     "spec": "specs/user-authentication/spec.md",

package/dist/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-eng-system",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "AI Engineering System with context engineering and research orchestration for Claude Code",
   "author": {
     "name": "v1truv1us"

package/dist/.opencode/command/ai-eng/ralph-wiggum.md

@@ -85,6 +85,7 @@ I bet you can't manage continuous iteration across all workflow phases without g
 | `--dry-run` | boolean | false | Show plan without executing |
 | `--resume` | boolean | false | Resume from last checkpoint |
 | `--parallel` | boolean | false | Run phases in parallel where safe |
+| `--refine-each-phase` | boolean | false | Re-invoke prompt-refinement at each phase (interactive mode) |
 
 **Default Completion Promise:**
 ```
@@ -95,6 +96,18 @@ I bet you can't manage continuous iteration across all workflow phases without g
 
 Load `skills/prompt-refinement/SKILL.md` and use phase: `plan` to transform your prompt into structured TCRO format (Task, Context, Requirements, Output). Ask clarifying questions if feature description, acceptance criteria, technical approach, or quality gates are unclear.
 
+**Store the refined output as `$REFINED_CONTEXT`** - this will be used for ALL subsequent phases without re-invoking prompt-refinement.
+
+### Autonomous Execution Model
+
+After Phase 0 completes:
+1. **Context is locked**: The refined TCRO applies to ALL subsequent phases
+2. **No re-refinement**: Do NOT invoke prompt-refinement again (unless `--refine-each-phase` is set)
+3. **Continuous execution**: Proceed through phases without pausing for user input
+4. **Checkpoints are optional**: Only pause if `--checkpoint` flag is explicitly set
+
+This enables overnight/unattended execution as intended by the Ralph Wiggum pattern.
+
 ## Phase 1: Git Setup
 
 ### 1.1 Create Feature Branch
@@ -137,7 +150,7 @@ This is the core Ralph Wiggum pattern - continuous iteration until completion.
 
 **Goal**: Gather context, patterns, and technical guidance
 
-**Load Ralph Wiggum skill**: `skills/workflow/ralph-wiggum/SKILL.md`
+**Context**: Use `$REFINED_CONTEXT` from Phase 0. Do NOT re-invoke prompt-refinement unless `--refine-each-phase` is set.
 
 **Execute**:
 ```bash
@@ -157,11 +170,13 @@ This is the core Ralph Wiggum pattern - continuous iteration until completion.
 
 **Checkpoint** (if `--checkpoint=all`): Pause and ask for approval before proceeding
 
+**→ CONTINUE**: Immediately proceed to Phase 2.3 (Specify) without waiting for user input.
+
 ### 2.3 Specify Phase (if not skipped)
 
 **Goal**: Create detailed specification with user stories and acceptance criteria
 
-**Load Ralph Wiggum skill**: `skills/workflow/ralph-wiggum/SKILL.md`
+**Context**: Use `$REFINED_CONTEXT` from Phase 0. Do NOT re-invoke prompt-refinement unless `--refine-each-phase` is set.
 
 **Execute**:
 ```bash
@@ -186,11 +201,13 @@ This is the core Ralph Wiggum pattern - continuous iteration until completion.
 
 **Checkpoint** (if `--checkpoint=all`): Pause and ask for approval
 
+**→ CONTINUE**: Immediately proceed to Phase 2.4 (Plan) without waiting for user input.
+
 ### 2.4 Plan Phase (if not skipped)
 
 **Goal**: Create implementation plan with tasks and dependencies
 
-**Load Ralph Wiggum skill**: `skills/workflow/ralph-wiggum/SKILL.md`
+**Context**: Use `$REFINED_CONTEXT` from Phase 0. Do NOT re-invoke prompt-refinement unless `--refine-each-phase` is set.
 
 **Execute**:
 ```bash
@@ -215,11 +232,13 @@ This is the core Ralph Wiggum pattern - continuous iteration until completion.
 
 **Checkpoint** (if `--checkpoint=all`): Pause and ask for approval
 
+**→ CONTINUE**: Immediately proceed to Phase 2.5 (Work) without waiting for user input.
+
 ### 2.5 Work Phase
 
 **Goal**: Implement feature with TDD, quality gates, and iterative refinement
 
-**Load Ralph Wiggum skill**: `skills/workflow/ralph-wiggum/SKILL.md`
+**Context**: Use `$REFINED_CONTEXT` from Phase 0. Do NOT re-invoke prompt-refinement unless `--refine-each-phase` is set.
 
 **Execute**:
 ```bash
@@ -248,11 +267,13 @@ npm test && npm run lint && npm run build
 
 **Checkpoint** (if `--checkpoint=all` or `--checkpoint=review`): Pause and ask for approval
 
+**→ CONTINUE**: Immediately proceed to Phase 2.6 (Review) without waiting for user input.
+
 ### 2.6 Review Phase
 
 **Goal**: Comprehensive multi-perspective code review
 
-**Load Ralph Wiggum skill**: `skills/workflow/ralph-wiggum/SKILL.md`
+**Context**: Use `$REFINED_CONTEXT` from Phase 0. Do NOT re-invoke prompt-refinement unless `--refine-each-phase` is set.
 
 **Execute**:
 ```bash
@@ -271,6 +292,8 @@ npm test && npm run lint && npm run build
 
 **Checkpoint** (if `--checkpoint=all` or `--checkpoint=review`): Pause and ask for approval
 
+**→ CONTINUE**: Immediately proceed to Phase 3 (Gap Analysis) without waiting for user input.
+
 ## Phase 3: Gap Analysis
 
 ### 3.1 Analyze Review Findings
@@ -354,6 +377,12 @@ Based on gap analysis from 3.1:
   "max_cycles": 5,
   "current_phase": "WORK",
   "completed_phases": ["RESEARCH", "SPECIFY", "PLAN"],
+  "refined_context": {
+    "task": "Specific, actionable task statement",
+    "context": "Broader system, goals, constraints from CLAUDE.md",
+    "requirements": ["Must-have requirement 1", "Must-have requirement 2"],
+    "output": "What should be delivered (working code, tests, docs, PR)"
+  },
   "artifacts": {
     "research": "docs/research/2026-01-05-user-authentication.md",
     "spec": "specs/user-authentication/spec.md",

package/dist/index.js

@@ -68,8 +68,7 @@ var AiEngSystem = async ({
   const targetDir = findInstallationTarget(directory);
   if (!targetDir) {
     return {
-      config: async (input) => {
-      }
+      config: async (input) => {}
     };
   }
   const isFirstRun = !fs.existsSync(path.join(targetDir, "command", "ai-eng"));
@@ -82,8 +81,7 @@ var AiEngSystem = async ({
     console.error(`[ai-eng-system] Installation warning: ${error instanceof Error ? error.message : String(error)}`);
   }
   return {
-    config: async (input) => {
-    }
+    config: async (input) => {}
   };
 };
 var src_default = AiEngSystem;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-eng-system",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Compounding engineering system for Claude Code and OpenCode. Shared agents, commands, skills, and plugin development tools.",
   "type": "module",
   "main": "./dist/index.js",
@@ -65,8 +65,6 @@
   ],
   "devDependencies": {
     "@biomejs/biome": "^1.9.4",
-    "@types/commander": "^2.12.0",
-    "@types/glob": "^8.1.0",
     "bun-types": "latest",
     "husky": "^9.1.7",
     "standard-version": "^9.5.0",