From ac859dc757105a5bd761a5f2933f9a9891d324ba Mon Sep 17 00:00:00 2001 From: Dean Sharon Date: Sun, 15 Mar 2026 18:13:48 +0200 Subject: [PATCH] =?UTF-8?q?fix:=20metadata=20and=20documentation=20accurac?= =?UTF-8?q?y=20=E2=80=94=205=20quick=20wins?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Add missing YAML frontmatter to audit-claude command (H3) - Fix subagent_type from "general-purpose" to "Synthesizer" in debug.md (H4) - Correct plugin count from "9 core + 8 optional" to "8 core + 9 optional" in CLAUDE.md (H6) - Add skills frontmatter to Skimmer (knowledge-persistence) and Simplifier (core-patterns) agents (M2) - Catalog ambient-router, search-first, and test-driven-development in skills-architecture.md (M8) --- CLAUDE.md | 4 ++-- docs/reference/skills-architecture.md | 3 +++ plugins/devflow-audit-claude/commands/audit-claude.md | 4 ++++ plugins/devflow-debug/commands/debug.md | 2 +- shared/agents/simplifier.md | 1 + shared/agents/skimmer.md | 1 + 6 files changed, 12 insertions(+), 3 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 7b5a476..73ac341 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -12,7 +12,7 @@ DevFlow enhances Claude Code with intelligent development workflows. Modificatio ## Architecture Overview -Plugin marketplace with 17 plugins (9 core + 8 optional language/ecosystem), each following the Claude plugins format (`.claude-plugin/plugin.json`, `commands/`, `agents/`, `skills/`). +Plugin marketplace with 17 plugins (8 core + 9 optional language/ecosystem), each following the Claude plugins format (`.claude-plugin/plugin.json`, `commands/`, `agents/`, `skills/`). | Plugin | Purpose | Teams Variant | |--------|---------|---------------| @@ -46,7 +46,7 @@ Commands with Teams Variant ship as `{name}.md` (parallel subagents) and `{name} devflow/ ├── shared/skills/ # 32 skills (single source of truth) ├── shared/agents/ # 10 shared agents (single source of truth) -├── plugins/devflow-*/ # 17 plugins (9 core + 8 optional language/ecosystem) +├── plugins/devflow-*/ # 17 plugins (8 core + 9 optional language/ecosystem) ├── docs/reference/ # Detailed reference documentation ├── scripts/ # Helper scripts (statusline, docs-helpers) │ └── hooks/ # Working Memory + ambient hooks (stop, session-start, pre-compact, ambient-prompt) diff --git a/docs/reference/skills-architecture.md b/docs/reference/skills-architecture.md index 4a5a7b4..3d9a212 100644 --- a/docs/reference/skills-architecture.md +++ b/docs/reference/skills-architecture.md @@ -21,6 +21,7 @@ Shared patterns used by multiple agents. | `github-patterns` | GitHub API patterns (rate limiting, PR comments, issues, releases) | Git | | `implementation-patterns` | CRUD, API endpoints, events, config, logging | Coder, Resolver | | `agent-teams` | Agent Teams patterns for peer-to-peer collaboration, debate, consensus | /code-review, /implement, /debug | +| `ambient-router` | Intent classification and proportional skill loading for ambient mode | `/ambient` command | | `knowledge-persistence` | Record/load architectural decisions and pitfalls to `.memory/knowledge/` | /implement, /code-review, /resolve, /debug, /specify, /self-review | ### Tier 1b: Pattern Skills @@ -47,6 +48,8 @@ Listed in Claude Code's skill catalog. May auto-invoke based on description matc | Skill | Purpose | Agent Refs | |-------|---------|------------| | `input-validation` | Boundary validation enforcement | Coder | +| `search-first` | Research-before-building enforcement for utility code | Coder | +| `test-driven-development` | RED-GREEN-REFACTOR cycle enforcement | Coder | ### Tier 3: Domain-Specific Skills diff --git a/plugins/devflow-audit-claude/commands/audit-claude.md b/plugins/devflow-audit-claude/commands/audit-claude.md index cfab975..a991b6b 100644 --- a/plugins/devflow-audit-claude/commands/audit-claude.md +++ b/plugins/devflow-audit-claude/commands/audit-claude.md @@ -1,3 +1,7 @@ +--- +description: Audit CLAUDE.md files against Anthropic best practices +--- + # Command: /audit-claude ## Description diff --git a/plugins/devflow-debug/commands/debug.md b/plugins/devflow-debug/commands/debug.md index 4088be6..05f64ec 100644 --- a/plugins/devflow-debug/commands/debug.md +++ b/plugins/devflow-debug/commands/debug.md @@ -91,7 +91,7 @@ Focus area: {specific code area, mechanism, or condition} Once all investigators return, spawn a Synthesizer agent to aggregate findings: ``` -Task(subagent_type="general-purpose", name="synthesizer"): +Task(subagent_type="Synthesizer"): "You are a root cause analyst. Synthesize these investigation reports: {paste all investigator reports} diff --git a/shared/agents/simplifier.md b/shared/agents/simplifier.md index 5c9c302..22b9985 100644 --- a/shared/agents/simplifier.md +++ b/shared/agents/simplifier.md @@ -1,6 +1,7 @@ --- name: Simplifier description: Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality. Focuses on recently modified code unless instructed otherwise. +skills: core-patterns model: inherit --- diff --git a/shared/agents/skimmer.md b/shared/agents/skimmer.md index c0c896f..0bf1740 100644 --- a/shared/agents/skimmer.md +++ b/shared/agents/skimmer.md @@ -1,6 +1,7 @@ --- name: Skimmer description: Codebase orientation using skim to identify relevant files, functions, and patterns for a feature or task +skills: knowledge-persistence model: inherit ---