sequant 2.6.1 → 2.7.0

package/dist/src/lib/templates.js

@@ -4,6 +4,7 @@
 import { readdir, chmod } from "fs/promises";
 import { join, dirname, relative, isAbsolute } from "path";
 import { fileURLToPath } from "url";
+import { diffLines } from "diff";
 import { readFile, writeFile, ensureDir, fileExists, isSymlink, createSymlink, removeFileOrSymlink, } from "./fs.js";
 import { getPackageVersion } from "./manifest.js";
 const SKILLS_VERSION_PATH = ".claude/skills/.sequant-version";
@@ -12,6 +13,11 @@ import { isNativeWindows } from "./system.js";
 import { getProjectName } from "./project-name.js";
 // Get the package templates directory
 export function getTemplatesDir() {
+    // Allow overriding the templates source (used by tests; also lets the dir be
+    // relocated without relying on the compiled-output layout below).
+    if (process.env.SEQUANT_TEMPLATES_DIR) {
+        return process.env.SEQUANT_TEMPLATES_DIR;
+    }
     const __dirname = dirname(fileURLToPath(import.meta.url));
     // Compiled structure: dist/src/lib/templates.js
     // So we need ../../../templates to reach project root templates/
@@ -64,6 +70,132 @@ export async function getTemplateContent(templatePath) {
     const fullPath = join(templatesDir, relativePath);
     return readFile(fullPath);
 }
+/**
+ * Files that are meant to be edited in place per project (e.g. the
+ * constitution). When one of these diverges from the rendered template
+ * without a parallel `.claude/.local/` file, it is treated as a protected
+ * local override rather than a stale "modified" file — so the default
+ * (non-`--force`) update/sync path never silently overwrites it.
+ */
+export const CUSTOMIZABLE_FILES = [".claude/memory/constitution.md"];
+/**
+ * Whether a local path is a customizable file edited in place per project.
+ */
+export function isCustomizableFile(localPath) {
+    // Normalize OS path separators so the allow-list match holds on Windows,
+    // where template paths are assembled with backslashes (#708).
+    return CUSTOMIZABLE_FILES.includes(localPath.replace(/\\/g, "/"));
+}
+/**
+ * Build the full set of template variables used when rendering templates.
+ *
+ * This is the single source of truth shared by `copyTemplates` (write time)
+ * and `computeTemplateChanges` (diff time) so the two can never drift — a
+ * mismatch here is what caused `constitution.md` to read as "modified" on
+ * every project (the diff used a different/incomplete variable set than the
+ * write). See #708.
+ */
+export async function buildTemplateVariables(stack, tokens, options = {}) {
+    const stackConfig = getStackConfig(stack);
+    // Detect project name from available sources (package.json, Cargo.toml, etc.)
+    const projectName = await getProjectName();
+    // Get stack-specific notes for constitution template
+    // Use multi-stack notes if additional stacks are provided
+    const stackNotes = options.additionalStacks && options.additionalStacks.length > 0
+        ? getMultiStackNotes(stack, options.additionalStacks)
+        : getStackNotes(stack);
+    return {
+        ...stackConfig.variables,
+        ...tokens,
+        PROJECT_NAME: projectName,
+        STACK: stack,
+        STACK_NOTES: stackNotes,
+    };
+}
+/**
+ * Compare bundled template content against what's installed under `.claude/`.
+ *
+ * Templates are rendered with the project's variables *before* comparison, so
+ * an unmodified file (e.g. a constitution with `{{PROJECT_NAME}}` expanded)
+ * reads as `unchanged` rather than `modified`. A file that diverges in place is
+ * `local-override` (skip-by-default) when it has a parallel `.claude/.local/`
+ * file or is in the customizable allow-list; otherwise it is `modified`.
+ */
+export async function computeTemplateChanges(stack, tokens, options = {}) {
+    const variables = await buildTemplateVariables(stack, tokens, options);
+    const templateFiles = await listTemplateFiles();
+    const changes = [];
+    for (const templatePath of templateFiles) {
+        // Normalize separators first: listTemplateFiles builds paths with the OS
+        // separator (backslashes on Windows), but the prefix swap and the .local/
+        // and customizable-file checks below all assume forward slashes (#708).
+        const localPath = templatePath
+            .replace(/\\/g, "/")
+            .replace("templates/", ".claude/");
+        // Skip .local files (user customizations are never overwritten)
+        if (localPath.includes(".local/")) {
+            continue;
+        }
+        const rendered = processTemplate(await getTemplateContent(templatePath), variables);
+        const exists = await fileExists(localPath);
+        if (!exists) {
+            changes.push({ path: localPath, templatePath, status: "new", rendered });
+            continue;
+        }
+        const localContent = await readFile(localPath);
+        if (localContent === rendered) {
+            changes.push({
+                path: localPath,
+                templatePath,
+                status: "unchanged",
+                rendered,
+            });
+            continue;
+        }
+        // Content differs after rendering. Protect in-place customizations:
+        // a parallel `.claude/.local/` override, or a known customizable file.
+        //
+        // Note: this protects a managed file that was *edited in place* (e.g. the
+        // constitution) when a parallel `.claude/.local/` twin exists. It is NOT a
+        // skill-loading mechanism — the harness never loads `.claude/.local/skills/
+        // <name>/SKILL.md`, so a full-file SKILL.md shadow does nothing at runtime
+        // (#711). Skills are instead customized via a runtime overlay: each managed
+        // SKILL.md opens (before its first heading) with a directive to honor
+        // `.claude/.local/skills/<name>/overrides.md`, and that overrides file is
+        // auto-skipped above because it lives under `.local/`. The directive sits at
+        // the top, not end-of-file, so it fires reliably even in 3000-line skills.
+        // See docs/guides/customization.md.
+        const localOverridePath = localPath.replace(".claude/", ".claude/.local/");
+        const hasLocalOverride = await fileExists(localOverridePath);
+        if (hasLocalOverride || isCustomizableFile(localPath)) {
+            changes.push({
+                path: localPath,
+                templatePath,
+                status: "local-override",
+                rendered,
+            });
+            continue;
+        }
+        const diff = diffLines(localContent, rendered)
+            .map((part) => {
+            const prefix = part.added ? "+" : part.removed ? "-" : " ";
+            return part.value
+                .split("\n")
+                .filter((l) => l)
+                .map((l) => `${prefix} ${l}`)
+                .join("\n");
+        })
+            .join("\n");
+        changes.push({
+            path: localPath,
+            templatePath,
+            status: "modified",
+            rendered,
+            diff,
+        });
+    }
+    return changes;
+}
 /**
  * Create symlinks for files in a directory, with fallback to copy
  * @param srcDir Source directory containing template files
@@ -159,21 +291,8 @@ export async function symlinkDir(srcDir, destDir, options = {}) {
  */
 export async function copyTemplates(stack, tokens, options = {}) {
     const templatesDir = getTemplatesDir();
-    const stackConfig = getStackConfig(stack);
-    // Detect project name from available sources (package.json, Cargo.toml, etc.)
-    const projectName = await getProjectName();
-    // Get stack-specific notes for constitution template
-    // Use multi-stack notes if additional stacks are provided
-    const stackNotes = options.additionalStacks && options.additionalStacks.length > 0
-        ? getMultiStackNotes(stack, options.additionalStacks)
-        : getStackNotes(stack);
-    const variables = {
-        ...stackConfig.variables,
-        ...tokens,
-        PROJECT_NAME: projectName,
-        STACK: stack,
-        STACK_NOTES: stackNotes,
-    };
+    // Single source of truth for template variables (shared with the diff path)
+    const variables = await buildTemplateVariables(stack, tokens, options);
     async function copyDir(srcDir, destDir) {
         try {
             const entries = await readdir(srcDir, { withFileTypes: true });

package/dist/src/ui/tui/App.js

@@ -19,6 +19,7 @@ export function App({ getSnapshot, onDone, }) {
     const [now, setNow] = useState(() => Date.now());
     const doneFired = useRef(false);
     const { stdout } = useStdout();
+    const [columns, setColumns] = useState(() => stdout?.columns ?? 80);
     // Snapshot poller (drives all state transitions).
     useEffect(() => {
         const id = setInterval(() => {
@@ -37,8 +38,29 @@ export function App({ getSnapshot, onDone, }) {
         const id = setInterval(() => setNow(Date.now()), 1000);
         return () => clearInterval(id);
     }, []);
-    const columns = stdout?.columns ?? 80;
-    const boxWidth = Math.min(columns - 2, 100);
+    // Track the terminal width reactively. ink's own resize handler re-renders
+    // the existing React tree but does NOT re-run this component, so a width read
+    // imperatively in render goes stale until the next poll. In that window ink
+    // repaints boxes at the old (now too-wide) width and the lines wrap, which
+    // misaligns the box borders into the duplicate/garbled frames. Updating
+    // `columns` from the resize event forces an immediate re-layout at the new
+    // width. A 1 Hz fallback poll covers terminals that don't emit `resize`.
+    useEffect(() => {
+        if (!stdout)
+            return;
+        const sync = () => setColumns(stdout.columns ?? 80);
+        stdout.on("resize", sync);
+        sync();
+        const id = setInterval(sync, 1000);
+        return () => {
+            stdout.off("resize", sync);
+            clearInterval(id);
+        };
+    }, [stdout]);
+    // Clamp each box to the current terminal width (minus a 2-col safety margin)
+    // so a box line can never equal or exceed the terminal width and wrap.
+    const safeColumns = columns > 0 ? columns : 80;
+    const boxWidth = Math.max(20, Math.min(safeColumns - 2, 100));
     // #699 AC-4: clamp the number of boxes to the terminal height so a large
     // batch on a short terminal can't overflow the frame (parity with the plain
     // renderer's #624 row cap). Older completed issues collapse into `✔ N done`.

package/dist/src/ui/tui/IssueBox.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { Box, Text } from "ink";
-import { DIVIDER_COLOR, PHASE_GLYPHS, borderColorForIssue, phaseStatusColor, } from "./theme.js";
+import { ACTIVE_PHASE_COLOR, DIVIDER_COLOR, PHASE_GLYPHS, borderColorForIssue, phaseStatusColor, } from "./theme.js";
 import { Spinner } from "./Spinner.js";
 import { ElapsedTimer, formatSinceActivity } from "./ElapsedTimer.js";
 import { truncateToWidth } from "./truncate.js";
@@ -20,7 +20,7 @@ export function IssueBox({ state, slot, width, now, }) {
     const displayPhaseN = activePhaseIndex >= 0 ? activePhaseIndex + 1 : doneCount;
     const total = state.phases.length;
     const headerTitle = truncateToWidth(`#${state.number}  ${state.title}`, Math.max(10, innerWidth - 20));
-    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: border, paddingX: 1, marginBottom: 1, width: width, children: [_jsxs(Box, { justifyContent: "space-between", children: [_jsx(Text, { color: border, children: headerTitle }), _jsxs(Text, { color: DIVIDER_COLOR, children: ["phase ", displayPhaseN, "/", total, " \u2022", " ", _jsx(ElapsedTimer, { startedAt: state.startedAt })] })] }), _jsx(Divider, { width: innerWidth }), _jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { color: DIVIDER_COLOR, children: "branch " }), _jsx(Text, { children: truncateToWidth(state.branch, innerWidth - 8) })] }), _jsx(PhaseProgression, { phases: state.phases, borderColor: border }), state.currentPhase?.logPath ? (_jsxs(Box, { children: [_jsx(Text, { color: DIVIDER_COLOR, children: "log " }), _jsx(Text, { children: truncateToWidth(state.currentPhase.logPath, innerWidth - 8) })] })) : null] }), _jsx(Divider, { width: innerWidth }), _jsx(Box, { flexDirection: "column", children: state.currentPhase ? (_jsxs(_Fragment, { children: [_jsxs(Box, { children: [_jsx(Text, { color: DIVIDER_COLOR, children: "now " }), _jsx(Spinner, { color: border }), _jsxs(Text, { children: ["  ", truncateToWidth(state.currentPhase.nowLine, innerWidth - 12)] })] }), _jsx(Box, { children: _jsxs(Text, { color: DIVIDER_COLOR, children: ["        └ last activity ", formatSinceActivity(now, state.currentPhase.lastActivityAt)] }) })] })) : (_jsx(Text, { color: DIVIDER_COLOR, children: statusLine(state) })) })] }));
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: border, paddingX: 1, marginBottom: 1, width: width, children: [_jsxs(Box, { justifyContent: "space-between", children: [_jsx(Text, { color: border, children: headerTitle }), _jsxs(Text, { color: DIVIDER_COLOR, children: ["phase ", displayPhaseN, "/", total, " \u2022", " ", _jsx(ElapsedTimer, { startedAt: state.startedAt })] })] }), _jsx(Divider, { width: innerWidth }), _jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { color: DIVIDER_COLOR, children: "branch " }), _jsx(Text, { children: truncateToWidth(state.branch, innerWidth - 8) })] }), _jsx(PhaseProgression, { phases: state.phases, activeColor: ACTIVE_PHASE_COLOR }), state.currentPhase?.logPath ? (_jsxs(Box, { children: [_jsx(Text, { color: DIVIDER_COLOR, children: "log " }), _jsx(Text, { children: truncateToWidth(state.currentPhase.logPath, innerWidth - 8) })] })) : null] }), _jsx(Divider, { width: innerWidth }), _jsx(Box, { flexDirection: "column", children: state.currentPhase ? (_jsxs(_Fragment, { children: [_jsxs(Box, { children: [_jsx(Text, { color: DIVIDER_COLOR, children: "now " }), _jsx(Spinner, { color: ACTIVE_PHASE_COLOR }), _jsxs(Text, { children: ["  ", truncateToWidth(state.currentPhase.nowLine, innerWidth - 12)] })] }), _jsx(Box, { children: _jsxs(Text, { color: DIVIDER_COLOR, children: ["        └ last activity ", formatSinceActivity(now, state.currentPhase.lastActivityAt)] }) })] })) : (_jsx(Text, { color: DIVIDER_COLOR, children: statusLine(state) })) })] }));
 }
 function statusLine(state) {
     switch (state.status) {
@@ -37,10 +37,10 @@ function statusLine(state) {
 function Divider({ width }) {
     return _jsx(Text, { color: DIVIDER_COLOR, children: "─".repeat(Math.max(0, width)) });
 }
-function PhaseProgression({ phases, borderColor, }) {
+function PhaseProgression({ phases, activeColor, }) {
     return (_jsxs(Box, { flexWrap: "wrap", children: [_jsx(Text, { color: DIVIDER_COLOR, children: "phases " }), phases.map((p, i) => {
                 const isLast = i === phases.length - 1;
-                return (_jsxs(Box, { children: [_jsx(PhaseGlyph, { status: p.status, label: p.name, activeColor: borderColor, elapsedMs: p.elapsedMs }), !isLast ? (_jsxs(Text, { color: DIVIDER_COLOR, children: ["   ", PHASE_GLYPHS.separator, "   "] })) : null] }, `${p.name}-${i}`));
+                return (_jsxs(Box, { children: [_jsx(PhaseGlyph, { status: p.status, label: p.name, activeColor: activeColor, elapsedMs: p.elapsedMs }), !isLast ? (_jsxs(Text, { color: DIVIDER_COLOR, children: ["   ", PHASE_GLYPHS.separator, "   "] })) : null] }, `${p.name}-${i}`));
             })] }));
 }
 function PhaseGlyph({ status, label, activeColor, elapsedMs, }) {

package/dist/src/ui/tui/load.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Loader for the Ink TUI module that forces React into its production build.
+ *
+ * `react-reconciler` (pulled in by `ink`) selects its dev-vs-prod bundle from
+ * `process.env.NODE_ENV` **at module-evaluation time**. The development bundle
+ * emits a `performance.measure()` per component render and never calls
+ * `performance.clearMeasures()`. Driven by the TUI's 10 Hz poll over a long
+ * `sequant run`, those entries accumulate in Node's global performance buffer
+ * until it overflows its ~1,000,000-entry cap and prints
+ * `MaxPerformanceEntryBufferExceededWarning` to stderr — a memory leak that
+ * also corrupts the dashboard's in-place redraw (the stderr write scrolls the
+ * terminal between log-update frames; see #647/#664).
+ *
+ * The TUI module is the *only* importer of `react`/`ink`/`react-reconciler`,
+ * and it is always reached through a dynamic `import()`, so bracketing that one
+ * import with `NODE_ENV=production` caches the production reconciler (which has
+ * zero `performance.measure` calls). We restore `NODE_ENV` immediately after so
+ * spawned child processes (claude phases, `npm install`, build steps) do NOT
+ * inherit `NODE_ENV=production` — which would, e.g., make `npm install` skip
+ * devDependencies.
+ *
+ * Only overrides when `NODE_ENV` is unset/empty: an explicit `development` or
+ * `test` (the test runner) is respected so dev warnings remain available there.
+ */
+export declare function loadTui(): Promise<typeof import("./index.js")>;

package/dist/src/ui/tui/load.js

@@ -0,0 +1,41 @@
+/**
+ * Loader for the Ink TUI module that forces React into its production build.
+ *
+ * `react-reconciler` (pulled in by `ink`) selects its dev-vs-prod bundle from
+ * `process.env.NODE_ENV` **at module-evaluation time**. The development bundle
+ * emits a `performance.measure()` per component render and never calls
+ * `performance.clearMeasures()`. Driven by the TUI's 10 Hz poll over a long
+ * `sequant run`, those entries accumulate in Node's global performance buffer
+ * until it overflows its ~1,000,000-entry cap and prints
+ * `MaxPerformanceEntryBufferExceededWarning` to stderr — a memory leak that
+ * also corrupts the dashboard's in-place redraw (the stderr write scrolls the
+ * terminal between log-update frames; see #647/#664).
+ *
+ * The TUI module is the *only* importer of `react`/`ink`/`react-reconciler`,
+ * and it is always reached through a dynamic `import()`, so bracketing that one
+ * import with `NODE_ENV=production` caches the production reconciler (which has
+ * zero `performance.measure` calls). We restore `NODE_ENV` immediately after so
+ * spawned child processes (claude phases, `npm install`, build steps) do NOT
+ * inherit `NODE_ENV=production` — which would, e.g., make `npm install` skip
+ * devDependencies.
+ *
+ * Only overrides when `NODE_ENV` is unset/empty: an explicit `development` or
+ * `test` (the test runner) is respected so dev warnings remain available there.
+ */
+export async function loadTui() {
+    const prev = process.env.NODE_ENV;
+    const override = prev === undefined || prev === "";
+    if (override)
+        process.env.NODE_ENV = "production";
+    try {
+        return await import("./index.js");
+    }
+    finally {
+        if (override) {
+            if (prev === undefined)
+                delete process.env.NODE_ENV;
+            else
+                process.env.NODE_ENV = prev;
+        }
+    }
+}

package/dist/src/ui/tui/theme.d.ts

@@ -6,14 +6,32 @@
  * Respects `NO_COLOR` automatically via `ink`/`chalk`.
  */
 import type { IssueStatus, PhaseStatus } from "../../lib/workflow/run-state.js";
+/**
+ * Sequant brand accents, sourced from sequant-landing `src/styles/tokens.css`:
+ *   - `BRAND_ORANGE` is the primary brand color (`--color-primary` dark mode).
+ *   - `BRAND_GREEN` is the accent/success green (`--color-accent`).
+ *
+ * Used to brand the two color signals that matter most at a glance — the
+ * live/active phase and success — while issue-distinction (border rotation),
+ * failure (red), and dividers (gray) stay on robust named ANSI colors.
+ *
+ * Ink/chalk auto-downsamples hex to the nearest ANSI color on terminals
+ * without truecolor, and `NO_COLOR` still strips all color, so these degrade
+ * gracefully without a manual capability check.
+ */
+export declare const BRAND_ORANGE: "#FF8012";
+export declare const BRAND_GREEN: "#10b981";
 /** Border-color palette rotated by issue start order. */
 export declare const BORDER_ROTATION: readonly ["cyan", "magenta", "blue", "yellow"];
-export type BorderColor = (typeof BORDER_ROTATION)[number] | "green" | "red" | "gray";
+export type BorderColor = (typeof BORDER_ROTATION)[number] | typeof BRAND_GREEN | typeof BRAND_ORANGE | "red" | "gray";
 /** Gray used for horizontal dividers inside each box. */
 export declare const DIVIDER_COLOR: "gray";
-/** Green used for the rolled-up `✔ N done` summary line (#699, parity with the
+/** Brand orange for the live/active phase spinner — the one element the eye
+ *  tracks. Border rotation still distinguishes concurrent issues. */
+export declare const ACTIVE_PHASE_COLOR: "#FF8012";
+/** Brand green for the rolled-up `✔ N done` summary line (#699, parity with the
  *  plain renderer's #624 rollup). */
-export declare const ROLLUP_COLOR: "green";
+export declare const ROLLUP_COLOR: "#10b981";
 /**
  * Pick the border color for an issue.
  * Failed / passed states win over rotation; otherwise rotate by slot.

package/dist/src/ui/tui/theme.js

@@ -5,13 +5,31 @@
  * status (failed / passed) overrides the rotation color where applicable.
  * Respects `NO_COLOR` automatically via `ink`/`chalk`.
  */
+/**
+ * Sequant brand accents, sourced from sequant-landing `src/styles/tokens.css`:
+ *   - `BRAND_ORANGE` is the primary brand color (`--color-primary` dark mode).
+ *   - `BRAND_GREEN` is the accent/success green (`--color-accent`).
+ *
+ * Used to brand the two color signals that matter most at a glance — the
+ * live/active phase and success — while issue-distinction (border rotation),
+ * failure (red), and dividers (gray) stay on robust named ANSI colors.
+ *
+ * Ink/chalk auto-downsamples hex to the nearest ANSI color on terminals
+ * without truecolor, and `NO_COLOR` still strips all color, so these degrade
+ * gracefully without a manual capability check.
+ */
+export const BRAND_ORANGE = "#FF8012";
+export const BRAND_GREEN = "#10b981";
 /** Border-color palette rotated by issue start order. */
 export const BORDER_ROTATION = ["cyan", "magenta", "blue", "yellow"];
 /** Gray used for horizontal dividers inside each box. */
 export const DIVIDER_COLOR = "gray";
-/** Green used for the rolled-up `✔ N done` summary line (#699, parity with the
+/** Brand orange for the live/active phase spinner — the one element the eye
+ *  tracks. Border rotation still distinguishes concurrent issues. */
+export const ACTIVE_PHASE_COLOR = BRAND_ORANGE;
+/** Brand green for the rolled-up `✔ N done` summary line (#699, parity with the
  *  plain renderer's #624 rollup). */
-export const ROLLUP_COLOR = "green";
+export const ROLLUP_COLOR = BRAND_GREEN;
 /**
  * Pick the border color for an issue.
  * Failed / passed states win over rotation; otherwise rotate by slot.
@@ -20,7 +38,7 @@ export function borderColorForIssue(status, slot) {
     if (status === "failed")
         return "red";
     if (status === "passed")
-        return "green";
+        return BRAND_GREEN;
     const idx = ((slot % BORDER_ROTATION.length) + BORDER_ROTATION.length) %
         BORDER_ROTATION.length;
     return BORDER_ROTATION[idx];
@@ -48,7 +66,7 @@ export const SPINNER_FRAMES = [
 /** Color for a phase glyph based on its status. Active phase uses border color. */
 export function phaseStatusColor(status) {
     if (status === "done")
-        return "green";
+        return BRAND_GREEN;
     if (status === "failed")
         return "red";
     return "gray";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sequant",
-  "version": "2.6.1",
+  "version": "2.7.0",
   "description": "AI coding agent orchestrator — resolve GitHub issues end-to-end with isolated git worktrees, quality gates, and an MCP server. Works with Claude Code or Aider.",
   "type": "module",
   "bin": {

package/templates/skills/assess/SKILL.md

@@ -13,6 +13,9 @@ allowed-tools:
   - Bash(gh *)
 ---
 
+<!-- sequant:local-override -->
+> **Local overrides (read this first).** Before following any instruction below, check whether `.claude/.local/skills/assess/overrides.md` exists. If it does, read it and treat its contents as authoritative: its instructions take precedence over anything in this skill they conflict with. This is the supported way to tailor `/assess` without forking it — `overrides.md` lives under `.claude/.local/`, which `sequant update` and `sync` never overwrite.
+
 # Unified Issue Assessment & Triage
 
 You are the "Assessment Agent" for the current repository.

package/templates/skills/clean/SKILL.md

@@ -27,6 +27,9 @@ allowed-tools:
   - Grep
 ---
 
+<!-- sequant:local-override -->
+> **Local overrides (read this first).** Before following any instruction below, check whether `.claude/.local/skills/clean/overrides.md` exists. If it does, read it and treat its contents as authoritative: its instructions take precedence over anything in this skill they conflict with. This is the supported way to tailor `/clean` without forking it — `overrides.md` lives under `.claude/.local/`, which `sequant update` and `sync` never overwrite.
+
 # Repository Cleanup Command
 
 Comprehensive, safe repository cleanup that archives stale files, removes artifacts, and commits changes.

package/templates/skills/docs/SKILL.md

@@ -18,6 +18,9 @@ allowed-tools:
   - Bash(gh pr diff:*)
 ---
 
+<!-- sequant:local-override -->
+> **Local overrides (read this first).** Before following any instruction below, check whether `.claude/.local/skills/docs/overrides.md` exists. If it does, read it and treat its contents as authoritative: its instructions take precedence over anything in this skill they conflict with. This is the supported way to tailor `/docs` without forking it — `overrides.md` lives under `.claude/.local/`, which `sequant update` and `sync` never overwrite.
+
 # Documentation Generator
 
 You are the Phase 4 "Documentation Agent" for the current repository.

package/templates/skills/exec/SKILL.md

@@ -43,6 +43,9 @@ allowed-tools:
   - TodoWrite
 ---
 
+<!-- sequant:local-override -->
+> **Local overrides (read this first).** Before following any instruction below, check whether `.claude/.local/skills/exec/overrides.md` exists. If it does, read it and treat its contents as authoritative: its instructions take precedence over anything in this skill they conflict with. This is the supported way to tailor `/exec` without forking it — `overrides.md` lives under `.claude/.local/`, which `sequant update` and `sync` never overwrite.
+
 # Implementation Command
 
 You are the Phase 2 "Implementation Agent" for the current repository.

package/templates/skills/fullsolve/SKILL.md

@@ -39,6 +39,9 @@ allowed-tools:
   - Bash(./scripts/list-worktrees.sh:*)
 ---
 
+<!-- sequant:local-override -->
+> **Local overrides (read this first).** Before following any instruction below, check whether `.claude/.local/skills/fullsolve/overrides.md` exists. If it does, read it and treat its contents as authoritative: its instructions take precedence over anything in this skill they conflict with. This is the supported way to tailor `/fullsolve` without forking it — `overrides.md` lives under `.claude/.local/`, which `sequant update` and `sync` never overwrite.
+
 # Full Solve Command
 
 You are the "Full Solve Agent" for the current repository.

package/templates/skills/improve/SKILL.md

@@ -16,6 +16,9 @@ allowed-tools:
   - AskUserQuestion
 ---
 
+<!-- sequant:local-override -->
+> **Local overrides (read this first).** Before following any instruction below, check whether `.claude/.local/skills/improve/overrides.md` exists. If it does, read it and treat its contents as authoritative: its instructions take precedence over anything in this skill they conflict with. This is the supported way to tailor `/improve` without forking it — `overrides.md` lives under `.claude/.local/`, which `sequant update` and `sync` never overwrite.
+
 # Improve Command
 
 You are the "Improvement Agent" for the current repository.
@@ -665,4 +668,4 @@ Error: Path `src/nonexistent/` not found.
 - [ ] **Recommendations** - Tips for running quick wins vs larger refactors
 
 **DO NOT proceed to issue creation without user selection.**
-**DO NOT respond until all items are verified.**
+**DO NOT respond until all items are verified.**

package/templates/skills/loop/SKILL.md

@@ -25,6 +25,9 @@ allowed-tools:
   - Bash(git status:*)
 ---
 
+<!-- sequant:local-override -->
+> **Local overrides (read this first).** Before following any instruction below, check whether `.claude/.local/skills/loop/overrides.md` exists. If it does, read it and treat its contents as authoritative: its instructions take precedence over anything in this skill they conflict with. This is the supported way to tailor `/loop` without forking it — `overrides.md` lives under `.claude/.local/`, which `sequant update` and `sync` never overwrite.
+
 # Quality Loop Command
 
 You are the "Quality Loop Agent" for the current repository.

package/templates/skills/merger/SKILL.md

@@ -16,6 +16,9 @@ allowed-tools:
   - Glob
 ---
 
+<!-- sequant:local-override -->
+> **Local overrides (read this first).** Before following any instruction below, check whether `.claude/.local/skills/merger/overrides.md` exists. If it does, read it and treat its contents as authoritative: its instructions take precedence over anything in this skill they conflict with. This is the supported way to tailor `/merger` without forking it — `overrides.md` lives under `.claude/.local/`, which `sequant update` and `sync` never overwrite.
+
 # Merger Skill
 
 You are the "Merger Agent" for handling post-QA integration of completed worktrees.

package/templates/skills/qa/SKILL.md

@@ -24,6 +24,9 @@ allowed-tools:
   - AgentOutputTool
 ---
 
+<!-- sequant:local-override -->
+> **Local overrides (read this first).** Before following any instruction below, check whether `.claude/.local/skills/qa/overrides.md` exists. If it does, read it and treat its contents as authoritative: its instructions take precedence over anything in this skill they conflict with. This is the supported way to tailor `/qa` without forking it — `overrides.md` lives under `.claude/.local/`, which `sequant update` and `sync` never overwrite.
+
 # QA & Code Review
 
 You are the Phase 3 "QA & Code Review Agent" for the current repository.

package/templates/skills/reflect/SKILL.md

@@ -12,6 +12,9 @@ allowed-tools:
   - Grep
 ---
 
+<!-- sequant:local-override -->
+> **Local overrides (read this first).** Before following any instruction below, check whether `.claude/.local/skills/reflect/overrides.md` exists. If it does, read it and treat its contents as authoritative: its instructions take precedence over anything in this skill they conflict with. This is the supported way to tailor `/reflect` without forking it — `overrides.md` lives under `.claude/.local/`, which `sequant update` and `sync` never overwrite.
+
 # Reflection Agent
 
 You are the "Reflection Agent" for the current repository.

package/templates/skills/security-review/SKILL.md

@@ -17,6 +17,9 @@ allowed-tools:
   - Bash(gh issue comment:*)
 ---
 
+<!-- sequant:local-override -->
+> **Local overrides (read this first).** Before following any instruction below, check whether `.claude/.local/skills/security-review/overrides.md` exists. If it does, read it and treat its contents as authoritative: its instructions take precedence over anything in this skill they conflict with. This is the supported way to tailor `/security-review` without forking it — `overrides.md` lives under `.claude/.local/`, which `sequant update` and `sync` never overwrite.
+
 # Security Review Command
 
 You are the Security Review Agent for the current repository.

package/templates/skills/setup/SKILL.md

@@ -30,6 +30,9 @@ allowed-tools:
   - Bash(curl:*)
 ---
 
+<!-- sequant:local-override -->
+> **Local overrides (read this first).** Before following any instruction below, check whether `.claude/.local/skills/setup/overrides.md` exists. If it does, read it and treat its contents as authoritative: its instructions take precedence over anything in this skill they conflict with. This is the supported way to tailor `/setup` without forking it — `overrides.md` lives under `.claude/.local/`, which `sequant update` and `sync` never overwrite.
+
 # Sequant Setup
 
 Initialize Sequant workflow system in your current project.

package/templates/skills/solve/SKILL.md

@@ -13,6 +13,9 @@ allowed-tools:
   - Bash(gh *)
 ---
 
+<!-- sequant:local-override -->
+> **Local overrides (read this first).** Before following any instruction below, check whether `.claude/.local/skills/solve/overrides.md` exists. If it does, read it and treat its contents as authoritative: its instructions take precedence over anything in this skill they conflict with. This is the supported way to tailor `/solve` without forking it — `overrides.md` lives under `.claude/.local/`, which `sequant update` and `sync` never overwrite.
+
 # /solve — Deprecated Alias for /assess
 
 **This command has been merged into `/assess`.** Use `/assess` instead.

package/templates/skills/spec/SKILL.md

@@ -17,6 +17,9 @@ allowed-tools:
   - AgentOutputTool
 ---
 
+<!-- sequant:local-override -->
+> **Local overrides (read this first).** Before following any instruction below, check whether `.claude/.local/skills/spec/overrides.md` exists. If it does, read it and treat its contents as authoritative: its instructions take precedence over anything in this skill they conflict with. This is the supported way to tailor `/spec` without forking it — `overrides.md` lives under `.claude/.local/`, which `sequant update` and `sync` never overwrite.
+
 # Planning Agent
 
 Phase 1 "Planning Agent." Understands the issue and AC, reviews or synthesizes a plan, identifies gaps and risks, and drafts a GitHub issue comment.

package/templates/skills/test/SKILL.md

@@ -19,6 +19,9 @@ allowed-tools:
   - Bash(npx tsx:*)
 ---
 
+<!-- sequant:local-override -->
+> **Local overrides (read this first).** Before following any instruction below, check whether `.claude/.local/skills/test/overrides.md` exists. If it does, read it and treat its contents as authoritative: its instructions take precedence over anything in this skill they conflict with. This is the supported way to tailor `/test` without forking it — `overrides.md` lives under `.claude/.local/`, which `sequant update` and `sync` never overwrite.
+
 # Browser Testing Command
 
 You are the "Testing Agent" for the current repository.

package/templates/skills/testgen/SKILL.md

@@ -20,6 +20,9 @@ allowed-tools:
   - Agent(sequant-testgen)
 ---
 
+<!-- sequant:local-override -->
+> **Local overrides (read this first).** Before following any instruction below, check whether `.claude/.local/skills/testgen/overrides.md` exists. If it does, read it and treat its contents as authoritative: its instructions take precedence over anything in this skill they conflict with. This is the supported way to tailor `/testgen` without forking it — `overrides.md` lives under `.claude/.local/`, which `sequant update` and `sync` never overwrite.
+
 # Test Generation Command
 
 You are the "Test Generation Agent" for the current repository.

package/templates/skills/verify/SKILL.md

@@ -15,6 +15,9 @@ allowed-tools:
   - Bash(gh issue comment:*)
 ---
 
+<!-- sequant:local-override -->
+> **Local overrides (read this first).** Before following any instruction below, check whether `.claude/.local/skills/verify/overrides.md` exists. If it does, read it and treat its contents as authoritative: its instructions take precedence over anything in this skill they conflict with. This is the supported way to tailor `/verify` without forking it — `overrides.md` lives under `.claude/.local/`, which `sequant update` and `sync` never overwrite.
+
 # Execution Verification
 
 You are the "Execution Verification Agent" for the current repository.