fix: metadata and documentation accuracy — medium batch

README.md

@@ -24,7 +24,7 @@ DevFlow adds structured commands that handle the full lifecycle: specify feature
 - **Full-lifecycle implementation** — spec, explore, plan, code, validate, refine in one command
 - **Automatic session memory** — survives restarts, `/clear`, and context compaction
 - **Parallel debugging** — competing hypotheses investigated simultaneously
-- **31 quality skills** — 9 auto-activating core, 8 optional language/ecosystem, plus specialized review and agent skills
+- **32 quality skills** — 9 auto-activating core, 8 optional language/ecosystem, plus specialized review and agent skills
 
 ## Quick Start
 

plugins/devflow-debug/.claude-plugin/plugin.json

@@ -15,7 +15,8 @@
     "agent-teams"
   ],
   "agents": [
-    "git"
+    "git",
+    "synthesizer"
   ],
   "skills": [
     "agent-teams",

plugins/devflow-debug/commands/debug.md

@@ -48,7 +48,7 @@ Analyze the bug description (from arguments or issue) and identify 3-5 plausible
 Spawn one Explore agent per hypothesis in a **single message** (parallel execution):
 
 ```
-Task(subagent_type="Explore", name="investigator-a"):
+Task(subagent_type="Explore"):
 "Investigate this bug: {bug_description}
 
 Hypothesis: {hypothesis A description}
@@ -67,15 +67,15 @@ Return a structured report:
 - Evidence AGAINST: [list with file:line refs]
 - Key finding: {one-sentence summary}"
 
-Task(subagent_type="Explore", name="investigator-b"):
+Task(subagent_type="Explore"):
 "Investigate this bug: {bug_description}
 
 Hypothesis: {hypothesis B description}
 Focus area: {specific code area, mechanism, or condition}
 
 [same steps and return format]"
 
-Task(subagent_type="Explore", name="investigator-c"):
+Task(subagent_type="Explore"):
 "Investigate this bug: {bug_description}
 
 Hypothesis: {hypothesis C description}

src/cli/plugins.ts

@@ -28,49 +28,49 @@ export const DEVFLOW_PLUGINS: PluginDefinition[] = [
   },
   {
     name: 'devflow-specify',
-    description: 'Interactive feature specification',
+    description: 'Interactive feature specification - creates well-defined GitHub issues',
     commands: ['/specify'],
     agents: ['skimmer', 'synthesizer'],
     skills: ['agent-teams'],
   },
   {
     name: 'devflow-implement',
-    description: 'Complete task implementation workflow',
+    description: 'Complete task implementation workflow with exploration, planning, and coding',
     commands: ['/implement'],
     agents: ['git', 'skimmer', 'synthesizer', 'coder', 'simplifier', 'scrutinizer', 'shepherd', 'validator'],
     skills: ['agent-teams', 'implementation-patterns', 'knowledge-persistence', 'self-review'],
   },
   {
     name: 'devflow-code-review',
-    description: 'Comprehensive code review',
+    description: 'Comprehensive code review with parallel specialized agents',
     commands: ['/code-review'],
     agents: ['git', 'reviewer', 'synthesizer'],
     skills: ['agent-teams', 'architecture-patterns', 'complexity-patterns', 'consistency-patterns', 'database-patterns', 'dependencies-patterns', 'documentation-patterns', 'knowledge-persistence', 'performance-patterns', 'regression-patterns', 'review-methodology', 'security-patterns', 'test-patterns'],
   },
   {
     name: 'devflow-resolve',
-    description: 'Process and fix review issues',
+    description: 'Process and fix code review issues with risk assessment',
     commands: ['/resolve'],
     agents: ['git', 'resolver', 'simplifier'],
     skills: ['agent-teams', 'implementation-patterns', 'knowledge-persistence', 'security-patterns'],
   },
   {
     name: 'devflow-debug',
-    description: 'Debugging with competing hypotheses',
+    description: 'Debugging workflows with competing hypothesis investigation using agent teams',
     commands: ['/debug'],
-    agents: ['git'],
+    agents: ['git', 'synthesizer'],
     skills: ['agent-teams', 'git-safety', 'knowledge-persistence'],
   },
   {
     name: 'devflow-self-review',
-    description: 'Self-review workflow (Simplifier + Scrutinizer)',
+    description: 'Self-review workflow: Simplifier + Scrutinizer for code quality',
     commands: ['/self-review'],
     agents: ['simplifier', 'scrutinizer', 'validator'],
     skills: ['self-review', 'core-patterns'],
   },
   {
     name: 'devflow-ambient',
-    description: 'Ambient mode — auto-loads relevant skills based on each prompt',
+    description: 'Ambient mode — auto-loads relevant skills for every prompt',
     commands: ['/ambient'],
     agents: [],
     skills: ['ambient-router'],