workflow-catalog.json

{
  "count": 21,
  "provenance": {
    "artifact_path": "ls/docs/_generated/workflow-catalog.json",
    "artifact_sha256": "7acb2334f8508e596193cf01679eb5076c5d42213b0a8969f34366f028d4b165",
    "emitter": "generate-docs",
    "framework_version": "4.89.10",
    "schema_version": 1,
    "source_commit": "0a1e7bed168b86d4a74801e95c413c12930ee7ee",
    "source_dirty": false,
    "source_provenance_hash": "da4f94cc5311f24042a68efa023b1a7b89d4b43668864ee8ce7e600cd3ddde9b",
    "source_root_id": "4e46d3aab17f450f4229b417c716410a50584c4f96918aca19c4bd12b0e7c494",
    "source_tag": null,
    "source_tree_sha": "8b7f6d1646f44125531a941231e03d631e1c5c80"
  },
  "workflows": [
    {
      "aliases": [
        "codex github issue goal loop",
        "github issue goal loop",
        "slash goal issue sweep",
        "github maintenance goal",
        "ls-workflow-codex-github-issue-goal-loop"
      ],
      "description": "Use when keeping a Codex goal active across turns to research GitHub issues, PRs, and feature requests, handle each accepted change as a documented local commit, and publish only within the user's scope.",
      "display_name": "Codex GitHub Issue Goal Loop",
      "package": "ls-wf-codex-github-issue-goal-loop",
      "packs": [
        "dev",
        "github-maintenance",
        "publishing"
      ],
      "path": "ls/workflows/ls-wf-codex-github-issue-goal-loop",
      "required_docs": [
        "ls/docs/CODEX_GITHUB_ISSUE_GOAL_LOOP.md",
        "ls/docs/WORKFLOW_STANDARD.md",
        "ls/docs/DOCUMENT_LIFECYCLE_MANAGEMENT.md",
        "ls/docs/OUTPUT_AND_DOC_GENERATION.md",
        "ls/docs/VERSIONING.md"
      ],
      "required_skills": [
        "ls-localsetup-framework-changes",
        "ls-git-merge-rebase",
        "ls-system-changes-backup",
        "ls-docs-create-move",
        "ls-docs-source-drift",
        "ls-write-run-tests",
        "ls-github-pr-review",
        "ls-github-release-publishing",
        "ls-version-bump-commits"
      ],
      "required_tools": [
        "git",
        "gh"
      ],
      "workflow_id": "codex-github-issue-goal-loop"
    },
    {
      "aliases": [
        "contribution journey",
        "resume contribution"
      ],
      "description": "Guide a contribution from choosing a task through implementation, review and submission; use to resume interrupted contributions or prepare a pull request. Keeps preparation separate from confirmed publication.",
      "display_name": "Contribution, Review, and Submission",
      "package": "ls-wf-contribution-review-submit",
      "packs": [
        "dev",
        "github-maintenance"
      ],
      "path": "ls/workflows/ls-wf-contribution-review-submit",
      "required_docs": [],
      "required_skills": [
        "ls-git-merge-rebase",
        "ls-requesting-code-review",
        "ls-receiving-code-review",
        "ls-github-release-publishing"
      ],
      "required_tools": [],
      "workflow_id": "contribution-review-submit"
    },
    {
      "aliases": [
        "git repair pipeline",
        "ls-workflow-pipeline-git-repair-hygiene",
        "pipeline-git-repair-hygiene"
      ],
      "description": "Use when recovering broken Git state and enforcing follow-up workflow hygiene checks.",
      "display_name": "Git Repair Hygiene",
      "package": "ls-wf-git-repair-hygiene",
      "packs": [
        "bootstrap",
        "dev"
      ],
      "path": "ls/workflows/ls-wf-git-repair-hygiene",
      "required_docs": [
        "ls/docs/GIT_TRACEABILITY.md"
      ],
      "required_skills": [
        "ls-git-broken-state-recovery",
        "ls-git-merge-rebase",
        "ls-localsetup-framework-changes"
      ],
      "required_tools": [],
      "workflow_id": "git-repair-hygiene"
    },
    {
      "aliases": [
        "github repository enhancement",
        "audit GitHub repository settings",
        "configure GitHub maintenance",
        "ls-workflow-github-repository-enhancement",
        "github-repository-enhancement"
      ],
      "description": "Audit, plan, apply, and verify documented GitHub repository settings through LocalSetup's fixed CLI workflow.",
      "display_name": "GitHub Repository Settings Audit",
      "package": "ls-wf-github-repository-settings-audit",
      "packs": [
        "github-maintenance",
        "publishing"
      ],
      "path": "ls/workflows/ls-wf-github-repository-settings-audit",
      "required_docs": [
        "ls/docs/REPO_MAINTENANCE.md",
        "ls/docs/COMMAND_REFERENCE.md",
        "ls/docs/VERSIONING.md",
        "ls/docs/DOCUMENT_LIFECYCLE_MANAGEMENT.md",
        "ls/skills/ls-github-release-publishing/SKILL.md",
        "ls/skills/ls-git-merge-rebase/SKILL.md",
        "ls/skills/ls-system-changes-backup/SKILL.md",
        "ls/skills/ls-docs-source-drift/SKILL.md",
        "ls/skills/ls-docs-create-move/SKILL.md",
        "ls/skills/ls-write-run-tests/SKILL.md",
        "ls/skills/ls-localsetup-framework-changes/SKILL.md",
        "ls/skills/ls-version-bump-commits/SKILL.md",
        "ls/workflows/ls-wf-github-repository-settings-audit/references/github-maintenance.md"
      ],
      "required_skills": [
        "ls-github-release-publishing",
        "ls-system-changes-backup",
        "ls-docs-source-drift",
        "ls-docs-create-move",
        "ls-write-run-tests",
        "ls-localsetup-framework-changes",
        "ls-git-merge-rebase",
        "ls-version-bump-commits"
      ],
      "required_tools": [],
      "workflow_id": "github-repository-settings-audit"
    },
    {
      "aliases": [
        "lscli compact worker",
        "qualify local compact worker",
        "ls-workflow-lscli-compact-worker"
      ],
      "description": "Qualify and assign a bounded local compact worker task through existing LSCli profiles and native tool calling, without adding a runner.",
      "display_name": "LSCli Compact Worker Qualification",
      "package": "ls-wf-lscli-compact-worker",
      "packs": [
        "dev"
      ],
      "path": "ls/workflows/ls-wf-lscli-compact-worker",
      "required_docs": [
        "ls/docs/LSCLI.md",
        "ls/docs/LSCLI_RUNTIME.md",
        "ls/docs/LSCLI_QUALIFICATION.md",
        "ls/docs/WORKFLOW_STANDARD.md"
      ],
      "required_skills": [
        "ls-agent-capability-routing",
        "ls-task-skill-matcher"
      ],
      "required_tools": [],
      "workflow_id": "lscli-compact-worker"
    },
    {
      "aliases": [
        "umbrella workflow",
        "ls-workflow-umbrella-run",
        "umbrella-run"
      ],
      "description": "Use when executing a named multi-phase umbrella workflow with explicit pre-human-confirmation gates.",
      "display_name": "Multi-Phase Task Execution",
      "package": "ls-wf-multi-phase-task-execution",
      "packs": [
        "specialized"
      ],
      "path": "ls/workflows/ls-wf-multi-phase-task-execution",
      "required_docs": [
        "ls/docs/AGENTIC_UMBRELLA_WORKFLOWS.md"
      ],
      "required_skills": [],
      "required_tools": [],
      "workflow_id": "multi-phase-task-execution"
    },
    {
      "aliases": [
        "manage OpenPGP keys",
        "recover OpenPGP authority",
        "share encrypted artifacts",
        "share private provenance",
        "verify encrypted file",
        "ls-workflow-openpgp-lifecycle",
        "openpgp-lifecycle"
      ],
      "description": "Share, verify, and accept encrypted files with private provenance across carriers; adopt, generate, back up, rotate, revoke, or recover OpenPGP keys using shared local trust. No automatic enrollment or disclosure.",
      "display_name": "OpenPGP Key Lifecycle",
      "package": "ls-wf-openpgp-key-lifecycle",
      "packs": [
        "core"
      ],
      "path": "ls/workflows/ls-wf-openpgp-key-lifecycle",
      "required_docs": [
        "ls/docs/OPENPGP_RUNTIME.md",
        "ls/docs/AGENTIC_AGENT_Q_BIDIRECTIONAL_BUILD_SPEC.md",
        "ls/docs/LSCLI_RUNTIME.md"
      ],
      "required_skills": [],
      "required_tools": [
        "ls/core/openpgp/__init__.py"
      ],
      "workflow_id": "openpgp-key-lifecycle"
    },
    {
      "aliases": [
        "planning critic loop",
        "planning agent critic",
        "critic reviewed plan",
        "ls-workflow-planning-critic-loop"
      ],
      "description": "Use when creating decision-complete plans through grounding, capped clarification, subagent delegation, and critic iteration.",
      "display_name": "Planning Critic Loop",
      "package": "ls-wf-planning-critic-loop",
      "packs": [
        "dev"
      ],
      "path": "ls/workflows/ls-wf-planning-critic-loop",
      "required_docs": [
        "ls/docs/DECISION_TREE_WORKFLOW.md",
        "ls/docs/WORKFLOW_STANDARD.md",
        "ls/docs/WORKFLOW_PACKAGES.md",
        "ls/docs/SKILLS_AND_RULES.md"
      ],
      "required_skills": [],
      "required_tools": [],
      "workflow_id": "planning-critic-loop"
    },
    {
      "aliases": [
        "pr feedback pipeline",
        "ls-workflow-pipeline-pr-feedback-loop",
        "pipeline-pr-feedback-loop"
      ],
      "description": "Use when turning pull request feedback into fixes, tests, and follow-up review.",
      "display_name": "Pull Request Review Feedback Fixes",
      "package": "ls-wf-pr-review-feedback-fixes",
      "packs": [
        "dev",
        "github-maintenance"
      ],
      "path": "ls/workflows/ls-wf-pr-review-feedback-fixes",
      "required_docs": [],
      "required_skills": [
        "ls-receiving-code-review",
        "ls-test-driven-development",
        "ls-github-pr-review"
      ],
      "required_tools": [],
      "workflow_id": "pr-review-feedback-fixes"
    },
    {
      "aliases": [
        "provenance refresh pipeline",
        "ls-workflow-provenance-refresh",
        "provenance-refresh"
      ],
      "description": "Refresh owner-specific mutable provenance and generated documentation without rewriting release or installed-target evidence.",
      "display_name": "Provenance Drift Check and Refresh",
      "package": "ls-wf-provenance-drift-check-refresh",
      "packs": [
        "dev",
        "github-maintenance",
        "publishing"
      ],
      "path": "ls/workflows/ls-wf-provenance-drift-check-refresh",
      "required_docs": [
        "ls/docs/ADAPTER_OWNERSHIP.md",
        "ls/docs/OUTPUT_AND_DOC_GENERATION.md",
        "ls/docs/REPO_MAINTENANCE.md",
        "ls/docs/SDK_FORK.md",
        "ls/docs/VERSIONING.md",
        "ls/docs/WORKFLOW_PACKAGES.md",
        "ls/docs/WORKFLOW_STANDARD.md",
        "ls/skills/ls-docs-source-drift/SKILL.md",
        "ls/workflows/ls-wf-release-publish-readiness/SKILL.md"
      ],
      "required_skills": [
        "ls-version-bump-commits",
        "ls-docs-source-drift",
        "ls-localsetup-framework-changes",
        "ls-git-merge-rebase",
        "ls-github-actions-builder",
        "ls-github-release-publishing",
        "ls-system-changes-backup",
        "ls-write-run-tests"
      ],
      "required_tools": [
        "ls/tools/generate_docs_artifacts.py",
        "ls/tools/localsetup.py",
        "ls/tools/docs_alignment.py"
      ],
      "workflow_id": "provenance-drift-check-refresh"
    },
    {
      "aliases": [
        "Agent Q queue",
        "process PRDs",
        "ls-workflow-queue-batch-implement"
      ],
      "description": "Use when processing queued PRD tasks in batch with status tracking and outcome reporting.",
      "display_name": "Queue Batch Implement",
      "package": "ls-wf-queue-batch-implement",
      "packs": [
        "dev"
      ],
      "path": "ls/workflows/ls-wf-queue-batch-implement",
      "required_docs": [
        "ls/docs/AGENTIC_AGENT_Q_PATTERN.md",
        "ls/docs/PRD_SCHEMA_EXTERNAL_AGENT_GUIDE.md"
      ],
      "required_skills": [],
      "required_tools": [],
      "workflow_id": "queue-batch-implement"
    },
    {
      "aliases": [
        "pre publish pipeline",
        "ls-workflow-pipeline-pre-publish",
        "pipeline-pre-publish"
      ],
      "description": "Use when running pre-publish checks, version sync, and framework audit before release actions.",
      "display_name": "Release Publish Readiness",
      "package": "ls-wf-release-publish-readiness",
      "packs": [
        "publishing"
      ],
      "path": "ls/workflows/ls-wf-release-publish-readiness",
      "required_docs": [
        "ls/docs/VERSIONING.md",
        "ls/workflows/ls-wf-github-repository-settings-audit/SKILL.md",
        "ls/skills/ls-github-release-publishing/SKILL.md",
        "ls/skills/ls-localsetup-framework-audit/SKILL.md"
      ],
      "required_skills": [
        "ls-github-release-publishing",
        "ls-version-bump-commits",
        "ls-localsetup-framework-audit"
      ],
      "required_tools": [],
      "workflow_id": "release-publish-readiness"
    },
    {
      "aliases": [
        "repo polish pipeline",
        "ls-workflow-pipeline-repo-polish",
        "pipeline-repo-polish"
      ],
      "description": "Use when polishing repository docs and scripts for sharing readiness.",
      "display_name": "Repository Documentation Release Preparation",
      "package": "ls-wf-repository-docs-release-preparation",
      "packs": [
        "dev"
      ],
      "path": "ls/workflows/ls-wf-repository-docs-release-preparation",
      "required_docs": [
        "ls/docs/README.md",
        "ls/workflows/ls-wf-github-repository-settings-audit/SKILL.md",
        "ls/skills/ls-script-docs-authoring/SKILL.md",
        "ls/skills/ls-humanize-ai-writing/SKILL.md",
        "ls/skills/ls-github-release-publishing/SKILL.md"
      ],
      "required_skills": [
        "ls-script-docs-authoring",
        "ls-humanize-ai-writing",
        "ls-github-release-publishing"
      ],
      "required_tools": [],
      "workflow_id": "repository-docs-release-preparation"
    },
    {
      "aliases": [
        "repo convert pipeline",
        "convert repo",
        "localsetup convert",
        "ls-workflow-pipeline-repo-convert",
        "pipeline-repo-convert"
      ],
      "description": "Use when converting an existing repo to the current LocalSetup framework with backup, blocker, install, and verification gates.",
      "display_name": "Repository LocalSetup Conversion",
      "package": "ls-wf-repository-localsetup-conversion",
      "packs": [
        "bootstrap",
        "dev"
      ],
      "path": "ls/workflows/ls-wf-repository-localsetup-conversion",
      "required_docs": [
        "ls/docs/REPO_CONVERSION.md",
        "ls/docs/MULTI_PLATFORM_INSTALL.md"
      ],
      "required_skills": [
        "ls-localsetup-framework-changes",
        "ls-system-changes-backup",
        "ls-git-merge-rebase",
        "ls-write-run-tests"
      ],
      "required_tools": [
        "git"
      ],
      "workflow_id": "repository-localsetup-conversion"
    },
    {
      "aliases": [
        "repo finalizer",
        "finalizer harness",
        "finalization checkpoint",
        "ls-workflow-repo-finalizer",
        "repo-finalizer"
      ],
      "description": "Use when safely inspecting repo dirty state and optionally checkpointing allowlisted managed outputs without destructive git operations.",
      "display_name": "Repository Status Checkpoint",
      "package": "ls-wf-repository-status-checkpoint",
      "packs": [
        "harness"
      ],
      "path": "ls/workflows/ls-wf-repository-status-checkpoint",
      "required_docs": [
        "ls/docs/HARNESS_AUTOMATION.md",
        "ls/docs/WORKFLOW_PACKAGES.md"
      ],
      "required_skills": [
        "ls-localsetup-framework-changes",
        "ls-git-merge-rebase"
      ],
      "required_tools": [
        "ls/tools/localsetup.py"
      ],
      "workflow_id": "repository-status-checkpoint"
    },
    {
      "aliases": [
        "lazy admin",
        "manual execution",
        "ls-workflow-ops-guarded",
        "ops-guarded"
      ],
      "description": "Use when risky operations need approval checkpoints, impact review, or guarded execution; hand off sudo, elevated, PTY, or interactive password execution to ls-wf-sudo-tmux-session.",
      "display_name": "Risky Operations Safety Approval",
      "package": "ls-wf-risky-operations-safety-approval",
      "packs": [
        "bootstrap",
        "dev"
      ],
      "path": "ls/workflows/ls-wf-risky-operations-safety-approval",
      "required_docs": [
        "ls/skills/ls-system-changes-backup/SKILL.md",
        "ls/workflows/ls-wf-sudo-tmux-session/SKILL.md"
      ],
      "required_skills": [
        "ls-localsetup-framework-changes",
        "ls-system-changes-backup"
      ],
      "required_tools": [],
      "workflow_id": "risky-operations-safety-approval"
    },
    {
      "aliases": [
        "server triage patch pipeline",
        "ls-workflow-pipeline-server-triage-patch",
        "pipeline-server-triage-patch"
      ],
      "description": "Use when capturing a Linux server baseline, diagnosing service issues from read-only evidence, and producing a patch plan without executing changes.",
      "display_name": "Server Triage Patch Planning",
      "package": "ls-wf-server-triage-patch-planning",
      "packs": [
        "ops"
      ],
      "path": "ls/workflows/ls-wf-server-triage-patch-planning",
      "required_docs": [
        "ls/docs/WORKFLOW_QUICK_REF.md"
      ],
      "required_skills": [
        "ls-system-baseline-diagnostics",
        "ls-linux-service-triage",
        "ls-linux-patch-planning"
      ],
      "required_tools": [],
      "workflow_id": "server-triage-patch-planning"
    },
    {
      "aliases": [
        "skill onboarding pipeline",
        "ls-workflow-pipeline-skill-onboard",
        "pipeline-skill-onboard"
      ],
      "description": "Use when running the skill onboarding pipeline from vetting through sandbox testing.",
      "display_name": "Skill Import, Normalize, and Test",
      "package": "ls-wf-skill-import-normalize-test",
      "packs": [
        "dev",
        "skill-lifecycle"
      ],
      "path": "ls/workflows/ls-wf-skill-import-normalize-test",
      "required_docs": [
        "ls/docs/SKILL_IMPORTING.md",
        "ls/skills/ls-skill-security-vetting/SKILL.md",
        "ls/skills/ls-import-external-skills/SKILL.md",
        "ls/skills/ls-normalize-skill-format/SKILL.md",
        "ls/skills/ls-skill-sandbox-tester/SKILL.md"
      ],
      "required_skills": [
        "ls-skill-security-vetting",
        "ls-import-external-skills",
        "ls-normalize-skill-format",
        "ls-skill-sandbox-tester"
      ],
      "required_tools": [],
      "workflow_id": "skill-import-normalize-test"
    },
    {
      "aliases": [
        "decision tree",
        "reverse prompt",
        "ls-workflow-spec-clarify-reverse"
      ],
      "description": "Use when running reverse-prompt spec clarification with one question per turn and bounded choices.",
      "display_name": "Spec Clarify Reverse",
      "package": "ls-wf-spec-clarify-reverse",
      "packs": [
        "dev"
      ],
      "path": "ls/workflows/ls-wf-spec-clarify-reverse",
      "required_docs": [
        "ls/docs/DECISION_TREE_WORKFLOW.md"
      ],
      "required_skills": [],
      "required_tools": [],
      "workflow_id": "spec-clarify-reverse"
    },
    {
      "aliases": [
        "tmux shared session",
        "sudo tmux",
        "elevated permissions",
        "interactive sudo prompt",
        "sudo password prompt handoff",
        "require_escalated",
        "pseudo-terminal ops",
        "managed tmux ops",
        "ls-workflow-ops-tmux-session",
        "ops-tmux-session"
      ],
      "description": "Automatically route sudo, root/admin elevation, require_escalated, pseudo-terminal/PTY handling, interactive sudo prompts, or managed tmux run tracking through the approved tmux workflow.",
      "display_name": "Sudo Managed Pane",
      "package": "ls-wf-sudo-tmux-session",
      "packs": [
        "core",
        "ops"
      ],
      "path": "ls/workflows/ls-wf-sudo-tmux-session",
      "required_docs": [
        "ls/docs/ops/tmux-ops-managed.md",
        "ls/docs/ops/tmux-ops-remote.md"
      ],
      "required_skills": [
        "ls-system-changes-backup"
      ],
      "required_tools": [
        "ls/tools/tmux_ops"
      ],
      "workflow_id": "sudo-tmux-session"
    },
    {
      "aliases": [
        "tmux terminal mode",
        "always-on tmux",
        "observable agent shells",
        "tmux command recovery",
        "ls-workflow-tmux-terminal-mode"
      ],
      "description": "Use for observable agent shell sessions, tmux availability, command recovery, application profiles, or terminal-mode setup; privileged commands retain the sudo workflow.",
      "display_name": "Observable Shells and Tmux Terminal Mode",
      "package": "ls-wf-tmux-terminal-mode",
      "packs": [
        "core",
        "ops"
      ],
      "path": "ls/workflows/ls-wf-tmux-terminal-mode",
      "required_docs": [
        "ls/docs/TMUX_TERMINAL_MODE.md"
      ],
      "required_skills": [],
      "required_tools": [
        "ls/tools/tmux_terminal_mode",
        "ls/tools/localsetup.py"
      ],
      "workflow_id": "tmux-terminal-mode"
    }
  ]
}