npm - @1agh/maude - Versions diffs - 0.15.0 - Mend

@1agh/maude 0.15.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (211) hide show

package/plugins/design/templates/design-system-inspiration/universal/empty-state.html.tpl ADDED Viewed

@@ -0,0 +1,34 @@
+<!--
+SPECIMEN: empty-state
+DEMONSTRATES: --bg-1, --fg-0..2, --accent, --accent-fg, --radius-md, --space-4/5
+COMPOSITION: generic empty state — icon, title, supporting sentence, primary action
+COPY VOICE: title is the situation ("No matches yet"), supporting sentence is what to do next ("Log your first match"), action verb on the CTA ("Log a match", never "Get Started")
+WHEN SCAFFOLDED: universal (default-on)
+NOTES: Replace {{empty_subject}} with the actual project subject during scaffold. Empty states should feel earned, not generic — name the actual thing that's missing.
+-->
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <title>Empty state — {{project_label}}</title>
+  <link rel="stylesheet" href="../core/colors_and_type.css" />
+  <link rel="stylesheet" href="../core/preview/_layout.css" />
+</head>
+<body class="app" data-theme="{{theme_default}}">
+  <main class="specimen">
+    <h1>Empty state</h1>
+    <p class="lede">Empty states are an opportunity. Don't waste them on "Nothing here yet" — name the thing that's missing, then offer the next step.</p>
+    <div style="background: var(--bg-1); border: 1px solid var(--border-subtle); border-radius: var(--radius-md); padding: 48px; text-align: center; max-width: 480px;">
+      <div style="font-size: 48px; line-height: 1; color: var(--fg-2); margin-bottom: 16px;" aria-hidden="true">∅</div>
+      <p style="margin: 0 0 4px; font-family: var(--font-display); font-size: var(--type-lg); font-weight: 600; color: var(--fg-0);">No {{empty_subject}} yet</p>
+      <p style="margin: 0 0 24px; color: var(--fg-1); font-size: var(--type-sm); max-width: 36ch; margin-left: auto; margin-right: auto;">{{empty_supporting}}</p>
+      <button style="background: var(--accent); color: var(--accent-fg); border: 0; padding: 8px 16px; border-radius: var(--radius-md); font: inherit; cursor: pointer;">{{empty_cta}}</button>
+    </div>
+    <footer class="legend">
+      <p>Empty-state copy survives years. Spend the time to write a real sentence: "Log your first match" beats "Get started" every time.</p>
+    </footer>
+  </main>
+</body>
+</html>

package/plugins/design/templates/design-system-inspiration/universal/logo.html ADDED Viewed

