@pageai/ralph-loop 1.16.0 → 1.18.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.agent/STEERING.md +0 -2
- package/.agent/skills/prd-creator/SKILL.md +6 -0
- package/README.md +22 -1
- package/package.json +1 -1
package/.agent/STEERING.md
CHANGED
|
@@ -29,8 +29,6 @@ This sandbox runs emulated aarch64 Linux. Apply as needed:
|
|
|
29
29
|
Fix: `rm -rf node_modules/<corrupt-pkg> && npm install --ignore-scripts`
|
|
30
30
|
Re-scan until clean. Only then start the dev server.
|
|
31
31
|
|
|
32
|
-
- **If using TanStack Start:** Check that `src/integrations/tanstack-query/root-provider.tsx` has a default export wrapping children with `QueryClientProvider`. The starter template ships without it, causing a 500 on load.
|
|
33
|
-
|
|
34
32
|
## Main Tasks
|
|
35
33
|
|
|
36
34
|
Install dependencies (using the sequence above), then install Playwright system dependencies: `sudo npx playwright install-deps chromium 2>&1`. Allow up to 10 minutes for tasks to complete.
|
|
@@ -1,6 +1,12 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: prd-creator
|
|
3
3
|
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.
|
|
4
|
+
license: MIT
|
|
5
|
+
metadata:
|
|
6
|
+
author: pageai
|
|
7
|
+
version: '1.0.1'
|
|
8
|
+
tags: prd, product requirements, software development, documentation, task generation
|
|
9
|
+
website: https://pageai.pro/blog/long-running-ai-coding-agents-ralph-loop#step-2-write-your-requirements
|
|
4
10
|
---
|
|
5
11
|
|
|
6
12
|
# PRD Creation Assistant
|
package/README.md
CHANGED
|
@@ -25,6 +25,7 @@ This is an implementation that actually works, containing a hackable script so y
|
|
|
25
25
|
- [Promise Tags](#promise-tags)
|
|
26
26
|
- [Exit Codes](#exit-codes)
|
|
27
27
|
- [Structure](#structure)
|
|
28
|
+
- [Continued Development](#continued-development)
|
|
28
29
|
- [Skills](#skills)
|
|
29
30
|
- [Available Skills](#available-skills)
|
|
30
31
|
- [Skills Directory Structure](#skills-directory-structure)
|
|
@@ -87,6 +88,8 @@ Requirements:
|
|
|
87
88
|
// etc.
|
|
88
89
|
```
|
|
89
90
|
|
|
91
|
+
> Check out [the video](https://www.youtube.com/watch?v=3TL8Ez66I3o&t=403s) for a more realistic example on how to write requirements.
|
|
92
|
+
|
|
90
93
|
<details>
|
|
91
94
|
<summary><strong>✨ Pro tips</strong></summary>
|
|
92
95
|
|
|
@@ -145,7 +148,7 @@ And follow the instructions to log in into Claude Code.
|
|
|
145
148
|
|
|
146
149
|
> NB: you might need to run `chmod +x ralph.sh` to make the script executable.
|
|
147
150
|
|
|
148
|
-
>
|
|
151
|
+
> 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.
|
|
149
152
|
|
|
150
153
|
⚠️ If you want to use a different language or testing framework, see below.
|
|
151
154
|
|
|
@@ -255,6 +258,24 @@ Ralph uses semantic tags to communicate status:
|
|
|
255
258
|
└── skills/ # Shared skills (source of truth)
|
|
256
259
|
```
|
|
257
260
|
|
|
261
|
+
## Continued Development
|
|
262
|
+
|
|
263
|
+
As Ralph implements tasks, you might notice that you want some tweaks, features or even bug fixes.<br/>
|
|
264
|
+
To do so, you need to continue using the `prd-creator` skill to update the PRD and task list.
|
|
265
|
+
|
|
266
|
+
For example:
|
|
267
|
+
|
|
268
|
+
```
|
|
269
|
+
I would like to expand the PRD / tasks with these tasks:
|
|
270
|
+
|
|
271
|
+
- there is a bug in X that should be fixed by doing Y
|
|
272
|
+
- create a new feature that implement Z
|
|
273
|
+
|
|
274
|
+
etc.
|
|
275
|
+
```
|
|
276
|
+
|
|
277
|
+
It's fine to add multiple tasks at once.
|
|
278
|
+
|
|
258
279
|
## Skills
|
|
259
280
|
|
|
260
281
|
Skills are reusable agent capabilities that provide specialized knowledge and workflows. The canonical source is `.agent/skills/`, which is symlinked to multiple agent tool directories for compatibility.
|