ForgeKitFORGEKIT

Build Log

OS Restructure

July 1, 2026

Moved OS docs into forgekit-os/, encoded two foundational principles, added three gates.

OSEngineRefactor
1
new Strike + Anvil
3
new gates
40
files restructured
2
principles encoded in HOW_TO_WORK_WITH_ZEB.md

Timeline

Start
Ignite + Strike capture
Wired 'knowing why you are right' into strikes.md, anvils.md, HOW_TO_WORK_WITH_ZEB.md
30m
OS stabilize (Session 2)
Deleted forgekit-website/scripts/, updated package.json paths
45m
OS Artifact Integrity Gate
Closed OS & Gate Logic watch before third hit
60m
Rules vs. documentation principle
Encoded: a rule without enforcement is documentation
75m
docs/ restructure
Moved OS docs into forgekit-os/, archived one-offs, verified pipeline
90m
packages/ README
Clarified packages/ as extraction output, not OS machinery

What shipped

Strike: 'Knowing why you are right is far more impressive than being right'

Paired Anvil in forgekit-os/journal/anvils.md

Named principle added to HOW_TO_WORK_WITH_ZEB.md

OS Artifact Integrity Gate — fires when writing/modifying gates, keywords, score rules, traps, trigger rows

'Rules vs. documentation' principle in HOW_TO_WORK_WITH_ZEB.md — a rule without enforcement is documentation

§OS section added to forgekit-os/patterns.md — explicit path constants pattern, enforced via gate checkbox

forgekit-website/scripts/ deleted — forgekit-os/scripts/ is now canonical

docs/forge-journal/ → forgekit-os/journal/

docs/reusable-patterns.md → forgekit-os/patterns.md

docs/extraction-backlog.md → forgekit-os/extraction-backlog.md

docs/focus.md → forgekit-os/focus.md

One-off OS docs archived to forgekit-os/archive/

One-off product docs archived to docs/archive/ or deleted

All path references updated across scripts, .claude/rules/, CLAUDE.md, HOW_TO_WORK_WITH_ZEB.md, PROJECT_INDEX.md, settings.json

packages/README.md — explains packages/ as extraction output vs OS machinery