@@ -0,0 +1,42 @@
+<!--
+SPECIMEN: logo
+DEMONSTRATES: brand wordmark + mark in their canonical contexts (dark frame, light frame, mark-only)
+COMPOSITION: 3 framed presentations — wordmark on --bg-1 (dark), wordmark on white (light), mark glyph alone
+COPY VOICE: tiny labels under each frame ("Wordmark — dark", "Wordmark — light", "Mark — glyph")
+WHEN SCAFFOLDED: conditional — scaffold IF assets/logos/ contains at least one *.svg (otherwise the specimen has nothing to display). The skill should ALSO generate a minimal placeholder SVG at scaffold time if a wordmark claim exists in copy.
+NOTES:
+  - The asset files referenced are placeholder paths — the skill rewrites these to point at the actual SVGs in assets/logos/ at scaffold time.
+  - If no wordmark exists yet, skip this specimen entirely rather than rendering a broken-image placeholder.
+  - Light frame uses an explicit white bg so the light-variant wordmark contrast is verifiable.
+-->
+<!doctype html>
+<html lang="en" data-theme="dark">
+<head>
+  <meta charset="utf-8" />
+  <title>Logo</title>
+  <link rel="stylesheet" href="../core/colors_and_type.css" />
+  <link rel="stylesheet" href="../core/preview/_layout.css" />
+  <style>
+    body { padding: 24px; display: flex; gap: 20px; align-items: center; flex-wrap: wrap; }
+    .frame { padding: 18px 22px; border: 1px solid var(--border-subtle); border-radius: var(--radius-lg); background: var(--bg-1); }
+    .light { background: #ffffff; }
+    .label { font-family: var(--font-mono); font-size: 11px; font-weight: 500; color: var(--fg-2); text-transform: uppercase; letter-spacing: 0.04em; margin-top: 10px; display: block; }
+  </style>
+</head>
+<body class="app">
+  <div>
+    <div class="frame"><img src="../assets/logos/wordmark.svg" alt="" style="display: block; height: 28px;" /></div>
+    <span class="label">Wordmark — dark</span>
+  </div>
+  <div>
+    <div class="frame light"><img src="../assets/logos/wordmark-light.svg" alt="" style="display: block; height: 28px;" /></div>
+    <span class="label">Wordmark — light</span>
+  </div>
+  <div>
+    <div class="frame" style="display: flex; align-items: center; justify-content: center; height: 64px; width: 64px; padding: 0;">
+      <img src="../assets/logos/mark.svg" alt="" style="display: block; width: 36px; height: 36px;" />
+    </div>
+    <span class="label">Mark — glyph</span>
+  </div>
+</body>
+</html>

package/plugins/design/templates/ds-specimen.tsx.template ADDED Viewed

@@ -0,0 +1,59 @@
+/**
+ * @canvas      {{NAME}} — {{SUBTITLE}}
+ * @ds          {{DS_NAME}}
+ * @platform    {{PLATFORM}}
+ * @opt_out     {{OPT_OUT_SCOPE}}
+ * @artboards   primary
+ * @brief       DS specimen — {{NAME}}
+ * @stack       React 19 · TSX · Bun.build · css_mode={{CSS_MODE}}
+ * @history     {{HISTORY_DIR}}
+ * @handoff     bunx shadcn add file://./{{NAME}}.registry.json
+ *
+ * Specimen surface for the {{DS_NAME}} design system. Bare TSX — no canvas-
+ * lib envelope (DesignCanvas / DCSection / DCArtboard). Specimens are
+ * flowing reference pages styled by `_layout.css` (which assumes `<body>` is
+ * the outer flex column) and their own component CSS rules in
+ * `_components.css`. The `<header class="specimen-hd">` provides SKU +
+ * crumbs + theme toggle exactly like the original .html specimens did.
+ *
+ * Tokens + `_layout.css` + `_components.css` are loaded by the dev-server's
+ * `_shell.html` harness via the iframe's `?tokens=` / `?components=` /
+ * `?layout=` query.
+ *
+ * Per-specimen bespoke CSS lives in a sibling `<Slug>.css` — `import` it
+ * below; canvas-build.ts injects it as a `<style>` tag at module init so
+ * the drop stays self-contained. (No `<link>` needed.)
+ *
+ * `data-cd-id="<8 hex>"` attributes are injected at request time by the
+ * dev-server's canvas pipeline pass 1 — don't author them by hand.
+ */
+import "./{{NAME}}.css";
+export default function {{COMPONENT_NAME}}() {
+  return (
+    <>
+      <header className="specimen-hd">
+        <span className="sku">{{SKU}}</span>
+        <span className="crumbs">
+          {/* {{CRUMB_HINT}} */}
+        </span>
+        {/* Theme toggle is wired by the host page (matchMedia + localStorage),
+            mirroring the legacy .html specimens. Author static markup here. */}
+        <span className="theme-toggle" role="tablist" aria-label="Theme">
+          <button data-theme="light">LIGHT</button>
+          <button data-theme="dark">DARK</button>
+        </span>
+      </header>
+      <main className="specimen">
+        <section className="specimen-title">
+          <h1>{{NAME}}</h1>
+          <p className="lede">{{BRIEF}}</p>
+        </section>
+        {/* Replace this scaffold with the actual specimen content. */}
+      </main>
+    </>
+  );
+}

package/plugins/flow/.claude-plugin/config.schema.json ADDED Viewed

@@ -0,0 +1,398 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "flow plugin — per-repo config",
+  "description": "Per-repo configuration consumed by the flow plugin's commands, skills, and subagents. Place at <repo>/.ai/workflows.config.json. Missing file = defaults; missing keys = same.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["name"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Short project / product name. Resolves the `<project>` placeholder in commands and file paths (e.g. `.ai/<project>-prd.md` → `.ai/<name>-prd.md`)."
+    },
+    "language": {
+      "type": "string",
+      "description": "Primary language used in plans, decisions, and review notes. ISO 639-1 (e.g. `en`, `cs`). Cosmetic — does not change plugin behaviour, only signals the team's preferred tone.",
+      "default": "en"
+    },
+    "theme": {
+      "type": "string",
+      "enum": ["dark", "light", "agnostic"],
+      "description": "Default theme target. `dark` and `light` enable theme-first contrast validation in a11y-rules; `agnostic` checks both.",
+      "default": "agnostic"
+    },
+    "paths": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Where to find canonical project context files. Defaults follow `<project>` placeholder convention.",
+      "properties": {
+        "prd": {
+          "type": "string",
+          "description": "Project requirements / product brief. Default: `.ai/<name>-prd.md`."
+        },
+        "designSystem": {
+          "type": "string",
+          "description": "Design system reference. Default: `.ai/<name>-design-system.md`."
+        },
+        "codebaseMap": {
+          "type": "string",
+          "description": "Living codebase snapshot. Default: `.ai/context/codebase-map.md`.",
+          "default": ".ai/context/codebase-map.md"
+        }
+      }
+    },
+    "platforms": {
+      "type": "array",
+      "description": "Platform variants the project ships to. Drives scenario-runner matrix and responsive-rules density mapping.",
+      "items": {
+        "type": "string",
+        "enum": [
+          "web-desktop",
+          "web-mobile",
+          "ios-phone",
+          "ios-tablet",
+          "android-phone",
+          "android-tablet",
+          "macos",
+          "windows",
+          "linux"
+        ]
+      },
+      "default": ["web-desktop"],
+      "uniqueItems": true
+    },
+    "bundleIdPrefix": {
+      "type": "string",
+      "description": "Native app bundle ID prefix (e.g. `com.acme.myapp`). Used by `/flow:utils-verify` and `/flow:scenario` when launching native builds. Omit for web-only projects."
+    },
+    "stack": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Auto-detected technology stack snapshot. Populated by /flow:init, refreshed by /flow:setup-codebase-map. Flow commands read this for routing decisions (e.g. which test runner to invoke, whether to gate on monorepo workspace builds). Use `unknown` when detection fails — never invent a value.",
+      "properties": {
+        "language": {
+          "type": "string",
+          "description": "Primary language: typescript | javascript | python | go | rust | java | kotlin | swift | ruby | php | unknown"
+        },
+        "framework": {
+          "type": "string",
+          "description": "Primary UI/app framework: next.js | vite | remix | sveltekit | astro | nuxt | expo | spring-boot | django | rails | express | fastapi | none | unknown"
+        },
+        "packageManager": {
+          "type": "string",
+          "description": "pnpm | yarn | npm | bun | cargo | go | pip | poetry | uv | maven | gradle | unknown"
+        },
+        "buildTool": {
+          "type": "string",
+          "description": "turbo | nx | lerna | rush | make | bazel | none | unknown"
+        },
+        "monorepo": {
+          "type": "boolean",
+          "description": "True if pnpm-workspace.yaml, turbo.json, nx.json, lerna.json, or rush.json is present."
+        },
+        "ci": {
+          "type": "string",
+          "description": "github-actions | gitlab-ci | jenkins | azure-devops | circleci | bitbucket | none | unknown"
+        },
+        "tests": {
+          "type": "string",
+          "description": "vitest | jest | playwright | cypress | rspec | pytest | go-test | cargo-test | junit | none | unknown"
+        },
+        "css": {
+          "type": "string",
+          "description": "tailwind | css-modules | styled-components | emotion | vanilla-extract | sass | plain-css | none | unknown"
+        },
+        "router": {
+          "type": "string",
+          "description": "next-app | next-pages | react-router | tanstack-router | expo-router | sveltekit-router | none | unknown"
+        }
+      }
+    },
+    "conventions": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Team conventions that flow commands enforce or display. Auto-detected where possible (e.g. `commits` from commitlint.config.*); otherwise asked once in /flow:init. Document non-obvious 'why' in `.ai/decisions/` as DDRs.",
+      "properties": {
+        "branchingModel": {
+          "type": "string",
+          "enum": ["github-flow", "trunk-based", "gitflow", "release-branch", "other"],
+          "description": "How feature branches relate to main. Drives /flow:done's push + PR behavior."
+        },
+        "commits": {
+          "type": "string",
+          "enum": ["conventional", "gitmoji", "free-form"],
+          "default": "conventional",
+          "description": "Commit message style. /flow:done formats commits to match."
+        },
+        "prohibited": {
+          "type": "array",
+          "items": { "type": "string" },
+          "default": [],
+          "description": "Packages, libraries, or APIs the project rejects (e.g. `lodash` because we use native ES; `moment` because we use date-fns). Flow commands flag accidental introduction."
+        },
+        "proxy": {
+          "type": "string",
+          "description": "Network constraint that commands must respect (e.g. `GODEBUG=x509negativeserial=1` for orgs with old certs)."
+        }
+      }
+    },
+    "boundaries": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Integration boundaries the project crosses. debugging-rules and testing-rules treat these as no-mock zones and demand evidence at the seam.",
+      "properties": {
+        "realtime": { "type": "array", "items": { "type": "string" }, "default": [] },
+        "video": { "type": "array", "items": { "type": "string" }, "default": [] },
+        "api": { "type": "array", "items": { "type": "string" }, "default": [] },
+        "db": { "type": "array", "items": { "type": "string" }, "default": [] },
+        "auth": { "type": "array", "items": { "type": "string" }, "default": [] },
+        "telemetry": { "type": "array", "items": { "type": "string" }, "default": [] },
+        "payments": { "type": "array", "items": { "type": "string" }, "default": [] }
+      }
+    },
+    "motion": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Motion duration budgets in milliseconds. motion-rules enforces these as hard ceilings.",
+      "properties": {
+        "micro": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 300,
+          "description": "Hover, focus, tooltip, icon swap."
+        },
+        "page": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 500,
+          "description": "Route transition, modal open."
+        },
+        "complex": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 1000,
+          "description": "Multi-step orchestrations, hero choreography."
+        },
+        "customPulses": {
+          "type": "object",
+          "description": "Named long-running ambient animations (e.g. `liveIndicator: 1500`). Exempt from the page/complex caps because they're loops, not transitions.",
+          "additionalProperties": { "type": "integer", "minimum": 0 },
+          "default": {}
+        }
+      }
+    },
+    "responsive": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Responsive layout knobs. responsive-rules reads this to enforce density-per-platform.",
+      "properties": {
+        "approach": {
+          "type": "string",
+          "enum": ["mobile-first", "desktop-first"],
+          "default": "mobile-first"
+        },
+        "densityMap": {
+          "type": "object",
+          "description": "Maps each entry in `platforms` to a density preset (`command-center` | `sideline-tool` | `palm-friendly` | `cozy` | `compact` | custom). responsive-rules uses this to flag wrong density per platform.",
+          "additionalProperties": { "type": "string" },
+          "default": {}
+        },
+        "breakpoints": {
+          "type": "object",
+          "description": "Named breakpoint tokens (px). Override only if project differs from defaults.",
+          "additionalProperties": { "type": "integer", "minimum": 0 },
+          "default": { "sm": 480, "md": 768, "lg": 1024, "xl": 1280, "2xl": 1536 }
+        }
+      }
+    },
+    "ux": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "UX hard targets surfaced to design-system-guard and any project-local UX critic.",
+      "properties": {
+        "responseTargetMs": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 100,
+          "description": "User-perceived response time ceiling for primary interactions."
+        },
+        "bilingual": {
+          "type": "array",
+          "items": { "type": "string" },
+          "default": [],
+          "description": "ISO 639-1 codes the UI ships in (e.g. `[\"cs\", \"en\"]`). Empty = monolingual."
+        }
+      }
+    },
+    "security": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Security review knobs. security-auditor + ethical-hacker subagents read these. Skip the whole pass with skills.securityRules.enabled = false.",
+      "properties": {
+        "severityFloor": {
+          "type": "string",
+          "enum": ["low", "medium", "high", "critical"],
+          "default": "medium",
+          "description": "Lowest severity that blocks /flow:validate step 6.5 and /flow:validate-security. Findings below this rate as warnings, not blockers."
+        },
+        "scope": {
+          "type": "array",
+          "items": { "type": "string", "enum": ["classic", "ai", "supply-chain"] },
+          "default": ["classic", "ai", "supply-chain"],
+          "description": "Which rule families to evaluate. Drop \"ai\" if the project has no model / MCP surface; drop \"supply-chain\" for projects with no third-party deps."
+        },
+        "includeAi": {
+          "type": "boolean",
+          "default": true,
+          "description": "Shortcut to enable/disable §B AI-era rules in security-rules skill. When false, ethical-hacker still threat-models classic surface but the mandatory AI/MCP section reads \"N/A — disabled by config\"."
+        }
+      }
+    },
+    "skills": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Per-skill toggles. Each enforcement skill respects its own `enabled` flag (default `true`).",
+      "properties": {
+        "motionRules": {
+          "type": "object",
+          "properties": { "enabled": { "type": "boolean", "default": true } },
+          "additionalProperties": false
+        },
+        "responsiveRules": {
+          "type": "object",
+          "properties": { "enabled": { "type": "boolean", "default": true } },
+          "additionalProperties": false
+        },
+        "a11yRules": {
+          "type": "object",
+          "properties": { "enabled": { "type": "boolean", "default": true } },
+          "additionalProperties": false
+        },
+        "testingRules": {
+          "type": "object",
+          "properties": { "enabled": { "type": "boolean", "default": true } },
+          "additionalProperties": false
+        },
+        "debuggingRules": {
+          "type": "object",
+          "properties": { "enabled": { "type": "boolean", "default": true } },
+          "additionalProperties": false
+        },
+        "securityRules": {
+          "type": "object",
+          "properties": { "enabled": { "type": "boolean", "default": true } },
+          "additionalProperties": false
+        },
+        "coverageTrend": {
+          "type": "object",
+          "description": "Optional coverage-trend warning in /flow:validate. Opt-in — disabled by default, because not every project has a stable coverage signal worth gating on. When enabled, /flow:validate parses the current run's coverage and compares against `.ai/state/coverage-baseline.json`; a drop greater than `warnThresholdPp` percentage points emits a soft warning (never blocks). Baseline is refreshed by /flow:done after a green run.",
+          "additionalProperties": false,
+          "properties": {
+            "enabled": { "type": "boolean", "default": false },
+            "warnThresholdPp": {
+              "type": "number",
+              "description": "Percentage-point drop that triggers the warning. e.g. `1.0` means a 1-point drop (78% → 77%) warns.",
+              "default": 1.0,
+              "minimum": 0
+            },
+            "baselineBranch": {
+              "type": "string",
+              "description": "Branch whose coverage is considered authoritative. /flow:done writes the baseline only when the active branch matches this value (typically `main`).",
+              "default": "main"
+            }
+          }
+        }
+      }
+    },
+    "integrations": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Lightweight pointers to external services the project plugs into. Generic commands read `provider` and decide whether to offer integration actions; project-specific shape (list IDs, custom field names, milestone hierarchies) lives in `defaults`. Document non-obvious conventions in `.ai/decisions/` as DDRs.",
+      "properties": {
+        "tracker": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "Issue / task tracker. Used by /flow:done, /flow:bug-rca, /flow:bug-fix to optionally create or update tickets.",
+          "properties": {
+            "provider": {
+              "type": "string",
+              "enum": [
+                "clickup",
+                "linear",
+                "github",
+                "jira",
+                "notion",
+                "asana",
+                "shortcut",
+                "none"
+              ],
+              "default": "none"
+            },
+            "mcp": {
+              "type": "string",
+              "description": "MCP tool name prefix used to call the provider (e.g. `mcp__claude_ai_ClickUp`, `mcp__github`). Generic commands resolve tool names by appending the operation (`<mcp>_<op>`). Omit if no MCP server is configured — commands will print payloads for manual handling."
+            },
+            "defaults": {
+              "type": "object",
+              "description": "Free-form project-specific defaults (list IDs, milestone names, custom field IDs, status labels, …). Generic commands pass this object through to MCP calls untouched. Schema-free on purpose — your tracker's idiosyncrasies belong here, not in the plugin.",
+              "additionalProperties": true
+            }
+          }
+        },
+        "analytics": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "Product analytics provider (PostHog, Amplitude, Mixpanel, …). Currently informational — surfaces in scenario reports and DDRs as context.",
+          "properties": {
+            "provider": { "type": "string", "default": "none" },
+            "mcp": { "type": "string" },
+            "defaults": { "type": "object", "additionalProperties": true }
+          }
+        },
+        "ci": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "CI / deploy provider (GitHub Actions, Vercel, Netlify, EAS, …). Used by /flow:validate to know where to look for build status.",
+          "properties": {
+            "provider": { "type": "string", "default": "none" },
+            "mcp": { "type": "string" },
+            "defaults": { "type": "object", "additionalProperties": true }
+          }
+        },
+        "design": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "Design source-of-truth (Figma, Penpot, Sketch, …). Used by /flow:plan when the planning input references design.",
+          "properties": {
+            "provider": { "type": "string", "default": "none" },
+            "mcp": { "type": "string" },
+            "defaults": { "type": "object", "additionalProperties": true }
+          }
+        },
+        "changelog": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "Release-note / changelog tooling. Used by /flow:validate and /flow:done to remind (soft warning) about missing release notes, by /flow:release-changelog to author entries, and by /flow:release to walk the project-owned release runbook. Phase 3 implements the `changesets` provider; other enum values are accepted but treated as no-op until their providers land.",
+          "properties": {
+            "provider": {
+              "type": "string",
+              "enum": ["changesets", "git-cliff", "conventional", "custom", "none"],
+              "default": "none"
+            },
+            "scope": {
+              "type": "string",
+              "description": "Optional package scope for monorepos — e.g. \"@1agh/maude\". Passed to provider commands when they need to target a workspace member."
+            },
+            "releaseGuide": {
+              "type": "string",
+              "default": ".ai/release-guide.md",
+              "description": "Path (repo-relative) to the project-owned release runbook that /flow:release walks step-by-step. The runbook is plain Markdown — H2 sections become steps, ```bash``` blocks become candidate commands (run only after user confirmation). Scaffolded with a provider-appropriate stub during /flow:init."
+            },
+            "mcp": { "type": "string" },
+            "defaults": { "type": "object", "additionalProperties": true }
+          }
+        }
+      }
+    }
+  }
+}

