Refresh Reins skill workflows and doctor guidance

[WellDunDun]

Summary

Refreshes the Reins skill workflows with richer command guidance while correcting schema/behavior mismatches to match the current CLI output.
Adds a dedicated Doctor workflow reference and tightens how audit/evolve/scaffold outputs should be parsed.

Changes

• Updated skill/Reins/SKILL.md routing, trigger phrasing, and quick-reference command/maturity sections.
• Expanded skill/Reins/Workflows/Audit.md with deterministic output parsing guidance and updated dimension notes.
• Added skill/Reins/Workflows/Doctor.md as a dedicated remediation workflow with correct JSON fields (check, status, fix, summary).
• Updated skill/Reins/Workflows/Evolve.md to match actual evolve payload shape (steps, weakest_dimensions, applied) and clarify --apply scope.
• Updated skill/Reins/Workflows/Scaffold.md to match init output (created entries include dirs/files) and practical post-scaffold flow.

Testing

• bun test passes
• bun src/index.ts audit ../.. score maintained or improved
• No new external dependencies added

Audit Impact

No audit logic changes. Self-audit remains 18/18 (L4: Self-Correcting).

Summary by CodeRabbit

• Documentation
  • Enhanced command reference with maturity levels, CLI commands, and workflow routing details.
  • Added comprehensive JSON output parsing guidance for audit, doctor, and evolve workflows.
  • Introduced new Doctor workflow documentation including detailed schema and remediation steps.
  • Expanded Quick Reference section with maturity level descriptions and additional examples.
  • Streamlined workflow documentation for improved prescriptive guidance.

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 4ee51b7 and be18b0c.

📒 Files selected for processing (5)

• skill/Reins/SKILL.md
• skill/Reins/Workflows/Audit.md
• skill/Reins/Workflows/Doctor.md
• skill/Reins/Workflows/Evolve.md
• skill/Reins/Workflows/Scaffold.md

---

📝 Walkthrough

Walkthrough

Documentation updates for Reins skill workflows emphasizing JSON output parsing, prescriptive fixes, and maturity levels. Introduces new Doctor workflow documentation and consolidates procedural guidance into structured, machine-readable formats across Audit, Evolve, and Scaffold workflows.

Changes

Cohort / File(s)	Summary
Main Reins Skill Documentation skill/Reins/SKILL.md	Expanded use cases with health check fixes; added Quick Reference section (CLI commands, maturity levels table); refined principles; introduced Doctor workflow row in routing table; added resource index.
Workflow Documentation skill/Reins/Workflows/Audit.md, skill/Reins/Workflows/Evolve.md, skill/Reins/Workflows/Scaffold.md	Shifted from procedural steps to JSON-driven output formats with parsing guidance. Updated dimension criteria, scoring thresholds, and remediation workflows to emphasize structured output analysis rather than manual step-by-step procedures.
New Doctor Workflow skill/Reins/Workflows/Doctor.md	New file introducing Doctor workflow with default commands, JSON output schema (command, project, target, summary, checks), comprehensive check list, parsing examples, and remediation workflow.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

• WellDunDun/reins#7: Shares audit/doctor/evolve workflow logic and risk-policy handling updates that align with the documentation restructuring in this PR.

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately summarizes the main changes: updating Reins skill workflows and adding doctor guidance documentation.
Description check	✅ Passed	The description provides a clear summary, detailed changes, completed testing checklist, and audit impact statement matching the template requirements.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch WellDunDun/skill-workflow-refresh

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}