Development happens from the c64forge root.
Rules:
- Do not edit or commit source changes inside
upstream/. - Shareable local deltas belong under
patches/. - Local-only proprietary or customer-specific deltas belong under ignored
patches-private/. - Use the root
./forgeentrypoint instead of invoking ad hoc helper scripts from upstream trees. - Keep
PLANS.mdandWORKLOG.mdcurrent while converging phase-based changes. - If an obsolete patch file is retired locally, remove its matching
patches/index.tsvrow when practical;./forge synctolerates stale rows asretiredso manual cleanup does not break the workspace.
Upstream bootstrap:
- Clone with submodules or run
git submodule update --init --recursive. - Treat
manifest.yamlas the pinned upstream record.
For generic 1541ultimate work that should go upstream, use the root ./forge pr 1541ultimate ... flow once Phase 6 is in place.