🚣 [readme] update features in .just readme

[chicks-net]

Done

• 🚣 [readme] update features in .just readme

Meta

(Automated in .just/gh-process.just.)

[Copilot]

Pull request overview

This PR updates the .just/README.md to provide a more comprehensive and better-organized documentation of the just-based workflow features. The changes reorganize existing features into logical categories and document several previously undocumented commands and scripts.

Key changes:

• Restructures feature list into four clear sections: Branch Management, PR Creation/Updates, PR Checks/AI Reviews, and Merge/Release
• Documents previously undocumented commands like utcdate, pr_update, pr_verify, again, claude_review, and release_age
• Adds new section documenting the install-prerequisites.sh script with its features and usage

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[claude]

Code Review - PR #52

Summary

This PR updates the .just/README.md documentation to provide better organization and more complete coverage of the gh-process.just workflow features. The changes reorganize existing bullet points into logical sections and add documentation for several recipes that were previously undocumented.

Positive Observations ✅

1. Better Organization: The new sectional structure (Branch Management, PR Creation and Updates, PR Checks and AI Reviews, Merge and Release, Safety and Automation) makes the documentation much easier to scan and understand.

2. Documentation Completeness: Previously undocumented recipes are now covered:

   • pr_update (.just/gh-process.just:203)
   • pr_verify (.just/gh-process.just:252)
   • again (.just/gh-process.just:398)
   • claude_review (.just/gh-process.just:194)
   • release_age (.just/gh-process.just:332)

3. Accurate Implementation Details: The descriptions accurately reflect the actual code implementation (verified against source).

4. Useful Context: Adding details like "reads from stdin" for pr_verify and "chains push, PR update, and checks monitoring" for again helps users understand how to use these recipes.

Suggestions for Improvement 💡

1. Hidden Recipe Documentation: The documentation mentions _on_a_pull_request (.just/gh-process.just:127) in the "Sanity checks" section, which is good. This is a new hidden recipe that was not documented before.

2. Polling Interval Consistency: The "PR Checks and AI Reviews" section mentions "5-second polling" which matches the implementation (-i 5 flag at line 154), but the original documentation in CLAUDE.md mentioned "5 second polling" while the updated README correctly states this. Good consistency.

3. Release Recipe Enhancement: The documentation now mentions "pulls the new tag locally" for the release recipe, which accurately reflects the git pull at line 147. Nice attention to detail!

4. Minor Wording: Consider if "Standalone Claude review" is the clearest description. Perhaps "View Claude review comments" or "Show latest Claude review" would be more action-oriented to match other bullets like "Displays both GitHub Copilot...".

Code Quality Assessment

• Accuracy: ✅ All documented features exist in the codebase
• Completeness: ✅ Covers all major public recipes
• Organization: ✅ Logical grouping improves readability
• Consistency: ✅ Formatting and style match existing documentation

Security & Performance

No concerns. This is documentation-only change.

Test Coverage

N/A - Documentation update only.

Recommendation

APPROVE ✅

This is a solid documentation improvement that makes the workflow features more discoverable and understandable. The reorganization into sections is a clear win for usability, and documenting the previously undocumented recipes (pr_update, pr_verify, again, claude_review, release_age) fills important gaps.

The documentation accurately reflects the implementation, which I verified by cross-referencing the recipe descriptions with the actual code in .just/gh-process.just.

---

🤖 Generated with Claude Code