Add optional structured-workflow examples for clearer task execution #16
+797
−0
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
This PR adds optional, additive documentation and examples that demonstrate one way to
structure work for Ralph, while fully preserving its minimal philosophy.
The goal is to help users define clearer, more focused tasks for each iteration,
without changing how Ralph executes or introducing any new abstractions.
What’s included
New files
examples/structured-workflow/README.mdOverview of the approach and its guiding principles.
examples/structured-workflow/TASK-BREAKDOWN-GUIDE.mdA practical guide for breaking work into focused stages
(foundation → logic → interface → integration → polish).
examples/structured-workflow/prd.json.exampleExample PRD using optional, backwards-compatible metadata fields
(
stage,focus,responsibility) that Ralph safely ignores.examples/structured-workflow/prompt-templates/Optional prompt snippets aligned with different task types:
foundation.md– schema, migrations, setuplogic.md– business rules, APIsinterface.md– UI componentsintegration.md– connecting piecespolish.md– edge cases, error handlingexamples/structured-workflow/example-feature/An end-to-end example showing a structured vs unstructured approach:
README.mdprd.jsonfor a sample “task comments” featureUpdates
README.mdupdated to reference the new structured workflow examples.Design principles preserved
ralph.shor the core execution loopWhy this exists
Ralph works best when each iteration has a narrow, well-defined goal.
These examples show one way to achieve that through task definition alone,
without adding process or complexity to the tool itself.