Skip to content

docs: add build-time optimization program driver and register#2032

Closed
markdumay wants to merge 1 commit into
mainfrom
docs/build-time-optimization-program
Closed

docs: add build-time optimization program driver and register#2032
markdumay wants to merge 1 commit into
mainfrom
docs/build-time-optimization-program

Conversation

@markdumay

Copy link
Copy Markdown
Collaborator

Summary

Program driver for executing the verified findings of the 2026-07-15 build-profiling session (baseline: warm exampleSite build 16–19 s wall / ~39 s CPU; combined verified experiments reached ~11–13 s / 29.5 s). Written to be picked up by a fresh session and executed autonomously.

Chunks (one agent each, every one gated by a byte-diff "output unchanged" check):

Chunk Repo Mode Verified effect
A: stop re-validating absent arguments mod-utils implement + auto-merge −11% CPU, byte-identical
B: search index off the render critical path mod-flexsearch implement + auto-merge −2 to −3.5 s wall
C: build hygiene (vendoring guard, CI GOGC, determinism harness, cache docs) hinode implement, PR held −4 s npm overhead + CI CPU
D: content render-once (context-independent shortcodes → .Content) hinode + mods audit + design only, STOP −21% CPU (later)
E: sidebar render-once hinode design only, STOP docs-site wall/CPU (later)
F: dependency bumps once A/B release hinode PR held carries A+B to users

Authority model (agreed 2026-07-15): module PRs merge after evidenced DoD + green CI (releases cut via semantic-release); hinode PRs are opened but never merged by the program. All work starts from origin/main in fresh clones/worktrees. At launch, the live register moves to a program/build-time-optimization branch; this PR is the launch snapshot.

The driver encodes the session's hard-won operational lessons: stale local clones, exampleSite module resolution (HUGO_MODULE_REPLACEMENTS), mount-order shadowing, single-return partials, the RSS-race diff allowlist (sprite ordering already fixed via #2031), auto-generated netlify.toml, and reusable-workflow env propagation.

QA: reviewed by an independent fresh-context agent against both repos; all 13 findings (1 blocker, 8 should-fix, 4 nits) addressed.

Launch

Approve + merge, then start a fresh session with: "Execute the program in docs/superpowers/specs/2026-07-15-build-time-optimization-program-driver.md".

🤖 Generated with Claude Code

Prepares an agent-orchestrated program to execute the verified findings
of the 2026-07-15 build profiling session as independent chunks:

- Chunk A (mod-utils): stop re-validating absent arguments
  (verified -11% CPU, byte-identical output)
- Chunk B (mod-flexsearch): take the search index off the render
  critical path (verified -2 to -3.5s wall)
- Chunk C (hinode): build hygiene - conditional vendoring, CI GOGC,
  determinism harness, caching docs
- Chunks D/E (gated): content render-once audit and sidebar
  render-once design, STOP before implementation
- Chunk F: hinode dependency bumps once A/B release

Authority: module PRs merge after evidenced DoD + green CI; hinode PRs
are opened and held for the maintainer. All work starts from
origin/main in fresh clones or worktrees; every chunk passes a
byte-diff output-unchanged gate. The live register moves to the
program branch at launch; this commit is the launch snapshot.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@netlify

netlify Bot commented Jul 15, 2026

Copy link
Copy Markdown

Deploy Preview for gethinode-demo ready!

Name Link
🔨 Latest commit f5a4a80
🔍 Latest deploy log https://app.netlify.com/projects/gethinode-demo/deploys/6a57d75ba60cc1000806b125
😎 Deploy Preview https://deploy-preview-2032--gethinode-demo.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@markdumay

Copy link
Copy Markdown
Collaborator Author

Superseded: the driver and register (with all QA fixes) moved to the private gethinode.com repo in gethinode/gethinode.com#160, adapted to their new home (program branch and live register now in gethinode.com; launch from the local gethinode.com clone). Companion removal of docs/superpowers from this repo: see the docs/move-superpowers-private PR.

@markdumay markdumay closed this Jul 15, 2026
@markdumay markdumay deleted the docs/build-time-optimization-program branch July 15, 2026 19:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant