Coding Workflow

A Research → Plan → User Review → Implement 4-stage procedure for code change tasks.

Trivial tasks such as simple configuration changes or 1~2 line edits may skip this workflow.

Step-by-Step Procedure

Step 1: Research (Read the Codebase)

Read and understand the relevant code deeply, then write findings to .ralph/docs/generated/research-<task>.md.

• Do not skim a file and move on at the signature level
• Understand existing layers, ORM relationships, and duplicate API presence
• Mandatory exploration of existing test files: Find related *.test.*, *.spec.* files and understand what cases are already covered
• Do not summarize in chat — always write to a file

Step 2: Plan (Write Plan MD)