@lumenflow/cli 5.3.2 → 5.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/cli",
-  "version": "5.3.2",
+  "version": "5.4.0",
   "description": "Command-line interface for LumenFlow workflow framework",
   "keywords": [
     "lumenflow",
@@ -98,6 +98,7 @@
     "lumenflow-validate": "./dist/validate.js",
     "mem-checkpoint": "./dist/mem-checkpoint.js",
     "mem-cleanup": "./dist/mem-cleanup.js",
+    "mem-converged": "./dist/mem-converged.js",
     "mem-context": "./dist/mem-context.js",
     "mem-create": "./dist/mem-create.js",
     "mem-delete": "./dist/mem-delete.js",
@@ -111,6 +112,7 @@
     "mem-start": "./dist/mem-start.js",
     "mem-summarize": "./dist/mem-summarize.js",
     "mem-triage": "./dist/mem-triage.js",
+    "mem-watch": "./dist/mem-watch.js",
     "metrics": "./dist/metrics-cli.js",
     "metrics-snapshot": "./dist/metrics-snapshot.js",
     "onboard": "./dist/onboard.js",
@@ -198,16 +200,16 @@
     "xstate": "^5.28.0",
     "yaml": "^2.8.2",
     "zod": "^4.3.6",
-    "@lumenflow/agent": "5.3.2",
-    "@lumenflow/control-plane-sdk": "5.3.2",
-    "@lumenflow/host": "^5.3.2",
-    "@lumenflow/initiatives": "5.3.2",
-    "@lumenflow/kernel": "5.3.2",
-    "@lumenflow/metrics": "5.3.2",
-    "@lumenflow/memory": "5.3.2",
-    "@lumenflow/packs-agent-runtime": "^5.3.2",
-    "@lumenflow/core": "5.3.2",
-    "@lumenflow/packs-software-delivery": "^5.3.2"
+    "@lumenflow/core": "5.4.0",
+    "@lumenflow/host": "^5.4.0",
+    "@lumenflow/initiatives": "5.4.0",
+    "@lumenflow/kernel": "5.4.0",
+    "@lumenflow/memory": "5.4.0",
+    "@lumenflow/agent": "5.4.0",
+    "@lumenflow/packs-software-delivery": "^5.4.0",
+    "@lumenflow/metrics": "5.4.0",
+    "@lumenflow/packs-agent-runtime": "^5.4.0",
+    "@lumenflow/control-plane-sdk": "5.4.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.0.18",

package/packs/agent-runtime/auto-session-integration.ts

@@ -83,6 +83,10 @@ interface SessionFileData {
   /** ADR-014 extension 2 — which skill bundle the agent identifies as carrying (WU-2754). */
   specialty_profile?: string;
   display_name?: string;
+  /** Stable explicit A2A reader identity. Format hint: <owner>:<role>:<purpose>. */
+  agent_identity?: string;
+  /** Reserved cloud workspace/tenant scope slot; unused by local runtime. */
+  tenant_id?: string;
   /** ADR-014 extension 2 — parent delegation registry reference (WU-2754). */
   delegation_id?: string;
 }
@@ -455,6 +459,10 @@ interface StartSessionOptions {
   /** ADR-014 specialty_profile for this session (e.g. 'delivery'). */
   specialtyProfile?: string;
   displayName?: string;
+  /** Explicit stable A2A reader identity. Format hint: <owner>:<role>:<purpose>. */
+  agentIdentity?: string;
+  /** Reserved cloud workspace/tenant scope slot; unused by local runtime. */
+  tenantId?: string;
   /** Parent delegation-registry record reference (dlg-XXXX). */
   delegationId?: string;
 }
@@ -511,6 +519,8 @@ export async function startSessionForWU(options: StartSessionOptions): Promise<S
     lifecycleRole,
     specialtyProfile,
     displayName,
+    agentIdentity,
+    tenantId,
     delegationId,
   } = options;
 
@@ -542,6 +552,8 @@ export async function startSessionForWU(options: StartSessionOptions): Promise<S
     lifecycle_role: lifecycleRole,
     specialty_profile: specialtyProfile,
     display_name: displayName,
+    agent_identity: agentIdentity,
+    tenant_id: tenantId,
     delegation_id: delegationId,
   });
   const resolvedDisplayName = roleAxes.display_name ?? acquireDisplayName(workspaceRoot, sessionId);