package/plugins/flow/README.md ADDED Viewed

@@ -0,0 +1,45 @@
+# flow — agentic workflow plugin
+Generic agentic workflow loop with a second-brain `.ai/` workspace. Project-agnostic via `<project>` placeholders + per-repo `.ai/workflows.config.json`.
+> For installation and the marketplace-level overview, see the [root README](../../README.md). For the canonical command catalog, see [`CATEGORIES.md`](./CATEGORIES.md).
+## Commands at a glance
+29 slash commands across 9 categories. Type **`/flow:help`** inside Claude Code for the live, auto-generated grouped index — it parses every command's `category:` frontmatter and prints the table fresh each time.
+| Group | Count | What it does |
+| ----- | ----- | ------------ |
+| **daily** | 11 | Every-cycle workflow: `plan`, `execute`, `done`, `validate`, `release`, `status`, `pause`, `resume`, `scenario`, `quick`, `help`. |
+| **setup-*** | 4 | One-shot bootstrapping: `init`, `setup-prd`, `setup-codebase-map`, `setup-context`. |
+| **validate-*** | 2 | Specialized validators: `validate-a11y`, `validate-visual`. |
+| **bug-*** | 2 | Incident workflow: `bug-rca`, `bug-fix`. |
+| **record-*** | 3 | Knowledge capture: `record-ddr`, `record-retro`, `record-execution`. |
+| **maintain-*** | 4 | Hygiene: `maintain-clean`, `maintain-docs`, `maintain-ai-health`, `maintain-discover`. |
+| **review-*** | 1 | `review-code` (pre-commit self-review). |
+| **release-*** | 1 | `release-changelog` (sibling of daily `release`). |
+| **utils-*** | 1 | `utils-verify` (sub-step of `execute`). |
+## Naming convention
+| Type | Pattern | Examples |
+| ---- | ------- | -------- |
+| **Daily** (called every feature cycle) | terse verb, no prefix | `plan`, `execute`, `done`, `validate`, `release` |
+| **Everything else** | `<group>-<verb>` | `bug-fix`, `setup-prd`, `record-ddr`, `maintain-clean` |
+The prefix is **load-bearing**: Claude Code does not support subdirectory namespacing for slash commands ([issue #2422](https://github.com/anthropics/claude-code/issues/2422)), so the `<group>-` prefix is what makes `/flow:bug-` autocomplete to only the bug-* commands. Every non-daily command carries a `category:` frontmatter field that matches its prefix — `/flow:help` reads those fields to render the grouped index.
+For the full catalog (group definitions, member descriptions, rename history), see [`CATEGORIES.md`](./CATEGORIES.md).
+## Subagents
+- `scenario-runner` — orchestrates cross-platform scenarios.
+- `a11y-auditor` — WCAG 2.1 AA pass over changed UI.
+- `design-system-guard` — compares rendered UI to the project's design system doc.
+- `test-coverage` — flags untested logic paths.
+## Skills
+`workflow-state`, `ddr-keeper`, `scenario`, `agent-browser`, `agent-device`, `codebase-intelligence`, `a11y-checker`, `question-protocol`, `make-skill-template`, `claude-md-keeper`, `debugging-rules`, `a11y-rules`, `motion-rules`, `responsive-rules`, `testing-rules`, `skill-loader`.
+See [`skills/`](./skills/) for the full list and per-skill SKILL.md files.

package/plugins/flow/templates/ai-skeleton/INDEX.md ADDED Viewed

@@ -0,0 +1,50 @@
+# `.ai/` — Index
+> Second-brain map. Auto-maintained by `/flow:status` and `/flow:setup-context`. Hand-edit additions are welcome.
+## Identity
+- name: `<PROJECT_NAME>` — see `.ai/workflows.config.json` → `name`
+- project conventions: see `CLAUDE.md` (or `.claude/CLAUDE.md`) at repo root — generated by Anthropic's `/init`
+- PRD: `.ai/<project>-prd.md`
+- design system: `.ai/<project>-design-system.md`
+- config: `.ai/workflows.config.json`
+## Active work
+> Updated by `/flow:status`. The single most useful screen for "where am I?".
+- current phase: see `state/STATE.md`
+- active plan: see `state/STATE.md` → Active plan
+- last touched: see `state/STATE.md` → Updated
+## Recent decisions
+> Last 5 DDRs. Full index in `decisions/README.md`.
+- (none yet — write one with `/flow:record-ddr <title>`)
+## Recent plans
+> Last 5 plans. Archive in `plans/archive/`.
+- (none yet — write one with `/flow:plan <feature>`)
+## Recent scenarios
+> Most recent run per scenario. Drill into `scenarios/<id>/` for the full history.
+- (none yet — run with `/flow:scenario <flow>`)
+## Where to find things
+| I want to know… | Look at |
+| --------------- | ------- |
+| What's the project's design rules? | `.ai/<project>-design-system.md` |
+| What are we building? | `.ai/<project>-prd.md` |
+| What did we decide and why? | `decisions/DDR-*.md` |
+| What was the plan for feature X? | `plans/<feature>.md` or `plans/archive/` |
+| How did scenario Y last run? | `scenarios/<flow>/<latest-date>/report.md` |
+| What's the codebase architecture? | `context/codebase-map.md` |
+| Where is the running TODO? | `state/STATE.md` → History tail |
+| Why is the workflow paused? | `state/HANDOFF.md` (if exists) |