From eb5aed9d51b91f68e3e57ef787f522aa57365629 Mon Sep 17 00:00:00 2001 From: Tym Rabchuk Date: Thu, 9 Apr 2026 20:10:22 -0400 Subject: [PATCH] Fix stale command references in README and status.md Rebase during PR 5 reverted README command tables to old 24-command format. This restores the 8-command + 18-workflow structure: - README: Replace old command tables with 8 commands + 18 workflows - README: Fix quick-start examples, agent usage table, arch diagram - status.md: Update example output to show 8 remaining commands --- README.md | 91 +++++++++++++++++++--------------------------- commands/status.md | 17 +++------ 2 files changed, 44 insertions(+), 64 deletions(-) diff --git a/README.md b/README.md index 9d49bdd..d18ceeb 100644 --- a/README.md +++ b/README.md @@ -68,7 +68,7 @@ These handle concerns devkit doesn't — methodology, specialized reviews, and c ```bash brew install rtk # Token optimization (60-90% savings on Bash output) -brew install ast-grep # AST-based repo mapping (/devkit:repo-map) +brew install ast-grep # AST-based repo mapping (devkit workflow run repo-map) ``` ### Verify @@ -93,66 +93,51 @@ This shows which CLIs are installed, which agents are available, and which comma # Slash commands for complex workflows: /devkit:pr-ready # Full PR pipeline /tri:review # Multi-agent code review -/self:lint --lint "npm run lint" # Fix all lint errors +devkit workflow run self-lint "npm run lint" # Fix all lint errors ``` --- ## Commands -### Development Lifecycle - -| Command | What it does | -|---|---| -| `/devkit:feature` | Brainstorm, plan, implement, test, lint, review | -| `/devkit:bugfix` | Reproduce, diagnose, fix, regression test, verify | -| `/devkit:refactor` | Analyze smells, plan, restructure, verify nothing broke | -| `/devkit:decompose` | Break a goal into a task DAG, assign agents, execute in order | - -### Shipping - -| Command | What it does | -|---|---| -| `/devkit:pr-ready` | Lint, test, security, changelog, create PR | -| `/devkit:pr-monitor` | Watch CI, fetch reviewer comments, fix iteratively, push | - -### Self-Improvement Loops - -Automated propose / measure / keep or discard / repeat cycles. - -| Command | What it does | -|---|---| -| `/self:improve` | General-purpose loop with custom metric gate | -| `/self:test` | Generate tests until coverage target is hit | -| `/self:lint` | Fix lint/type errors until zero remain | -| `/self:perf` | Hypothesis-driven perf investigation | -| `/self:migrate` | Incremental migration (JS->TS, etc.) with test gate | -| `/self:audit` | Measure everything, rank hypotheses, report only | -| `/devkit:autoloop` | Autonomous improvement loop — audit, fix, measure, repeat | - -### Multi-Agent (Claude + Codex + Gemini) - -Runs with whatever agents are available. Claude always runs. +8 tab-completable slash commands. All other workflows are context-activated via skills or invoked directly with `devkit workflow run `. | Command | What it does | |---|---| | `/tri:review` | Code review from 1-3 agents, consolidated report | -| `/tri:dispatch` | Send any task to all agents, compare outputs | | `/tri:debug` | Independent root-cause analysis from each agent | -| `/tri:test-gen` | Generate tests from multiple agents, merge coverage | | `/tri:security` | Security audit with severity-ranked consensus | - -### Utility - -| Command | What it does | -|---|---| -| `/devkit:repo-map` | AST-based symbol index with dependency graph | -| `/devkit:deep-research` | Competing hypotheses, disconfirmation, evidence matrix | -| `/devkit:audit` | Dependencies, vulnerabilities, licenses, lint, security | +| `/devkit:pr-ready` | Lint, test, security, changelog, create PR | +| `/devkit:pr-monitor` | Watch CI, fetch reviewer comments, fix iteratively, push | | `/devkit:workflow` | Run user-defined YAML workflows | | `/devkit:status` | Health check | | `/devkit:setup-rules` | Install language-specific coding rules to `~/.claude/rules/` | +### Workflows (via `devkit workflow run `) + +All 18 YAML workflows can be invoked directly. Skills auto-activate for common triggers (e.g., "research X", "fix this bug", "add a feature"). + +| Workflow | What it does | +|---|---| +| `feature` | Brainstorm, plan, implement, test, lint, review | +| `bugfix` | Reproduce, diagnose, fix, regression test, verify | +| `refactor` | Analyze smells, plan, restructure, verify nothing broke | +| `research` | Clarify, decompose, parallel search, corroborate, synthesize | +| `deep-research` | ACH: hypotheses, disconfirmation, evidence matrix | +| `self-test` | Run tests, fix failures, repeat until passing | +| `self-lint` | Run linter, fix violations, repeat until clean | +| `self-perf` | Benchmark, optimize, repeat until target met | +| `self-improve` | Run metric, fix issues, repeat until passing | +| `self-migrate` | Migrate code incrementally with test gate | +| `self-audit` | Measure codebase, rank improvements by evidence | +| `autoloop` | Autonomous audit/fix/measure/keep-or-revert loop | +| `audit` | Dependencies, vulnerabilities, licenses, lint, security | +| `pr-ready` | Full PR preparation pipeline | +| `tri-review` | Multi-agent code review | +| `tri-debug` | Multi-agent debugging | +| `tri-security` | Multi-agent security audit | +| `tri-dispatch` | Send any task to multiple agents | + --- ## Skills @@ -197,12 +182,12 @@ Coding principles (`clean-code`, `dry`, `yagni`, `dont-reinvent`, `executing`, ` | Agent | Model | Used by | |---|---|---| -| `reviewer` | Opus | tri:review | -| `researcher` | Sonnet | tri:dispatch, tri:debug, onboard | -| `improver` | Opus | self:*, tri:dispatch | -| `test-writer` | Sonnet | test-gen, self:test, tri:test-gen | -| `documenter` | Haiku | doc-gen | -| `security-auditor` | Opus | tri:security, pr-ready, audit | +| `reviewer` | Opus | tri-review workflow, feature workflow | +| `researcher` | Sonnet | research, deep-research, tri-debug workflows | +| `improver` | Opus | self-improve, self-lint, self-perf, refactor workflows | +| `test-writer` | Sonnet | self-test, tri-test-gen workflows | +| `documenter` | Haiku | doc-gen skill | +| `security-auditor` | Opus | tri-security, pr-ready, audit workflows | All agents run in worktree isolation. @@ -291,12 +276,12 @@ Workflow Engine (Go binary) │ └── Budget check every step └── Commit, report, clean up -Multi-Agent (tri:* commands) +Multi-Agent (tri-* workflows) ├── Claude → native background agent (always) ├── Codex → plugin or CLI (optional) └── Gemini → plugin or CLI (optional) -Self-Improvement (self:* commands) +Self-Improvement (self-* workflows) └── Loop: propose → measure → keep/revert → repeat ``` diff --git a/commands/status.md b/commands/status.md index fb10adb..e4d813c 100644 --- a/commands/status.md +++ b/commands/status.md @@ -67,18 +67,13 @@ List all commands, marking which ones need external CLIs: | Command | Status | Notes | |---------|--------|-------| | /tri:review | ⚠ partial | 2/3 agents available (no gemini) | -| /tri:dispatch | ⚠ partial | 2/3 agents available | -| /self:improve | ✓ ready | Claude-only | -| /self:test | ✓ ready | Claude-only | -| /self:lint | ✓ ready | Claude-only | -| /self:perf | ✓ ready | Claude-only | -| /self:migrate | ✓ ready | Claude-only | -| /devkit:test-gen | ✓ ready | Claude-only | -| /devkit:doc-gen | ✓ ready | Claude-only | +| /tri:debug | ⚠ partial | 2/3 agents available | +| /tri:security | ⚠ partial | 2/3 agents available | | /devkit:pr-ready | ✓ ready | Uses gh for PR creation | -| /devkit:onboard | ✓ ready | Claude-only | -| /devkit:changelog | ✓ ready | Claude-only | -| /devkit:workflow | ✓ ready | Claude-only | +| /devkit:pr-monitor | ✓ ready | Uses gh for PR monitoring | +| /devkit:workflow | ✓ ready | Runs YAML workflows via Go engine | +| /devkit:status | ✓ ready | This command | +| /devkit:setup-rules | ✓ ready | One-time setup | ### Agents | Agent | Model | Isolation | Status |