docs(prompting): document the intent interview and align pages with skill contracts - #2872
Open
WaterrrForever wants to merge 4 commits into
Open
Conversation
general-video leads with its positive identity and companion mode; faceless-explainer keys on invented visuals instead of TTS; talking-head-recut uses the 'graphic overlays' trigger term; motion-graphics gains its input side and overlay output; music-to-video stops implying images are required.
Replace the 4-5 column table hack with a 3-column CSS grid, switch demo clips to autoplay muted loops (no black poster frame, no player chrome over tiny videos), and align cells at 16:9.
The guide taught prompt shapes but never prepared readers for the conversation that follows: the intent interview, the two run-shape questions (storyboard, automation vs companion), the just-build-it skip, and BRIEF.md as the resumable artifact. Add that section to the overview, a disambiguation note on the storyboards page, and free up 'companion' as a reserved term in media-and-audio.
Step 3 (Strategy & Messaging) listed no output while describing exactly what BRIEF.md now captures. Name the artifact in the step table, project tree, step body, gate, and iterating list, and fix SCRIPT.md's step label in the tree (Step 4, not 3).
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Stacked on #2109 — targets its branch, since the
docs/prompting/pages only exist there.What
BRIEF.mdas the artifact later sessions resume from.BRIEF.mdthe pipeline guide's Step 3 artifact (step table, project tree, step body, gate, iterating list), and fixSCRIPT.md's mislabeled step in the tree (Step 4, not 3).preload="metadata", player chrome covering ~250px-wide videos, ragged cell heights).Why
The intent layer (
BRIEF.md,flow,storyboard) is the front door of every skills run, but the guide never prepared readers for it: no page explained the interview, companion vs automation, or the file that makes a brief resumable. The catalog one-liners had also drifted from the SKILL.md descriptions they compress — including one that inverted a contract (music-to-video requires zero user assets).Test plan
mint dev: pages render, the new#the-interview-what-the-agent-asks-firstanchor resolves from both cross-links, video grids play and align