Commit Graph

127 Commits

Author SHA1 Message Date
Kieran Klaassen 90554cb118 Merge main into feat/compound-writing-plugin 2026-01-20 20:59:07 -08:00
Kieran Klaassen cb2485ff48 [2.27.0] Release with contributor shoutouts
## Added
- /workflows:plan - Interactive Q&A refinement phase (#88)

## Changed
- /workflows:work - Incremental commits and branch safety (#93)
- Fixed command count: 21 → 23 (corrected across all descriptions)

## Fixed
- dhh-rails-style skill - Broken markdown table (#96)
- Documentation year references 2025 → 2026 (#86, #91)

## Contributors 🙌
- @tmchow - Interactive Q&A, incremental commits, year updates (3 PRs!)
- @ashwin47 - Markdown table fix
- @rbouschery - Documentation year update

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-20 16:49:13 -08:00
Trevin Chow 6ab1f3c3ba feat: Add interactive Q&A refinement to /workflows:plan (#88)
Add two new phases to improve plan quality through user collaboration:

- Phase 0: Idea Refinement - Refines feature ideas through dialogue
  before running research agents. Asks questions one at a time,
  prefers multiple choice, focuses on purpose/constraints/success
  criteria. Skip option for detailed descriptions.

- Research Validation - After research completes, summarizes findings
  and validates alignment before drafting the full plan.

Both phases are optional and can be skipped, ensuring the workflow
remains lightweight while catching misunderstandings early.
2026-01-20 18:34:34 -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
Trevin Chow 87138ea974 feat(workflows:work): add incremental commits and branch safety (#93)
- Add branch detection at start of Setup Environment step
- Support continuing on existing feature branch or creating new
- Require explicit confirmation to commit to default branch
- Add incremental commit guidance with decision criteria table
- Include heuristic: "Can I write a meaningful commit message?"
- Generalize test commands to be framework-agnostic
2026-01-20 18:29:19 -06:00
Ashwin M 384b41648d Fix broken markdown table in dhh-rails-style skill (#96)
- Remove quotes from the routing table's Response column
- Add blank line after <routing> tag to allow markdown parsing

GitHub treats custom XML tags as HTML, requiring a blank line
before markdown content to render correctly.

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-20 18:27:43 -06:00
Robert Bouschery 42a31332cb Update current year in deepen-plan documentation (#86) 2026-01-19 22:51:14 -06:00
Kieran Klaassen c5783da496 Revert "chore: Remove coding-tutor plugin from marketplace"
This reverts commit d4d31c1614.
2026-01-19 20:24:00 -08:00
Kieran Klaassen 08eed310e5 chore: Revert to Every Marketplace naming
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-18 21:36:17 -08:00
Kieran Klaassen d4d31c1614 chore: Remove coding-tutor plugin from marketplace
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-18 21:32:07 -08:00
Kieran Klaassen d96608691b chore: Rename to compound-marketplace, update GitHub org
- Renamed every-marketplace to compound-marketplace
- Updated all EveryInc references to kieranklaassen
- Updated owner info in marketplace.json

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-18 21:30:37 -08:00
Kieran Klaassen 9671f48629 fix(workflows:work): Mark off checkboxes in plan as tasks complete
Added step to update original plan document with completed checkboxes
([ ] → [x]) after each task is finished. Keeps the plan as a living
document showing progress.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-18 20:52:15 -08:00
Kieran Klaassen 5f264e1f6b feat(compound-writing): Add local library search before web research
- /writing:plan now searches YOUR library first (always)
  - Past pieces in drafts/ and published/
  - Patterns in .claude/writing-knowledge/patterns/
  - Voice profiles in .claude/writing-knowledge/voices/
  - Scratchpad preferences
- Web research is now OPTIONAL (asked after library search)
- /writing:init creates proper library structure:
  - voices/, patterns/, pieces/, references/
  - published/ archive for finished work

Your past work compounds. External research is supplementary.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-16 22:18:28 -08:00
Kieran Klaassen 02255e0e62 feat(compound-writing): Add AI pattern detection and optional research
- Add ai-pattern-detector agent for detecting AI slop
- Add Vale rules: AISlop.yml (flagged words) and AIPhrases.yml (formulaic phrases)
- Update /writing:plan to ASK about research instead of auto-searching
- Bump version to 1.2.0 (now 8 agents, 8 commands, 9 skills)

Sources:
- https://en.wikipedia.org/wiki/Wikipedia:Signs_of_AI_writing
- https://aisdr.com/blog/words-to-avoid-so-you-dont-sound-like-ai/

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-16 22:15:43 -08:00
Kieran Klaassen 7aae227a58 chore(compound-writing): Bump version to 1.1.0
Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-16 22:02:23 -08:00
Kieran Klaassen 2108f5e6ac feat(compound-writing): Add Vale linting to every-style-editor skill
Add automated prose linting using Vale with 15 custom rules based on
Every's style guide. Rules are bundled inside the skill and called via
${CLAUDE_PLUGIN_ROOT}/skills/editing/every-style-editor/scripts/lint.sh

Vale rules included:
- OverusedWords (actually, very, just)
- PassiveVoice detection
- EmDash spacing (no spaces)
- OxfordComma enforcement
- ClickHere link text
- StartWithThis sentence starts
- WeHaveWeGet openings
- Cliches and jargon
- Percentages format
- CompanyPronouns (it not they)
- BoldEmphasis (use italics)
- Numbers (spell out 1-9)
- Adverbs (cuttable adverbs)
- Ellipsis spacing
- OverUnder (more/fewer than)

Updated /writing:review to run Vale via skill script.
Updated /writing:skill to optionally create Vale rules for new skills.

Sources:
- https://vale.sh/docs/
- https://vale.sh/docs/topics/styles/

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-16 21:42:10 -08:00
Kieran Klaassen 956e26cf5e docs(compound-writing): Add getting started sections to README
- Add "First Time Setup" section with /writing:init
- Add "Create Custom Skills" section with /writing:skill examples
- Reorganize Quick Start into logical sections
- Show both interactive and --minimal setup modes

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-16 21:24:04 -08:00
Kieran Klaassen 438d50042e fix(compound-writing): Enforce AskUserQuestion for all post-command options
- Add **MANDATORY** instruction to ensure tool is used, not plain text
- Convert all "What next?" sections to explicit YAML format
- Add "Based on selection" handlers for each option
- Reorder options to put "Open/View" first (review before action)
- Add "Open outline/draft/report" as primary action

Updated commands:
- writing-plan: Open outline → Deepen → Review → Start drafting
- writing-draft: Open draft → Review → Feedback → Refine
- writing-review: View report → View diff → Another pass → Compound
- writing-compound: View patterns → Review library → Start new
- writing-skill: View skill → Test → Refine → Create another
- writing-init: View setup → Start draft → Configure → Done

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-16 21:22:00 -08:00
Kieran Klaassen 69ef09ef60 feat(compound-writing): Add /writing:init command for interactive project setup
Interactive wizard that sets up compound-writing for a project:
- Creates .claude/writing-knowledge/ directories
- Initializes drafts/ with scratchpad and context files
- Creates/updates project CLAUDE.md with writing config
- Configures voice profile (from samples, description, or preset)
- Sets default style guide preference
- Optional .gitignore configuration

Supports --minimal mode for quick setup without questions.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-16 21:15:52 -08:00
Kieran Klaassen c4ab8cf0fa docs(compound-writing): Add writing-focused examples to /writing:skill
Update skill templates with concrete writing examples:

Voice skill:
- Before/after paragraph transformations
- Writing-specific anti-patterns (passive voice, jargon, hedging)

Domain skill:
- "Use when writing" context
- Writing frameworks and argument structures
- Example paragraphs with hooks and key phrases

Format skill:
- Full example post with annotation
- Hook examples (contrarian, story, number, bold claim)
- Writing techniques (front-load value, write for skimmers)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 21:07:48 -08:00
Kieran Klaassen 2119e055e4 feat(compound-writing): Add /writing:skill command for creating skills
New command to create voice, domain, and format skills automatically:

Usage:
- /writing:skill create voice "kieran-blog" samples/*.md
- /writing:skill create domain "saas-metrics"
- /writing:skill create format "linkedin"

Features:
- Parallel sub-agents research the skill type
- Reads existing skills as patterns/templates
- Generates complete skill structure with references
- Updates documentation automatically
- Commits the new skill

Total commands: 6 → 7

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 21:04:38 -08:00
Kieran Klaassen d8de2178c1 refactor(compound-writing): Organize skills by type taxonomy
Restructure skills directory following WRITING-ARCHITECTURE.md types:

skills/
├── core/           # Orchestration, memory, handoffs (4)
├── voice/          # All voices - can layer multiple (4)
│   ├── pragmatic-writing
│   ├── dhh-writing
│   ├── every-essay-guide
│   └── source-code-guide
├── editing/        # Review tools for post-draft (1)
│   └── every-style-editor
├── domain/         # Future: "10 Books Expert" skills
└── format/         # Future: platform-specific

Key insight: every-essay-guide and source-code-guide are VOICE skills
(they define how to write for a publication), while every-style-editor
is an EDITING tool (checks mechanical compliance after drafting).

Voice layering now supported - combine multiple voices per piece.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 20:59:22 -08:00
Kieran Klaassen ac3b7b4206 feat(compound-writing): Add source-code-guide skill
New skill for Every's Source Code series - essays on building in the AI era:
- Vision: Coin language, demonstrate workflows, shape industry thinking
- Source Code gradient (engineering → practice → philosophy → journey)
- 6 strategy principles (first-person authority, stakes, One Big Idea, ELI5)
- Sensibility and voice spectrum
- Opening patterns and structural templates
- 10 Source Code Commandments

Total skills: 8 → 9

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 20:54:28 -08:00
Kieran Klaassen 8d73682f1c feat(compound-writing): Add every-essay-guide skill
New skill capturing Every's essay philosophy and best practices:
- Worldview: optimistic realism, personal narrative + intellectual rigor
- 10 craft principles (hook, depth, facts before feelings, etc.)
- Hed/Dek/Opening paragraph playbook
- Pre-share checklist (8 quality scans)
- Quick reference card

Complements every-style-editor which handles mechanical editing.
Total skills: 7 → 8

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 20:52:27 -08:00
Kieran Klaassen 4f0cd07765 feat(compound-writing): Enhance all commands with explicit steps and skill loading
- Add "Skills to Load" sections to all 6 commands
- Number all steps explicitly (Step 1, Step 2, etc.)
- Add AskUserQuestion blocks for interactive decision points
- Mark brainstorming steps with (BRAINSTORM) labels
- Add quality checklists at the end of each command
- Include context notes handoff sections

Commands enhanced:
- /writing:plan (11 steps)
- /writing:draft (14 steps)
- /writing:review (15 steps)
- /writing:compound (12 steps)
- /writing:feedback (8 steps)
- /writing:knowledge (multiple actions with steps)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 20:47:21 -08:00
Kieran Klaassen ff05ff8776 docs(compound-writing): Add architecture framework and development guide
- WRITING-ARCHITECTURE.md: Complete 8-phase writing process framework
  - 18 agent roles mapped across phases
  - 5 skill types (core, voice, style guide, domain, format)
  - "10 books expert" pattern for domain expertise
  - Implementation roadmap

- CLAUDE.md: Development guide for plugin contributors
  - Current component inventory
  - Key concepts (two-agent, two-gate, strategies)
  - Adding new agents/skills/voices
  - Quality checklist

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

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-16 20:37:45 -08:00
Kieran Klaassen a1ce5cdced feat(compound-writing): Add scratchpad, context notes, and knowledge systems
New commands:
- /writing:feedback - Capture real-time preferences into scratchpad
- /writing:knowledge - Manage voice profiles, patterns, and references

New skills:
- scratchpad - Session memory for iterative refinement
- context-notes - Structured handoff protocol between commands

Updates:
- All commands now support context notes for seamless handoffs
- Draft ID management for persistent tracking across session
- Writing-orchestration skill integrated with scratchpad
- README updated with comprehensive workflow documentation

Component counts: 7 agents, 6 commands, 7 skills

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

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-16 19:26:22 -08:00
Kieran Klaassen 806d61af1f feat: Add compound-writing plugin for AI-powered writing tools
Create a new standalone plugin that applies compound engineering
principles to content creation. Just as compound-engineering captures
coding patterns, compound-writing captures voice, style, and editorial
preferences to accelerate writing.

Components:
- 7 specialized agents (source-researcher, fact-checker, structure-architect,
  voice-guardian, clarity-editor, publishing-optimizer, every-style-editor)
- 4 workflow commands (writing:plan, writing:draft, writing:review,
  writing:compound)
- 5 skills (pragmatic-writing, dhh-writing, voice-capture, every-style-editor,
  writing-orchestration)

Key features:
- Two-agent orchestration pattern (Orchestrator + Writer)
- Two-gate content readiness assessment
- 10 baseline writing strategies (always apply)
- 20+ situational strategies (select 3-4)
- Producer-critic loop with voice score targeting
- Quality checkpoints for draft verification
- Pattern capture system for compounding knowledge

Moved every-style-editor from compound-engineering to compound-writing
as it's more appropriate for writing workflows.

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 18:30:58 -08:00
Kieran Klaassen 7e625e3aab [2.26.4] Add Compound Engineered badge to /workflows:work PRs
- Updated PR template to include badge at bottom linking to plugin repo
- Added badge requirement to quality checklist
- Badge provides attribution and link to the plugin

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-15 22:11:53 -08: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 d1defc2e57 [2.26.2] Clarify test-browser to use agent-browser CLI only
- Add explicit warning: DO NOT use Chrome MCP tools
- Add Step 0: Verify agent-browser installation
- Add full CLI reference section
- Add Next.js route mapping patterns

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 21:04:26 -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 67eb8473a2 feat: add /lfg command for full autonomous engineering workflow
- Orchestrates: plan → deepen-plan → work → review → resolve todos → test-browser → feature-video
- Uses ralph-loop for autonomous completion
- Migrated from local command
- Updated to use /test-browser instead of /playwright-test

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

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-14 16:24:00 -08:00
Kieran Klaassen 43f6804b17 feat: add headed/headless mode option to test-browser
- Add Step 0 asking user if they want to watch browser tests
- Headed mode opens visible browser window
- Headless mode runs faster in background
- Bump version to 2.25.0

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

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-14 16:21:39 -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
mlissen 012a638d31 fix: Add explicit plan filename naming guidance (#76)
The /workflows:plan skill was producing inconsistent plan filenames
(sometimes gibberish, sometimes descriptive) because it lacked explicit
rules for converting issue titles to filenames.

Changes:
- Step 2: Added instruction to convert title to kebab-case filename
  with example transformation (feat: Add User Auth → feat-add-user-auth.md)
- Output Format: Replaced vague <issue_title> placeholder with clear
  pattern and good/bad examples

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 18:20:27 -06:00
Kieran Klaassen c06f7e889f feat(reproduce-bug): Add Playwright visual reproduction instructions
Enhanced /reproduce-bug command with browser automation:
- Added Phase 2 for visual bug reproduction using Playwright MCP
- Step-by-step guide for navigating to affected areas
- Screenshot capture at each reproduction step
- Console error checking
- User flow reproduction with clicks, typing, snapshots
- Better documentation structure with 4 clear phases

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

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-09 08:07:35 -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
Kieran Klaassen 8c4ed0d458 [2.23.0] Add /agent-native-audit command
- New command for comprehensive agent-native architecture review
- Launches 8 parallel sub-agents, one per core principle
- Principles: Action Parity, Tools as Primitives, Context Injection,
  Shared Workspace, CRUD Completeness, UI Integration, Capability
  Discovery, Prompt-Native Features
- Each agent produces specific score (X/Y format with percentage)
- Generates summary report with overall score and top 10 recommendations
- Supports single principle audit via argument

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-08 08:49:04 -08:00
Dan Shipper 68aa93678c [2.23.0] Major update to agent-native-architecture skill (#70)
Align skill with canonical Agent-Native Architecture document:

## Core Changes
- Restructure SKILL.md with 5 named principles from canonical:
  - Parity: Agent can do whatever user can do
  - Granularity: Prefer atomic primitives
  - Composability: Features are prompts
  - Emergent Capability: Handle unanticipated requests
  - Improvement Over Time: Context accumulation

- Add "The test" for each principle
- Add "Why Now" section (Claude Code origin story)
- Update terminology from "prompt-native" to "agent-native"
- Add "The Ultimate Test" to success criteria

## New Reference Files
- files-universal-interface.md: Why files, organization patterns, context.md pattern, conflict model
- from-primitives-to-domain-tools.md: When to add domain tools, graduating to code
- agent-execution-patterns.md: Completion signals, partial completion, context limits
- product-implications.md: Progressive disclosure, latent demand discovery, approval matrix

## Updated Reference Files
- mobile-patterns.md: Add iOS storage architecture (iCloud-first), "needs validation" callouts, on-device vs cloud section
- architecture-patterns.md: Update overview to reference 5 principles and cross-link new files

## Anti-Patterns
- Add missing anti-patterns: agent as router, build-then-add-agent, request/response thinking, defensive tool design, happy path in code

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

Co-authored-by: Claude <noreply@anthropic.com>
2026-01-07 10:50:58 -06:00
Kieran Klaassen be30002bbe [2.22.1] Improve feature-video with GitHub embed learnings
- Add low-quality preview GIF creation (640px, 128 colors)
- Use --s3-no-check-bucket flag for rclone uploads
- Document GitHub limitation: external MP4s don't embed
- Use clickable GIF linking to video for PR descriptions

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

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-05 11:10:53 -08:00
Kieran Klaassen 84890f1e16 [2.22.0] Add rclone skill and enhance feature-video command
- Add rclone skill for uploading to S3, Cloudflare R2, Backblaze B2
- Update /feature-video with better ffmpeg commands (proper scaling)
- Add rclone integration for cloud uploads in feature-video
- 27 agents, 20 commands, 13 skills, 2 MCP servers

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

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-05 11:07:02 -08:00
Kieran Klaassen fd21f58264 [2.21.0] Version cleanup after merge 2026-01-05 10:28:58 -08:00
Kieran Klaassen 141bbb42cb [2.16.0] Consolidate DHH styles and add /feature-video command
- Merge dhh-ruby-style into dhh-rails-style for comprehensive Rails conventions
- Add testing.md reference covering Rails testing patterns
- Add /feature-video command for recording PR demo videos
- Update docs and component counts

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-05 10:25:32 -08:00
tschier d6b8cbc5db Update year and improve markdown formatting in plan.md (#64)
Updated the current year from 2025 to 2026 in the plan documentation and improved markdown formatting for code examples.
2026-01-03 01:09:39 -06:00
Kieran Klaassen 948fb4b984 feat(create-agent-skills): rewrite to match Anthropic official spec
The previous version incorrectly recommended XML tags for skill body content.
Anthropic's official specification uses standard markdown headings.

Changes:
- SKILL.md: Complete rewrite using markdown format, not XML tags
- Added references/official-spec.md from code.claude.com/docs/en/skills
- Added references/best-practices.md from platform.claude.com
- Removed obsolete use-xml-tags.md
- Updated naming to gerund form (creating-agent-skills)
- Descriptions now third person with "what" and "when"

BREAKING: If you followed the old XML tag guidance, convert to markdown headings.

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-01 21:38:53 -08:00
Kieran Klaassen 14512fe980 [2.19.0] Filter learnings by frontmatter before spawning sub-agents
- Read frontmatter (title, category, tags, module, symptom) of each learning
- Compare against plan to determine relevance
- SKIP learnings that are clearly not applicable
- SPAWN sub-agents only for learnings that MIGHT apply
- Example: 15 files found → filter to 3 relevant → spawn 3 sub-agents

Smarter than spawning 50 sub-agents when only 5 are relevant.

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-31 16:26:47 -08:00
Kieran Klaassen e2979b60ec [2.19.0] Make learnings location crystal clear
- Show exact folder structure: docs/solutions/[category]/*.md
- Clear step-by-step: find files → list them → spawn sub-agent per file
- Explicit bash commands to discover learning files
- Concrete example showing 3 files → 3 parallel sub-agents
- PRIMARY location is docs/solutions/ (from /workflows:compound)

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-31 16:25:22 -08:00