backlog-md-workflow

backlog-md-workflow

A Claude Code plugin that wraps Backlog.md into a reusable task management workflow.

What you get

Three skills that cover the full lifecycle:

Skill	Purpose
setup	Idempotent installer for Backlog.md in a target repository — registers the mise tool, the MCP server, the .gitignore line, and injects an AGENTS.md section without overwriting existing directives.
conventions	Operating wisdom — when to create a backlog task vs a todo list, treating tasks as design documents, decisions/ acceptance authority, and multi-task PR grouping.
task-create	Guided authoring of a single task with Description, Acceptance Criteria, Implementation Plan, Alternatives table, and Open Questions.

Plus a backlog-md-workflow CLI with diagnostic and install helpers (status, check, install-public-registry, init-safe).

Why this plugin exists

Backlog.md is a great tool but it leaves several decisions to you:

• Where do tasks belong? Some work is a real task, some is an in-session todo, some is a drafts/ idea. The conventions skill is the decision rule.
• What goes in a task body? A bare backlog task create produces an empty stub. The task-create skill writes the body in one shot — Description, AC, Plan, Alternatives, Open Questions — so the task functions as its own design document.
• How do you install it without clobbering existing agent directives? backlog init's interactive wizard auto-generates AGENTS.md, CLAUDE.md, and .cursorrules. The setup skill runs it with the safe flag combo that disables the auto-generation, then injects a single ## Task Management section into the existing AGENTS.md.

Install

Add to your .claude/settings.json:

{
  "extraKnownMarketplaces": {
    "ether-moon-skills": {
      "source": {
        "source": "github",
        "repo": "ether-moon/ether-moon-skills"
      }
    }
  },
  "enabledPlugins": {
    "backlog-md-workflow@ether-moon-skills": true
  }
}

Restart Claude Code so the marketplace and plugin register.

Usage

In any repository where you want Backlog.md:

/backlog-md-workflow:setup

After setup, in day-to-day work the skills auto-trigger:

• "Should I create a task for this?" → invokes conventions
• "Create a task for the visual regression infra" → invokes task-create

Development

git clone https://github.com/ether-moon/ether-moon-skills
cd ether-moon-skills
bash tests/all.sh

The test suite validates plugin structure, JSON files, skill frontmatter, the CLI, and asset presence.

Origin

Extracted from the fame repository's Backlog.md adoption (PR #137). The conventions skill content was originally a .ai/memories/task_management.md file in fame, distilled by the guarding-agent-directives 5-question gate so only the recurring, non-obvious, project-portable items survived.

License

MIT