Skip to content

Commit d41bed5

Browse files
authored
chore: wave2 fork customizations doc (#3)
Document light-customization fork governance for AiFeatures/OpenShell: upstream NVIDIA/OpenShell, sync cadence quarterly, owner @ashsolei. Standardizes per enterprise fork-governance.md and the fork-upstream-merge runbook.
1 parent 908ffd7 commit d41bed5

1 file changed

Lines changed: 71 additions & 0 deletions

File tree

FORK-CUSTOMIZATIONS.md

Lines changed: 71 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,71 @@
1+
# Fork Customizations
2+
3+
> Upstream: [NVIDIA/OpenShell](https://github.com/NVIDIA/OpenShell)
4+
> Fork maintained by: @ashsolei
5+
> Last reviewed: 2026-04-08
6+
> Fork type: **light-customization**
7+
> Sync cadence: **quarterly**
8+
9+
## Purpose of Fork
10+
11+
NVIDIA OpenShell fork; iAiFy evaluation-only scope with enterprise CI overlay.
12+
13+
## Upstream Source
14+
15+
| Property | Value |
16+
|---|---|
17+
| Upstream | [NVIDIA/OpenShell](https://github.com/NVIDIA/OpenShell) |
18+
| Fork org | AiFeatures |
19+
| Fork type | light-customization |
20+
| Sync cadence | quarterly |
21+
| Owner | @ashsolei |
22+
23+
## Carried Patches
24+
25+
Local commits ahead of `upstream/main` at last review:
26+
27+
- `908ffd7d docs: add iAiFy Fork Notes block to README (#2)`
28+
- `a95991f0 chore: remove obsolete .agents/skills definitions`
29+
- `a60ce82d ci: add dependabot.yml for iAiFy governance`
30+
- `88d4049c docs: add copilot-instructions.md for iAiFy governance`
31+
32+
## Supported Components
33+
34+
- Root governance files (`.github/`, `CLAUDE.md`, `AGENTS.md`, `FORK-CUSTOMIZATIONS.md`)
35+
- Enterprise CI/CD workflows imported from `Ai-road-4-You/enterprise-ci-cd`
36+
37+
## Out of Support
38+
39+
- All upstream source directories are tracked as upstream-of-record; local edits to core source are discouraged.
40+
41+
## Breaking-Change Policy
42+
43+
1. On upstream sync, classify per `governance/docs/fork-governance.md`.
44+
2. Breaking API/license/security changes auto-classify as `manual-review-required`.
45+
3. Owner triages within 5 business days; conflicts are logged to the `fork-sync-failure` issue label.
46+
4. Revert local customizations only after stakeholder sign-off.
47+
48+
## Sync Strategy
49+
50+
This fork follows the [Fork Governance Policy](https://github.com/Ai-road-4-You/governance/blob/main/docs/fork-governance.md)
51+
and the [Fork Upstream Merge Runbook](https://github.com/Ai-road-4-You/governance/blob/main/docs/runbooks/fork-upstream-merge.md).
52+
53+
- **Sync frequency**: quarterly
54+
- **Conflict resolution**: Prefer upstream; reapply iAiFy customizations on a sync branch
55+
- **Automation**: [`Ai-road-4-You/fork-sync`](https://github.com/Ai-road-4-You/fork-sync) workflows
56+
- **Failure handling**: Sync failures create issues tagged `fork-sync-failure`
57+
58+
## Decision: Continue, Rebase, Refresh, or Replace
59+
60+
| Option | Current Assessment |
61+
|---|---|
62+
| Continue maintaining fork | yes - governance overlay only |
63+
| Full rebase onto upstream | feasible on request |
64+
| Fresh fork (discard local changes) | acceptable |
65+
| Replace with upstream directly | possible |
66+
67+
## Maintenance
68+
69+
- **Owner**: @ashsolei
70+
- **Last reviewed**: 2026-04-08
71+
- **Reference runbook**: `ai-road-4-you/governance/docs/runbooks/fork-upstream-merge.md`

0 commit comments

Comments
 (0)