refactor: purge agent-deck/superpowers refs across active code, tasks, visualizations

[AndreJorgeLopes]

Summary

Audit of every superpowers / agent-deck / Agent Deck / bare upstream-skill-name reference across the codebase, with three actions:

1. Active devflow code (CLAUDE.md, AGENTS.md, visualizations) — updated to use the /devflow:* wrapper convention + 5-layer architecture (agent-deck removed long ago, the visualizations still showed 6 layers with Agent Deck + Conductor nodes).
2. Tasks folder — deleted 10 fully-stale agent-deck-era tasks; updated salvageable tasks (5 mod, drop agent-deck mentions but keep core idea). README rewritten with new task list, dependency graph, execution order.
3. Visualizations — full rewrite to drop Agent Deck / Conductor nodes, add phase-handoff spawn nodes, update color palette, update tool-active-per-phase table from 6 to 5 layers.

Per user's Recommended options across all three buckets.

Files changed (33 total)

Deletions (10 stale tasks + 3 agent-deck config files = 13 deletes)

• config/agent-deck/ — whole directory (README.md, config.toml.tmpl, tmux-notifications-fix.md)
• tasks/P0/ARCH-skills-mcp-sync.md — agent-deck MCP-pool task
• tasks/P1/ARCH-update-actual-configs.md — agent-deck config.toml updates
• tasks/P1/ARCH-skills-registry-global-sources.md — agent-deck skills registry
• tasks/P1/ARCH-agent-spawning-consistency.md — entire premise was "everything goes through agent-deck add"
• tasks/P1/ARCH-devflow-work-entry-point.md — entire premise was agent-deck add launching
• tasks/P1/ARCH-forgotten-items-previous-impl.md — agent-deck group/session wiring
• tasks/P1/ARCH-session-task-completion.md — agent-deck session cleanup logic
• tasks/P3/SPIKE-dynamic-mcp-selection.md — agent-deck MCP pool exploration
• tasks/P4/POLISH-yadm-tracking.md — YADM-track agent-deck + superpowers configs
• tasks/P4/POLISH-docker-sandbox-adr.md — Agent Deck Docker sandbox ADR

Updates (active code)

• CLAUDE.md — pipeline + bullets → /devflow:* form; added wrapper convention note
• visualizations/README.md — 6 → 5 layer, drop Agent Deck color/files; phase-handoff color added
• visualizations/workflows/development-workflow.md — full rewrite (8 sections): pipeline diagram now shows phase-handoff spawns + /devflow:* slash commands, tool-active table dropped Agent Deck/Conductor cols, dropped Conductor escalation notes, dropped agent-deck add alt entry point
• visualizations/architecture/devflow-ecosystem.md — full rewrite (5 sections): 6 → 5 layers, dropped Agent Deck + Conductor + Web UI nodes, added phase-handoff node, updated runtime architecture diagram + CLI commands table
• config/bootstrap-snippet.sh — brew "agent-deck" removed, added brew "gh" + brew "glab"
• skills/update-visualizations/SKILL.md (+ mirrors) — dropped agent-deck-integration.md mapping
• tasks/README.md — fully regenerated: 28 → 23 tickets, new dependency graph + execution order

Updates (salvageable tasks)

• tasks/P0/ARCH-visualization-update-hook.md — dropped agent-deck-integration file from proposed tree + dropped Agent Deck/Conductor from color palette
• tasks/P1/ARCH-detached-head-worktrees.md — example branch name updated
• tasks/P1/ARCH-stop-hook-finish-feature-removal.md — agent-deck sessions → phase-handoff spawned sessions
• tasks/P1/ARCH-testing-foundation.md — pipeline mention → /devflow:* form
• tasks/P1/ARCH-testing-infrastructure.md — drop agent-deck from mock list, add gh/glab
• tasks/P3/SPIKE-telemetry-observability.md — drop agent-deck logging questions/refs, retain skill-policy spike
• tasks/P3/SPIKE-hooks-improvement-opportunities.md — agent-deck hook-handler question → Claude Code plugin-hook coordination question
• tasks/P3/SPIKE-kanban-board-integration.md — agent-deck conductor notifications → OS-level notifications
• tasks/P4/POLISH-readme-improvement.md — drop Agent Deck Layer 2 from README diagram example

Out of scope (kept intentionally)

• docs/superpowers/ — explicit user-requested exception; preserved untouched
• docs/plans/* — historical plan docs (time-capsule of past decisions); rewriting them obscures history; preserved untouched
• docs/plans/2026-05-20-...-design.md — local-only gitignored file; doesn't exist in this worktree
• tasks/done/* — historical record of completed work; preserved untouched
• Wrapper-internal superpowers: refs in devflow-plugin/commands/{brainstorming,executing-plans,writing-plans}.md + mirrors — describing what the wrapper wraps is correct + necessary
• lib/worktree.sh --agent deprecation message — intentional; helps users who try the removed flag
• skills/registry.json writing-plans description — accurately describes wrapper-extends-upstream relationship

Audit after this MR (excluded: docs/, wrapper internals, tasks/done/, lib/worktree.sh deprecation, skills/registry.json writing-plans wrapper desc)

File	Type	Reasoning
tasks/README.md:131	Changelog footer	Documents what this MR did
skills/lock-tests/SKILL.md Attribution + Phase 2-3 refs	Wrapper-internal (lock-tests delegates Phases 2-3 to /devflow:executing-plans which itself delegates to upstream)	Accurate description of wrapper internals
skills/phase-handoff/SKILL.md "Note on impl"	Wrapper-internal explanation of /executing-plans slash-command auto-exposure	Future-proof note for older CC installs
Above mirrors at devflow-plugin/{commands,skills}/...	Generated from sources via devflow skills convert	Always in sync with sources

All these are intentional or auto-generated. No remaining unwanted refs.

Test plan

• devflow skills convert validates clean (✔ Validation passed)
• grep -RIln "agent-deck\|superpowers" ... returns only intentional refs (audit table above)
• tasks/README.md tally matches actual file count (23 tickets across P0-P4)
• MANUAL: visualizations render correctly in mermaid.live / VS Code Mermaid Preview

🤖 Generated with Claude Code

[Copilot]

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.