Skip to content

Fix discrepancies and improve public repo experience#3

Merged
Jacob Miller (jacob-pattern) merged 1 commit intomainfrom
claude/goofy-almeida
Apr 3, 2026
Merged

Fix discrepancies and improve public repo experience#3
Jacob Miller (jacob-pattern) merged 1 commit intomainfrom
claude/goofy-almeida

Conversation

@jacob-pattern
Copy link
Copy Markdown
Collaborator

Summary

  • Fix Mermaid flowchart in README to show sequential outcome order (was incorrectly showing parallel fan-out, contradicting all other docs)
  • Add fail: true to lychee CI so broken markdown links actually block PRs
  • Standardize mkdir/.gitkeep commands across all auditor SKILL.md Output sections (runtime-auditor was missing .gitkeep creation)
  • Reorder README sections so value proposition (Three Pillars, At A Glance, What This Unlocks) comes before implementation instructions
  • Replace wide 7-column checklist table with compact 3-column summary + per-outcome vertical detail sections for better readability
  • Add bug report issue template (only documentation template existed)
  • Add docs/README.md index with reading order guide
  • Document SRE auditor exception in skill-development.md (intentionally routes to sre-agent, not a paired creator)
  • Add status vocabulary clarification to skills-status.md (different from checklist vocabulary by design)
  • Align operator prompt wording between README and adoption-guide
  • Add canonical mkdir command to skill template to prevent future inconsistency

Out of scope (noted for follow-up)

  • Claude Code skill registrations use stale names (autonomy-staging-auditorautonomy--runtime-auditor, resolution-ticket-writerclarity--ticket-writer, etc.) — needs fix in skill registration config
  • v1.0.0 release tag — create after merge

Test plan

  • Verify Mermaid diagram renders as a sequential chain on GitHub
  • Verify lychee CI check runs and would fail on broken links
  • Confirm all internal markdown cross-references resolve
  • Read README top-to-bottom as a first-time visitor — value prop should be clear before instructions

🤖 Generated with Claude Code

- Fix Mermaid flowchart to show sequential outcome order (was parallel)
- Add fail: true to lychee CI so broken links actually block PRs
- Standardize mkdir/gitkeep commands across all auditor SKILL.md files
- Reorder README: value proposition sections before implementation instructions
- Replace wide 7-column checklist table with compact summary + vertical details
- Add bug report issue template for public repo
- Add docs/README.md index with reading order guide
- Document SRE auditor/agent exception in skill-development.md
- Add status vocabulary clarification to skills-status.md
- Align operator prompt wording between README and adoption-guide
- Add canonical mkdir command to skill template to prevent future drift

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@jacob-pattern Jacob Miller (jacob-pattern) merged commit e89c97f into main Apr 3, 2026
7 checks passed
@jacob-pattern Jacob Miller (jacob-pattern) deleted the claude/goofy-almeida branch April 3, 2026 21:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants