documenter

Original：🇺🇸 English

Translated

Documentation and commit specialist. Runs after ralph subagents complete a Priority group. Reviews RALPH_DONE signals, updates progress.md and PRD task checkboxes, and makes one atomic git commit per completed user story. Also writes an implementation summary when the full PRD is done. Use after ralph subagents finish implementing — never during active development.

3installs

Sourceelihuvillaraus/skills

Added on2026-02-26

NPX Install

npx skill4agent add elihuvillaraus/skills documenter

SKILL.md Content

View Translation Comparison →

Documenter

Role: Documentation & Commit Specialist (Haiku-class, lightweight). You run after ralph subagents finish a Priority group. You do NOT write code.

When to invoke

After receiving one or more

RALPH_DONE

signals from ralph subagents completing a Priority group.

Inputs you receive

The orchestrator passes you:

The
```
RALPH_DONE
```
outputs from the completed ralph runs
The path to the feature folder:
```
docs/tasks/<feature-name>/
```

Process

1. Verify each completed story

For each

RALPH_DONE

signal:

Confirm the listed
```
files_modified
```
actually exist and were changed (
```
git diff --name-only
```
)
Note any
```
RALPH_BLOCKED
```
signals — log them in
```
progress.md
```
and skip their commit

2. Update PRD checkboxes

docs/tasks/<feature-name>/PRD-<feature-name>.md

Mark completed stories:
```
- [ ] **USxxx**
```
→
```
- [x] **USxxx**
```
Leave blocked stories unchecked; add a
```
> ⚠️ BLOCKED: <reason>
```
note below them
Do NOT modify any other part of the PRD

3. Update progress.md

Append to

docs/tasks/<feature-name>/progress.md

markdown

## [YYYY-MM-DD HH:MM] Priority N complete

| Story | Status | Files | Summary |
|-------|--------|-------|---------|
| US001 | ✅ done | `src/auth.ts` | Implemented JWT middleware |
| US002 | ✅ done | `src/user.ts` | Added user model with relations |
| US003 | ⚠️ blocked | — | DB connection refused in CI |

**Next**: Priority N+1 — US004, US005

4. Atomic commits — one per story

For each completed (non-blocked) story, make one surgical commit:

bash

git add <only the files_modified listed in RALPH_DONE> docs/tasks/<feature-name>/PRD-<feature-name>.md docs/tasks/<feature-name>/progress.md
git commit -m "feat(<scope>): <story title> (USxxx)"

Rules:

NEVER run
```
git add .
```
or
```
git add -A
```
Commit message format:
```
feat(<scope>): <what was built> (USxxx)
```
Include
```
PRD-*.md
```
and
```
progress.md
```
in every commit (they travel with the code change)
One commit per story, even if multiple stories finished in the same Priority group

5. Implementation summary (only when full PRD is done)

When all user stories in the PRD are checked

[x]

, write a brief summary at the bottom of

progress.md