Skip to content

docs: add CLAUDE.md, split changelog, new skills, and remove stray diagnostics - #100

Merged
lihsaa591 merged 2 commits into
masterfrom
docs/maintainability-improvements
Sep 30, 2026
Merged

lihsaa591 merged 2 commits into
masterfrom
docs/maintainability-improvements

Conversation

@lihsaa591

Copy link
Copy Markdown
Contributor

Summary

  • Adds root CLAUDE.md indexing .claude/skills/ and the doc split, so an agent working from a fresh checkout discovers existing institutional knowledge instead of re-deriving it -- directly motivated by the PR fix: replace permanent auto-escalate block with real-activity freshness check #93 mistake, which happened while working from a scratch clone with none of this loaded.
  • Splits the changelog out of PHASE2-SETUP.md into CHANGELOG.md.
  • Adds debug-crisp-triage-not-investigated skill: the elimination checklist from the 2026-09-29 investigations.
  • Extends verify-github-actions-change with the stale-branch-name lesson from PR fix: replace permanent auto-escalate block with real-activity freshness check #93.
  • Corrects PHASE2-SETUP.md's file listing: investigated.json no longer gates anything post-checkedThroughAt; escalated.json (which actually does) wasn't listed at all.
  • Removes 3 temporary diagnostic scripts + their workflow, left on master from the 2026-09-29 investigations and missed in that day's own cleanup -- caught while reviewing scripts/ for this same work.

Test plan

  • Verified via gh api .../contents?ref=<branch> that the pushed branch actually contains everything (CLAUDE.md, CHANGELOG.md present; no diagnose-* files remain)
  • Validated both skill files' YAML frontmatter parses correctly

🤖 Generated with Claude Code

lihsaa591 and others added 2 commits September 30, 2026 10:42
…agnostics

Adds a root CLAUDE.md indexing .claude/skills/ and the doc split, so an
agent working from a fresh checkout discovers existing institutional
knowledge instead of re-deriving it -- directly motivated by today's
PR #93 mistake, which happened while working from a scratch clone with
none of this loaded.

- Splits the changelog out of PHASE2-SETUP.md into CHANGELOG.md.
- Adds debug-crisp-triage-not-investigated skill: the elimination
  checklist from the 2026-09-29 investigations.
- Extends verify-github-actions-change with the stale-branch-name
  lesson from PR #93.
- Corrects PHASE2-SETUP.md's file listing: investigated.json no
  longer gates anything post-checkedThroughAt; escalated.json (which
  actually does) wasn't listed at all.
- Removes 3 temporary diagnostic scripts + their workflow, left on
  master from the 2026-09-29 investigations and missed in that day's
  own cleanup -- caught while reviewing scripts/ for this same work.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@lihsaa591
lihsaa591 merged commit 4440a8b into master Sep 30, 2026
@lihsaa591
lihsaa591 deleted the docs/maintainability-improvements branch September 30, 2026 05:02
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.

1 participant