diff --git a/.gitignore b/.gitignore index b7202fd..94964e6 100644 --- a/.gitignore +++ b/.gitignore @@ -8,3 +8,4 @@ Cargo.lock .omc/ .claude/ demo.mp4 +CLAUDE.md diff --git a/CLAUDE.md b/CLAUDE.md deleted file mode 100644 index 2d804b9..0000000 --- a/CLAUDE.md +++ /dev/null @@ -1,90 +0,0 @@ -# CLAUDE.md — git-parsec Project Instructions - -## Project Overview - -- **Name**: git-parsec (binary: `parsec`) -- **Language**: Rust (edition 2021) -- **Repo**: https://github.com/erishforG/git-parsec -- **Docs site**: https://erishforg.github.io/git-parsec/ (GitHub Pages from `docs/` on `main`) - -## Branch Strategy - -- **Main branch**: `main` — production, auto-releases on push -- **Dev branch**: `develop` — development work -- PRs go from `develop` → `main` -- Default branch prefix: `feature/` - -## Release Process - -### How Releases Work - -Releases are **fully automated via CI** (`.github/workflows/release.yml`). The workflow triggers on every push to `main` and: - -1. Reads version from `Cargo.toml` -2. Checks if a git tag for that version already exists -3. If new: creates git tag, publishes to crates.io, creates GitHub Release, builds binaries, and snapshots versioned docs - -### NEVER Create Tags Manually - -**Do NOT run `git tag` or create tags manually.** The CI workflow handles tag creation automatically. Manually creating tags will cause the release workflow to skip (it checks `if tag exists → skip`). - -### How to Release a New Version - -1. Bump `version` in `Cargo.toml` -2. Ensure all changes are on `develop` -3. Merge `develop` → `main` via PR -4. CI does the rest automatically - -### Pre-Release Checklist (MANDATORY) - -**CRITICAL: Do NOT merge to `main` without completing ALL items below. Skipping README or docs updates has caused issues in the past.** - -Before merging to `main`, verify: - -- [ ] `Cargo.toml` version bumped -- [ ] **`README.md` updated** — new commands, changed flags, feature descriptions, command count -- [ ] **`docs/` pages updated** — this is the public-facing site, must reflect current version - - `docs/index.html` — feature list, command count, examples - - `docs/guide/index.html` — installation, workflows, new features - - `docs/reference/index.html` — all commands with correct options/examples - - `softwareVersion` in structured data (`