Skip to content

Releases: malston/plugin-design-advisor

Release list

v0.1.1

v0.1.1 Latest
Latest

Choose a tag to compare

View all tags
@malston malston released this 08 Mar 11:39
v0.1.1
cf8d5f0
This commit was signed with the committer’s verified signature.
malston Mark Alston
SSH Key Fingerprint: ThCHHSyUUhWWcjC4VnS9pVN7/QBpFt6AJz5h9nPS5lY
Verified
Learn about vigilant mode.

What's Changed

Bug Fixes

  • Correct validator output schema in DESIGN.md and CLAUDE.md -- add missing path and evidence fields to match actual agent contract
  • Resolve doc completeness gaps: move 3 resolved questions from Open to Decided in DESIGN.md, complete architecture tree with missing files

Documentation

  • Add See Also section to README.md linking to plugin-dev and skill-creator

Maintenance

  • Bump version to 0.1.1
  • Add Task to validate command's allowed-tools for agent orchestration

Full Changelog: v0.1.0...v0.1.1

Assets 2
Loading

v0.1.0

v0.1.0

Choose a tag to compare

View all tags
@malston malston released this 08 Mar 10:52
v0.1.0
5782cc5
This commit was signed with the committer’s verified signature.
malston Mark Alston
SSH Key Fingerprint: ThCHHSyUUhWWcjC4VnS9pVN7/QBpFt6AJz5h9nPS5lY
Verified
Learn about vigilant mode.

Initial Release

A self-demonstrating Claude Code plugin that encodes heuristics for plugin design decisions -- skill vs. agent vs. command vs. hook.

What's Included

Component Purpose
skills/plugin-design-advisor/ Core heuristics for choosing the right plugin mechanism
skills/decision-explorer/ Interactive decision tree for learners
agents/architecture-validator.md Audits existing plugin structure for misclassifications
agents/requirements-analyzer.md Classifies task characteristics
agents/constraint-extractor.md Identifies parallelism/isolation/tiering needs
commands/design.md Multi-phase design workflow with parallel analysis
commands/validate.md Run architecture-validator against a plugin directory
hooks/hooks.json PreToolUse guard on Write/Edit to agents/ and skills/

Anti-Patterns Detected

  • Agent-as-skill -- read-only agent with no isolation benefit
  • Skill-as-agent -- domain knowledge buried in an agent prompt
  • Procedure-as-skill -- procedural workflow stuffed into a skill
  • Command-without-hook -- system-event workflow as explicit command
  • Hook-without-suppression -- hook fires on every event without checking session state
  • MCP-for-no-reason -- MCP server added without external service dependency

Implementation Phases

  • Phase 1: Core skill + architecture-validator agent
  • Phase 2: Design command + parallel analyzer agents with DECISIONS.md suppression
  • Phase 3: plugin-file-guard PreToolUse hook with path filter and session dedup
  • Phase 4: decision-explorer interactive skill with adaptive branching
Loading