@pageai/ralph-loop 1.15.0 → 1.17.0

package/.agent/skills/prd-creator/SKILL.md

@@ -1,6 +1,12 @@
 ---
 name: prd-creator
 description: Guides creation of comprehensive Product Requirement Documents (PRDs) for software projects through structured questioning and validation, then generates implementation task lists in JSON format. Use when users want to document a software idea, create specifications for development, plan a new application feature/bug, or break down requirements into actionable tasks. Transforms ideas into implementation-ready documents with verifiable pass criteria.
+license: MIT
+metadata:
+  author: pageai
+  version: '1.0.1'
+  tags: prd, product requirements, software development, documentation, task generation
+  website: https://pageai.pro/blog/long-running-ai-coding-agents-ralph-loop#step-2-write-your-requirements
 ---
 
 # PRD Creation Assistant

package/README.md

@@ -87,6 +87,8 @@ Requirements:
 // etc.
 ```
 
+> Check out [the video](https://www.youtube.com/watch?v=3TL8Ez66I3o&t=403s) for a more realistic example on how to write requirements.
+
 <details>
 <summary><strong>✨ Pro tips</strong></summary>
 
@@ -145,7 +147,7 @@ And follow the instructions to log in into Claude Code.
 
 > NB: you might need to run `chmod +x ralph.sh` to make the script executable.
 
-> ⚠️ The default "mode" is "implementation". Depending on your use case, you might want to change `.agent/PROMPT.md` to a different mode, e.g. "refactor", "review", "test" etc.
+> The default "mode" is "implementation". Depending on your use case, you might want to change `.agent/PROMPT.md` to a different mode, e.g. "refactor", "review", "test" etc.
 
 ⚠️ If you want to use a different language or testing framework, see below.
 

package/bin/cli.js

@@ -353,12 +353,12 @@ async function main() {
 
   // Playwright setup
   if (installPlaywright) {
-    setupPlaywright(clack, TARGET_DIR, appDir);
+    await setupPlaywright(clack, TARGET_DIR, appDir);
   }
 
   // Vitest setup
   if (installVitest) {
-    setupVitest(clack, TARGET_DIR, appDir);
+    await setupVitest(clack, TARGET_DIR, appDir);
   }
 
   // Final setup steps (git init, shadcn install)
@@ -372,7 +372,7 @@ async function main() {
 
     if (needsGit) {
       try {
-        initGitRepo(TARGET_DIR);
+        await initGitRepo(TARGET_DIR);
       } catch {
         // Non-critical — continue setup even if git init fails
       }
@@ -380,7 +380,7 @@ async function main() {
 
     if (needsShadcn) {
       try {
-        installAllComponents(appDirPath);
+        await installAllComponents(appDirPath);
       } catch {
         // Non-critical — continue setup even if shadcn install fails
       }

package/bin/lib/git.js

@@ -4,9 +4,12 @@
  */
 
 const path = require('path');
-const { execSync } = require('child_process');
+const { exec } = require('child_process');
+const { promisify } = require('util');
 const { exists } = require('./copy');
 
+const execAsync = promisify(exec);
+
 /**
  * Checks if a directory is inside a git repository
  * @param {string} dir - Directory path to check
@@ -19,9 +22,10 @@ function isGitRepo(dir) {
 /**
  * Initializes a new git repository in the given directory
  * @param {string} dir - Directory path to initialize
+ * @returns {Promise<void>}
  */
-function initGitRepo(dir) {
-  execSync('git init', { cwd: dir, stdio: 'pipe' });
+async function initGitRepo(dir) {
+  await execAsync('git init', { cwd: dir });
 }
 
 module.exports = {

package/bin/lib/playwright.js

@@ -4,17 +4,20 @@
  */
 
 const path = require('path');
-const { execSync } = require('child_process');
+const { exec } = require('child_process');
+const { promisify } = require('util');
 const { copyFile, exists } = require('./copy');
 const display = require('./display');
 
+const execAsync = promisify(exec);
+
 /**
  * Copies playwright.config.ts into the app directory and installs Chromium.
  * @param {object} clack - @clack/prompts module (passed in because it's ESM)
  * @param {string} targetDir - Project root (TARGET_DIR)
  * @param {string} appDir - Relative app source directory
  */
-function setupPlaywright(clack, targetDir, appDir) {
+async function setupPlaywright(clack, targetDir, appDir) {
   console.log();
   display.printStep('🎭', 'Playwright setup');
 
@@ -31,9 +34,8 @@ function setupPlaywright(clack, targetDir, appDir) {
   const s = clack.spinner();
   s.start('Installing Playwright browsers (chromium)...');
   try {
-    execSync('npx playwright install --with-deps chromium', {
+    await execAsync('npx playwright install --with-deps chromium', {
       cwd: path.join(targetDir, appDir),
-      stdio: 'pipe',
     });
     s.stop('Playwright browsers installed');
   } catch (err) {

package/bin/lib/shadcn.js

@@ -5,9 +5,12 @@
 
 const fs = require('fs');
 const path = require('path');
-const { execSync } = require('child_process');
+const { exec } = require('child_process');
+const { promisify } = require('util');
 const { exists } = require('./copy');
 
+const execAsync = promisify(exec);
+
 const SHADCN_SCHEMA = 'https://ui.shadcn.com/schema.json';
 
 /**
@@ -61,10 +64,9 @@ function isShadcnProject(dir) {
  * then strips the "#/" alias prefix from components.json.
  * @param {string} dir - Directory path to run the init in
  */
-function initShadcn(dir) {
-  execSync('npx shadcn@latest init -y -d 2>&1', {
+async function initShadcn(dir) {
+  await execAsync('npx shadcn@latest init -y -d 2>&1', {
     cwd: dir,
-    stdio: 'pipe',
   });
 
   stripAliasPrefix(dir);
@@ -97,14 +99,13 @@ function stripAliasPrefix(dir) {
  * Runs init first if no components.json exists.
  * @param {string} dir - Directory path to run the install in
  */
-function installAllComponents(dir) {
+async function installAllComponents(dir) {
   if (!hasShadcnConfig(dir)) {
-    initShadcn(dir);
+    await initShadcn(dir);
   }
 
-  execSync('npx shadcn@latest add --all --yes --overwrite 2>&1', {
+  await execAsync('npx shadcn@latest add --all --yes --overwrite 2>&1', {
     cwd: dir,
-    stdio: 'pipe',
   });
 }
 

package/bin/lib/vitest.js

@@ -5,11 +5,14 @@
 
 const fs = require('fs');
 const path = require('path');
-const { execSync } = require('child_process');
+const { exec } = require('child_process');
+const { promisify } = require('util');
 const { copyFile, exists } = require('./copy');
 const display = require('./display');
 const { DEFAULT_APP_DIR } = require('./consts');
 
+const execAsync = promisify(exec);
+
 /**
  * Copies vitest.config.ts into the app directory, patches the include
  * paths to match appDir, and installs vitest + react plugin.
@@ -17,7 +20,7 @@ const { DEFAULT_APP_DIR } = require('./consts');
  * @param {string} targetDir - Project root (TARGET_DIR)
  * @param {string} appDir - Relative app source directory
  */
-function setupVitest(clack, targetDir, appDir) {
+async function setupVitest(clack, targetDir, appDir) {
   console.log();
   display.printStep('⚡', 'Vitest setup');
 
@@ -42,9 +45,8 @@ function setupVitest(clack, targetDir, appDir) {
   const s = clack.spinner();
   s.start('Installing Vitest dependencies...');
   try {
-    execSync('npm install --save-dev vitest @vitejs/plugin-react', {
+    await execAsync('npm install --save-dev vitest @vitejs/plugin-react', {
       cwd: path.join(targetDir, appDir),
-      stdio: 'pipe',
     });
     s.stop('Vitest dependencies installed');
   } catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pageai/ralph-loop",
-  "version": "1.15.0",
+  "version": "1.17.0",
   "publishConfig": {
     "access": "public"
   },