Skip to content

Commit bc02964

Browse files
committed
docs: add CLAUDE.md with fork context and drift policy
1 parent 4217a7b commit bc02964

1 file changed

Lines changed: 43 additions & 0 deletions

File tree

CLAUDE.md

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
# spec-kit — Fellowship Fork
2+
3+
This is a fork of [github/spec-kit](https://github.com/github/spec-kit), intentionally diverged. We maintain our own flavor: tighter line limits, no prose, bash scripts included.
4+
5+
## Fork Status
6+
7+
- **Upstream**: `github/spec-kit`
8+
- **Commits behind upstream**: 252+ (intentional — we diverged significantly)
9+
- **Do NOT auto-merge upstream** — changes must be cherry-picked manually and reviewed
10+
11+
## Consumer Repos
12+
13+
These repos install speckit commands from this fork (not from upstream):
14+
15+
- `fellowship-dev/booster-pack`
16+
- `fellowship-dev/rails-backend`
17+
- `fellowship-dev/inbox-angel-worker`
18+
- `fellowship-dev/mtg-lotr`
19+
- Clapes repos
20+
21+
Consumer repos copy commands into `.claude/commands/` (e.g., `speckit.specify.md`, `speckit.plan.md`).
22+
23+
## Drift & Updates
24+
25+
- **Drift is checked weekly** by the tooling crew (every Monday at 1am CLT)
26+
- The sync task compares installed command SHAs against this repo's HEAD
27+
- If a consumer repo is drifted, the sync task opens a PR to update it
28+
- To update a consumer repo manually: copy updated command files into `.claude/commands/`
29+
30+
## Upstream Cherry-Picks
31+
32+
- The tooling crew also checks `github/spec-kit` weekly for potentially relevant commits
33+
- A GitHub issue is created on this repo listing recommendations
34+
- Cherry-picks are **manual only** — review carefully before applying
35+
- Never auto-merge from upstream
36+
37+
## What Changed vs Upstream
38+
39+
- Commands cut ~80%: original ~1,400 lines → this fork ~250 lines
40+
- Strict line limits: spec ≤50, plan ≤50, tasks ≤40
41+
- No prose: tasks are checkboxes, specs are bullets, plans are tables
42+
- Bash scripts included for branch creation and plan setup
43+
- Generic constitution template included

0 commit comments

Comments
 (0)