{
  "schema": "kiwe.command-manifest.v1",
  "productName": "SeamFlow",
  "flowName": "seamflow",
  "purpose": "Fast machine-readable SeamFlow slash-command router for browser AIs, IDE AIs, MCP clients, skill-capable agents, and Companion-assisted Kiwe workflows.",
  "entry": {
    "humanPattern": "read https://start.kiwelaunch.com/start.md",
    "rawEntrypoint": "https://start.kiwelaunch.com/start.md",
    "machineEntrypoint": "https://start.kiwelaunch.com/entry.json",
    "freshDiscovery": "https://start.kiwelaunch.com/.well-known/kiwe.json?refresh={UTC_TIMESTAMP_OR_RANDOM_NONCE}",
    "contractVersion": "7.26",
    "rule": "Read SeamFlow Start first, report the SeamFlow contract version, then route the next slash command through this manifest. Treat explore as a location pointer, not permission to crawl the repository."
  },
  "architecture": {
    "seamflow": "External AI command-central flow for Seam Framework + Bricks-powered webpages, headers, footers, reusable templates, Framework profiles, dynamic intent, and accessibility.",
    "compilerAuthority": "SEAM Compiler 0.13.0 is the deterministic authority for raw Bricks conversion, optional one-pass Framework optimization, and executable conversion proof. Browser AI must not manually recreate production Bricks JSON or Framework Profile data.",
    "stageBoundary": "Raw /convert /bricks is Framework-neutral. Optional /convert /bricks /seamframework is the preferred one-pass Framework mode; /seamframework remains valid while raw evidence is retained. Both emit one project-wide Framework Profile, stable profile-installed class IDs, dependent templates, and executable package audit proof. Accessibility is a separate explicit stage after Framework and has its own executable audit gate.",
    "kiweInternalAi": "Bounded Kiwe Companion/Internal AI. It can assist when /usecompanion or API/MCP access exists, but browser-only SeamFlow must still work without it.",
    "currentLaunchScope": "Close page-builder flow through Seam Framework first: Framework profile, Bricks pages/header/footer/templates, stable class and variable ownership, and executable /audit /seamframework proof. Accessibility follows as a separate active phase with measured evidence and executable audit proof.",
    "nextPhase": "DSA/AppShell theme remains mapped, but full DSA theme production hardening comes after page-builder flow testing passes.",
    "creativeAuthority": "Kiwe does not influence /ideate aesthetics. Conversion and Framework lanes preserve/translate deterministically. Bare /accessibility is the only bounded design-aware refinement lane: preserve the approved light design, minimally repair evidence-backed accessibility/responsive failures, and use wider visual judgment only to create an intentional peer dark appearance."
  },
  "pluginApi": {
    "rule": "When KIWE_REST_BASE and KIWE_AI_KEY are supplied, call the plugin SeamFlow REST routes instead of reconstructing validators or manually claiming closure.",
    "scope": "seamflow, studio_ai, bricks_ai, or all",
    "askWhenMissing": "If Route C/D, /usecompanion, plugin validation, or live Site Graph/API proof is selected and credentials are absent, ask for KIWE_REST_BASE and KIWE_AI_KEY. Tell the human to create the key in WordPress Admin → Kiwe → AI → API access keys with seamflow, studio_ai, bricks_ai, or all.",
    "routes": {
      "status": "{KIWE_REST_BASE}/ai/seamflow/status",
      "classify": "{KIWE_REST_BASE}/ai/seamflow/classify",
      "rebuild": "{KIWE_REST_BASE}/ai/seamflow/rebuild",
      "audit": "{KIWE_REST_BASE}/ai/seamflow/audit",
      "frameworkProfile": "{KIWE_REST_BASE}/ai/seamflow/framework-profile",
      "convertBricks": "{KIWE_REST_BASE}/ai/seamflow/convert-bricks",
      "accessibility": "{KIWE_REST_BASE}/ai/seamflow/accessibility",
      "execute": "{KIWE_REST_BASE}/ai/seamflow/execute"
    }
  },
  "globalRules": {
    "readPolicy": [
      "Read KIWE-START.md or entry.json first when the human gives only the Kiwe repo/link.",
      "Do not read the whole repository.",
      "Do not clone the repository for a slash-command lane unless the human explicitly asks you to inspect implementation source.",
      "Do not search GitHub docs for hidden contracts. This manifest plus the listed context files are the contract for the matched command.",
      "Do not use general web search, arXiv, unrelated GitHub search, commit browsing, stale local examples, prior-output research, or prior accepted notes to complete SeamFlow.",
      "Do not use search results when an exact raw URL/context route is required. If your environment starts a search instead of direct raw fetch/open, stop with ERROR: KIWE_SEARCH_DRIFT.",
      "Before every /command, including the first after Start classification, fetch fresh discovery with a never-before-used nonce, verify contractVersion/releaseId/sourceHash, then load only the selected content-hash immutable command route and its hash-declared pinned resources.",
      "Do not mark artifact lanes PASS from manual confidence, copied/reconstructed validator logic, simulated validator logic, or equivalent checks. PASS requires executable validator proof.",
      "Do not use prior Kiwe validation material, old National Chikki/BioVantage attempts, previous browser-AI outputs, local downloads, search results, or accepted notes unless the human supplied those exact files in the current turn or explicitly asked for comparison.",
      "Read only the context files listed for the matched command.",
      "Prefer this JSON manifest first when available because it is smaller and less ambiguous than prose.",
      "When files are supplied without a slash command, run kiwe_seamflow_plan, compatibility alias kiwe_plan_flow, or use entry.json flowPlanner rules before generation.",
      "If a required artifact is missing, stop with a compact diagnostic instead of guessing."
    ],
    "documentation": "Documentation is opt-in. Do not create README, NOTES, reports, duplicate previews, ZIP files, or explanation documents unless /document is present or the human explicitly asks.",
    "ideation": "For /ideate, auto-detect an attached Kiwe Design Context, preserve owner facts and preferences, ask only missing project-specific creative questions, create only the first Framework-neutral homepage HTML/CSS/JS, and continue small refinements through normal conversation without another command. Bare /accessibility may then improve the current raw page without introducing Seam Framework or Bricks.",
    "finalResponse": "Return a compact result: PASS/FAIL/WARN, files changed, files kept/removed when relevant, validator/audit status, and remaining warnings. Do not write long essays.",
    "companion": "/usecompanion is optional and non-blocking. If MCP/tool access is absent, ask for KIWE_REST_BASE and KIWE_AI_KEY, call one bounded Companion status/context route, report COMPANION: connected with compact route/hash proof on success, or COMPANION: fallback and continue without it on failure.",
    "firstInteractionRoutes": "When files are supplied without a command, always show route choices after the recommended next command: Route A hosted SEAM Compiler, Route B local deterministic compiler, Route C Plugin REST authority bridge, Route D Plugin REST + Companion review. For raw HTML/CSS/JS, choose raw /convert /bricks or one-pass /convert /bricks /seamframework. Accessibility is a separate active stage after conversion or Framework, using /create /accessibility and /audit. Ask for API credentials only for Route C/D or /usecompanion/plugin proof.",
    "structure": "Fix commands preserve the existing artifact lane. They must not restart creative work, silently change lanes, or create unrelated packages.",
    "redo": "/redo declares that the immediate previous output failed. The token itself is sufficient failure notice: do not ask the human to diagnose it. Discard that candidate and rerun the same output-producing instruction from its original approved input snapshot under the freshly discovered current release. Inspect the failed candidate only as negative evidence, never as source. It is not localized /fix and stops when the instruction/input snapshot is unavailable.",
    "cacheFreshness": "Canonical start.kiwelaunch.com responses are no-store. Every later slash command must use fresh discovery with a unique nonce, then content-hash immutable routes. Verify route sourceHash and each resource sha256; never mix releases or trust a URL already opened in the conversation.",
    "commandGrammar": "SeamFlow commands are composable shell-like tokens, not fixed magic phrases. Parse the user line into one primary action, optional phase/target, and modifiers. Equivalent valid ordering may be normalized when unambiguous; unknown, contradictory, or lane-invalid combinations stop with KIWE_UNKNOWN_COMMAND or KIWE_WRONG_LANE.",
    "auditClosure": "SeamFlow closes only when the required /audit command for the detected current artifact lane returns PASS after any needed /fix loops. /audit /eachstep audits after each phase; /audit /fix /eachstep explicitly runs phase -> audit -> fix actual artifact if needed -> same audit again until PASS or NEEDS_INPUT. /audit /atend audits before final delivery; /audit /fix /atend explicitly repairs failed final lanes and reruns audits until PASS or NEEDS_INPUT.",
    "validatorAuthority": "Only executed validator proof may close a lane as PASS: SEAM Compiler, official Kiwe validator command, Kiwe MCP validator tool, Kiwe REST/plugin validator, or hosted/local Kiwe validator endpoint. Copied/reconstructed or AI-authored converter/validator logic may guide diagnosis but cannot produce PASS. If unavailable, report WARN or UNVERIFIED. Visual accuracy is INCOMPLETE when viewport provenance differs or foreign overlays contaminate either capture.",
    "browserAiFallback": "When the hosted SEAM Compiler is unavailable, browser AI must use the official local compiler/runtime from the Kiwe source, then the Kiwe REST validation bridge when available. It may invoke tools, prepare source files, interpret executable proof, and fix source defects, but it must never replace the compiler by writing production Bricks JSON, Framework Profiles, measured accessibility ratios, or PASS reports from prose. If no official executable route is available, return WARN/UNVERIFIED with KIWE_VALIDATOR_UNAVAILABLE.",
    "routeFallbackLadder": "Applies to every phase. Prefer Route D when /usecompanion and Plugin REST are reachable. If Companion fails, continue as Route C. If Plugin REST fails or the host cannot resolve, and shell/Node/Git tools are available, immediately fall back to Route B and run the official matching validator/compiler. Only return WARN/UNVERIFIED after Plugin REST failed and no official Git/Node/MCP/hosted validator can execute.",
    "fullFlowDiscipline": "/execute /fullflow means one final delivery, not one giant context load. Execute phase-by-phase, read only the context/validator files for the current phase, close that phase with /audit -> /fix -> /audit, then continue.",
    "reportDiscipline": "/report is an interaction flag. In /execute /stepbystep, stop after the current phase closes, return the phase artifact plus compact generated/audited/fixed/warnings report, and wait for the human to say continue. In /execute /fullflow, /report adds a compact final phase ledger but does not pause between phases.",
    "siteGraphBoundary": "Missing SiteGraph/API/export is not a blocker for static conversion or /usebrickscontext targets. /usesitegraph is an evidence source and requires /for plus explicit targets. Stop for SiteGraph only when a selected target needs real site content/identity/IDs, live binding verification, or staging/apply authority.",
    "errorHandling": "SeamFlow is a command central. If a command, artifact, validator, route, token budget, context window, or requested lane is not valid enough to continue, stop immediately with STATUS plus ERROR: KIWE_* and the next valid command. Do not invent a manual pass or wander into unrelated sources.",
    "compilerContract": "kiwe-ai-toolkit/contracts/seam-compiler-contract.json"
  },
  "errorCatalog": {
    "responseShape": ["STATUS: NEEDS_INPUT | FAIL | WARN", "SeamFlow contract: 7.26", "ERROR: KIWE_...", "Command:", "Current artifact:", "Why stopped:", "Next valid command:"],
    "codes": {
      "KIWE_UNKNOWN_COMMAND": "Unknown or misspelled command token.",
      "KIWE_MISSING_ARTIFACT": "Required current files/attachments are missing.",
      "KIWE_WRONG_LANE": "Supplied artifact does not qualify for the requested command.",
      "KIWE_STALE_SOURCE_BLOCKED": "Only stale/prior outputs are available.",
      "KIWE_VALIDATOR_UNAVAILABLE": "Official validator/tool/API cannot execute.",
      "KIWE_VALIDATOR_PROOF_MISSING": "PASS was claimed without executable validator proof.",
      "KIWE_MANUAL_PASS_BLOCKED": "Only manual confidence is available for an importable lane.",
      "KIWE_PREVIOUS_AUDIT_MISSING": "/fix /previousaudit was requested without immediately previous audit findings.",
      "KIWE_PREVIOUS_OUTPUT_MISSING": "/previousoutput was requested but immediate previous output files are not accessible.",
      "KIWE_PREVIOUS_COMMAND_MISSING": "/redo was requested but the immediate previous output-producing instruction or its approved input snapshot is not accessible.",
      "KIWE_CONTEXT_WINDOW_RISK": "Requested flow is too large for the current AI/session.",
      "KIWE_TOKEN_BUDGET_RISK": "Command is likely to waste tokens.",
      "KIWE_TOOL_UNAVAILABLE": "Required MCP/API/browser/validator tool unavailable.",
      "KIWE_STALE_CONTRACT": "A later command follows refinement/output but the current exact raw entry, manifest, or routed context could not be refreshed.",
      "KIWE_CONTRACT_INTEGRITY_FAILED": "Fresh discovery, release ID, source hash, or pinned resource hash disagrees.",
      "KIWE_SEARCH_DRIFT": "Search engine, arXiv, GitHub search, commit browsing, or prior-example lookup was used or attempted instead of exact raw URL/context routing.",
      "KIWE_SITEGRAPH_REQUIRED": "Live Site Graph/API data was explicitly required but not supplied.",
      "KIWE_COMPANION_FALLBACK": "/usecompanion requested but unavailable.",
      "KIWE_STALE_BRICKS_PAGE_CSS": "Live Bricks preview/builder proof is contaminated by existing page-level Bricks custom CSS or stale selectors from prior imports."
    }
  },
  "flowPlanner": {
    "cli": "kiwe seamflow [--command text] [--artifact-summary text] [--desired-outcome text] [--use-companion]",
    "mcp": "kiwe_seamflow_plan",
    "compatibilityCli": "kiwe plan-flow",
    "compatibilityMcp": "kiwe_plan_flow",
    "purpose": "Classify files and plan the smallest safe path across Seam rebuild, Framework profile, Bricks conversion, DSA theme, combined handoff, and accessibility."
  },
  "contexts": {
    "workflow": "kiwe-ai-toolkit/contexts/workflow-lite.md",
    "ideation": "kiwe-ai-toolkit/contexts/ideate-lite.md",
    "seamAttributes": "kiwe-ai-toolkit/contexts/seam-attributes-lite.md",
    "bricksConversion": "kiwe-ai-toolkit/contexts/bricks-conversion-lite.md",
    "seamCompiler": "kiwe-ai-toolkit/contexts/seam-compiler-lite.md",
    "accessibility": "kiwe-ai-toolkit/contexts/accessibility-lite.md",
    "dynamic": "kiwe-ai-toolkit/contexts/dynamic-lite.md",
    "combined": "kiwe-ai-toolkit/contexts/combined-lite.md",
    "audit": "kiwe-ai-toolkit/contexts/audit-lite.md"
  },
  "commandGrammar": {
    "rule": "Tokens are independent and composable. Do not require a memorized full phrase when a command line is unambiguous.",
    "primaryActions": ["/ideate", "/execute", "/rebuild", "/create", "/convert", "/seamframework", "/audit", "/fix", "/redo", "/apply", "/list", "/document"],
    "phaseTargets": ["/stepbystep", "/fullflow", "/seamframework", "/frameworkprofile", "/bricks", "/bricksconversion", "/accessibility", "/dsatheme", "/combined", "/allattached", "/allflow", "/previousoutput", "/previousaudit", "/previewdata", "/bricksbindings", "/dynamictags", "/queryloops", "/kiwelaunchers", "/siteidentity", "/designcontext", "/designcontextenhancement"],
    "contextSources": ["/usesitegraph", "/usebrickscontext"],
    "entityScopes": ["/products", "/posts", "/pages", "/media", "/menus"],
    "fieldScopes": ["/titles", "/images", "/prices", "/links", "/excerpts", "/metadata"],
    "modifiers": ["/for", "/audit", "/fix", "/eachstep", "/atend", "/report", "/usecompanion", "/nonai", "/nopreviewdata"],
    "examples": {
      "/execute /fullflow /audit /fix /eachstep": "primary /execute, phase /fullflow, modifiers /audit /fix /eachstep",
      "/execute /stepbystep /audit /fix /eachstep /report": "primary /execute, phase /stepbystep, modifiers /audit /fix /eachstep /report",
      "/audit /allattached /allflow": "primary /audit, targets /allattached and /allflow"
    },
    "invalid": "Unknown tokens, contradictory cadence tokens, or lane-invalid combinations must stop with KIWE_UNKNOWN_COMMAND or KIWE_WRONG_LANE."
  },
  "commands": {
    "/ideate": {
      "phase": "ideate",
      "aliases": ["/ideate /webdraft", "/creative", "/webdraft"],
      "read": ["kiwe-ai-toolkit/contexts/ideate-lite.md"],
      "requires": ["an attached Kiwe Design Context or adaptive answers for facts it does not supply; project relationship; reusable versus inspiration references; any material creative constraints"],
      "output": ["one original homepage as index.html, styles.css, and script.js"],
      "forbidden": ["Bricks JSON", "Site Graph binding", "AppShell or DSA output", "post-conversion Seam migration", "framework-driven visual homogenization", "more than three questions at once", "restarting the interview during normal refinements"],
      "finalResponse": "Auto-detect Design Context, ask only unanswered project-specific creative questions, generate one Framework-neutral homepage, then accept subsequent refinements through normal conversation without another slash command."
    },
    "/list": {
      "phase": "discover",
      "read": ["KIWE-AI.md", "kiwe-ai-toolkit/command-manifest.json"],
      "requires": [],
      "output": ["compact command list"],
      "forbidden": ["generation", "audit", "file creation", "repository crawl"],
      "finalResponse": "List commands only, then stop."
    },
    "/redo": {
      "phase": "redo",
      "read": ["kiwe-ai-toolkit/entry.json", "kiwe-ai-toolkit/command-manifest.json"],
      "requires": ["the immediate previous output-producing instruction or canonical slash command", "that instruction's exact approved input/source snapshot, attachments, brief, refinements and target scope in the current conversation"],
      "must": ["treat /redo itself as sufficient notice that the last output failed; do not request a failure explanation", "fetch fresh discovery with a unique nonce", "load the current content-hash release route for the previous producing instruction", "discard the previous generated candidate as authority", "inspect the failed candidate only as negative evidence to avoid repeating its observable failure", "regenerate from the preserved approved input snapshot", "run every validator and render proof required by the refreshed route"],
      "output": ["one newly generated replacement candidate for the immediate previous output"],
      "forbidden": ["asking the human why the output failed before rerunning", "localized patching that belongs to /fix", "using the failed candidate as source", "changing instruction scope", "searching old conversations or downloads", "mixing command releases", "returning the same candidate without new execution", "claiming PASS without current validator proof"],
      "finalResponse": "Replace only the immediate previous output and report the refreshed release/validator proof. If the previous producing instruction or approved input snapshot is unavailable or ambiguous, stop with ERROR: KIWE_PREVIOUS_COMMAND_MISSING."
    },
    "/execute /stepbystep": {
      "phase": "execute",
      "read": ["kiwe-ai-toolkit/entry.json", "kiwe-ai-toolkit/command-manifest.json"],
      "requires": ["classified current artifact or explicit current command path"],
      "output": ["the next safe phase artifact only"],
      "forbidden": ["running the whole flow", "using prior test material", "docs unless /document", "ZIP"],
      "finalResponse": "Run only the next command in the current SeamFlow path. If /audit /fix /eachstep is selected, run audit/fix/audit until PASS or NEEDS_INPUT. If /report is selected, return the artifact plus compact report and wait for human continue."
    },
    "/execute /fullflow": {
      "phase": "execute",
      "read": ["kiwe-ai-toolkit/entry.json", "kiwe-ai-toolkit/command-manifest.json", "only the contexts required by the current phase, one phase at a time"],
      "requires": ["classified current artifact and human approval for full-flow execution"],
      "output": ["final canonical artifacts for the selected flow"],
      "forbidden": ["using prior test material", "loading all contexts upfront", "general web search", "docs unless /document", "ZIP", "DSA/AppShell output unless target requests DSA or combined", "treating missing Site Graph as a blocker for static Bricks conversion"],
      "finalResponse": "Return only final canonical artifacts after every required closing audit for the detected start point has passed, plus compact pass/fail/warn status."
    },
    "/audit /eachstep": {
      "phase": "flag",
      "read": ["kiwe-ai-toolkit/command-manifest.json"],
      "requires": ["/execute /stepbystep or /execute /fullflow"],
      "output": ["audit/fix gates after each phase before continuing"],
      "forbidden": ["standalone generation"],
      "finalResponse": "Use as an execution flag; do not treat as a standalone artifact command."
    },
    "/audit /fix /eachstep": {
      "phase": "flag",
      "read": ["kiwe-ai-toolkit/command-manifest.json"],
      "requires": ["/execute /stepbystep or /execute /fullflow"],
      "output": ["explicit audit/fix/re-audit loop after each phase before continuing"],
      "forbidden": ["standalone generation", "skipping re-audit after a fix"],
      "finalResponse": "Use as an execution flag. For each phase: generate/convert -> audit -> fix actual artifact if failed -> rerun same audit -> repeat until PASS or NEEDS_INPUT."
    },
    "/audit /atend": {
      "phase": "flag",
      "read": ["kiwe-ai-toolkit/command-manifest.json"],
      "requires": ["/execute /fullflow"],
      "output": ["final audit/fix gates before delivery"],
      "forbidden": ["standalone generation"],
      "finalResponse": "Use as an execution flag; do not treat as a standalone artifact command."
    },
    "/audit /fix /atend": {
      "phase": "flag",
      "read": ["kiwe-ai-toolkit/command-manifest.json"],
      "requires": ["/execute /fullflow"],
      "output": ["final audit/fix/re-audit gates before delivery"],
      "forbidden": ["standalone generation", "skipping re-audit after a fix"],
      "finalResponse": "Use as an execution flag. After generation/conversion, run required closure audits, fix failed lanes, and rerun the same audits until PASS or NEEDS_INPUT."
    },
    "/report": {
      "phase": "flag",
      "read": ["kiwe-ai-toolkit/command-manifest.json"],
      "requires": ["/execute /stepbystep or /execute /fullflow"],
      "output": ["compact generated/audited/fixed/warnings report"],
      "forbidden": ["creating documentation files", "long prose", "extra reports unless /document is also present"],
      "finalResponse": "In /execute /stepbystep, stop after the current phase closes, return the current phase file and compact report, then wait for human continue. In /execute /fullflow, include a compact final phase ledger only."
    },
    "/audit /allattached": {
      "phase": "audit",
      "read": ["kiwe-ai-toolkit/entry.json", "kiwe-ai-toolkit/command-manifest.json", "lane contexts and validators for every detected supplied artifact"],
      "requires": ["one or more current attached/supplied artifacts"],
      "output": ["pass/fail findings for every detected lane"],
      "forbidden": ["fixes unless /fix is also present", "creative rebuild", "redesign", "docs unless /document", "ZIP", "stale files"],
      "finalResponse": "Return compact PASS/FAIL/WARN per detected lane and next matching /fix command when needed."
    },
    "/fix /allattached": {
      "phase": "fix",
      "read": ["kiwe-ai-toolkit/entry.json", "kiwe-ai-toolkit/command-manifest.json", "lane contexts and validators for every failed supplied artifact"],
      "requires": ["current attached/supplied artifacts and failed audit findings or rerunnable validators"],
      "output": ["corrected current artifact files only"],
      "forbidden": ["creative rebuild", "redesign", "DSA/combined expansion unless already present", "docs unless /document", "ZIP", "stale files"],
      "finalResponse": "Return corrected files only plus compact audit status after rerunning every matching lane audit."
    },
    "/audit /allflow": {
      "phase": "audit",
      "read": ["kiwe-ai-toolkit/entry.json", "kiwe-ai-toolkit/command-manifest.json", "lane contexts and validators required by the detected start point/current stage"],
      "requires": ["classified current artifact or file map"],
      "output": ["pass/fail findings for every required closure audit"],
      "forbidden": ["fixes unless /fix is also present", "creative rebuild", "redesign", "docs unless /document", "ZIP", "stale files"],
      "finalResponse": "Return compact PASS/FAIL/WARN across all required closure audits for the detected flow."
    },
    "/fix /allflow": {
      "phase": "fix",
      "read": ["kiwe-ai-toolkit/entry.json", "kiwe-ai-toolkit/command-manifest.json", "lane contexts and validators required by failed closure audits"],
      "requires": ["classified current artifact/file map and failed audit findings or rerunnable validators"],
      "output": ["corrected canonical artifacts for the detected current flow"],
      "forbidden": ["creative rebuild", "redesign", "DSA/combined expansion unless already present or requested", "docs unless /document", "ZIP", "stale files"],
      "finalResponse": "Return corrected canonical artifacts only plus compact audit status after rerunning every required closure audit."
    },
    "/audit /previousoutput": {
      "phase": "audit",
      "read": ["kiwe-ai-toolkit/entry.json", "kiwe-ai-toolkit/command-manifest.json", "lane contexts and validators for every artifact in the immediate previous AI output"],
      "requires": ["files generated in the immediate previous AI output in this same session"],
      "output": ["pass/fail findings for every detected lane in the previous output"],
      "forbidden": ["fixes unless /fix is also present", "creative rebuild", "redesign", "docs unless /document", "ZIP", "stale files", "searching downloads or old conversations"],
      "finalResponse": "Audit only the immediate previous AI output files. If unavailable, stop with ERROR: KIWE_PREVIOUS_OUTPUT_MISSING."
    },
    "/fix /previousoutput": {
      "phase": "fix",
      "read": ["kiwe-ai-toolkit/entry.json", "kiwe-ai-toolkit/command-manifest.json", "lane contexts and validators for failed artifacts in the immediate previous AI output"],
      "requires": ["files generated in the immediate previous AI output in this same session"],
      "output": ["corrected files for the previous output only"],
      "forbidden": ["creative rebuild", "redesign", "new lane creation", "docs unless /document", "ZIP", "stale files", "searching downloads or old conversations"],
      "finalResponse": "Fix only the immediate previous AI output files and rerun matching audits. If unavailable, stop with ERROR: KIWE_PREVIOUS_OUTPUT_MISSING."
    },
    "/audit /allattached /allflow": {
      "phase": "audit",
      "read": ["kiwe-ai-toolkit/entry.json", "kiwe-ai-toolkit/command-manifest.json", "lane contexts and validators for every detected supplied artifact and every required closure audit"],
      "requires": ["current attached/supplied artifacts or file map"],
      "output": ["pass/fail findings per detected artifact lane and per required closure audit"],
      "forbidden": ["fixes unless /fix is also present", "creative rebuild", "redesign", "docs unless /document", "ZIP", "stale files"],
      "finalResponse": "Return compact PASS/FAIL/WARN for every detected artifact and every required closure audit."
    },
    "/fix /previousaudit": {
      "phase": "fix",
      "read": ["kiwe-ai-toolkit/entry.json", "kiwe-ai-toolkit/command-manifest.json", "lane contexts and validators referenced by the immediately previous audit findings"],
      "requires": ["immediately previous audit findings and current artifact files"],
      "output": ["corrected files for the previously audited failed lanes only"],
      "forbidden": ["creative rebuild", "redesign", "new lane creation", "docs unless /document", "ZIP", "stale files", "fixing from memory without previous findings"],
      "finalResponse": "Return corrected files only plus compact status after rerunning the exact previous audit scope."
    },
    "/fix /previouspass": {
      "phase": "diagnostic",
      "read": ["kiwe-ai-toolkit/entry.json", "kiwe-ai-toolkit/command-manifest.json"],
      "requires": ["current artifacts and immediately previous audit findings if the human wants a fix"],
      "output": ["ERROR: KIWE_PREVIOUS_AUDIT_MISSING when no previous audit findings exist"],
      "forbidden": ["execution", "silent aliasing", "fixing from memory", "stale files"],
      "finalResponse": "Do not execute. Explain that the canonical command is /fix /previousaudit and suggest /audit /allattached /allflow first when no previous audit findings exist."
    },
    "/create /designcontextenhancement": {
      "phase": "design-context-enhancement",
      "read": ["kiwe-ai-toolkit/contexts/dynamic-lite.md", "the attached kiwe.sitegraph-design-context.v1 export and its embedded designContextEnhancementContract"],
      "requires": ["a current kiwe.sitegraph-design-context.v1 export containing ownerContextHash and designContextEnhancementContract"],
      "must": ["copy the exact sourceContextHash", "set authority.mayOverwriteOwnerEvidence to false", "preserve every locked path and owner-selected color", "suggest colors only for semantic roles the owner left empty", "keep factual claims grounded in owner/SiteGraph evidence", "put uncertainty in requiresHumanReview"],
      "output": ["kiwe-design-context-enhancement.json using schema kiwe.design-context-enhancement.v1"],
      "forbidden": ["overwriting owner evidence", "inventing contacts addresses products legal facts awards or dates", "meta keywords", "keyword stuffing", "Bricks JSON", "automatically enabling Seam Framework", "browser-AI-authored production Framework Profile"],
      "finalResponse": "Return the enhancement JSON only plus compact locked/preserved/review counts. The administrator imports it in Kiwe > Framework."
    },
    "/seamframework": {
      "phase": "framework",
      "read": ["kiwe-ai-toolkit/contracts/seam-compiler-contract.json", "kiwe-ai-toolkit/contexts/seam-compiler-lite.md", "kiwe-ai-toolkit/contexts/bricks-conversion-lite.md"],
      "requires": ["successful raw SEAM Compiler conversion result or project batch"],
      "must": ["run the deterministic SEAM Compiler Framework stage; do not ask browser AI to rewrite the design", "emit one project-wide Framework Profile before dependent templates", "move body, H1-H6, link and site background ownership into Bricks Theme Style", "move repeated values/classes into universal or project profile layers", "keep genuine one-off exceptions element-native", "keep scoped CSS only where Bricks 2.3.10 lacks a faithful native control", "require the profile to be pushed in Kiwe > Framework before importing templates"],
      "output": ["framework/kiwe-framework-profile.json", "framework/audit-seamframework.json", "bricks-template/[name]-template-upload.json"],
      "forbidden": ["source redesign", "AI-authored production JSON", "inline variable fallbacks", "duplicate Theme Style/class/element ownership", "DSA theme", "docs unless /document", "ZIP"],
      "finalResponse": "Return the Framework Profile first, dependent templates second, and compact executable proof."
    },
    "/convert /bricks /seamframework": {
      "phase": "framework",
      "read": ["kiwe-ai-toolkit/contracts/seam-compiler-contract.json", "kiwe-ai-toolkit/contexts/seam-compiler-lite.md", "kiwe-ai-toolkit/contexts/bricks-conversion-lite.md"],
      "requires": ["arbitrary HTML/CSS/JS project, folder, archive, or standalone document"],
      "must": ["run SEAM Compiler 0.13.0 in one-pass Framework mode", "capture raw rendered evidence before Framework ownership", "emit one project-wide Framework Profile before dependent templates", "emit an explicit install-order manifest", "run /audit /seamframework and require PASS at 100% integration"],
      "output": ["framework/kiwe-framework-profile.json", "framework/audit-seamframework.json", "manifest-seam-framework.json", "bricks-template/[name]-template-upload.json"],
      "forbidden": ["source redesign", "AI-authored production JSON", "inline variable fallbacks", "discarding raw compiler evidence before Framework mapping", "docs unless /document", "ZIP"],
      "finalResponse": "Return the audited one-pass package with profile-first install order."
    },
    "/rebuild /seamframework": {
      "phase": "compatibility",
      "aliases": ["/seamframework"],
      "read": ["kiwe-ai-toolkit/contracts/seam-compiler-contract.json", "kiwe-ai-toolkit/contexts/seam-compiler-lite.md"],
      "requires": ["raw HTML/CSS/JS or an existing raw conversion result"],
      "must": ["normalize this legacy command to deterministic raw /convert /bricks followed by optional /seamframework", "never manually rewrite source HTML or production Bricks JSON"],
      "output": ["framework/kiwe-framework-profile.json", "bricks-template/[name]-template-upload.json"],
      "forbidden": ["legacy regex/token substitution as production authority", "AI-authored production JSON", "source redesign", "docs unless /document", "ZIP"],
      "finalResponse": "Report that the legacy command was normalized to Convert then Framework and return executable proof."
    },
    "/audit /seamframework": {
      "phase": "audit",
      "read": ["kiwe-ai-toolkit/contracts/seam-compiler-contract.json", "kiwe-ai-toolkit/contexts/seam-compiler-lite.md", "kiwe-ai-toolkit/contexts/bricks-conversion-lite.md"],
      "requires": ["Framework Profile plus every dependent Bricks template"],
      "output": ["framework/audit-seamframework.json", "pass/fail findings only"],
      "must": ["execute validate-seamframework.cjs or the SEAM Compiler package audit; never reuse the older raw-page adoption audit for a Framework package", "require status PASS and integration 100", "verify profile-before-template install order", "verify every consumed variable and reusable class is defined by the profile", "verify profile class IDs exactly match every dependent template _cssGlobalClasses reference", "fail duplicate Theme Style/project-class/element visual ownership", "fail local H1-H6 locks that should inherit Bricks Theme Style", "compare the raw and Framework templates to prove no redesign", "include validator proof in any PASS response"],
      "forbidden": ["manual-only PASS", "copied/reconstructed validator PASS", "fixes unless /fix is also present", "docs unless /document", "ZIP"],
      "finalResponse": "PASS/FAIL/INCOMPLETE with package proof, blocking errors, warnings, and install order."
    },
    "/fix /seamframework": {
      "phase": "fix",
      "read": ["kiwe-ai-toolkit/contexts/workflow-lite.md", "kiwe-ai-toolkit/contexts/seam-attributes-lite.md", "kiwe-ai-toolkit/tools/validate-seamframework.cjs"],
      "requires": ["failed Seam page artifact and audit findings"],
      "output": ["website/bricks-paste.html"],
      "must": ["fix the actual Seam page artifact", "move visual CSS off bare seam-* selectors and onto project-owned classes", "rerun the same Seam validator until PASS or NEEDS_INPUT"],
      "forbidden": ["Bricks JSON", "DSA theme", "redesign", "docs unless /document", "ZIP"],
      "finalResponse": "Return fixed Seam page artifact and compact validator-proof status."
    },
    "/create /frameworkprofile": {
      "phase": "create",
      "read": ["kiwe-ai-toolkit/contexts/workflow-lite.md"],
      "requires": ["explicit approved foundation tokens for a new blank profile, or deterministic SEAM Compiler evidence for a converted project"],
      "output": ["framework/kiwe-framework-profile.json"],
      "must": ["for converted HTML/CSS/JS use /convert /bricks /seamframework; do not infer an importable profile from screenshots, prose, or serialized Bricks alone", "run the official framework-profile generator and validate-framework-profile.cjs, Kiwe MCP, or Kiwe REST validator before PASS", "official Kiwe universal values go in settings.tokens.overrides", "project-specific variables/classes required by Bricks templates go in settings.tokens.project and are pushed to dedicated Kiwe Project categories in Bricks"],
      "forbidden": ["browser-AI-authored production profile inferred from a converted webpage", "manual-only PASS", "Bricks template JSON", "DSA theme package", "docs unless /document", "ZIP"],
      "finalResponse": "Return the deterministically generated profile and executable validation status; otherwise return WARN/UNVERIFIED and route converted projects to /convert /bricks /seamframework."
    },
    "/audit /frameworkprofile": {
      "phase": "audit",
      "read": ["kiwe-ai-toolkit/contexts/workflow-lite.md"],
      "requires": ["framework/kiwe-framework-profile.json"],
      "output": ["pass/fail findings only"],
      "must": ["reject custom token names in overrides", "allow project-specific variables/classes only in settings.tokens.project", "verify project variable/class names are prefixed and collision-safe"],
      "forbidden": ["fixes unless /fix is also present", "docs unless /document", "ZIP"],
      "finalResponse": "PASS/FAIL with blocking errors and warnings."
    },
    "/fix /frameworkprofile": {
      "phase": "fix",
      "read": ["kiwe-ai-toolkit/contexts/workflow-lite.md"],
      "requires": ["framework profile file and audit findings"],
      "output": ["framework/kiwe-framework-profile.json"],
      "forbidden": ["Bricks template JSON", "DSA theme package", "docs unless /document", "ZIP"],
      "finalResponse": "Return fixed profile and compact pass/fail summary."
    },
    "/create /brickstheme": {
      "phase": "create",
      "read": ["kiwe-ai-toolkit/contexts/workflow-lite.md"],
      "requires": ["approved design token/style direction"],
      "output": ["bricks-theme-style.json"],
      "forbidden": ["Framework profile", "Bricks page/template JSON", "DSA theme package", "docs unless /document", "ZIP"],
      "finalResponse": "Return only the Bricks theme style JSON and validation status."
    },
    "/convert /bricks": {
      "phase": "convert",
      "read": ["kiwe-ai-toolkit/contracts/seam-compiler-contract.json", "kiwe-ai-toolkit/contexts/seam-compiler-lite.md", "kiwe-ai-toolkit/contexts/bricks-conversion-lite.md"],
      "requires": ["arbitrary HTML/CSS/JS project, folder, archive, or standalone document"],
      "must": ["run SEAM Compiler 0.13.0 or a compatible deterministic compiler endpoint; browser AI must not author production JSON", "keep raw conversion Framework-neutral", "discover arbitrary pages without home/shop route assumptions", "split a complete standalone document into header, footer and content templates when applicable", "preserve source defects as 1:1 parity instead of redesigning them", "use Bricks-native element controls before scoped CSS", "preserve authored classes, attributes, interactions and executable behavior only within the compiler safety contract", "when live Bricks proof is used, reject stale page CSS, mismatched viewport provenance and foreign overlay contamination before scoring"],
      "output": ["bricks-template/[page-or-template-name]-template-upload.json"],
      "targetTypes": {
        "homepageBody": "title Home, templateType content, content[]",
        "pageBody": "templateType content, content[]",
        "header": "templateType header, header[]",
        "footer": "templateType footer, footer[]",
        "section": "templateType section, content[]"
      },
      "forbidden": ["mandatory Framework Profile", "automatic Seam token/class injection", "AI-authored production JSON", "project-specific compiler rules", "Code element fallback when native Bricks elements are possible", "docs unless /document", "ZIP"],
      "finalResponse": "Return every discovered raw native Bricks template and compact executable conversion proof."
    },
    "/audit /bricksconversion": {
      "phase": "audit",
      "read": ["kiwe-ai-toolkit/contracts/seam-compiler-contract.json", "kiwe-ai-toolkit/contexts/seam-compiler-lite.md", "kiwe-ai-toolkit/contexts/bricks-conversion-lite.md"],
      "requires": ["raw source plus native Bricks template upload JSON or compiler proof bundle"],
      "must": ["run executable structural/native-coverage validation", "treat the source as the visual contract even when it contains its own responsive defect", "require equal viewport provenance before any visual percentage", "mark mismatched canvas, DPR, page identity, scrollbar geometry, stale target CSS, or foreign overlay contamination INCOMPLETE", "report native coverage and scoped CSS exceptions separately", "fail runtime Code elements unless explicitly marked review-only unsupported exceptions", "fail framework-dependent settings in raw mode"],
      "output": ["pass/fail findings only"],
      "forbidden": ["fixes unless /fix is also present", "docs unless /document", "ZIP"],
      "finalResponse": "PASS/FAIL/INCOMPLETE with executable proof, valid visual score when available, blocking errors, and warnings."
    },
    "/fix /bricksconversion": {
      "phase": "fix",
      "read": ["kiwe-ai-toolkit/contexts/bricks-conversion-lite.md", "kiwe-ai-toolkit/contexts/seam-attributes-lite.md"],
      "requires": ["failed Bricks conversion/template artifact"],
      "must": ["fix the Bricks artifact itself; do not claim a Framework profile will repair hardcoded template JSON later", "use official tokens first, declared project variables second, and real fluid clamps only when source responsive states prove different min/max values"],
      "output": ["fixed Bricks conversion/template artifact only"],
      "forbidden": ["DSA/AppShell conversion", "website redesign", "docs unless /document", "ZIP"],
      "finalResponse": "Return fixed artifact and compact pass/fail summary."
    },
    "/accessibility": {
      "phase": "accessibility-current-artifact",
      "read": ["kiwe-ai-toolkit/contexts/accessibility-lite.md"],
      "requires": ["current page, preview, artifact, or file map; the active /ideate page qualifies"],
      "must": ["treat the approved current artifact and light appearance as design authority", "run inspect -> audit -> minimal fix -> render -> re-audit", "inspect the complete artifact in light and dark at desktop, tablet, mobile and narrow widths", "discover responsive defects without requiring the human to name them", "check card flex/grid growth, repeated-component sizing and CTA/footer alignment", "check wrapping, clipping, overlap, viewport overflow and touch-control collisions", "preserve content, hierarchy, identity, interaction intent, distinctive composition and light-mode art direction", "use bounded visual judgment to create a semantic dark appearance with peer hierarchy, brand recognition and intentional surface/accent distribution", "run validate-accessibility.cjs <artifact-root> --closure before PASS"],
      "output": ["revised existing artifact file(s)", "accessibility/kiwe-accessibility-plan.json", "SEAM automated accessibility score with automated coverage", "responsive reflow/alignment findings", "separate dark-mode visual-parity review", "manual checks outside the score"],
      "forbidden": ["influencing /ideate art direction", "forcing Seam Framework", "forcing Bricks conversion", "generic redesign", "copy or storytelling rewrite", "light-mode redesign", "dark-mode inversion", "claiming subjective beauty or user preference is scientifically certified", "unmeasured compliance claims", "ZIP"],
      "closureValidator": "Bare /accessibility is a closed audit/fix/re-audit pass. Require approvedDesignPreserved, lightModeArtDirectionPreserved, darkModeArtDirection, darkModeParityReview, responsiveUsabilityReviewed, repeatedComponentsReviewed and light/dark render proof at desktop/tablet/mobile/narrow. If render or validator proof is unavailable, return corrected candidates as NEEDS_INPUT rather than PASS.",
      "finalResponse": "Return technical accessibility status separately from dark-mode visual-parity review; include files changed, structural drift, validator/render proof, and remaining human/device checks."
    },
    "/create /accessibility": {
      "phase": "create",
      "read": ["kiwe-ai-toolkit/contexts/accessibility-lite.md", "kiwe-ai-toolkit/contexts/seam-attributes-lite.md"],
      "requires": ["existing website/page, DSA theme, combined handoff, Framework profile, Bricks theme style, or Bricks conversion"],
      "output": ["accessibility/kiwe-accessibility-plan.json", "minimal existing artifact edits when needed for dark/light proof"],
      "forbidden": ["new page design", "Bricks reconversion", "DSA theme creation", "docs unless /document", "ZIP"],
      "finalResponse": "Return plan/artifact file(s) and compact pass/fail summary."
    },
    "/audit /accessibility": {
      "phase": "audit",
      "read": ["kiwe-ai-toolkit/contexts/accessibility-lite.md"],
      "requires": ["existing artifact files and optional accessibility/kiwe-accessibility-plan.json"],
      "output": ["pass/fail findings only"],
      "forbidden": ["fixes unless /fix is also present", "docs unless /document", "ZIP"],
      "checks": ["WCAG contrast and semantic interaction", "native light/dark proof", "brand-preserving dark art direction", "full-page light/dark rendered inspection at desktop/tablet/mobile/narrow", "semantic project token pairs; Kiwe/Seam pairs only when that framework is already in scope", "Bricks theme-style alignment only for a Bricks target", "critical text wrapping, clipping, overlap and viewport overflow", "card flex/grid growth and equal-height resilience", "repeated-component CTA/footer and internal alignment", "touch target size and collision", "Appsite capability attributes preserved when present"],
      "closureValidator": "For combined /audit /fix /accessibility, run validate-accessibility.cjs <artifact-root> --closure after the repair and re-audit. Require approvedDesignPreserved, lightModeArtDirectionPreserved, darkModeArtDirection, darkModeParityReview, responsiveUsabilityReviewed, repeatedComponentsReviewed and passed light/dark proof at desktop/tablet/mobile/narrow. A non-zero or unavailable result must not be labelled PASS or complete; return any corrected candidate artifact as STATUS: NEEDS_INPUT with the missing proof.",
      "finalResponse": "PASS/FAIL with blocking errors and warnings."
    },
    "/fix /accessibility": {
      "phase": "fix",
      "read": ["kiwe-ai-toolkit/contexts/accessibility-lite.md", "kiwe-ai-toolkit/contexts/seam-attributes-lite.md"],
      "requires": ["failed accessibility audit or existing artifact needing accessibility repair"],
      "output": ["revised existing artifact file(s)", "accessibility/kiwe-accessibility-plan.json"],
      "forbidden": ["new Bricks elements unless explicitly required and explained", "new classes unless official/project-token mapping cannot solve the failure", "removed Seam classes", "removed Kiwe/Appsite attributes", "DSA/AppShell structure changes", "Bricks reconversion", "website redesign", "docs unless /document", "ZIP"],
      "preserve": ["element counts where possible", "global class counts where possible", "global variable names unless adding documented accessibility token mappings", "Seam classes", "data-role/data-flow", "data-kiwe-* attributes", "data-dsa-* attributes", "Bricks dynamic tags", "query-loop intent"],
      "darkModeRecipe": {
        "sourceOfTruth": "Use this recipe; do not search repo docs for a separate dark-mode contract.",
        "selectorPattern": [
          ".page-root-class, [data-kiwe-theme=\"light\"] .page-root-class, html[data-brx-theme=\"light\"] .page-root-class, :root[data-brx-theme=\"light\"] .page-root-class",
          "html[data-kiwe-theme=\"dark\"] .page-root-class, [data-kiwe-theme=\"dark\"] .page-root-class, .page-root-class[data-kiwe-theme=\"dark\"], html[data-brx-theme=\"dark\"] .page-root-class, :root[data-brx-theme=\"dark\"] .page-root-class"
        ],
        "bricksCompatibility": "When the target Bricks site exposes frontend color mode, Bricks may set document.documentElement.dataset.brxTheme on the frontend and emit palette variables at :root plus :root[data-brx-theme=\"dark\"]. Bricks-ready accessibility fixes must support data-brx-theme alongside Kiwe data-kiwe-theme when available; do not rely on Bricks editor dark UI alone.",
        "requiredKiweTokens": [
          "--kiwe-color-surface",
          "--kiwe-color-surface-raised",
          "--kiwe-color-surface-sunken",
          "--kiwe-color-text",
          "--kiwe-color-text-muted",
          "--kiwe-color-text-inverse",
          "--kiwe-color-border",
          "--kiwe-color-brand",
          "--kiwe-color-accent"
        ],
        "rule": "For artifacts already targeting Kiwe, Seam, AppShell, or Bricks, remap their existing project variables to Kiwe tokens for light and dark states without inventing a second palette. For framework-neutral raw HTML/CSS/JS, preserve project-owned semantic variables and use artifact-native data-theme state; do not introduce Kiwe, Seam, or Bricks solely for accessibility."
      },
      "checks": ["WCAG contrast and semantic interaction", "native light/dark proof", "brand-preserving dark art direction", "full-page light/dark rendered inspection at desktop/tablet/mobile/narrow", "semantic project token pairs; Kiwe/Seam pairs only when that framework is already in scope", "Bricks theme-style alignment only for a Bricks target", "critical text wrapping, clipping, overlap and viewport overflow", "card flex/grid growth and equal-height resilience", "repeated-component CTA/footer and internal alignment", "touch target size and collision", "reduced motion when motion exists"],
      "closureValidator": "Run validate-accessibility.cjs <artifact-root> --closure. Require plan.closure.approvedDesignPreserved, lightModeArtDirectionPreserved, darkModeArtDirection, darkModeParityReview, responsiveUsabilityReviewed, repeatedComponentsReviewed and passed light/dark proof at desktop/tablet/mobile/narrow. A non-zero or unavailable result must not be labelled PASS or complete; return the corrected candidate artifact as STATUS: NEEDS_INPUT with the missing proof.",
      "finalResponse": "Return fixed file(s), PASS/FAIL/WARN, files changed, and structural-drift summary. Keep it compact."
    },
    "/document": {
      "phase": "document",
      "read": ["context for the already completed command lane"],
      "requires": ["existing artifact"],
      "output": ["the narrow notes/report file for that lane"],
      "forbidden": ["redesign", "rebuild", "conversion", "theme creation", "ZIP unless explicitly requested"],
      "finalResponse": "Return the requested documentation file and compact summary."
    }
  }
}