Skip to content

Add prebuild skill - #79

Open
LukeJSimmons wants to merge 15 commits into
mainfrom
add-prebuild-skill
Open

LukeJSimmons wants to merge 15 commits into
mainfrom
add-prebuild-skill

Conversation

@LukeJSimmons

@LukeJSimmons LukeJSimmons commented Oct 20, 2026 •

Copy link
Copy Markdown
Contributor

Why

Review mostly happens after a feature is built, when changes are expensive. This adds a short pre-build session for a Linear card: Claude does the homework, the card owner answers what they can alone, and a teammate joins only for what's still open. Discussion starts from real evidence (diagrams, plus facts tied to files and cards), not a document to read. It's the teammate stage after brave-breakdown, and folds in beta feedback from the merge-script trial and from Malachi (HTML diagrams instead of Mermaid).

What Changed

  • Adds prebuild: preps a Linear card (or builds on an existing BRAVE breakdown), explains it back, and builds a deck sized by the estimate
  • Each slide pairs one question with a diagrams.js diagram (vendored unchanged from feature-review; an Expand view that fills the window, render-checked during prep, optional per-source arrow colours) and verified facts grouped as Gaps / Constraints / Context
  • A local presenter (serve.py + presenter.html) with a notes composer for open questions (multi-line notes, In/Out-style columns with a General list underneath and drag between them), photos, and a per-slide whiteboard (inline Excalidraw or a live excalidraw.com session)
  • Owner pass first; the live session (?open) covers only what's still open, and is skipped when nothing is
  • Wrap-up reads notes, photos, whiteboards and optionally Granola, saves summary.md, and copies Markdown or posts to Linear only on request

Screenshots

A slide: question, diagram, and facts grouped as gaps, constraints and context Whiteboard in live-session mode, above the notes composer with an open question Whiteboard in inline mode: Excalidraw started from the slide's compare diagram

Pre-merge

  • Have you updated README.md and AGENTS.md? Any new, renamed, or removed skill needs a row in the README table and a bullet in AGENTS.md. Check the box or replace it with N/A if this PR touches no skill.

A pre-build session for a Linear card: the owner and a teammate go through a browser presenter where each slide pairs a diagram and verified facts with one question and a board for notes and photos. The teammate stage after brave-breakdown.
@LukeJSimmons LukeJSimmons self-assigned this Oct 20, 2026
Copilot AI balanced review requested due to automatic review settings October 20, 2026 16:33

This comment was marked as resolved.

@Malachirwin

Copy link
Copy Markdown
Contributor

👍 Beta feedback on prebuild from malachi

Worked pretty well! It produced clean, clear, concise slide decks that inspired menaingful disucussions.

It seems like it is imited to only mermaid diagrams, maybe in part by restrictions about rendering in linear (for comments, etc). I would like it if we couled convert that to be HTML diagrams instead since that would make it more flexiable what it can do. That’s what the /feature-review skill does and it produces some great results!

Sent from RoleModel Vault · branch add-prebuild-skill

- Plain bullets everywhere; checkboxes only for Done when
- Dark only: remove the light palette and theme toggle
- Copy as Markdown on the wrap-up screen, and summary.md with a copy option at Share
- Open switch beside the add box, so a note can be marked open as it is written
- Build from an existing BRAVE breakdown instead of asking its questions again
- Owner answers the deck alone first; the live session covers only what is still open (?open view)
- serve.py ignores query strings
Replaces Mermaid in the presenter with a vendored, unchanged copy of
feature-review's diagrams.js, so slides can use structure, sequence,
compare, svg and html diagrams and the page works offline. Legends and
status tags can be relabelled per diagram. Diagram and deck-format
guidance moves into references/.
- Composer under each board with a Note / Open question toggle, an Add button and an Added flash
- Open questions show as amber rows with a ? badge instead of a trailing OPEN tag
- Unsent text is added on slide change and page close, never on blur
- Clearing a note's text deletes it
- Whiteboard row above Notes, starting from the slide's diagram (whiteboard.js)
- Inline mode: an Excalidraw editor in the slide that saves after edits, with full screen and arrow keys guarded
- Live session mode: step-by-step hand-off to excalidraw.com and back by pasting or uploading
- serve.py serves whiteboard.js and saves boards to whiteboards/
- Wrap-up compares each saved board with its starting board (references/whiteboard.md)
@Malachirwin

Copy link
Copy Markdown
Contributor

👍 Beta feedback on prebuild from malachi (written by claude)

Owner (mid-prep, design spike with no estimate): "This prep looks fine let's keep going." Explain-back + tier/assist proposal landed well.

Sent from RoleModel Vault · branch add-prebuild-skill

@Malachirwin

Copy link
Copy Markdown
Contributor

👍 Beta feedback on prebuild from malachi (written by claude)

Owner verdict on KATT-2242 (8pt design spike, solo pass): Helped. No reason given. Ended with 2 Open notes, wrapped up as open questions, summary kept local.

Sent from RoleModel Vault · branch add-prebuild-skill

- Notes wrap instead of scrolling, and Shift+Enter adds a new line
- Every board except stickies gets a General notes list
- Notes drag between columns on columns boards
- Removing or moving a note keeps the one being typed
- colorBy "source" gives each source box and its arrows a colour
- Diagrams never shrink below 90%; diagramCheck() flags scrolling or crossed arrows during prep
- Whiteboards open by default only when something has been drawn
- Arrow-key hints beside Back and Next
- Explain-back draws its diagram as plain text in chat
Approach and Done when use plain notes, and General notes show only under columns boards.
A diagram's block grows up to the window edge until it fits; facts, whiteboard and notes keep the column width. A side-by-side pair too wide even then is stacked.
Replaces widening past the column: diagrams fit the column again, and Expand opens the whole diagram over the page, with a compare pair kept side by side. Esc, the backdrop or Close shut it, and the arrow keys don't change slides while it's open.
@Malachirwin

Copy link
Copy Markdown
Contributor

👍 Beta feedback on prebuild from malachi (written by claude)

KATT-2253 epic, async owner pass. User: "It went really well tell luke this is a great tool and thanks for the quick fixes!" Minor: port 8765 was still held by a previous session's server, so the first open showed the old deck; the skill could check that the server serves the expected issue before opening.

Sent from RoleModel Vault · branch add-prebuild-skill

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

3 participants