Commit Graph

36 Commits

Author SHA1 Message Date
John Lamb
8279c8ddc3 Merge upstream origin/main into local fork
Accept upstream ce-review pipeline rewrite, retire 4 overlapping review
agents, add 5 local agents as conditional personas. Accept skill renames,
port local additions. Remove Rails/Ruby skills per FastAPI pivot.

36 agents, 48 skills, 7 commands.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-25 13:32:26 -05:00
John Lamb
0b26ab8fe6 Merge upstream origin/main with local fork additions preserved
Accept upstream's ce-review pipeline rewrite (6-stage persona-based
architecture with structured JSON, confidence gating, three execution
modes). Retire 4 overlapping review agents (security-sentinel,
performance-oracle, data-migration-expert, data-integrity-guardian)
replaced by upstream equivalents. Add 5 local review agents as
conditional personas in the persona catalog (kieran-python, tiangolo-
fastapi, kieran-typescript, julik-frontend-races, architecture-
strategist).

Accept upstream skill renames (file-todos→todo-create, resolve_todo_
parallel→todo-resolve), port local Assessment and worktree constraint
additions to new files. Merge best-practices-researcher with upstream
platform-agnostic discovery + local FastAPI mappings. Remove Rails/Ruby
skills (dhh-rails-style, andrew-kane-gem-writer, dspy-ruby) per fork's
FastAPI pivot.

