Build Log · July 1, 2026

OS Restructure

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

  • OS
  • Engine
  • Refactor
new Strike + Anvil
1

new Strike + Anvil

new gates
3

new gates

files restructured
40

files restructured

principles encoded in HOW_TO_WORK_WITH_ZEB.md
2

principles encoded in HOW_TO_WORK_WITH_ZEB.md

Timeline

  1. Start

    Ignite + Strike capture

    Wired 'knowing why you are right' into strikes.md, anvils.md, HOW_TO_WORK_WITH_ZEB.md

  2. 30m

    OS stabilize (Session 2)

    Deleted forgekit-website/scripts/, updated package.json paths

  3. 45m

    OS Artifact Integrity Gate

    Closed OS & Gate Logic watch before third hit

  4. 60m

    Rules vs. documentation principle

    Encoded: a rule without enforcement is documentation

  5. 75m

    docs/ restructure

    Moved OS docs into forgekit-os/, archived one-offs, verified pipeline

  6. 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