docs: NOTICE, Apache license text, README interop, project structure

NOTICE.md names what gstack derived from impeccable (rule ids and names in
the catalog and the registry fixture; the visitor modes, craft-floor
reflexes, and calibration in the design resolvers; the font procedure in the
consultation template) and from Google's DESIGN.md specification (the format
lib/design-md.ts implements), states that gstack does not distribute or audit
the impeccable engine, and points at licenses/Apache-2.0.txt (verbatim).

README: the design-consultation, design-review, and design-html rows say what
changes when impeccable or the open DESIGN.md format is in play, and a "Works
with impeccable" paragraph explains the pre-pass, the shared ids, PRODUCT.md
and DESIGN.md as the shared surface, the handoffs, the no-nag posture without
impeccable, and the off switch. docs/skills.md gets the detector paragraph
under /design-review. docs/PROJECT_STRUCTURE.md lists the new lib and bin
files, NOTICE.md, and licenses/. docs/designs/IMPECCABLE_INTEROP.md promotes
the CEO plan (its ~/.gstack copy is flipped to PROMOTED) with a "what
shipped" summary. TODOS.md files the seven deferrals from the reviews: the
design-review Phases 7-11 carve (the budget lever, with the +2.87K vs 2.5K
landing recorded), the Bun .env audit across bin/*.ts, the Kiro bin/lib gap,
the $D check slop rubric, taste-profile interplay, the CEO Section 11
bullets, and the scan cache.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
Garry Tan
2026-09-08 16:31:25 +00:00
co-authored by Claude Fable 5.1
parent 59cfa1547f
commit f1ce46eb8b
7 changed files with 362 additions and 5 deletions
+42
View File
@@ -2,6 +2,48 @@
## NEXT PRIORITY
### P2/P3: impeccable interop deferrals (filed 2026-09-08, from the CEO + eng reviews of docs/designs/IMPECCABLE_INTEROP.md)
Each item was weighed during the review and deferred with a reason; none blocks
the shipped detector, catalog, or open DESIGN.md format.
- **Carve design-review Phases 7-11 into a section (budget lever)** — design-review's
eager tokens landed at +2.87K against the review's 2.5K target after every
planned lever (ids-only detector rules in category 9, the dump script moved to
`lib/dom-dump.js`, trimmed prose); the ceiling in
`test/fixtures/context-budget.json` moved to the measured 31,319. The next real
lever is carving the fix loop (Phases 7-11) into a section, which touches the
E2E copy logic in `test/skill-e2e-design.test.ts`. Effort M. Priority P2.
- **Bun `.env` auto-load audit across `bin/*.ts`** — Bun loads a cwd `.env` into
`process.env` even for a script outside cwd. `gstack-design-detect.ts` and
`gstack-design-md.ts` render with `--no-env-file` and ignore in-repo
`IMPECCABLE_BIN` / `IMPECCABLE_HOME`; every other `bun run
~/.claude/skills/gstack/bin/*.ts` a skill renders has the same exposure for any
env-driven exec path. Audit them, render `--no-env-file` where an env var can
name a binary or a path. Effort S. Priority P2.
- **Kiro install arm links `SKILL.md` and `sections/` only** — every gstack
`bin/` path a Kiro render carries (the detector, the DESIGN.md tool, the render
CLI, review-log, diff-scope) is a pre-existing gap on that host. Link `bin/`
and `lib/` together there like the other arms (`setup` ~2341). Effort S.
Priority P2. Collaborative repo, not fixed in the interop PR.
- **`$D check` slop rubric** — add the catalog's LLM-only tells (hero metrics,
identical cards, glassmorphism, content stand-ins) to `design/src/check.ts`'s
vision pass once those entries have been exercised in reviews. Open questions:
a paid GPT-4o call per variant, and vision misjudging cream palettes and nested
cards. Effort M. Priority P3.
- **Taste-profile interplay for `overused-font`** — downgrade a detector
overused-font hit to polish when the face is in the user's approved taste
profile. Today `impeccable hooks ignore-value overused-font <face>` covers it
without coupling the two schemas. Effort S. Priority P3.
- **plan-ceo-review Section 11 catalog bullets** — render `{{DESIGN_SLOP_BULLETS}}`
into the CEO review's design section. Blocked on the plan-ceo-review doctrine
carve (~555 B of skeleton headroom today). Effort S. Priority P3.
- **Detector scan cache** — cache `gstack-design-detect.ts scan` results under
`${GSTACK_HOME}/cache/design-detect/` keyed on engine hash, target-set hash,
and `.impeccable/config*.json` hash, so Phase 9's rescan and repeated ship
reviews skip unchanged files. Effort S. Priority P3.
### P2: fork-port residual wave deferrals (filed at Wave A, 2026-09-03)
Filed from the time-attack/gstack residual evaluation