From c83d9413e0f5f142bb813ff71764a68333918cce Mon Sep 17 00:00:00 2001 From: Produtora MaxVision Date: Sat, 30 May 2026 20:58:43 -0300 Subject: [PATCH 1/2] docs(skills): add tool-design to inventory, reconcile counts to 101 Add `tool-design` to the Doctrine layer in DOMAIN-SKILLS.md and reconcile the native skill count across all docs to the filesystem-verified total of 101 (was inconsistently 100/72/76 across files). - DOMAIN-SKILLS.md: Doctrine 14->15, total 100->101, primary 72->73; new tool-design row (28 helpers unchanged; 73+28=101). - USER-GUIDE.md: "All 100 skills" -> 101; install-output "Skills: 100" -> 101. - COMMANDS.md: taxonomy "(100 skills)" -> "(101 skills)". - cheatsheets/CLAUDE-skills.md: "total = 76" -> 101 (76 was a stale undercount). - cheatsheets/CLAUDE.md: "100 skills nativas v0.1.0" -> "101 skills nativas". No version bump (stays 0.1.2). README Skills table left untouched (orchestration-core only). .maxvision/ specs untouched (historical). Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/COMMANDS.md | 2 +- docs/DOMAIN-SKILLS.md | 9 +++++---- docs/USER-GUIDE.md | 4 ++-- docs/cheatsheets/CLAUDE-skills.md | 2 +- docs/cheatsheets/CLAUDE.md | 2 +- 5 files changed, 10 insertions(+), 9 deletions(-) diff --git a/docs/COMMANDS.md b/docs/COMMANDS.md index 692c2f2..216b724 100644 --- a/docs/COMMANDS.md +++ b/docs/COMMANDS.md @@ -108,7 +108,7 @@ field) for the full per-command flag list. ## Related references - [`docs/PHASE-MODEL.md`](PHASE-MODEL.md) — how Spec → Discuss → Plan → Execute → Verify → Ship connect. -- [`docs/DOMAIN-SKILLS.md`](DOMAIN-SKILLS.md) — full skill taxonomy (100 skills). +- [`docs/DOMAIN-SKILLS.md`](DOMAIN-SKILLS.md) — full skill taxonomy (101 skills). - [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) — orchestrate 8-phase flow + FTS5 routing. - [`commands/.maxvision-source.json`](../commands/.maxvision-source.json) — upstream provenance (`produtoramaxvision/maxvision@beb7e05`, MIT). - [`CHANGELOG.md`](../CHANGELOG.md) — release notes including `commands/` directory introduction. diff --git a/docs/DOMAIN-SKILLS.md b/docs/DOMAIN-SKILLS.md index ffc6162..32307af 100644 --- a/docs/DOMAIN-SKILLS.md +++ b/docs/DOMAIN-SKILLS.md @@ -1,6 +1,6 @@ # Domain Skills — v0.1.0 -The plugin ships **100 skills** under [`skills/`](../skills/). The 72 primary +The plugin ships **101 skills** under [`skills/`](../skills/). The 73 primary skills are organized into four functional layers and documented below. The remaining 28 are internal helpers, review variants, and platform skills (e.g. `analyze-candidates`, `keyword-extractor`, `query-index`, `grill-me`, @@ -10,14 +10,14 @@ source is documented in [`LICENSES/THIRD-PARTY-NOTICES.md`](../LICENSES/THIRD-PA | Layer | Purpose | Count | | --- | --- | --- | -| Doctrine | Cross-cutting craft rules (planning, TDD, debugging, review) | 14 | +| Doctrine | Cross-cutting craft rules (planning, TDD, debugging, review) | 15 | | Workflow | Phase engine (spec → discuss → plan → execute → verify → ship) | 15 | | User-facing | Slash-command-style affordances for product flows | 23 | | Orchestration infra | Catalog, install/update, ephemeral lifecycle | 20 | | Internal helpers | Routing, scoring, sub-skills consumed by other skills | 28 | -| **Total** | | **100** | +| **Total** | | **101** | -## Doctrine layer (14 skills) +## Doctrine layer (15 skills) Cross-cutting craft rules — invoked by virtually every other skill via the `Skill()` tool. @@ -38,6 +38,7 @@ Cross-cutting craft rules — invoked by virtually every other skill via the | [`writing-skills`](../skills/writing-skills/SKILL.md) | Author and verify new skills before deployment. | | [`subagent-driven-development`](../skills/subagent-driven-development/SKILL.md) | Execute plans with independent tasks via subagents. | | [`using-maxvision`](../skills/using-maxvision/SKILL.md) | Bootstrap skill — establishes how to find and invoke other skills. | +| [`tool-design`](../skills/tool-design/SKILL.md) | Design the tools and MCP surfaces agents use effectively — tools-as-contracts, the consolidation principle, architectural reduction, description engineering, and MCP fully-qualified naming. Adapted from sickn33/antigravity-awesome-skills (CC BY 4.0). | ## Workflow layer (15 skills) diff --git a/docs/USER-GUIDE.md b/docs/USER-GUIDE.md index 12a6cd6..f4b3f0f 100644 --- a/docs/USER-GUIDE.md +++ b/docs/USER-GUIDE.md @@ -19,7 +19,7 @@ Expected output: ``` Installed maxvision@maxvision (v0.1.0) - Skills: 100 + Skills: 101 Subagents: 34 (33 maxvision-* specialists + 1 orchestrator) Commands: 40 Hooks: 8 events (SubagentStart, SessionEnd, SessionStart, PreToolUse, PostToolUse, ConfigChange, CwdChanged, InstructionsLoaded) @@ -253,7 +253,7 @@ Disable plugins you don't use. See | --- | --- | | Routing & FTS5 internals | [`docs/ARCHITECTURE.md`](ARCHITECTURE.md) | | Phase lifecycle contract | [`docs/PHASE-MODEL.md`](PHASE-MODEL.md) | -| All 100 skills | [`docs/DOMAIN-SKILLS.md`](DOMAIN-SKILLS.md) | +| All 101 skills | [`docs/DOMAIN-SKILLS.md`](DOMAIN-SKILLS.md) | | All 40 slash commands | [`docs/COMMANDS.md`](COMMANDS.md) | | Hook strategy | [`docs/HOOKS-CROSS-PLATFORM.md`](HOOKS-CROSS-PLATFORM.md) | | Precedence rules | [`docs/INSTRUCTION-PRIORITY.md`](INSTRUCTION-PRIORITY.md) | diff --git a/docs/cheatsheets/CLAUDE-skills.md b/docs/cheatsheets/CLAUDE-skills.md index dc8e4d5..6603952 100644 --- a/docs/cheatsheets/CLAUDE-skills.md +++ b/docs/cheatsheets/CLAUDE-skills.md @@ -20,7 +20,7 @@ Plugin v0.1.0 deixou de ser apenas orquestrador. Agora **absorve sob branding Ma | **R3** doctrine | produtoramaxvision/maxvision v5.1.0 | `brainstorming`, `writing-plans`, `executing-plans`, `subagent-driven-development`, `dispatching-parallel-agents`, `test-driven-development`, `systematic-debugging`, `verification-before-completion`, `requesting-code-review`, `receiving-code-review`, `finishing-a-development-branch`, `using-git-worktrees`, `writing-skills`, `using-maxvision` | | **R3** doctrine (adapted) | sickn33/antigravity-awesome-skills (CC BY 4.0) | `tool-design` | -Skills nativas total = **76**. Todas invocáveis via `/maxvision:`. Skills externas (impeccable, frontend-design, anthropic-skills, etc.) continuam suportadas — orchestrate detecta e instala on-demand. +Skills nativas total = **101**. Todas invocáveis via `/maxvision:`. Skills externas (impeccable, frontend-design, anthropic-skills, etc.) continuam suportadas — orchestrate detecta e instala on-demand. **Breaking change v0.6 → v1.0:** state directory `.planning/` → **`.maxvision/`**. diff --git a/docs/cheatsheets/CLAUDE.md b/docs/cheatsheets/CLAUDE.md index 78f99e9..8a8cd74 100644 --- a/docs/cheatsheets/CLAUDE.md +++ b/docs/cheatsheets/CLAUDE.md @@ -79,7 +79,7 @@ Skills R2 (phase engine: `discuss-phase`, `plan-phase`, `execute-phase`, `verify ## Skills (cheatsheet + orquestração) -Cheatsheet de skills (frontmatter completo 14 fields, settings oficiais `skillListingBudgetFraction`/`maxSkillDescriptionChars`/`skillOverrides`, 100 skills nativas v0.1.0, bin tooling, padrões de uso, guardrails): @~/.claude/CLAUDE-skills.md +Cheatsheet de skills (frontmatter completo 14 fields, settings oficiais `skillListingBudgetFraction`/`maxSkillDescriptionChars`/`skillOverrides`, 101 skills nativas, bin tooling, padrões de uso, guardrails): @~/.claude/CLAUDE-skills.md Para tarefas multi-domínio que precisam de subagent + skills coordenados (com checagem de versão upstream antes de usar), invocar `/maxvision:orchestrate ` — flow de 10 fases (P-1 → P10) com hooks ativos em 8 events. From f4781417ae5ca19ee1f809efb21ae3a839b24570 Mon Sep 17 00:00:00 2001 From: Produtora MaxVision Date: Sat, 30 May 2026 21:03:47 -0300 Subject: [PATCH 2/2] =?UTF-8?q?docs:=20address=20review=20=E2=80=94=20fix?= =?UTF-8?q?=20invocability=20claim=20+=20install-example=20version?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - CLAUDE-skills.md (CodeRabbit Major): "Todas invocáveis" was false after reconciling to 101 — 28 of the 101 are internal orchestrate helpers, not user-invocable. Clarify: 73 primary invocable + 28 internal helpers. - USER-GUIDE.md (Codex P3): install-example banner showed v0.1.0 alongside the 101-skill count; a 101-skill install is v0.1.2. Bump banner to v0.1.2. Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/USER-GUIDE.md | 2 +- docs/cheatsheets/CLAUDE-skills.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/USER-GUIDE.md b/docs/USER-GUIDE.md index f4b3f0f..db0721e 100644 --- a/docs/USER-GUIDE.md +++ b/docs/USER-GUIDE.md @@ -18,7 +18,7 @@ For the quick demo of the lazy-load behavior, see Expected output: ``` -Installed maxvision@maxvision (v0.1.0) +Installed maxvision@maxvision (v0.1.2) Skills: 101 Subagents: 34 (33 maxvision-* specialists + 1 orchestrator) Commands: 40 diff --git a/docs/cheatsheets/CLAUDE-skills.md b/docs/cheatsheets/CLAUDE-skills.md index 6603952..d2bb00c 100644 --- a/docs/cheatsheets/CLAUDE-skills.md +++ b/docs/cheatsheets/CLAUDE-skills.md @@ -20,7 +20,7 @@ Plugin v0.1.0 deixou de ser apenas orquestrador. Agora **absorve sob branding Ma | **R3** doctrine | produtoramaxvision/maxvision v5.1.0 | `brainstorming`, `writing-plans`, `executing-plans`, `subagent-driven-development`, `dispatching-parallel-agents`, `test-driven-development`, `systematic-debugging`, `verification-before-completion`, `requesting-code-review`, `receiving-code-review`, `finishing-a-development-branch`, `using-git-worktrees`, `writing-skills`, `using-maxvision` | | **R3** doctrine (adapted) | sickn33/antigravity-awesome-skills (CC BY 4.0) | `tool-design` | -Skills nativas total = **101**. Todas invocáveis via `/maxvision:`. Skills externas (impeccable, frontend-design, anthropic-skills, etc.) continuam suportadas — orchestrate detecta e instala on-demand. +Total de skills nativas = **101**. Destas, **73** são primárias (invocáveis via `/maxvision:`); as **28** restantes são helpers internos do fluxo orchestrate e não aparecem como comando user-invocable. Skills externas (impeccable, frontend-design, anthropic-skills, etc.) continuam suportadas — orchestrate detecta e instala on-demand. **Breaking change v0.6 → v1.0:** state directory `.planning/` → **`.maxvision/`**.