[roadmap]: Skills Architecture Evolution - Migrate to lol CLI

[were]

Description

This roadmap outlines the migration from Claude Code plugin-based multi-agent orchestration workflows to formalized lol CLI scripts, reducing complexity and removing vendor lock-in.

Motivation

The current skills/commands architecture has two problems:

1. Plugin installation barrier - Users need to install Claude Code plugins, which has operational overhead
2. Vendor lock-in - Tightly coupled to Anthropic ecosystem

The new acw CLI + lol plan/impl workflow provides:

• 2x faster planning - lol plan skips sub-agent coordination overhead vs /ultra-planner
• Provider-agnostic - acw supports multiple AI providers (Claude, Codex, Gemini, etc.)
• Formalized scripts - Reproducible, scriptable workflows

Architecture

Skills to KEEP (8 total)

Guidelines (4) - Referenced by other flows/models

Skill	Purpose
document-guideline	Per-source-unit documentation standard
plan-guideline	Implementation plan format standard
doc-architect	Project-level documentation architecture
review-standard	Code review standards (can be referenced by codex)

Atomic Operations (4) - Invoked by models on-demand

Skill	Purpose
commit-msg	Interactive git commit with meaningful messages
move-a-file	Move/rename files with automatic reference updates
debug-report	Debug test failures and report via GitHub Issues
shell-script-review	Review shell scripts for bash/zsh compatibility

Skills to DEPRECATE (~15 total)

Skill/Command	Replacement
mega-planner	lol plan
ultra-planner	lol plan
sibyl	lol plan
issue-to-impl	lol impl
milestone	lol impl iteration loop
external-consensus	lol plan (formalized version)
external-synthesize	lol plan
open-issue	Step in lol plan
open-pr	Step in lol impl
fork-dev-branch	wt spawn --no-agent
code-review	codex review
agent-review	codex review
resolve-review	Prompt-based ("resolve codex review results")
plan-to-issue	Step in lol plan
setup-viewboard	One-time setup, keep as standalone script

Proposed Solution

Phase 1: Documentation & Deprecation Notices

• Add deprecation notices to all deprecated skills/commands READMEs
• Update main README to recommend lol plan / lol impl workflow
• Document migration path from old to new workflow

Phase 2: Ensure lol CLI Completeness

• Verify lol plan covers all mega-planner / ultra-planner use cases
• Verify lol impl covers all issue-to-impl / milestone use cases
• Add any missing atomic operations to lol subcommands if needed

Phase 3: Integration with External Tools

• Document codex review usage as replacement for code-review / agent-review
• Create prompt templates for common review resolution patterns
• Ensure acw properly supports codex CLI invocation

Phase 4: Cleanup

• Remove deprecated skills/commands from .claude/ directories
• Archive deprecated code to deprecated/ folder (for reference)
• Update all documentation to reflect new architecture

Success Criteria

• Users can complete full feature development cycle using only:
  • lol plan - Planning and issue creation
  • lol impl - Implementation with iteration loops
  • codex review - Code review
  • commit-msg - Commits (when in interactive Claude Code session)
• No dependency on Claude Code plugin installation for core workflows
• Provider-agnostic: workflows work with Claude, Codex, or other providers via acw

Timeline

This is a gradual migration. Deprecated skills will remain functional but unmaintained until Phase 4 cleanup.

Related PR

TBD - will be updated as phases are completed