Component counts: 36 agents, 48 skills, 7 commands.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-25 13:28:22 -05:00
Trevin Chow
7c5ff445e3 feat: promote ce:review-beta to stable ce:review (#371) 2026-03-24 21:00:38 -07:00
Trevin Chow
4e3af07962 feat: optimize ce:compound speed and effectiveness (#370) 2026-03-24 20:12:19 -07:00
John Lamb
3e3d122a4b feat: add design-conformance-reviewer agent, weekly-shipped skill, fix counts and worktree constraints
- Add design-conformance-reviewer agent for reviewing code against design docs
- Add weekly-shipped skill for stakeholder summaries from Jira/GitHub
- Fix component counts across marketplace.json, plugin.json, and README
- Add worktree constraints to ce-review and resolve_todo_parallel skills
- Fix typo in resolve_todo_parallel SKILL.md

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-24 09:16:11 -05:00
Trevin Chow
18d22afde2 feat: redesign document-review skill with persona-based review (#359) 2026-03-24 01:51:22 -07:00
Trevin Chow
e932276866 feat: add ce:review-beta with structured persona pipeline (#348) 2026-03-23 21:49:04 -07:00
Trevin Chow
affba1a6a0 feat: improve reproduce-bug skill, sync agent-browser, clean up redundant skills (#333) 2026-03-21 19:49:12 -07:00
Trevin Chow
4087e1df82 feat: fix skill transformation pipeline across all targets (#334) 2026-03-21 19:45:20 -07:00
Trevin Chow
1c28d03214 feat: improve repo-research-analyst by adding a structured technology scan (#327) 2026-03-20 15:13:31 -07:00
Trevin Chow
f47f829d81 feat: migrate repo releases to manual release-please (#293) 2026-03-17 17:58:13 -07:00
Trevin Chow
0fc6717542 feat: add issue-grounded ideation mode to ce:ideate
New issue-intelligence-analyst agent that fetches GitHub issues via
gh CLI, clusters by root-cause themes, and returns structured analysis
with trend direction, confidence scores, and source mix. Designed for
both ce:ideate integration and standalone use.

Agent design:
- Priority-aware fetching with label scanning for focus targeting
- Truncated bodies (500 chars) in initial fetch to avoid N+1 calls
- Single gh call per fetch, no pipes or scripts (avoids permission spam)
- Built-in --jq for all field extraction and filtering
- Mandatory structured output with self-check checklist
- Accurate counts from actual data, not assumptions
- Closed issues as recurrence signal only, not standalone evidence

ce:ideate gains:
- Issue-tracker intent detection in Phase 0.2
- Conditional agent dispatch in Phase 1 (parallel with existing scans)
- Dynamic frame derivation from issue clusters in Phase 2
- Hybrid strategy: cluster-derived frames + default padding when < 4
- Resume awareness distinguishing issue vs non-issue ideation
- Numbered table format for rejection summary in ideation artifacts
2026-03-16 23:18:24 -07:00
Trevin Chow
b290690655 fix: research agents prefer native tools over shell for repo exploration
Research agents (repo-research-analyst, git-history-analyzer,
best-practices-researcher, framework-docs-researcher) were using
shell commands like find, rg, cat, and chained pipelines for routine
codebase exploration. This triggers permission prompts in Claude Code
and degrades the user experience when these agents run as sub-agents.

Updated all research agents with platform-agnostic tool selection
guidance that prefers native file-search/glob, content-search/grep,
and file-read tools over shell equivalents. Shell is now reserved for
commands with no native equivalent (ast-grep, bundle show, git).
Git-history-analyzer additionally limits shell to one simple git
command per call with no chaining or piping.

Added tool selection rules to AGENTS.md so future agents follow
the same pattern by default.
2026-03-16 22:25:00 -07:00
John Lamb
6aec16b9cc Merge upstream origin/main into local fork
163 upstream commits merged. All local skills, agents, and commands
preserved. Metadata recalculated: 30 agents, 56 skills, 7 commands.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-16 10:46:52 -05:00
John Lamb
eb96e32c58 Merge upstream v2.40.0 with local fork additions preserved
Incorporates 163 upstream commits (origin/main) while preserving all
local skills, agents, and commands. Metadata descriptions updated to
reflect actual component counts (30 agents, 56 skills, 7 commands).
file-todos/SKILL.md merged with both upstream command rename and local
assessment fields.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-16 10:45:33 -05:00
Trevin Chow
30852b7293 fix(agents): update learnings-researcher model from haiku to inherit
Replaces hardcoded haiku model with inherit so the agent uses the
caller's model instead of being pinned to an older/smaller model.

Supersedes #249
2026-03-12 23:39:19 -07:00
Matt Van Horn
4fc70939eb refactor(agents): remove duplicate every-style-editor agent
The every-style-editor agent file was a duplicate of the existing
every-style-editor skill. Agent files are eagerly loaded into the
Task tool definition on every API call (~100-200 tokens each),
while skills are lazy-loaded only when invoked. Removing the
duplicate saves tokens and eliminates potential runtime errors
when the agent is invoked via Task tool instead of Skill tool.

Changes:
- Delete agents/workflow/every-style-editor.md (skill version
  in skills/every-style-editor/ already exists)
- Update README.md workflow agent count from 5 to 4
- Update plugin.json agent counts from 29 to 28

Fixes #156

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-08 12:45:27 -07:00
Kieran Klaassen
64c9b326a8 feat: Update agent references from workflows:* to ce:*
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-01 15:26:17 -08:00
John Lamb
d306c49179 Merge upstream v2.34.0 with FastAPI pivot (v2.35.0)
Incorporate 42 upstream commits while preserving the Ruby/Rails → Python/FastAPI
pivot. Each of the 24 conflicting files was individually triaged.

Added: tiangolo-fastapi-reviewer, python-package-readme-writer, lint (Python),
pr-comments-to-todos, fastapi-style skill, python-package-writer skill.

Removed: 3 design agents, ankane-readme-writer, dhh-rails-reviewer,
kieran-rails-reviewer, andrew-kane-gem-writer, dhh-rails-style, dspy-ruby.

Merged: best-practices-researcher, kieran-python-reviewer, resolve_todo_parallel,
file-todos, workflows/review (pressure test), workflows/plan (reviewer names).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-16 17:34:54 -06:00
Kieran Klaassen
f744b797ef Reduce context token usage by 79% — fix silent component exclusion (#161)
* Update create-agent-skills to match 2026 official docs, add /triage-prs command

- Rewrite SKILL.md to document that commands and skills are now merged
- Add new frontmatter fields: disable-model-invocation, user-invocable, context, agent
- Add invocation control table and dynamic context injection docs
- Fix skill-structure.md: was incorrectly recommending XML tags over markdown headings
- Update official-spec.md with complete 2026 specification
- Add local /triage-prs command for PR triage workflow
- Add PR triage plan document

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* [2.31.0] Reduce context token usage by 79%, include recent community contributions

The plugin was consuming 316% of Claude Code's description character budget
(~50,500 chars vs 16,000 limit), causing components to be silently excluded.
Now at 65% (~10,400 chars) with all components visible.

Changes:
- Trim all 29 agent descriptions (move examples to body)
- Add disable-model-invocation to 18 manual commands
- Add disable-model-invocation to 6 manual skills
- Include recent community contributions in changelog
- Fix component counts (29 agents, 24 commands, 18 skills)

Contributors: @trevin, @terryli, @robertomello, @zacwilliams,
@aarnikoskela, @samxie, @davidalley

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Fix: keep disable-model-invocation off commands called by /lfg, rename xcode-test

- Remove disable-model-invocation from test-browser, feature-video,
  resolve_todo_parallel — these are called programmatically by /lfg and /slfg
- Rename xcode-test to test-xcode to match test-browser naming convention

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Fix: keep git-worktree skill auto-invocable (used by /workflows:work)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat(converter): support disable-model-invocation frontmatter

Parse disable-model-invocation from command and skill frontmatter.
Commands/skills with this flag are excluded from OpenCode command maps
and Codex prompt/skill generation, matching Claude Code behavior where
these components are user-only invocable.

Bump converter version to 0.3.0.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-08 22:28:51 -06:00
Kieran Klaassen
2429f59529 [2.29.0] Add schema-drift-detector agent
- New agent: schema-drift-detector for catching unrelated schema.rb changes in PRs
- Compares schema.rb diff against migrations in the PR
- Detects columns, indexes, tables from other branches
- Provides clear fix instructions
- Essential pre-merge check for database changes

Also updates component counts in README (were outdated)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-04 21:17:06 -08:00
Trevor Hinesley
9f93f54b1f Improvement: protect plan files from review deletion (#142)
* fix: protect plan and solution files from review/resolve deletion

The review/resolve pipeline could flag docs/plans/*.md and
docs/solutions/*.md files for deletion, contradicting /workflows:work
which treats them as living documents.

Adds protection at three layers:
- review.md: Protected Artifacts section + synthesis filter
- code-simplicity-reviewer.md: YAGNI exception for pipeline artifacts
- resolve_todo_parallel.md: Safety check to skip/wont_fix such todos

Fixes #140

* fix: protect plan and solution files from review/resolve deletion

The review/resolve pipeline could flag docs/plans/*.md and
docs/solutions/*.md files for deletion, contradicting /workflows:work
which treats them as living documents.

Adds protection at four layers:
- review.md: Protected Artifacts section and synthesis filter
- code-simplicity-reviewer.md: YAGNI exception for pipeline artifacts
- resolve_todo_parallel.md: Skip and wont_fix todos targeting these paths
- git-history-analyzer.md: Note not to characterize them as unnecessary

Fixes #140

---------

Co-authored-by: Axl Ottle <axl@Axls-Virtual-Machine.local>
2026-02-02 14:26:30 -06:00
terry-li-hm
2eae6ad21a fix: remove hardcoded CORA project references (#121)
The plugin had hardcoded references to 'CORA' (Every's internal project)
throughout the documentation workflow, making it project-specific rather
than generic. This affected users trying to use the plugin on non-CORA
projects.

Changes:
- Replace 'cora-critical-patterns.md' with 'critical-patterns.md'
- Replace 'Which CORA module' with 'Which module or component'
- Replace 'CORA-Specific Resources' with 'Project-Specific Resources'
- Replace 'CORA-MODULES.md' with 'modules documentation'
- Replace 'CORA system' with 'System-wide' in templates
- Update cora-test-reviewer description to be generic

Files modified:
- learnings-researcher.md: Fixed critical patterns file reference
- compound-docs/SKILL.md: Removed module and filename hardcoding
- compound-docs/assets/*.md: Generalized template references
- workflows/compound.md: Changed 'CORA schema' to 'solution schema'
- workflows/work.md: Made test reviewer description generic

This makes the plugin truly project-agnostic as advertised.
2026-01-24 15:08:43 -06:00
Trevin Chow
ebbf43db62 feat(agents): add learnings-researcher for institutional knowledge (#106)
* fix(compound-docs): correct severity enum in validation example

The example error message referenced [critical, moderate, minor] but
the yaml-schema.md defines severity as [critical, high, medium, low].

* refactor(agents): standardize search tool recommendations

- Update repo-research-analyst to recommend built-in Grep tool instead
  of CLI rg (Grep uses ripgrep under the hood)
- Add TypeScript example for ast-grep alongside Ruby
- Update pattern-recognition-specialist to use built-in Grep tool
- Keep ast-grep for AST-based structural matching (language-specific)

* feat(agents): add learnings-researcher for institutional knowledge

Add new research agent that efficiently searches docs/solutions/ for
relevant past solutions before implementing features or fixing bugs.

Key features:
- Grep-first filtering strategy for efficiency with 100+ files
- Category-based narrowing to reduce search scope
- Parallel Grep calls with synonym support (OR patterns)
- Frontmatter-only reads before full document reads
- Always checks critical patterns file
- Uses haiku model for speed (structured task, recipe-based)

Integrates with /workflows:plan to run in parallel with
repo-research-analyst during local research phase.

Closes the loop on compound engineering: solutions documented via
/workflows:compound are now discoverable during planning.
2026-01-21 22:01:34 -06:00
jaredmorgenstern
17fe887ae7 feat(research): add mandatory API deprecation validation (#102)
Add deprecation/sunset checks to research agents before they recommend
external APIs, OAuth flows, or third-party services.

Changes:
- framework-docs-researcher: Added step 2 "Deprecation/Sunset Check"
  and updated Quality Standards
- best-practices-researcher: Added Phase 1.5 "MANDATORY Deprecation Check"

This prevents wasted development time on deprecated APIs. For example,
Google Photos Library API scopes were deprecated in March 2025, and
without validation, developers can spend hours debugging OAuth errors
on dead APIs.

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-21 16:27:31 -06:00
Trevin Chow
215445b5d0 Update hardcoded year references from 2025 to 2026 (#91)
- Update "current year is 2025" to 2026 in 4 research agents
- Update year ranges to 2024-2026 for content searches in deepen-plan
  and create-agent-skills workflows
- Change "currency" to "recency" for clarity in domain expertise skill
2026-01-20 18:33:37 -06:00
Kieran Klaassen
fa061405ed [2.26.3] Simplify design-iterator skill loading
Skills are auto-loaded in context, no need to manually cat files.
Simplified Step 0 to just reference loaded skill context.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 21:19:34 -08:00
Kieran Klaassen
be8e5f3ba2 [2.26.3] Design-iterator: auto-load skills, smaller iterations
- Added "Step 0: Discover and Load Design Skills (MANDATORY)"
- Discovers skills from all locations (plugin, global, project)
- Maps user context to relevant skills (Swiss → swiss-design, etc.)
- Changed iteration approach: ONE change per iteration, not 3-5
- Updated output format: focus on single most impactful change
- Added rule: "If you can't identify ONE clear improvement, stop"

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 21:18:54 -08:00
Kieran Klaassen
f3a098dc43 [2.26.1] Improve best-practices-researcher to check skills first
- Add Phase 1: Discover and read relevant SKILL.md files before going online
- Add skill mappings for common technologies (Rails, Frontend, AI, etc.)
- Only proceed to online research if skills don't provide enough coverage
- Prioritize skill-based guidance with clear source attribution
- Synthesize findings from skills + online sources

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-14 20:51:08 -08:00
Kieran Klaassen
31bd85f60b feat: Replace Playwright MCP with agent-browser CLI
- Remove Playwright MCP server from plugin
- Add new agent-browser skill for CLI-based browser automation
- Rename /playwright-test to /test-browser command
- Update all commands and agents to use agent-browser CLI
- Update README and plugin.json

agent-browser is Vercel's headless browser CLI designed for AI agents.
It uses ref-based selection (@e1, @e2) from accessibility snapshots
and provides a simpler CLI interface compared to MCP tools.

Key benefits:
- No MCP server required
- Simpler Bash-based workflow
- Same ref-based element selection
- Better for quick automation tasks

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-14 16:21:21 -08:00
CodePoet
fe3f19f220 Fix YAML parsing errors in agent description fields (#74) 2026-01-09 07:40:33 -08:00
Kieran Klaassen
60b06424e7 Add model: inherit to all agents
All 26 agents now use `model: inherit` so they match whatever model
the user has configured in their main conversation.

Only `lint` keeps `model: haiku` since it's a simple task.

Fixes #69

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 17:02:45 -08:00
Dan Shipper
1bc6bd9164 [2.18.0] Add Dynamic Capability Discovery and iCloud sync patterns (#62)
* [2.17.0] Expand agent-native skill with mobile app learnings

Major expansion of agent-native-architecture skill based on real-world
learnings from building the Every Reader iOS app.

New reference documents:
- dynamic-context-injection.md: Runtime app state in system prompts
- action-parity-discipline.md: Ensuring agents can do what users can
- shared-workspace-architecture.md: Agents and users in same data space
- agent-native-testing.md: Testing patterns for agent-native apps
- mobile-patterns.md: Background execution, permissions, cost awareness

Updated references:
- architecture-patterns.md: Added Unified Agent Architecture, Agent-to-UI
  Communication, and Model Tier Selection patterns

Enhanced agent-native-reviewer with comprehensive review process covering
all new patterns, including mobile-specific verification.

Key insight: "The agent should be able to do anything the user can do,
through tools that mirror UI capabilities, with full context about the
app state."

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* [2.18.0] Add Dynamic Capability Discovery and iCloud sync patterns

New patterns in agent-native-architecture skill:

- **Dynamic Capability Discovery** - For agent-native apps integrating with
  external APIs (HealthKit, HomeKit, GraphQL), use a discovery tool (list_*)
  plus a generic access tool instead of individual tools per endpoint.
  (Note: Static mapping is fine for constrained agents with limited scope.)

- **CRUD Completeness** - Every entity needs create, read, update, AND delete.

- **iCloud File Storage** - Use iCloud Documents for shared workspace to get
  free, automatic multi-device sync without building a sync layer.

- **Architecture Review Checklist** - Pushes reviewer findings earlier into
  design phase. Covers tool design, action parity, UI integration, context.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>
2025-12-25 12:03:07 -06:00
Kieran Klaassen
3c6aa1144b feat(agents): Add data-migration-expert and deployment-verification-agent
New review agents for validating database migrations and risky data deployments:

- data-migration-expert: Validates ID mappings match production reality, checks
  for swapped values, verifies rollback safety, provides SQL verification snippets

- deployment-verification-agent: Produces Go/No-Go deployment checklists with
  pre/post-deploy SQL queries, data invariants, rollback procedures, monitoring

Updated /workflows:review to conditionally run these agents when PRs contain
database migrations (db/migrate/*.rb), data backfills, or ID/enum mappings.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-15 11:26:55 -08:00
Kieran Klaassen
4ea9f52ba9 [2.10.0] Add agent-native reviewer and architecture skill
- Add agent-native-reviewer agent to verify features are agent-accessible
- Add agent-native-architecture skill for prompt-native design patterns
- Add agent-native-reviewer to /review command parallel agents
- Move agent-native skill to correct plugin folder
- Update component counts (25 agents, 12 skills)
- Include mermaid dark mode fix from PR #45

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-10 11:26:02 -08:00
Kieran Klaassen
6c5b3e40db [2.9.0] Rename plugin to compound-engineering
BREAKING: Plugin renamed from compounding-engineering to compound-engineering.
Users will need to reinstall with the new name:

  claude /plugin install compound-engineering

Changes:
- Renamed plugin directory and all references
- Updated documentation counts (24 agents, 19 commands)
- Added julik-frontend-races-reviewer to docs

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-02 17:32:16 -08:00