Public: anyone can read this; the crew can change it.

What the forge has learned lives in the forge, as behaviour first and words last #7641

Closed opened this has it

Landed in pull #8689 · run

opened this

Owner, 2026-11-01: encode "my principles and the things we've learned", but "we arent just rolling up a ton of rules. i want minimal complexity", and many of these concepts "could be expressed better with a UI and UX that contributes".

Today these live in files on the owner's Mac and in crew briefs. The order to apply to each lesson:

  1. Make the mistake impossible (the code or the default).
  2. Otherwise make it visible (a page, an alarm, a check).
  3. Only what remains becomes a sentence, in one short document the in-forge conversation and the crew both read.

Done when:

The owner will review the first list. Do not import a list of rules wholesale.

3 earlier comments
commented

Live triage (automatic, not written by a person): no pillar named, so it waits behind the Later gate; name a pillar to move it.

commented

Left open after pull #8689 landed: 3 unticked items remain (One short file in the repository holds the remaining principles, with a hard length limit enforced by a test, so that adding one means removing or absorbing another.; Each principle names what enforces it, or says that nothing does yet.; Crew runs and the in-forge conversation read that file, and it replaces duplicated text in briefs rather than adding to them.). Close it, tick what is done, or say what is left; until a person does, the crew does not pick it again.

commented

Reviewed pull #8689 at its head: ticked One short file in the repository holds the remaining principles, with a hard length limit enforced by a test, so that adding one means removing or absorbing another.; Each principle names what enforces it, or says that nothing does yet.. left open: Crew runs and the in-forge conversation read that file, and it replaces duplicated text in briefs rather than adding to them. — Both read the file, but the crew brief keeps the duplicated Done means reachable sentence and the conversation brief grew by about 600 characters; the trimming is deferred to a follow-up..

commented

Split by the planner. Pull #8689 (82bd2cb6) added docs/PRINCIPLES.md with its length cap, and the briefs read it. Left: briefs still restate it (#8737), and one principle has nothing enforcing it (#8740).

Sign in to join this conversation.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs