Gigio Project Setup

Install or audit the durable intent layer of a project: PROJECT.md plus the instruction wiring that makes every later session actually read it.

Step 1 — Inspect before asking

Read what exists: PROJECT.md (audit path, Step 4), README, docs, git log, AGENTS.md and CLAUDE.md. Never ask the user for a fact the repository already answers. If an equivalent intent document exists under another name, follow any migration choice already given. Otherwise inspect the difference and ask only before replacing or creating a rival source of intent; an audit can report the existing document without waiting for that choice.

Step 2 — PROJECT.md: six questions, two speeds

Interview for material gaps only, one question at a time. Carry forward explicit user decisions from the session without asking for their confirmation again.

Top half — human-owned. Mark the boundary in the file (for example <!-- human-owned: renegotiate with the user before editing -->). Model inference is not a decision until the user confirms it.

1. Why this exists — a diagnosis, not an aspiration: one concrete incident showing why the current state fails.
2. Pillars — 3–5 sentences carrying the intended experience or goal, each paired with "this does not mean X".
3. Non-goals — reasonable options deliberately excluded, with reasons; deferred items carry a re-evaluation condition.
4. Judgment rules — numbered, falsifiable imperatives ("when A conflicts with B, choose A"), each anchored to the real decision or incident that created it.