# 224 Fn 13 Pxj6 667f61b7

> fn-13-pxj.6 Update documentation

- Skill: `tools-only/224-fn-13-pxj6-667f61b7` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add tools-only/224-fn-13-pxj6-667f61b7`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/224-fn-13-pxj6-667f61b7/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: tools-only (https://skillmd.com/u/tools-only)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/tools-only/224-fn-13-pxj6-667f61b7

---

# fn-13-pxj.6 Update documentation

## Description
Update documentation to cover new async control commands.

**NOTE**: Only update existing files. Do NOT create new documentation files.

### Files to Update

**1. `plugins/flow-next/README.md`**

Add "Controlling Ralph" section:
- `flowctl status` usage and output examples
- `flowctl ralph pause/resume/stop/status` commands
- Sentinel file mechanism (for manual control)
- `flowctl task reset` for rollback/retry workflows
- Example: pause → fix requirement → resume workflow

Also update **Troubleshooting** section:
- Replace outdated `flowctl task set --status pending` reference with `flowctl task reset`
- The current docs mention `task set` which doesn't exist in flowctl.py

**2. Root `CLAUDE.md`**

No changes needed - it references README which will be updated.

### Documentation Style
- Keep examples concise
- Show both CLI and manual (file-based) approaches where applicable
- Include JSON output examples for automation use cases
- Ensure all documented commands actually exist in flowctl.py

### Key Files
- `plugins/flow-next/README.md`
## Acceptance
- [ ] README.md has "Controlling Ralph" section
- [ ] Examples show `flowctl status`, `flowctl ralph`, `flowctl task reset`
- [ ] Troubleshooting section updated (replace `task set` with `task reset`)
- [ ] All documented commands exist in flowctl.py
- [ ] Documentation is concise and matches actual command behavior
- [ ] No new documentation files created
## Done summary
- Added "Controlling Ralph" subsection with CLI + sentinel file docs
- Fixed Troubleshooting: replaced nonexistent `task set` with `task reset`
- Removed jq dependency from example code

Why: Document new async control features, fix broken documentation

Verification: CI 40/40, README renders correctly
## Evidence
- Commits: 7b9969e9557088074a5c108c0814d98c182ca67a
- Tests: plugins/flow-next/scripts/ci_test.sh
- PRs: