mirror of
https://github.com/garrytan/gstack.git
synced 2026-09-14 17:05:28 +02:00
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:
co-authored by
Claude Fable 5.1
parent
59cfa1547f
commit
f1ce46eb8b
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user