Skip to content

Refine 'Tools as Primitives' principle with spectrum-based guidance #72

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
kieranklaassen wants to merge 1 commit into
base: main
Choose a base branch
from
+340 −100
Open

Refine 'Tools as Primitives' principle with spectrum-based guidance #72

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .claude-plugin/marketplace.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,8 +11,8 @@
"plugins": [
{
"name": "compound-engineering",
"description": "AI-powered development tools that get smarter with every use. Make each unit of engineering work easier than the last. Includes 27 specialized agents, 20 commands, and 12 skills.",
"version": "2.21.0",
"description": "AI-powered development tools that get smarter with every use. Make each unit of engineering work easier than the last. Includes 27 specialized agents, 21 commands, and 13 skills.",
"version": "2.23.2",
"author": {
"name": "Kieran Klaassen",
"url": "https://github.com/kieranklaassen",
Expand Down
2 changes: 1 addition & 1 deletion plugins/compound-engineering/.claude-plugin/plugin.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "compound-engineering",
"version": "2.23.1",
"version": "2.23.2",
"description": "AI-powered development tools. 27 agents, 21 commands, 13 skills, 2 MCP servers for code review, research, design, and workflow automation.",
"author": {
"name": "Kieran Klaassen",
Expand Down
21 changes: 21 additions & 0 deletions plugins/compound-engineering/CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,27 @@ All notable changes to the compound-engineering plugin will be documented in thi
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [2.23.2] - 2026-01-08

### Changed

- **`agent-native-architecture` skill** - Major refinement of the "Tools as Primitives" principle
- Added **Primitives** vocabulary section defining key terms (Pure Primitive, Guided Primitive, Domain Tool, Orchestrated Action, Sub-Agent, Harness)
- Replaced binary "primitives vs workflows" with spectrum-based guidance
- Added **Decision Framework**: "Who should own this decision?" (business rule → code, tool-specific → description, context-dependent → prompt, agent judgment → neither)
- Added **"What IS a Tool?"** philosophical section clarifying that tool calls are mechanisms, not design constraints
- Added **JIT Context Injection** pattern: tool descriptions as modular prompting that travels with tools
- Added **Harness Pattern** for business invariants that must always execute together
- Refined anti-patterns section with "when it's wrong" vs "when it's fine" guidance
- Applied pragmatic writing style with concrete story openings throughout
- Updated architecture checklist with new tool design checkboxes

### Summary

- 27 agents, 21 commands, 13 skills, 2 MCP servers

---

## [2.23.1] - 2026-01-08

### Changed
Expand Down
Loading