@ryuenn3123/agentic-senior-core 6.16.1 → 6.16.3

package/.agents/plugins/agentic-senior-core/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-senior-core",
-  "version": "6.16.1",
+  "version": "6.16.3",
   "description": "Universal AI coding rules. Write code like a staff engineer.",
   "skills": "./skills/",
   "hooks": "./hooks/hooks.json",

package/.agents/plugins/agentic-senior-core/hooks/lib/known-ui-slop-patterns.json

@@ -139,6 +139,26 @@
       "id": "ui-agency-micro-meta",
       "regex": "(?:\\b\\d{1,2}\\.\\d+°\\s*[NSEW]\\b|©\\s*20\\d\\d\\s*—\\s*Scroll)",
       "message": "note: performative agency metadata (geographic coordinates, fake version/scroll stamps) detected. Remove ornamental meta."
+    },
+    {
+      "id": "copy-ai-buzzwords",
+      "regex": "\\b(seamlessly?|robust(?:ness)?|empowers?|supercharg(?:ed?|ing)|cutting-edge|next-generation|blazing-fast|effortlessly?)\\b",
+      "message": "note: generic AI buzzword detected ('seamless', 'robust', 'supercharge', 'cutting-edge'). Use plain operational verbs and concrete metrics."
+    },
+    {
+      "id": "copy-cadence-tricolon",
+      "regex": "\\b[A-Z][a-z]+\\.\\s+[A-Z][a-z]+\\.\\s+[A-Z][a-z]+\\.",
+      "message": "note: tricolon cadence detected ('Word. Word. Word.'). State the capability or outcome directly instead of using advertising triplets."
+    },
+    {
+      "id": "copy-cadence-rebuttal",
+      "regex": "\\b(Not (?:just )?a|More than a) \\w+[,.] (?:it's|a) \\w+\\b",
+      "message": "note: synthetic rebuttal cadence ('Not just a X, it\\'s a Y') detected. State what the system does directly without the false dichotomy."
+    },
+    {
+      "id": "copy-filler-preamble",
+      "regex": "\\b(In today's (?:fast-paced|digital)|Built for (?:the )?modern teams?|Welcome to the)\\b",
+      "message": "note: AI preamble/filler detected ('In today\\'s fast-paced...', 'Built for modern teams'). Delete the introductory throat-clearing and lead with action."
     }
   ]
 }

