9thlevelsoftware/legion/workflow-common

Step 0: Check for override file
  - Read .legion-cli in the project root (if it exists)
  - If it contains a valid CLI identifier (e.g., "claude-code", "codex-cli"):
    → Use that adapter directly, skip Steps 1-3
    → Log: "CLI override: {cli} (from .legion-cli)"
 
Step 1: Tool probe (primary detection)
  - For each adapter in adapters/, check the detection.primary field:
    - Claude Code: TeamCreate tool is available
    - Codex CLI: `.codex-plugin/plugin.json`, `.codex/prompts/legion-start.md`, or `~/.codex/prompts/legion-start.md` exists
    - Cursor: `.cursor/rules/legion.mdc` exists
    - Copilot CLI: `.github/skills/legion-start/SKILL.md`, `~/.copilot/skills/legion-start/SKILL.md`, `.github/agents/legion-orchestrator.agent.md`, or `~/.config/copilot/agents/legion-orchestrator.agent.md` exists
    - Gemini CLI: `.gemini/commands/legion/start.toml` or `~/.gemini/commands/legion/start.toml` exists
    - Antigravity CLI: `.agents/plugins/legion/plugin.json` or `~/.gemini/config/plugins/legion/plugin.json` exists
    - Kiro CLI: `.kiro/agents/legion-orchestrator.md`, `~/.kiro/agents/legion-orchestrator.md`, `.kiro/steering/legion.md`, or `~/.kiro/steering/AGENTS.md` exists
    - Windsurf: `.windsurf/rules/legion.md` exists
    - OpenCode: `.opencode/command/legion-start.md`, `~/.config/opencode/command/legion-start.md`, `.opencode/agent/legion-orchestrator.md`, or `~/.config/opencode/agent/legion-orchestrator.md` exists
    - Kilo Code Plugin: `.kilocodemodes` contains `slug: legion` or `~/.kilocode/globalStorage/kilo code.kilo-code/settings/custom_modes.yaml` contains `slug: legion`
    - Kilo CLI: `.kilo/commands/legion-start.md`, `~/.config/kilo/commands/legion-start.md`, `.kilo/agents/legion-orchestrator.md`, `~/.config/kilo/agents/legion-orchestrator.md`, `.kilo/skills/code-polish/SKILL.md`, or `~/.kilo/skills/code-polish/SKILL.md` exists
    - Aider: `.aider.conf.yml`, `AGENTS.md`, or `CONVENTIONS.md` exists
  - If exactly one primary matches: use that adapter
  - If multiple match: use the first match in the order above (Claude Code wins ties; Kilo Code wins over Kilo CLI when the Kilo Code mode bridge is installed because both targets may share `.kilo/` workflow/skill paths)
 
Step 2: Secondary detection (fallback)
  - If no primary matched, check each adapter's detection.secondary field
  - These are additional filesystem markers or runtime-native configuration directories
  - Use the first match
 
Step 3: Default
  - If no detection matched: default to Claude Code adapter
  - Log: "No CLI detected — defaulting to Claude Code adapter"
 
Step 4: After detection
  - Read the full adapter file: adapters/{cli}.md
  - Parse YAML frontmatter for capabilities and tool mappings
  - Log: "Active adapter: {cli_display_name} (parallel: {parallel_execution}, messaging: {structured_messaging})"

Step 1: Try to read ./settings.json from current working directory.
Step 2: If the file is missing or invalid JSON, continue with built-in defaults.
Step 3: Resolve these runtime settings once per command invocation:
  - planning.max_tasks_per_plan (default: 3, per-plan task cap only)
  - review.max_cycles (default: 3)
  - execution.agent_personality_verbosity (default: full)
  - integrations.github (default: prompt)
  - memory.enabled (default: true)
  - memory.project_scoped_only (default: true)
Step 4: Log resolved values in command notes before execution.

{AGENTS_DIR}/{agent-id}.md

Step 1: Try Claude Code's native agents directory
  - Run: Bash  ls ~/.claude/agents/agents-orchestrator.md 2>/dev/null && echo "FOUND"
  - If output contains "FOUND":
    - Run: Bash  cd ~/.claude/agents && pwd
    - Store the absolute path as AGENTS_DIR
    → Log: "AGENTS_DIR: {AGENTS_DIR} (installed)"
    → Done.
 
Step 1.5: Try Legion's generic agents directory (non-Claude runtimes)
  - Run: Bash  ls ~/.legion/agents/agents-orchestrator.md 2>/dev/null && echo "FOUND"
  - If output contains "FOUND":
    - Run: Bash  cd ~/.legion/agents && pwd
    - Store the absolute path as AGENTS_DIR
    → Log: "AGENTS_DIR: {AGENTS_DIR} (legion-global)"
    → Done.
  - This path is used by runtimes with storageLayout: 'legion' (Codex CLI,
    Cursor, Copilot CLI, Gemini CLI, Kiro CLI, Windsurf, OpenCode, Aider).
    Checking it before local/manifest avoids unnecessary fallbacks.
 
Step 2: Try local (CWD) path — for plugin development
  - Attempt to Read agents/agents-orchestrator.md from the current working directory
  - If the file exists and is readable:
    → AGENTS_DIR = "agents"   (relative — local dev mode)
    → Log: "AGENTS_DIR: agents (local)"
    → Done.
 
Step 3: Fallback — read npm install manifest
  - Try Claude Code manifest first:
    Run: Bash  cat ~/.claude/legion/manifest.json 2>/dev/null
  - If not found, try generic manifest:
    Run: Bash  cat ~/.legion/manifest.json 2>/dev/null
  - If the file exists and contains valid JSON:
    - Extract the "paths.agents" value
    - Set AGENTS_DIR = {paths.agents}
    - Verify by attempting to Read {AGENTS_DIR}/agents-orchestrator.md
    - If readable:
      → Log: "AGENTS_DIR: {AGENTS_DIR} (npm manifest)"
      → Done.