From 31e0c2bfeec2e98eb63a4f22ac0408c16a899d2f Mon Sep 17 00:00:00 2001 From: Thomas Hallock Date: Wed, 21 Jan 2026 11:19:13 -0600 Subject: [PATCH] chore: remove obsolete root .claude docs Part of agent instructions refactoring (Phase 1 deletions). Co-Authored-By: Claude Opus 4.5 --- .claude/AUTOMATED_WORKFLOWS.md | 97 ---------------------------------- .claude/REBUILD_REMINDER.md | 32 ----------- 2 files changed, 129 deletions(-) delete mode 100644 .claude/AUTOMATED_WORKFLOWS.md delete mode 100644 .claude/REBUILD_REMINDER.md diff --git a/.claude/AUTOMATED_WORKFLOWS.md b/.claude/AUTOMATED_WORKFLOWS.md deleted file mode 100644 index 5ac254f5..00000000 --- a/.claude/AUTOMATED_WORKFLOWS.md +++ /dev/null @@ -1,97 +0,0 @@ -# Automated Workflows for Claude - -This file documents automated workflows that Claude should be aware of when working on this project. - -## NPM Package Publishing - -### @soroban/abacus-react Package - -**Status**: ✅ Fully configured and ready for automated publishing to npm - -**How to trigger a release**: - -```bash -# Minor version bump (new features) -git commit -m "feat(abacus-react): add new bead animation system" - -# Patch version bump (bug fixes) -git commit -m "fix(abacus-react): resolve gesture detection issue" - -# Patch version bump (performance) -git commit -m "perf(abacus-react): optimize bead rendering" - -# Major version bump (breaking changes) -git commit -m "feat(abacus-react)!: change callback signature" -``` - -**Key Requirements**: - -- Must use `(abacus-react)` scope in commit message -- Changes must be in `packages/abacus-react/` directory -- NPM_TOKEN secret must be configured in GitHub repository settings - -**Workflow Details**: - -- **File**: `.github/workflows/publish-abacus-react.yml` -- **Triggers**: Push to main branch with changes in `packages/abacus-react/` -- **Steps**: Install deps → Build package → Run tests → Configure dual auth → Semantic release → Publish to npm + GitHub Packages -- **Versioning**: Independent from monorepo (uses tags like `abacus-react-v1.2.3`) -- **Publishing**: Dual publishing to both npm and GitHub Packages simultaneously - -**Current Status**: - -- ✅ Workflow configured for dual publishing -- ✅ Semantic release setup for both registries -- ✅ Package build/test passing -- ✅ GitHub Packages authentication configured (uses GITHUB_TOKEN) -- ⏸️ Awaiting NPM_TOKEN secret for actual npm publishing - -**What Claude should do**: -When making changes to the abacus-react package: - -1. Use the proper commit format with `(abacus-react)` scope -2. Remember this will trigger automatic npm publishing -3. Ensure changes are meaningful enough for a version bump -4. Reference this workflow in explanations to users - -## Storybook Deployment - -**Status**: ✅ Fully functional - -**Trigger**: Any push to main branch -**Output**: https://antialias.github.io/soroban-abacus-flashcards/ - -- Web app Storybook: `/web/` -- Abacus React component Storybook: `/abacus-react/` - -## Semantic Release (Monorepo) - -**Status**: ✅ Configured to exclude abacus-react scope - -**Workflow**: Regular commits without `(abacus-react)` scope trigger monorepo releases -**Versioning**: Affects root package.json version and creates GitHub releases - -## Claude Guidelines - -1. **Always check commit scope**: When working on abacus-react, use `(abacus-react)` scope -2. **Be intentional**: Package releases are permanent - ensure changes warrant a version bump -3. **Documentation**: Point users to CONTRIBUTING.md for full details -4. **Status awareness**: Remember NPM_TOKEN is required for actual publishing -5. **Testing**: Package tests must pass before publishing (currently has workaround for vitest config issue) - -## Quick Reference - -| Action | Commit Format | Result | -| ---------------------------- | ---------------------------------- | --------------------------- | -| Add abacus-react feature | `feat(abacus-react): description` | npm minor version bump | -| Fix abacus-react bug | `fix(abacus-react): description` | npm patch version bump | -| Breaking abacus-react change | `feat(abacus-react)!: description` | npm major version bump | -| Regular monorepo feature | `feat: description` | monorepo minor version bump | -| Regular monorepo fix | `fix: description` | monorepo patch version bump | - -## Files to Reference - -- `CONTRIBUTING.md` - Full contributor guidelines -- `packages/abacus-react/README.md` - Package-specific documentation -- `.github/workflows/publish-abacus-react.yml` - Publishing workflow -- `packages/abacus-react/.releaserc.json` - Semantic release config diff --git a/.claude/REBUILD_REMINDER.md b/.claude/REBUILD_REMINDER.md deleted file mode 100644 index 65741077..00000000 --- a/.claude/REBUILD_REMINDER.md +++ /dev/null @@ -1,32 +0,0 @@ -# 🚂 STEAM TRAIN REBUILD REMINDER - -**⚠️ ALWAYS CHECK THIS BEFORE STARTING WORK ON TRAIN FEATURES:** - -## What Happened: - -- Git reset destroyed all enhanced steam train features -- Features were in commits 57ef456 and bf65d45 but got lost -- User is rightfully pissed about losing working features - -## What To Do: - -1. **ALWAYS reference `/Users/antialias/projects/soroban-abacus-flashcards/REBUILD_CHECKLIST.md`** -2. **Rebuild features systematically, one at a time** -3. **Commit each feature individually** -4. **Test each feature before moving to next** -5. **Never do destructive git operations without user approval** - -## Current Status: - -- On commit 84334f9 (only has timer bar hidden) -- Need to rebuild ALL enhanced train features -- Priority: Fix question generation first, then visual features - -## Key Lesson: - -- When user asks to "hide timer bar" → just hide the timer bar -- Don't break the entire question generation system -- Don't do git resets that lose working features -- Always keep this checklist updated - -**🔥 CHECK THE REBUILD CHECKLIST BEFORE EVERY TRAIN-RELATED TASK**