package/.agents/plugins/agentic-senior-core/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-senior-core",
-  "version": "6.16.1",
+  "version": "6.16.3",
   "description": "Universal AI coding rules. Because your AI writes code like it gets paid by the line.",
   "contextFileName": "rules/agentic-senior-core.md",
   "rules": [

package/.agents/plugins/agentic-senior-core/rules/agentic-senior-core.md

@@ -42,7 +42,11 @@ When picking step 5 or 6 (unless trivial):
 - Early returns over deep nesting (keep happy path flat).
 - Three similar lines is better than a premature abstraction (duplication over wrong abstraction).
 - Single design source of truth: UI styling must reuse defined design tokens, theme variables, or existing page patterns. No ad-hoc palette, radius, or font deviations between pages.
-- UI copy & microcopy hygiene: Functional UI is a tool, not a brochure. Zero conversational filler or marketing buzzwords ("seamless", "empower", "robust"). Never echo heading text in redundant subheadings. Enforce strict single-language consistency without unidiomatic foreign loanwords or hybrid transliterations.
+- Human writing & prose hygiene: Functional communication is an operational tool, not marketing collateral. This applies to UI microcopy, READMEs, PR descriptions, and code comments alike:
+  - 50% reduction rule: Write the statement, then cut unnecessary words. Replace ornamental adjectives with measurable facts (not "a robust, blazing-fast parser", write "parses 50MB/s with zero heap allocations").
+  - Ban AI cadences: Never use the Tricolon ("Fast. Simple. Secure."), the Mad-Lib ("The AI-powered platform for modern teams"), the Rebuttal ("Not just a tool, it's a workflow"), or conversational throat-clearing ("In today's fast-paced landscape...").
+  - Buzzword blacklist: Never emit `seamless(ly)`, `robust`, `empower(ing)`, `supercharge`, `elevate`, `effortless(ly)`, `cutting-edge`, `delve`, `testament`, `pivotal`, `crucial`, `game-changing`, or `next-generation`.
+  - Strict single-language purity: Choose one language per document or surface. In Indonesian contexts, never prefix grammatical affixes to raw English stems (`di-submit`, `meng-generate`, `di-approve`, `me-restore`).
 - Code comment hygiene: Zero decorative character banners (// =====), zero line-by-line narration (// Step 1: validate), zero empty category tags (// Main logic), and zero signature echoes in docstrings. Keep only comments that document non-obvious operational constraints, security boundaries, concurrency hazards, or protocol contracts.
 - Delete code that carries no behavior, safety, or test value. Readability wins over brevity.
 - Detect and respect project linter/formatter configs. Do not restate style rules enforced by tooling.

package/.agents/plugins/agentic-senior-core/skills/asc-develop/SKILL.md

@@ -27,7 +27,7 @@ Use when creating a new application, service, or repository from zero.
    - Can standard library or native platform handle it?
    - Can this be one straightforward function?
 2. Build the core domain entities, data models, and services first before protocol/transport controllers.
-3. For frontend interfaces, follow the design standards in `/asc-ui`.
+3. For frontend interfaces, follow `/asc-ui`. For documentation and prose (READMEs, ADRs), enforce the Universal Prose Floor (zero AI throat-clearing, 50% word reduction, zero buzzwords).
 4. Generate a quality gate workflow (e.g., `.github/workflows/quality-gate.yml`) that runs linter, type-check, and tests.
 
 ### Step 3: Validation
@@ -51,7 +51,7 @@ Use when adding endpoints, components, pages, or capabilities to an existing cod
    - What happens on network/API failure or timeout?
    - What feedback does the user see? (Pending state, inline field error, toast/banner with retry).
    - How can the system recover? (Retry, cached fallback, degraded mode).
-3. If building UI, ensure compliance with `/asc-ui` (zero marketing fluff, single-language consistency, mobile reflow, WCAG AA contrast).
+3. If building UI or writing documentation, ensure compliance with the Universal Prose Floor and `/asc-ui` (zero marketing fluff, single-language consistency, mobile reflow, WCAG AA contrast).
 
 ### Step 3: Implement & Validate (TDD Integration)
 1. Follow the TDD cycle via `/asc-test`: write the failing test first (RED), write minimal code to pass (GREEN), then refactor.

package/.agents/plugins/agentic-senior-core/skills/asc-review/SKILL.md

@@ -37,7 +37,7 @@ Use when reviewing PRs, diffs, commits, or newly written feature code.
    - **Severity 1 (Critical)**: Correctness, data corruption, auth/permission bypass, security sinks, PII leakage.
    - **Severity 2 (High)**: Action feedback failures (hanging spinners, unhandled mutations, missing error boundaries), unhandled async rejections, missing remote timeouts.
    - **Severity 3 (Medium)**: Public contract drift, missing failure-path tests, architectural boundary violations.
-   - **Severity 4 (Low)**: Maintainability debt, performance micro-optimizations, code comment noise.
+   - **Severity 4 (Low)**: Maintainability debt, performance micro-optimizations, narrative code comment noise, AI prose cadence or buzzwords in user-facing copy or documentation.
 
 ---
 

package/.agents/plugins/agentic-senior-core/skills/asc-ui/SKILL.md

@@ -76,8 +76,10 @@ Visual posture is governed by the surface type, not product branding. Every surf
 
 ## 4. Scope Classification: Refine vs. Redesign
 
-- **Refinement:** Preserves layout structure, component APIs, DOM hierarchy, and color tokens. Polishes padding rhythm, contrast, microcopy, and state completeness.
-- **Redesign:** Replaces the visual hierarchy, typographic pairing, and surface mode while strictly preserving data bindings, event handlers, and business logic.
+Never split the difference into cosmetic polish on a discarded look:
+- **Polish / Refinement:** Preserves layout structure, DOM hierarchy, and design tokens. Resolves contrast, missing state quad, microcopy, and lint issues.
+- **Restyle:** Preserves layout geometry. Replaces color tokens, typographic scales, corner radiuses, and elevation shadows.
+- **Full Redesign:** Replaces entire spatial geometry and posture. Mandatory decoupled protocol: extract data/contracts first, discard old DOM, author standalone preview (`asc preview <path>`), build fresh geometry, re-bind dynamic data.
 
 ---
 

package/.agents/plugins/agentic-senior-core/skills/asc-ui/references/copy-i18n.md

@@ -29,11 +29,44 @@ Exception: Standard multi-step navigation controls in fixed wizards (`Back`, `Ne
 
 ---
 
-## 3. Marketing Buzzword Blacklist
+## 3. Arithmetic Copy Budgets & The Argument-First Protocol
+
+### 3.1 Arithmetic Budgets
+Constraint is arithmetic; enforce before falling in love with a sentence:
+- **Hero Headline Budget:** Must fit in **two lines or fewer** across all viewports.
+  - Mobile (390px): $\le 32$ characters ($\sim 4$–$5$ words).
+  - Desktop (1280px): $\le 42$ characters ($\sim 5$–$6$ words).
+  - Use `text-wrap: balance` and intentional `<br>` tags to avoid single-word orphans.
+- **Supporting Line Budget:** Exactly **1 sentence**, at most **22 words**.
+  - Directly states concrete function and audience.
+  - Never repeats or paraphrases headline words.
+- **First-Viewport Word Budget:** Maximum **80 words** total across the first screen.
+
+### 3.2 The Argument-First Protocol
+Before writing any HTML/JSX markup, outline the page as a sequence of claims with verifiable proofs:
+```text
+1. Claim: Three-legged oak stool, made to order.      → Proof: High-res macro photography of stool.
+2. Claim: Each seat cut from single solid board.      → Proof: 3 close-ups of continuous wood grain.
+3. Claim: Shipped in 6 weeks with tracking.           → Proof: Verifiable production stages schedule.
+4. Claim: Costs $240, delivered by the maker.         → Proof: Exact price figure + Order button.
+```
+*Rule:* Any section that lacks a factual claim or verifiable proof is filler—delete it immediately.
 
-The following words are banned in operational interfaces:
+---
+
+## 4. AI Cadences & Marketing Buzzword Blacklist
+
+### 4.1 Banned AI Cadence Formulas
+Language models fall into statistical average patterns; recognize and refuse them:
+1. **The Mad-Lib:** *"The [AI-powered/next-gen] platform for modern teams."*
+2. **The Tricolon:** *"Fast. Simple. Secure."* or *"Plan. Build. Ship."*
+3. **The Rebuttal:** *"It’s not just a tool, it’s a workflow."* / *"More than a framework."*
+4. **The Preamble Throat-Clearing:** *"In today’s fast-paced digital world..."* / *"Built for modern teams..."*
+5. **The Em-Dash Habit:** Using multiple em-dashes (`—`) in a single paragraph. Use a full stop.
 
-`seamless`, `seamlessly`, `empower`, `empowering`, `robust`, `effortless`, `effortlessly`, `cutting-edge`, `game-changing`, `elevate`, `unlock`, `dive in`, `delightful`, `next-generation`, `supercharge`, `blazing-fast`.
+### 4.2 Banned Marketing Buzzwords
+The following adjectives and verbs are banned across all surfaces:
+`seamless`, `seamlessly`, `empower`, `empowering`, `robust`, `effortless`, `effortlessly`, `cutting-edge`, `game-changing`, `elevate`, `unlock`, `unleash`, `dive in`, `delightful`, `next-generation`, `supercharge`, `blazing-fast`.
 
 When tempted to write an adjective, state the measurable property instead:
 - Instead of: *"A robust, blazing-fast pipeline."*
@@ -41,16 +74,31 @@ When tempted to write an adjective, state the measurable property instead:
 
 ---
 
-## 4. Single-Language Purity & Anti-Gado-Gado
+## 5. Actionable Error Messages & Recovery
+
+An operational error message must never produce a dead end or display raw internal stack traces. Every error must answer three questions:
+1. **What failed:** Direct statement of the blocked action.
+2. **Why:** Factual cause (if actionable and known).
+3. **How to recover:** Concrete button or path to unblock the user.
+
+| Raw / Unhelpful Error | Actionable Engineering Copy | Recovery Path |
+|---|---|---|
+| "Error 413: Payload too large." | "File exceeds the 25MB limit." | "Choose a smaller file" CTA |
+| "Failed to connect to server." | "Unable to reach database. Changes saved locally." | "Retry connection" button |
+| "Invalid credentials." | "Incorrect password for user@example.com." | "Reset password →" link |
+
+---
+
+## 6. Single-Language Purity & Anti-Gado-Gado
 
 Interfaces must maintain strict language purity. Mixing two languages within the same surface causes cognitive friction and feels unpolished.
 
-### 4.1 Strict Monolingual Surface
+### 6.1 Strict Monolingual Surface
 Choose one language for the entire surface and enforce it across headings, labels, errors, and tooltips:
 - **English UI:** All copy, actions, and timestamps in English.
 - **Indonesian UI:** All copy, actions, and timestamps in standard Indonesian (KBBI/PUEBI).
 
-### 4.2 Ban Hybrid Neologisms (Indonesian Context)
+### 6.2 Ban Hybrid Neologisms (Indonesian Context)
 Never prefix Indonesian grammatical affixes (`di-`, `meng-`, `ter-`, `pe-`) onto raw English stems:
 
 | Hybrid Neologism (Banned) | Standard Indonesian | Pure English Alternative |
@@ -66,14 +114,14 @@ Never prefix Indonesian grammatical affixes (`di-`, `meng-`, `ter-`, `pe-`) onto
 
 ---
 
-## 5. Dynamic Text Expansion & Internationalization Layout
+## 7. Dynamic Text Expansion & Internationalization Layout
 
 Text length varies drastically between languages:
 - German and Dutch expand +20% to +35% compared to English.
 - Indonesian expands +15% to +30% for verb-rich phrases.
 - Japanese and Chinese are visually dense and vertically taller.
 
-### 5.1 Layout Rules for Expanding Strings
+### 7.1 Layout Rules for Expanding Strings
 1. **Never set fixed widths on action buttons:**
    ```html
    <!-- BANNED: clips or overflows in German/Indonesian -->

package/.agents/plugins/agentic-senior-core/skills/asc-ui/references/craft/color-surfaces.md

@@ -25,6 +25,9 @@ Grounded in: Apple HIG, Google Material Design 3, and Refactoring UI Color Strat
   - The dedicated brand accent hue.
   - **Accent Exclusivity:** Accent color is reserved strictly for interactive affordances: Primary CTA button, active navigation indicator, unread dot, selected checkbox.
   - **Forbidden:** Never use the accent color as background wallpaper, card borders, or decorative section dividers.
+- **Full-Field Grounding (Anti-Sterile Surface):**
+  - To prevent the "sterile white void" trap, at least one major functional region (the Hero Stage, the Signature Canvas, or the Master Header) must own a deep, purposeful surface field (e.g. deep midnight grounding, rich brand tint, or dark canvas container).
+  - This establishes an optical center of gravity, preventing the page from looking like an unstyled wireframe.
 
 ---
 

package/.agents/plugins/agentic-senior-core/skills/asc-ui/references/craft/typography.md

@@ -13,6 +13,11 @@ Grounded in: Refactoring UI, Bringhurst's The Elements of Typographic Style, and
 - **Weight Contrast Before Size Inflation:**
   - Build strong typographic hierarchy by varying font weights (`font-bold` vs `font-normal`) and contrast tokens (`text-foreground` vs `text-muted-foreground`) before jumping to oversized font sizes.
   - A clean 24px `font-bold` title paired with a 14px `text-muted-foreground` subtitle establishes clearer hierarchy than inflating the title to 48px with identical gray values.
+- **The Generative Scale Contrast Floor ($Display \ge 3.5\times Body$):**
+  - On landing, marketing, and hero surfaces (`Persuade`), the primary headline must establish an optical scale step over body text:
+    - Target: $Display \ge 3.5\times Body$ (e.g. `text-5xl` to `text-7xl` [48px–72px] display vs `text-base` [16px] or `text-sm` [14px] body).
+    - Heading leading must be tight: `leading-[1.05]` to `leading-tight`.
+    - An under-scaled heading ($< 2.5\times$ body, such as 24px H1) collapses optical gravity and makes marketing pages look like internal memo forms.
 
 ---
 

package/.agents/plugins/agentic-senior-core/skills/asc-ui/references/modes/persuade.md

@@ -43,6 +43,33 @@ When building or redesigning a Persuade surface, never let the LLM default to th
   - If technical documentation, whitepaper, or architectural manifesto $\to$ **Posture 2 (The Monolith Ledger)**.
   - If performance benchmarks, protocol comparisons, or telemetry proof $\to$ **Posture 4 (Kinetic Proof Stream)**.
 
+### Structural Blueprints (Enforced DOM Geometries)
+
+#### Posture 1: Asymmetric Stage (65/35 Split)
+- **Container:** `grid grid-cols-1 lg:grid-cols-12 gap-12 items-center`
+- **Left Lead (7 cols):** `lg:col-span-7 space-y-6 text-left`
+  - Display headline: `text-5xl lg:text-7xl font-bold tracking-tight leading-[1.05]`
+  - Subtitle: `text-lg text-muted-foreground max-w-xl`
+  - Actions: `flex flex-wrap items-center gap-4 pt-2`
+- **Right Artifact (5 cols):** `lg:col-span-5`
+  - Authentic artifact, interactive widget, or live ROI card: `rounded-2xl border border-border/80 bg-card p-6 shadow-sm`
+  - Zero equal-weight card grids below.
+
+#### Posture 2: The Monolith Ledger
+- **Container:** `max-w-4xl mx-auto px-6 py-16 divide-y divide-border/60`
+- **Tabular Rows:** Each entity or program is a horizontal row: `py-8 grid grid-cols-1 md:grid-cols-12 gap-6 items-baseline`
+  - Category / Date: `md:col-span-3 text-xs font-semibold tracking-wider uppercase text-muted-foreground`
+  - Heading & Data: `md:col-span-5 text-xl font-bold text-foreground`
+  - Detail & Action: `md:col-span-4 text-sm text-muted-foreground`
+
+#### Posture 3: Product-Led Canvas
+- **Container:** `flex flex-col items-center text-center max-w-6xl mx-auto px-6 pt-16 pb-20`
+- **Compact Hero Frame:** `max-w-2xl space-y-4 mb-10`
+  - Headline: `text-4xl sm:text-6xl font-extrabold tracking-tight`
+  - 1-sentence value claim + 1 primary action.
+- **Hero Canvas (70% Viewport Lead):** `w-full rounded-2xl border border-border/80 bg-slate-950 p-2 shadow-2xl`
+  - Real interface fragment or live demo canvas dominating the first viewport.
+
 ---
 
 ## 3. Anti-Cardocalypse & Visual Pacing

package/.agents/plugins/agentic-senior-core/skills/asc-ui/references/redesign-audit.md

@@ -4,21 +4,44 @@ Modifying an existing interface requires clear intent. Audits must provide actio
 
 ---
 
-## 1. Refinement vs. Redesign Semantics
+## 1. Scope Classification: The 3 Redesign Depths
 
-Before touching code, explicitly classify the scope of work:
+Never split the difference into cosmetic polish on a discarded look. Before touching code, explicitly classify the depth of work:
 
-| Mode | Objective | What Stays Intact | What Changes |
+| Depth | Scope & Intent | What Stays Intact | What Changes |
 |---|---|---|---|
-| **Refinement** | Polish craft, fix accessibility, eliminate slop, align spacing. | Layout structure, component APIs, color tokens, DOM tree, established brand identity. | Padding rhythm, contrast ratios, missing hover/focus rings, microcopy concision, state quad completeness. |
-| **Redesign** | Overhaul visual hierarchy, modernize surface mode, eliminate fundamental architectural flaws. | Functional data bindings, event handlers, business rules, routing. | Visual posture, typography system, component composition, spatial elevation, color distribution. |
+| **`polish`** | Resolve bugs, contrast, microcopy, states. | Layout structure, DOM hierarchy, and design system tokens. | Padding rhythm, WCAG AA contrast, missing state quad (empty/error/loading), focus rings, microcopy brevity, lint fixes. |
+| **`restyle`** | Upgrade design system without breaking layout. | Layout grid, component hierarchy, and DOM structure. | Color palette (60-30-10), typographic scale, corner radiuses, elevation shadows, button and input styles. |
+| **`full`** | Total visual and structural overhaul. | Factual content, data bindings (`$variables`, loops), routes, form handlers. | **Spatial geometry, grid ratios, surface posture, and typography.** Treated as fresh build from subject truth. |
 
-> [!WARNING]
-> Never perform an unprompted redesign when asked to "fix", "clean up", or "refine" a component. Respect existing design tokens and architectural patterns unless the user explicitly mandates a redesign.
+---
+
+## 2. The Decoupled Redesign Protocol (For Full Redesigns)
+
+When executing a **Full Redesign** on an existing template or page (`.blade.php`, `.tsx`, `.vue`, `.html`), editing in-place is forbidden because the AI's attention mechanism will anchor to the old DOM structure. Execute this 4-step decoupled sequence:
+
+1. **Step 1: Extract Data Contracts & Factual Inventory**
+   - Parse the incumbent file and extract all dynamic variables, loops, route helpers, form submission endpoints, and real text/assets into a clean data list.
+   - Separate product truth (names, prices, verified claims) from discarded markup.
+2. **Step 2: Isolate / Discard Old Markup**
+   - Treat the old layout as an anti-reference. Do not perform incremental class swapping on it.
+3. **Step 3: Author Standalone HTML Prototype & Preview**
+   - Create an ephemeral standalone prototype in the brain directory: `<appDataDir>/brain/<id>/preview.html`.
+   - Select 1 of the 4 Structural Postures (`references/modes/persuade.md` or `operate.md`).
+   - Use Tailwind via CDN and realistic sample data.
+   - Run zero-dependency visual capture:
+     ```bash
+     asc preview <path_to_preview.html>
+     ```
+     Inspect the captured image at `%TEMP%/asc-preview-active.png` (or pass `--open` to view in OS browser). Verify typographic scale ($Display \ge 3.5\times Body$) and full-field grounding.
+4. **Step 4: Re-inject Data Contracts into Production**
+   - Transfer the proven clean geometry into the project file (`welcome.blade.php`, `Page.tsx`).
+   - Re-bind the dynamic data loops, Blade/React variables, and event handlers.
+   - Confirm project test suite and linters pass cleanly.
 
 ---
 
-## 2. Structured Audit Matrix
+## 3. Structured Audit Matrix
 
 When auditing an existing interface or PR, generate a structured findings table categorized by severity:
 
@@ -41,29 +64,29 @@ When auditing an existing interface or PR, generate a structured findings table
 
 ---
 
-## 3. Systematic Audit Checklist
+## 4. Systematic Audit Checklist
 
 Audit screens systematically against four engineering vectors:
 
-### 3.1 Ergonomics & Responsiveness
+### 4.1 Ergonomics & Responsiveness
 - [ ] Render at `375px` width (mobile viewport) and `1280px` (desktop viewport).
 - [ ] Verify zero horizontal scrollbars on mobile (`overflow-x: clip`).
 - [ ] Confirm all touch targets meet minimum $44 \times 44\text{px}$ bounding box.
 - [ ] Verify mobile layout uses `dvh` instead of `vh` to prevent browser chrome clipping.
 
-### 3.2 Accessibility & Contrast (WCAG 2.2 AA)
+### 4.2 Accessibility & Contrast (WCAG 2.2 AA)
 - [ ] Check normal text against backgrounds ($\ge 4.5:1$).
 - [ ] Check input borders, active toggles, and large headings ($\ge 3:1$).
 - [ ] Cycle through entire screen using `Tab` and `Shift+Tab` with mouse disconnected.
 - [ ] Press `Escape` while dialog/modal is open; verify closure and focus restoration.
 
-### 3.3 State Quad Coverage
+### 4.3 State Quad Coverage
 - [ ] Inspect loading state: does it use proportional skeletons matching final dimensions?
 - [ ] Inspect empty state: is it actionable with a 1-sentence explanation?
 - [ ] Inspect error state: does it diagnose the issue and provide an inline retry button?
 - [ ] Inspect mutation triggers: do buttons lock and display spinners during network latency?
 
-### 3.4 Microcopy & Token Hygiene
+### 4.4 Microcopy & Token Hygiene
 - [ ] Run 50% word reduction sweep across headings and explanatory paragraphs.
 - [ ] Confirm all buttons follow `Verb + Noun` grammar.
 - [ ] Verify zero banned buzzwords (*seamless*, *empower*, *robust*).

package/bin/agentic-senior-core.js

@@ -36,6 +36,7 @@ function printUsage() {
   console.log('  uninstall         Remove ASC adapter files and git hooks from this project');
   console.log('  clean             Remove v4 per-project artifacts');
   console.log('  status            Show detected IDEs and install hints');
+  console.log('  preview           Render zero-dependency multi-browser snapshot or preview');
   console.log('  --version         Show version');
   console.log('  --help            Show this help');
 }
@@ -90,6 +91,12 @@ async function main() {
     return;
   }
 
+  if (commandArgument === 'preview') {
+    const { runPreviewCommand } = await import('../lib/cli/commands/preview.mjs');
+    await runPreviewCommand(commandArguments);
+    return;
+  }
+
   console.error(`Unknown command: ${commandArgument}`);
   printUsage();
   exit(1);

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-senior-core",
-  "version": "6.16.1",
+  "version": "6.16.3",
   "description": "Universal AI coding rules. Write code like a staff engineer.",
   "author": "fatidaprilian",
   "license": "MIT",

package/lib/cli/commands/preview.mjs

@@ -0,0 +1,206 @@
+/**
+ * Zero-dependency Multi-Browser Preview & Headless Snapshot Engine.
+ * Detects installed browsers (Brave, Edge, Chrome, Firefox, Vivaldi, Arc)
+ * and captures a headless snapshot or opens in the OS default browser.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { execSync } from 'node:child_process';
+
+export function getBrowserCandidates() {
+  const platform = process.platform;
+  const candidates = [];
+
+  if (platform === 'win32') {
+    const localAppData = process.env.LOCALAPPDATA || '';
+    const programFiles = process.env['ProgramFiles'] || 'C:\\Program Files';
+    const programFilesX86 = process.env['ProgramFiles(x86)'] || 'C:\\Program Files (x86)';
+
+    candidates.push(
+      {
+        name: 'Brave Browser',
+        family: 'chromium',
+        paths: [
+          path.join(programFiles, 'BraveSoftware', 'Brave-Browser', 'Application', 'brave.exe'),
+          path.join(programFilesX86, 'BraveSoftware', 'Brave-Browser', 'Application', 'brave.exe'),
+          path.join(localAppData, 'BraveSoftware', 'Brave-Browser', 'Application', 'brave.exe'),
+        ]
+      },
+      {
+        name: 'Microsoft Edge',
+        family: 'chromium',
+        paths: [
+          path.join(programFilesX86, 'Microsoft', 'Edge', 'Application', 'msedge.exe'),
+          path.join(programFiles, 'Microsoft', 'Edge', 'Application', 'msedge.exe'),
+          path.join(localAppData, 'Microsoft', 'Edge', 'Application', 'msedge.exe'),
+        ]
+      },
+      {
+        name: 'Google Chrome',
+        family: 'chromium',
+        paths: [
+          path.join(programFiles, 'Google', 'Chrome', 'Application', 'chrome.exe'),
+          path.join(programFilesX86, 'Google', 'Chrome', 'Application', 'chrome.exe'),
+          path.join(localAppData, 'Google', 'Chrome', 'Application', 'chrome.exe'),
+        ]
+      },
+      {
+        name: 'Mozilla Firefox',
+        family: 'firefox',
+        paths: [
+          path.join(programFiles, 'Mozilla Firefox', 'firefox.exe'),
+          path.join(programFilesX86, 'Mozilla Firefox', 'firefox.exe'),
+        ]
+      },
+      {
+        name: 'Vivaldi',
+        family: 'chromium',
+        paths: [
+          path.join(localAppData, 'Vivaldi', 'Application', 'vivaldi.exe'),
+          path.join(programFiles, 'Vivaldi', 'Application', 'vivaldi.exe'),
+        ]
+      },
+      {
+        name: 'Arc',
+        family: 'chromium',
+        paths: [
+          path.join(localAppData, 'Arc', 'Arc.exe'),
+        ]
+      }
+    );
+  } else if (platform === 'darwin') {
+    candidates.push(
+      {
+        name: 'Google Chrome',
+        family: 'chromium',
+        paths: ['/Applications/Google Chrome.app/Contents/MacOS/Google Chrome']
+      },
+      {
+        name: 'Brave Browser',
+        family: 'chromium',
+        paths: ['/Applications/Brave Browser.app/Contents/MacOS/Brave Browser']
+      },
+      {
+        name: 'Microsoft Edge',
+        family: 'chromium',
+        paths: ['/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge']
+      },
+      {
+        name: 'Mozilla Firefox',
+        family: 'firefox',
+        paths: ['/Applications/Firefox.app/Contents/MacOS/firefox']
+      },
+      {
+        name: 'Arc',
+        family: 'chromium',
+        paths: ['/Applications/Arc.app/Contents/MacOS/Arc']
+      }
+    );
+  } else {
+    // Linux
+    candidates.push(
+      { name: 'google-chrome', family: 'chromium', commands: ['google-chrome', 'google-chrome-stable'] },
+      { name: 'chromium', family: 'chromium', commands: ['chromium', 'chromium-browser'] },
+      { name: 'brave', family: 'chromium', commands: ['brave-browser', 'brave'] },
+      { name: 'microsoft-edge', family: 'chromium', commands: ['microsoft-edge', 'microsoft-edge-stable', 'msedge'] },
+      { name: 'firefox', family: 'firefox', commands: ['firefox'] }
+    );
+  }
+
+  return candidates;
+}
+
+export function findBrowserExecutable() {
+  const candidates = getBrowserCandidates();
+
+  for (const candidate of candidates) {
+    if (candidate.paths) {
+      for (const p of candidate.paths) {
+        if (fs.existsSync(p)) {
+          return { name: candidate.name, family: candidate.family, path: p };
+        }
+      }
+    } else if (candidate.commands) {
+      for (const cmd of candidate.commands) {
+        try {
+          const resolved = execSync(`which ${cmd} 2>/dev/null`, { encoding: 'utf8' }).trim();
+          if (resolved) {
+            return { name: candidate.name, family: candidate.family, path: resolved };
+          }
+        } catch {
+          // ignore
+        }
+      }
+    }
+  }
+
+  return null;
+}
+
+export async function runPreviewCommand(args = []) {
+  const targetFile = args.find(a => !a.startsWith('-'));
+  const shouldOpen = args.includes('--open');
+  const width = 1280;
+  const height = 800;
+
+  if (!targetFile) {
+    console.error('Usage: asc preview <html-file> [--open]');
+    process.exit(1);
+  }
+
+  const resolvedHtmlPath = path.resolve(process.cwd(), targetFile);
+  if (!fs.existsSync(resolvedHtmlPath)) {
+    console.error(`File not found: ${resolvedHtmlPath}`);
+    process.exit(1);
+  }
+
+  // Single fixed reusable slot in OS temp directory
+  const tempDir = os.tmpdir();
+  const outputPng = path.join(tempDir, 'asc-preview-active.png');
+
+  // Open in default OS browser if requested
+  if (shouldOpen) {
+    const opener = process.platform === 'win32' ? 'start' : process.platform === 'darwin' ? 'open' : 'xdg-open';
+    try {
+      execSync(`${opener} "" "${resolvedHtmlPath}"`, { stdio: 'ignore' });
+      console.log(`[asc preview] Opened in default browser: ${resolvedHtmlPath}`);
+      return;
+    } catch (err) {
+      console.error(`Failed to open default browser: ${err.message}`);
+    }
+  }
+
+  // Headless snapshot mode
+  const browser = findBrowserExecutable();
+  if (!browser) {
+    console.warn('[asc preview] No supported headless browser detected (Brave, Edge, Chrome, Firefox). Falling back to OS opener.');
+    const opener = process.platform === 'win32' ? 'start' : process.platform === 'darwin' ? 'open' : 'xdg-open';
+    execSync(`${opener} "" "${resolvedHtmlPath}"`, { stdio: 'ignore' });
+    return;
+  }
+
+  try {
+    let command;
+    if (browser.family === 'chromium') {
+      command = `"${browser.path}" --headless --disable-gpu --screenshot="${outputPng}" --window-size=${width},${height} "${resolvedHtmlPath}"`;
+    } else if (browser.family === 'firefox') {
+      command = `"${browser.path}" -headless -screenshot "${outputPng}" -window-size ${width},${height} "${resolvedHtmlPath}"`;
+    }
+
+    execSync(command, { stdio: 'pipe' });
+
+    if (fs.existsSync(outputPng)) {
+      const stat = fs.statSync(outputPng);
+      console.log(`[asc preview] Captured via ${browser.name} (${width}x${height}, ${stat.size} bytes)`);
+      console.log(`Output: ${outputPng}`);
+    } else {
+      throw new Error('Screenshot file was not generated');
+    }
+  } catch (err) {
+    console.warn(`[asc preview] Headless snapshot failed: ${err.message}. Falling back to OS opener.`);
+    const opener = process.platform === 'win32' ? 'start' : process.platform === 'darwin' ? 'open' : 'xdg-open';
+    execSync(`${opener} "" "${resolvedHtmlPath}"`, { stdio: 'ignore' });
+  }
+}
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ryuenn3123/agentic-senior-core",
-  "version": "6.16.1",
+  "version": "6.16.3",
   "type": "module",
   "description": "Agentic Senior Core: Universal AI coding rules and workflows. Write code like a staff engineer, not a junior.",
   "bin": {

package/plugin.yaml

@@ -1,5 +1,5 @@
 name: agentic-senior-core
-version: 6.16.1
+version: 6.16.3
 description: Universal AI coding rules. Write code like a staff engineer.
 author: fatidaprilian
 provides_hooks: