{"slug":"brief-2","title":"brief","summary":"Interactive briefing of a plan file — explains reasoning, schema decisions, component choices. Use when developers need to understand a plan before approving.","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-10-04T15:14:10.118793Z","repo":{"url":"https://github.com/oliver-kriska/claude-elixir-phoenix","stars":560,"forks":44,"license":"MIT","updatedAt":"2026-10-02T04:11:38Z"},"bodyHtml":"<hr>\n<h2>name: brief\ndescription: Interactive briefing of a plan file — explains reasoning, schema decisions, component choices. Use when developers need to understand a plan before approving.\neffort: low\nargument-hint: \"[path to plan file]\"</h2>\n<h1>Plan Briefing</h1>\n<p>Interactive walkthrough of a plan's reasoning, decisions, and solution\nshape. Designed for developers who need to understand a plan in 1-2\nminutes instead of reading the full document.</p>\n<h2>Why This Exists</h2>\n<p>Plans answer \"what to do\" but bury \"why.\" This skill bridges that\ngap with an interactive walkthrough.</p>\n<h2>Usage</h2>\n<pre><code>/phx:brief                                    # Latest plan\n/phx:brief .claude/plans/user-auth/plan.md    # Specific plan\n</code></pre>\n<h2>Arguments</h2>\n<ul>\n<li><code>$ARGUMENTS</code> = Path to plan file (optional, auto-detects latest)</li>\n</ul>\n<h2>Mode Detection</h2>\n<p>Read the plan file and determine mode from phase statuses:</p>\n<ul>\n<li><strong>All phases <code>[PENDING]</code></strong> = Pre-work briefing (what WILL happen)</li>\n<li><strong>Any phase <code>[COMPLETED]</code> or <code>[IN_PROGRESS]</code></strong> = Post-work briefing\n(what WAS done and why)</li>\n</ul>\n<h2>Execution Flow</h2>\n<h3>Step 1: Locate and Load Plan</h3>\n<ol>\n<li><p>If <code>$ARGUMENTS</code> has a path, use it</p>\n</li>\n<li><p>Otherwise, find latest plan:</p>\n<p>Use Glob to find <code>.claude/plans/*/plan.md</code> and pick the most recent.</p>\n</li>\n<li><p>If no plan found, tell user and suggest <code>/phx:plan</code></p>\n</li>\n<li><p>Read the plan file</p>\n</li>\n</ol>\n<h3>Step 2: Load Supporting Artifacts</h3>\n<p>Read what's available (don't fail if missing):</p>\n<ul>\n<li><code>.claude/plans/{slug}/summaries/consolidated.md</code> (research summary)</li>\n<li><code>.claude/plans/{slug}/scratchpad.md</code> (decisions, dead-ends)</li>\n<li><code>.claude/plans/{slug}/progress.md</code> (work log, post-work only)</li>\n</ul>\n<h3>Step 3: Present Briefing Sections</h3>\n<p>Present ONE section at a time, wrapped in the visual briefing block\n(see <code>${CLAUDE_SKILL_DIR}/references/briefing-guide.md</code> Visual Formatting).</p>\n<p><strong>The section MUST be emitted as visible response text BEFORE the\n<code>AskUserQuestion</code> call.</strong> Content composed only in thinking/reasoning\nis invisible to the user, and the <code>question</code> field is too short to\ncarry it. If the user would see only a \"Continue?\" dialog, the section\nwas never shown. Write the ★ Briefing block as normal output first,\nthen ask:</p>\n<ul>\n<li>If sections remain: question \"Continue the briefing?\" with options\n<strong>\"Next: \"</strong>, <strong>\"Ask me a question about this\"</strong>, <strong>\"Stop here\"</strong></li>\n<li>If final section: no question needed, show closing message</li>\n</ul>\n<h3>Section Flow (Pre-Work Mode)</h3>\n<table>\n<thead>\n<tr>\n<th>#</th>\n<th>Title</th>\n<th>Source</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>1</td>\n<td>What We're Building</td>\n<td>Summary + Scope</td>\n</tr>\n<tr>\n<td>2</td>\n<td>Key Decisions</td>\n<td>Technical Decisions + scratchpad rationale</td>\n</tr>\n<tr>\n<td>3</td>\n<td>Solution Shape</td>\n<td>Phases overview + Data Model</td>\n</tr>\n<tr>\n<td>4</td>\n<td>Risks &amp; Confidence</td>\n<td>Risks table + unknowns/spikes</td>\n</tr>\n</tbody>\n</table>\n<h3>Section Flow (Post-Work Mode)</h3>\n<table>\n<thead>\n<tr>\n<th>#</th>\n<th>Title</th>\n<th>Source</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>1</td>\n<td>What Was Built</td>\n<td>Summary + completion status</td>\n</tr>\n<tr>\n<td>2</td>\n<td>Key Decisions &amp; Why</td>\n<td>Technical Decisions + scratchpad</td>\n</tr>\n<tr>\n<td>3</td>\n<td>How It Was Built</td>\n<td>Phases with implementation notes</td>\n</tr>\n<tr>\n<td>4</td>\n<td>Lessons &amp; Patterns</td>\n<td>Risks encountered + patterns used</td>\n</tr>\n</tbody>\n</table>\n<p>See <code>${CLAUDE_SKILL_DIR}/references/briefing-guide.md</code> for section content templates.</p>\n<h2>Iron Laws</h2>\n<ol>\n<li><strong>ONE section at a time</strong> — never dump all content</li>\n<li><strong>User controls pace</strong> — always offer to stop</li>\n<li><strong>Explain WHY, not just WHAT</strong> — rationale over listing</li>\n<li><strong>Ground in artifacts</strong> — focus on insights specific to this\nplan's research, decisions, and scratchpad entries, not general\nprogramming concepts</li>\n<li><strong>Keep each section under 20 lines</strong> — this is a briefing,\nnot a lecture</li>\n<li><strong>NEVER skip sections or auto-start work</strong> — briefing is read-only; do not execute plan tasks or launch <code>/phx:work</code> without explicit user request</li>\n<li><strong>SECTION TEXT BEFORE THE QUESTION</strong> — every ★ Briefing block is\nvisible response text emitted before its <code>AskUserQuestion</code>; never\ndeliver a section only inside thinking or the question field</li>\n</ol>\n<h2>Closing Message</h2>\n<p>After final section (or when user stops):</p>\n<pre><code>That's the briefing! For full details, see:\n{plan_path}\n\nReady to proceed? Try `/phx:work {plan_path}` to start execution.\n</code></pre>\n<p>Post-work variant:</p>\n<pre><code>That's what was built! For full details, see:\n{plan_path}\n\nConsider `/phx:compound` to capture key learnings for future reference.\n</code></pre>\n<h2>Integration</h2>\n<pre><code>/phx:plan  --&gt;  /phx:brief (optional)  --&gt;  /phx:work  --&gt;  /phx:brief (optional)\n  create       understand before            execute        understand after\n</code></pre>\n<h2>Complex Plan Enhancement</h2>\n<p>For plans with 5+ phases or 4+ key decisions, consider suggesting\nvisual rendering after Section 3. See\n<code>${CLAUDE_SKILL_DIR}/references/visual-explainer.md</code> for thresholds and commands.</p>\n<h2>Notes</h2>\n<ul>\n<li>Runs in main conversation context (not a subagent)</li>\n<li>Model: no special requirement — uses default session model</li>\n<li>No artifacts written — briefing is ephemeral, plan IS the artifact</li>\n<li>Reference file readable since skill runs in user's session</li>\n</ul>\n","files":[{"path":"references/briefing-guide.md","sizeBytes":9727,"isText":true},{"path":"references/visual-explainer.md","sizeBytes":2331,"isText":true},{"path":"SKILL.md","sizeBytes":4850,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-10-04T15:14:30.285066Z","sha256":"4588CD886EC534F57BC608D48EA1BDD5DF006BC0B2842D191640F7BEB2BB29B3","sizeBytes":7692},"review":null,"source":{"repositoryUrl":"https://github.com/oliver-kriska/claude-elixir-phoenix","path":"plugins/elixir-phoenix/skills/brief","license":"MIT","commit":"9767a82d24ddddad553e85f88efc2869a7fd7d88","subtreeSha":"6967EF33C66332AB7DF2FCDB0E0176DDC3621B006DE8F8C4F509E96B01489C04","lastSyncedAt":"2026-10-04T15:14:09.139242Z"},"reviewedAt":"2026-10-04T15:14:57.619451Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/oliver-kriska/claude-elixir-phoenix/tree/main/plugins/elixir-phoenix/skills/brief"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install oliver-kriska-claude-elixir-phoenix@llmmart"},{"target":"git","command":"git clone https://github.com/oliver-kriska/claude-elixir-phoenix.git"}]}