197 Fn 22 53k7 65e2bac5

Name: 197 Fn 22 53k7 65e2bac5
Author: tools-only

ASecurity

Update documentation to cover epic-completion review feature.

9 stars
0 votes
0 copies
0 views
Added May 31, 2026

documentationdocumentation

Security analysis

A100/100

Pro scans all 2 files and shows the line behind each finding

Scanned May 31, 2026

npx -y skills add tools-only/X-Skills --skill 197-fn-22-53k7_65e2bac5 --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of 197 Fn 22 53k7 65e2bac5?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for 197 Fn 22 53k7 65e2bac5

[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/tools-only-197-fn-22-53k7-65e2bac5/badge)](https://www.skillsdirectory.com/skills/tools-only-197-fn-22-53k7-65e2bac5)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro

SKILL.md

# fn-22-53k.7 docs: update flowctl.md, ralph.md, README.md

## Description

Update documentation to cover epic-completion review feature.

**Files to update:**

1. **`plugins/flow-next/docs/flowctl.md`** — Add new commands:
   - `epic set-completion-review-status <fn-N> --status ship|needs_work|unknown` (after `epic set-plan-review-status`)
   - `codex completion-review` command (implemented in task fn-22-53k.6)
   - `next --require-completion-review` flag documentation

2. **`plugins/flow-next/docs/ralph.md`** — Add completion review gate:
   - New section after "Plan Review Gate" (~line 295): "Epic-Completion Review Gate"
   - Configuration variable: `COMPLETION_REVIEW` (no separate REQUIRE_ flag per epic spec)
   - Update flowchart to show completion_review gate before epic close
   - Receipt path: `completion-fn-N.json`

3. **`plugins/flow-next/README.md`** — Feature overview:
   - Add `/flow-next:epic-review` to commands table (~line 935)
   - Document `completion_review_status` field in .flow/ directory section (~line 1234)
   - Brief mention in Features section

**Naming consistency (must match everywhere):**
- Epic fields: `completion_review_status`, `completion_reviewed_at`
- Env var: `COMPLETION_REVIEW` (no separate REQUIRE_ per epic spec line 68)
- Receipt: `completion-fn-N.json`, type `completion_review`
- Selector: `--require-completion-review`, status `completion_review`

**Pattern reference:** Follow existing plan-review docs structure

## Acceptance

- [ ] flowctl.md documents `epic set-completion-review-status` command
- [ ] flowctl.md documents `codex completion-review` command
- [ ] flowctl.md documents `--require-completion-review` flag on `next`
- [ ] ralph.md has "Epic-Completion Review Gate" section
- [ ] ralph.md configuration reference includes `COMPLETION_REVIEW`
- [ ] README.md commands table includes `/flow-next:epic-review`
- [ ] README.md documents `completion_review_status` epic field

## Done summary
Document epic-completion review feature across flowctl.md, ralph.md, README.md. Added command refs, config vars, receipt schemas, and command reference. Fixed inconsistencies across SKILL.md/workflow.md regarding receipt policy.
## Evidence
- Commits: 7b7fe87, 2053eb2, 3807a70, daf8074
- Tests: grep pattern verification
- PRs: