Skip to content

Commit 190e1ab

Browse files
dtomsclaude
andcommitted
docs: relax single-commit rule, add fork baseline to FORK.md
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 7bcb98a commit 190e1ab

2 files changed

Lines changed: 14 additions & 5 deletions

File tree

CLAUDE.md

Lines changed: 2 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,16 +4,13 @@ Read @FORK.md for full context on this fork.
44

55
## Branch & Commit Strategy
66

7-
- `af-main` is the fork branch. It must always be exactly **one commit** ahead of upstream.
8-
- That commit has the subject line: `feat: AppFolio spec-kit fork — specify-af-cli with bundled extensions`. Use this to identify it.
9-
- When merging work into `af-main` (directly or via squash merge), amend into this single fork commit rather than adding new commits.
7+
- `af-main` is the fork branch. It accumulates commits from PRs and releases.
108
- On feature branches, squash to one commit before merge.
11-
- Before integrating an upstream release, ensure af-main is one commit ahead, then merge the upstream tag. Resolve conflicts per @FORK.md.
9+
- Before integrating an upstream release, squash all af-main commits since the fork baseline (see @FORK.md) into one commit, then merge the upstream tag. Resolve conflicts per @FORK.md.
1210
- Use Conventional Commits on feature branches: `feat:`, `fix:`, `chore:`, etc.
1311

1412
## Git Rules (enforced by Claude unless user explicitly overrides)
1513

16-
- **Never create additional commits on `af-main`** — always amend the single fork commit.
1714
- **Always work on a feature branch.** Never commit directly to `af-main` without user confirmation.
1815
- **Never push merge commits.** If a pull or merge introduces a merge commit, rebase instead.
1916
- **Before force-pushing `af-main`:** confirm with the user first — this rewrites shared history.

FORK.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,18 @@ When merging upstream releases, expect conflicts in these files:
2525
- `extensions/catalog.json` — keep AF entries and catalog URL
2626
- `.github/workflows/release.yml` — keep `af-v*` tag filter, AF install URL, extension ZIP step
2727

28+
## Fork Baseline
29+
30+
The fork diverged from upstream at commit `43cb0fa` (`feat: add bundled lean preset with minimal workflow commands (#2161)`).
31+
The first AF modification is `f44666a` (`feat: AppFolio spec-kit fork — specify-af-cli with bundled extensions`).
32+
33+
When integrating an upstream release:
34+
1. Squash all af-main commits since `43cb0fa` into one
35+
2. Merge the upstream tag on top
36+
3. Update the baseline commit below after resolving conflicts
37+
38+
**Current baseline**: `43cb0fa``feat: add bundled lean preset with minimal workflow commands (#2161)`
39+
2840
## How to Maintain
2941

3042
### Local Development Setup

0 commit comments

Comments
 (0)