← ClaudeAtlas

submit-plan-artifactlisted

Use when authoring or revising a markdown plan artifact
Ralph-Workflow/Ralph-Workflow · ★ 5 · AI & Automation · score 77
Install: claude install-skill Ralph-Workflow/Ralph-Workflow
# submit-plan-artifact Read `.agent/artifact-formats/plan.md`. Submit one mandatory executor-ready plan: stable `### [S-n] Title` steps, allowed `Type`, concrete targets or discovery location, real dependencies, and per-step proof. ## Author and submit 1. Ground the outcome, current behavior, target files, risks, and proof in repository evidence. 2. Cover Orient, Characterize, Change, Verify. Use a discovery step for an unknown rather than inventing a path or command. 3. Optionally check with `ralph_verify_md_artifact`, then submit with `ralph_submit_md_artifact` using `artifact_type: plan` and the full text. 4. For a similar revision, use `ralph_edit_md_artifact` on the staged draft; it submits when valid. Use `ralph_stage_md_artifact` with `replace_all` only for a wholesale rewrite. `ralph_get_md_draft` inspects the draft and `ralph_finalize_md_artifact` submits an assembled staged draft. 5. `ralph_discard_md_draft` is only for a genuine wholesale restart. Worked example: ```markdown --- type: plan --- ## Work ### [S-1] Characterize the retry default Inspect the current retry behavior and add a focused regression before changing it. Type: file_change Files: - modify ralph/retry.py - modify tests/test_retry.py Verify: pytest tests/test_retry.py -q Expect: the regression fails before the change ### [S-2] Change and prove the timeout behavior Implement the smallest timeout change, then run the focused regression. Type: file_change Files: - modify ralph/retry.py - mod