@@ -564,6 +576,8 @@ export async function startSessionForWU(options: StartSessionOptions): Promise<S
     lifecycle_role: roleAxes.lifecycle_role,
     specialty_profile: roleAxes.specialty_profile,
     display_name: resolvedDisplayName,
+    ...(roleAxes.agent_identity ? { agent_identity: roleAxes.agent_identity } : {}),
+    ...(roleAxes.tenant_id ? { tenant_id: roleAxes.tenant_id } : {}),
     ...(roleAxes.delegation_id ? { delegation_id: roleAxes.delegation_id } : {}),
   };
 

package/packs/agent-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/packs-agent-runtime",
-  "version": "5.3.2",
+  "version": "5.4.0",
   "description": "Agent runtime pack scaffold for LumenFlow — governed model-turn execution, pack config, and provider capability baselines",
   "keywords": [
     "lumenflow",

package/packs/agent-runtime/session-schema.ts

@@ -70,6 +70,7 @@ export const DISPLAY_NAME_POOL_RELATIVE_PATH = '.lumenflow/agents/display-name-p
 export const DISPLAY_NAME_RESERVATIONS_RELATIVE_PATH =
   '.lumenflow/state/display-name-reservations.jsonl';
 export const DISPLAY_NAME_RESERVATION_TTL_HOURS = 12;
+export const AGENT_IDENTITY_MIN_LENGTH = 3;
 
 /** Regex for delegation_id references back into delegation registry. */
 export const DELEGATION_ID_PATTERN = /^dlg-[0-9a-f]{4}$/;
@@ -93,6 +94,14 @@ export const SessionRoleAxesSchema = z.object({
     .optional(),
 });
 
+const AgentIdentitySchema = z
+  .string()
+  .trim()
+  .min(AGENT_IDENTITY_MIN_LENGTH, {
+    message: `agent_identity must be at least ${AGENT_IDENTITY_MIN_LENGTH} characters`,
+  });
+const TenantIdSchema = z.string().trim().min(1, { message: 'tenant_id must be non-empty' });
+
 /**
  * Base session schema — shared fields across v1 and v2.
  *
@@ -104,6 +113,8 @@ const SessionRecordBaseSchema = z.object({
   session_id: z.string().min(1),
   wu_id: z.string().min(1),
   started: z.string().min(1),
+  agent_identity: AgentIdentitySchema.optional(),
+  tenant_id: TenantIdSchema.optional(),
 });
 
 /**
@@ -172,11 +183,15 @@ export function withV2RoleDefaults(input: {
   specialty_profile?: string | null;
   display_name?: string | null;
   delegation_id?: string | null;
+  agent_identity?: string | null;
+  tenant_id?: string | null;
 }): {
   lifecycle_role: string;
   specialty_profile: string;
   display_name?: string;
   delegation_id?: string;
+  agent_identity?: string;
+  tenant_id?: string;
 } {
   const lifecycle_role =
     typeof input.lifecycle_role === 'string' && input.lifecycle_role.trim().length > 0
@@ -194,11 +209,14 @@ export function withV2RoleDefaults(input: {
     typeof input.display_name === 'string' && input.display_name.trim().length > 0
       ? input.display_name.trim()
       : undefined;
+  const identityFields = normalizeOptionalSessionIdentityFields(input);
   const out: {
     lifecycle_role: string;
     specialty_profile: string;
     display_name?: string;
     delegation_id?: string;
+    agent_identity?: string;
+    tenant_id?: string;
   } = {
     lifecycle_role,
     specialty_profile,
@@ -209,6 +227,32 @@ export function withV2RoleDefaults(input: {
   if (delegation_id) {
     out.delegation_id = delegation_id;
   }
+  if (identityFields.agent_identity) {
+    out.agent_identity = identityFields.agent_identity;
+  }
+  if (identityFields.tenant_id) {
+    out.tenant_id = identityFields.tenant_id;
+  }
+  return out;
+}
+
+export function normalizeOptionalSessionIdentityFields(input: {
+  agent_identity?: string | null;
+  tenant_id?: string | null;
+}): {
+  agent_identity?: string;
+  tenant_id?: string;
+} {
+  const out: {
+    agent_identity?: string;
+    tenant_id?: string;
+  } = {};
+  if (typeof input.agent_identity === 'string' && input.agent_identity.trim().length > 0) {
+    out.agent_identity = AgentIdentitySchema.parse(input.agent_identity);
+  }
+  if (typeof input.tenant_id === 'string' && input.tenant_id.trim().length > 0) {
+    out.tenant_id = TenantIdSchema.parse(input.tenant_id);
+  }
   return out;
 }
 

package/packs/sidekick/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/packs-sidekick",
-  "version": "5.3.2",
+  "version": "5.4.0",
   "description": "Sidekick personal assistant pack for LumenFlow — 16 tools for task management, typed memory, channels, routines, and audit",
   "keywords": [
     "lumenflow",

package/packs/software-delivery/manifest.ts

@@ -140,6 +140,7 @@ const MEM_DELETE_TOOL_ENTRY = 'tool-impl/memory-tools.ts#memDeleteTool';
 const MEM_EXPORT_TOOL_ENTRY = 'tool-impl/memory-tools.ts#memExportTool';
 const MEM_INBOX_TOOL_ENTRY = 'tool-impl/memory-tools.ts#memInboxTool';
 const MEM_SIGNAL_TOOL_ENTRY = 'tool-impl/memory-tools.ts#memSignalTool';
+const MEM_CONVERGED_TOOL_ENTRY = 'tool-impl/memory-tools.ts#memConvergedTool';
 const MEM_SUMMARIZE_TOOL_ENTRY = 'tool-impl/memory-tools.ts#memSummarizeTool';
 const MEM_TRIAGE_TOOL_ENTRY = 'tool-impl/memory-tools.ts#memTriageTool';
 const MEM_RECOVER_TOOL_ENTRY = 'tool-impl/memory-tools.ts#memRecoverTool';
@@ -245,6 +246,7 @@ const TOOL_PERMISSIONS = {
   'wu:validate': 'read',
   'mem:checkpoint': 'write',
   'mem:cleanup': 'write',
+  'mem:converged': 'read',
   'mem:context': 'read',
   'mem:create': 'write',
   'mem:delete': 'write',
@@ -371,6 +373,7 @@ const TOOL_ENTRY_OVERRIDES: Partial<Record<ToolName, string>> = {
   'mem:export': MEM_EXPORT_TOOL_ENTRY,
   'mem:inbox': MEM_INBOX_TOOL_ENTRY,
   'mem:signal': MEM_SIGNAL_TOOL_ENTRY,
+  'mem:converged': MEM_CONVERGED_TOOL_ENTRY,
   'mem:summarize': MEM_SUMMARIZE_TOOL_ENTRY,
   'mem:triage': MEM_TRIAGE_TOOL_ENTRY,
   'mem:recover': MEM_RECOVER_TOOL_ENTRY,

package/packs/software-delivery/manifest.yaml

@@ -244,6 +244,13 @@ tools:
     entry: tool-impl/memory-tools.ts#memCleanupTool
     permission: write
     required_scopes: *softwareDeliveryWriteScopes
+  - name: mem:converged
+    entry: tool-impl/memory-tools.ts#memConvergedTool
+    permission: read
+    required_scopes:
+      - type: path
+        pattern: '**'
+        access: read
   - name: mem:context
     entry: tool-impl/memory-tools.ts#memContextTool
     permission: read

package/packs/software-delivery/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/packs-software-delivery",
-  "version": "5.3.2",
+  "version": "5.4.0",
   "description": "Software delivery pack for LumenFlow — work units, gates, lanes, initiatives, and agent coordination",
   "keywords": [
     "lumenflow",

package/packs/software-delivery/tool-impl/memory-tools.ts

@@ -16,6 +16,7 @@ const MEMORY_TOOLS = {
   MEM_EXPORT: 'mem:export',
   MEM_INBOX: 'mem:inbox',
   MEM_SIGNAL: 'mem:signal',
+  MEM_CONVERGED: 'mem:converged',
   MEM_SUMMARIZE: 'mem:summarize',
   MEM_TRIAGE: 'mem:triage',
   MEM_RECOVER: 'mem:recover',
@@ -35,6 +36,7 @@ const MEMORY_TOOL_ERROR_CODES: Record<MemoryToolName, string> = {
   'mem:export': 'MEM_EXPORT_ERROR',
   'mem:inbox': 'MEM_INBOX_ERROR',
   'mem:signal': 'MEM_SIGNAL_ERROR',
+  'mem:converged': 'MEM_CONVERGED_ERROR',
   'mem:summarize': 'MEM_SUMMARIZE_ERROR',
   'mem:triage': 'MEM_TRIAGE_ERROR',
   'mem:recover': 'MEM_RECOVER_ERROR',
@@ -55,6 +57,7 @@ const MEMORY_TOOL_COMMANDS: Record<
   'mem:export': RUNTIME_CLI_COMMANDS.MEM_EXPORT,
   'mem:inbox': RUNTIME_CLI_COMMANDS.MEM_INBOX,
   'mem:signal': RUNTIME_CLI_COMMANDS.MEM_SIGNAL,
+  'mem:converged': RUNTIME_CLI_COMMANDS.MEM_CONVERGED,
   'mem:summarize': RUNTIME_CLI_COMMANDS.MEM_SUMMARIZE,
   'mem:triage': RUNTIME_CLI_COMMANDS.MEM_TRIAGE,
   'mem:recover': RUNTIME_CLI_COMMANDS.MEM_RECOVER,
@@ -338,6 +341,18 @@ export async function memInboxTool(input: unknown): Promise<ToolOutput> {
   if (lane) {
     args.push('--lane', lane);
   }
+  const reader = toStringValue(parsed.for);
+  if (reader) {
+    args.push('--for', reader);
+  }
+  const thread = toStringValue(parsed.thread);
+  if (thread) {
+    args.push('--thread', thread);
+  }
+  const intent = toStringValue(parsed.intent);
+  if (intent) {
+    args.push('--intent', intent);
+  }
 
   return executeMemoryTool(MEMORY_TOOLS.MEM_INBOX, args);
 }
@@ -354,7 +369,47 @@ export async function memSignalTool(input: unknown): Promise<ToolOutput> {
     return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.WU_REQUIRED);
   }
 
-  return executeMemoryTool(MEMORY_TOOLS.MEM_SIGNAL, [message, '--wu', wu]);
+  const args = [message, '--wu', wu];
+  const to = toStringValue(parsed.to);
+  if (to) {
+    args.push('--to', to);
+  }
+  const thread = toStringValue(parsed.thread);
+  if (thread) {
+    args.push('--thread', thread);
+  }
+  const replyTo = toStringValue(parsed.reply_to);
+  if (replyTo) {
+    args.push('--reply-to', replyTo);
+  }
+  const intent = toStringValue(parsed.intent);
+  if (intent) {
+    args.push('--intent', intent);
+  }
+  const interrupt = toStringValue(parsed.interrupt);
+  if (interrupt) {
+    args.push('--interrupt', interrupt);
+  }
+  if (parsed.requires_ack === true) {
+    args.push('--requires-ack');
+  }
+
+  return executeMemoryTool(MEMORY_TOOLS.MEM_SIGNAL, args);
+}
+
+export async function memConvergedTool(input: unknown): Promise<ToolOutput> {
+  const parsed = toRecord(input);
+  const thread = toStringValue(parsed.thread);
+  if (!thread) {
+    return createMissingParameterOutput('thread is required');
+  }
+
+  const args = ['--thread', thread];
+  if (parsed.quiet === true) {
+    args.push('--quiet');
+  }
+
+  return executeMemoryTool(MEMORY_TOOLS.MEM_CONVERGED, args);
 }
 
 export async function memSummarizeTool(input: unknown): Promise<ToolOutput> {

package/packs/software-delivery/tool-impl/runtime-cli-adapter.ts

@@ -47,6 +47,7 @@ export const RUNTIME_CLI_COMMANDS = {
   MEM_DELETE: 'mem-delete',
   MEM_EXPORT: 'mem-export',
   MEM_INBOX: 'mem-inbox',
+  MEM_CONVERGED: 'mem-converged',
   MEM_INIT: 'mem-init',
   MEM_READY: 'mem-ready',
   MEM_RECOVER: 'mem-recover',

package/templates/core/AGENTS.md.template

@@ -70,7 +70,7 @@ cd <project-root> && pnpm wu:done --id WU-XXXX
 Step 2 above is not optional:
 
 - `wu:brief` records checkpoint evidence; `wu:done` **blocks** without it for feature/bug WUs.
-- `wu:brief` also auto-loads shared memory and coordination signals into the generated prompt (WU-1240, WU-2607) — read the `## Memory Context` section in the brief output before coding. Manual `mem:context`/`mem:inbox` calls are still available as ad-hoc lookups mid-WU.
+- `wu:brief` also auto-loads shared memory and an Inbox Snapshot into the generated prompt (WU-1240, WU-2607) — read the `## Memory Context` section in the brief output before coding. Manual `mem:context`/`mem:inbox` calls are still available as ad-hoc lookups mid-WU.
 - Load relevant skills (`design-first`, `tdd-workflow`, `frontend-design`, `worktree-discipline`, `lumenflow-gates`) via your vendor's skill primitive. Claude Code, Codex, Cursor, and Windsurf all support `SKILL.md`-based skills (with minor invocation differences); Aider uses `CONVENTIONS.md`; Cline uses `.clinerules`. See [LUMENFLOW.md "Skills & Agents"](LUMENFLOW.md#skills--agents) for the invocation table, and your per-vendor rules file for specifics.
 
 ### During the WU
@@ -83,6 +83,16 @@ pnpm mem:signal '<short status>' --wu WU-XXXX
 pnpm mem:checkpoint --wu WU-XXXX --note '<progress>' --next-steps '<what is next>'
 ```
 
+### Inbox Signals Are Decision Points
+
+At `wu:brief`, after every `mem:checkpoint`, and before `wu:prep`, inspect unread coordination
+signals for your WU/session. A signal is not noise: read it, decide whether it changes or blocks the
+WU, and reply, acknowledge, or dismiss it before continuing.
+
+This convention applies to Claude Code, Codex, Cursor, Gemini CLI, and Windsurf briefs. Aider and
+Cline do not use `wu:brief` client variants, but they must follow the same polling rule through this
+onboarding guidance and their generated rules surfaces.
+
 **Classification rule:** if the fact would help _another_ agent vendor working this repo, it belongs in shared memory (`mem:create`), not your vendor's personal memory folder. Examples of shared: bug discoveries, architecture decisions, CI/gates gotchas, initiative direction, cross-WU scope flags. Examples of vendor-personal: behavioural feedback, user preferences, tool-invocation mechanics.
 
 **Shell-quoting footgun:** always **single-quote** the `--title` value. Bash expands `$var`, `$0`, backticks, and `!hist` inside double-quoted strings, silently corrupting prose containing prices (`$49`), positional refs, or exclamation marks. See [Memory section in LUMENFLOW.md](LUMENFLOW.md#memory-shared-vs-vendor-personal) for the full mem:\* contract.
@@ -204,6 +214,14 @@ LumenFlow enforces safety at the repository level via git wrappers and hooks. Fo
 
 This file provides universal guidance for all AI agents. LumenFlow skills live in `.lumenflow/skills/` as `SKILL.md` files and are projected to each vendor via `pnpm lumenflow:integrate --client <x>`.
 
+Agent plugins are a discovery and invocation on-ramp, not a replacement for repo-level LumenFlow
+integration. If a plugin is installed alongside standalone projections, use the surface-specific
+name: standalone skills keep local names such as `design-first`, Claude plugin skills use names such
+as `/lumenflow:design-first`, and Codex plugin use should select the installed `lumenflow` plugin or
+bundled skill through Codex's `@` plugin selection surface. Plugin installation must not delete
+`.claude/skills/` or `.agents/skills/`, and governed repo enforcement still requires
+`npx lumenflow init`, `pnpm lumenflow:integrate`, or `pnpm lumenflow:integrate --sync`.
+
 | Vendor       | Skill / rules surface                               | Invocation                                                             |
 | ------------ | --------------------------------------------------- | ---------------------------------------------------------------------- |
 | Claude Code  | `.claude/skills/` + `.claude/CLAUDE.md`             | `Skill` tool call, or `/skill <name>` in interactive CLI               |

package/templates/core/LUMENFLOW.md.template

@@ -727,6 +727,15 @@ If you're an AI agent, read the onboarding docs:
 
 Skills are reusable workflow/knowledge bundles that agents load on demand. The `SKILL.md` format pioneered by Claude Code has converged into a de-facto standard adopted by OpenAI Codex (Dec 2025), Cursor (v2.4), and Windsurf Cascade (Jan 2026). LumenFlow stores vendor-neutral skill sources in `.lumenflow/skills/` and projects them to each vendor surface via `pnpm lumenflow:integrate --client <x>`.
 
+Agent plugins are a distribution on-ramp, not a replacement for these repo-level
+projections or for the Software Delivery Pack runtime. Standalone projected
+skills keep local names such as `design-first`, while plugin-installed Claude
+skills use plugin-qualified names such as `/lumenflow:design-first`. If both
+surfaces exist, prompts and handoff text must say which one they mean.
+Installing a plugin gives the agent methodology and entrypoint guidance;
+repo-level enforcement still requires `npx lumenflow init`,
+`pnpm lumenflow:integrate`, or `pnpm lumenflow:integrate --sync`.
+
 ### Core skills (vendor-neutral)
 
 | Skill                 | Load before...                               |
@@ -752,6 +761,14 @@ A skill name written in prose does nothing — it must be **loaded** through the
 | Aider        | `CONVENTIONS.md`          | `/read CONVENTIONS.md` or `aider --read CONVENTIONS.md`  |
 | Cline        | `.clinerules`             | Auto-loaded                                              |
 
+For plugin-distributed skills, prefer the vendor's plugin-qualified invocation
+surface instead of rewriting all canonical skill names. Claude Code plugin
+skills are namespaced as `/lumenflow:<skill>`. Codex plugin use should name the
+installed `lumenflow` plugin or one of its bundled skills through Codex's `@`
+plugin selection surface. Standalone projections remain valid until a future
+explicit cleanup command such as `--plugin-only` exists and is run
+intentionally.
+
 For vendor-specific setup details and per-vendor quirks, see:
 
 - Claude Code: [.claude/CLAUDE.md](.claude/CLAUDE.md)

package/templates/core/ai/onboarding/agent-safety-card.md.template

@@ -40,12 +40,28 @@ Quick reference for AI agents working in LumenFlow projects.
 | Read WU spec first                   | Understand scope                  |
 | cd to worktree after claim           | Isolation                         |
 | Write tests before code              | TDD                               |
+| Treat unread inbox signals as decisions | Prevent missed redirects       |
 | Run wu:prep in the claimed workspace | Quality and lifecycle correctness |
 | Run wu:done from main                | Complete WU                       |
 | Stay within code_paths               | Scope discipline                  |
 
 ---
 
+## Coordination Signals
+
+`wu:brief` includes an Inbox Snapshot when memory is available. Also check `mem:inbox`
+after checkpoints and before `wu:prep`.
+
+An unread signal is a decision point:
+
+1. Read it.
+2. Decide whether it changes, blocks, or does not affect the WU.
+3. Reply, acknowledge, or dismiss it before continuing.
+
+Do not leave directed signals for `wu:done`; by then the coordination window has already passed.
+
+---
+
 ## Universal Safety Mechanisms
 
 ### Git Safety Wrapper

package/templates/core/ai/onboarding/vendor-support.md.template

@@ -31,15 +31,15 @@ lumenflow init
 
 For popular AI coding assistants, LumenFlow provides **optional enhanced integrations** with deeper features like auto-detection, skills, and vendor-specific configurations.
 
-| Assistant   | Config File                    | Auto-detected | Enhanced Features               |
-| ----------- | ------------------------------ | ------------- | ------------------------------- |
-| Claude Code | `CLAUDE.md`, `.claude/`        | Yes           | Skills, agents, hooks, settings |
-| Cursor      | `.cursor/rules/lumenflow.md`   | Yes           | Rules integration               |
-| Windsurf    | `.windsurf/rules/lumenflow.md` | Yes           | Rules integration               |
-| Cline       | `.clinerules`                  | No            | Rules file                      |
-| Codex       | `AGENTS.md` (native)           | No            | Uses universal files directly   |
-| Aider       | `.aider.conf.yml`              | No            | Config file                     |
-| Antigravity | `AGENTS.md` (native)           | Unknown       | Research phase                  |
+| Assistant   | Config File                    | Auto-detected | Enhanced Features                                                |
+| ----------- | ------------------------------ | ------------- | ---------------------------------------------------------------- |
+| Claude Code | `CLAUDE.md`, `.claude/`        | Yes           | Skills, agents, hooks, settings, A2A `signal:received` delivery |
+| Cursor      | `.cursor/rules/lumenflow.md`   | Yes           | Rules integration; A2A push deferred to `mem:watch`              |
+| Windsurf    | `.windsurf/rules/lumenflow.md` | Yes           | Rules integration; A2A push deferred to `mem:watch`              |
+| Cline       | `.clinerules`                  | No            | Rules file; poll `mem:inbox` for A2A signals                     |
+| Codex       | `AGENTS.md` (native)           | No            | Universal files directly; A2A push deferred to `mem:watch`       |
+| Aider       | `.aider.conf.yml`              | No            | Config file; poll `mem:inbox` for A2A signals                    |
+| Antigravity | `AGENTS.md` (native)           | Unknown       | Research phase                                                   |
 
 ---