@claudeautopm/plugin-core

Core framework functionality for ClaudeAutoPM

Version: 2.0.0 Category: Core Framework Size: ~8 KB (gzipped) Status: ✅ Required (always installed)

Overview

This is the core framework plugin that provides essential functionality for ClaudeAutoPM. It includes universal agents, rules, hooks, and utilities that apply to ALL projects regardless of technology stack.

This plugin is REQUIRED and is automatically installed with ClaudeAutoPM.

What's Included

🤖 Agents (4)

Core agents for framework functionality:

1. agent-manager - Create, analyze, and manage agents in the registry
2. code-analyzer - Analyze code changes for bugs, trace logic flow, investigate issues
3. test-runner - Run tests and provide comprehensive analysis of results
4. file-analyzer - Analyze and summarize large files to reduce context usage

📋 Commands (3)

Framework utility commands:

1. code-rabbit - Process CodeRabbit review comments with context-aware discretion
2. prompt - Handle complex prompts with many @ references
3. re-init - Reinitialize CLAUDE.md with framework rules

📜 Rules (23)

Universal rules that apply to all projects:

Critical Priority:

• tdd.enforcement - Enforce Test-Driven Development (Red-Green-Refactor)
• context7-enforcement - Enforce Context7 documentation queries
• framework-path-rules - Path convention enforcement
• golden-rules - Core framework principles
• security-checklist - Universal security standards

High Priority:

• agent-coordination - Agent orchestration patterns
• agent-mandatory - Agent usage requirements
• command-pipelines - Command orchestration
• development-workflow - Universal development workflow
• git-strategy - Git workflow and branching
• definition-of-done - Quality standards
• pipeline-mandatory - Pipeline enforcement

Medium Priority:

• ai-integration-patterns - AI integration best practices
• context-optimization - Context management strategies
• development-environments - Environment setup
• naming-conventions - Naming standards
• no-pr-workflow - Alternative git workflow
• performance-guidelines - Performance optimization
• standard-patterns - Universal coding patterns

Low Priority:

• datetime - Date/time handling conventions
• frontmatter-operations - Frontmatter parsing
• strip-frontmatter - Frontmatter utilities
• use-ast-grep - AST parsing utilities

🪝 Hooks (7)

Enforcement hooks for framework behavior:

Context7 Enforcement:

• pre-command-context7.js - Enforce Context7 queries before command execution (BLOCKING)
• pre-agent-context7.js - Enforce Context7 queries before agent invocation (BLOCKING)
• unified-context7-enforcement.sh - Unified Context7 wrapper
• context7-reminder.md - Context7 reminder text

Agent Enforcement:

• enforce-agents.js + .sh - Enforce agent usage over direct tool calls (BLOCKING)
• strict-enforce-agents.sh - Stricter agent enforcement (BLOCKING)

Testing:

• test-hook.sh - Hook testing utility

📦 Scripts (10)

Framework utilities and libraries:

lib/ - Shared Libraries (5 scripts):

• datetime-utils.sh - Date and time utilities
• frontmatter-utils.sh - Markdown frontmatter parsing
• github-utils.sh - GitHub API utilities
• logging-utils.sh - Logging utilities
• validation-utils.sh - Validation utilities

mcp/ - MCP Management (5 scripts):

• add.sh - Add MCP server
• enable.sh - Enable MCP server
• disable.sh - Disable MCP server
• list.sh - List MCP servers
• sync.sh - Sync MCP configuration

Installation

This plugin is automatically installed with ClaudeAutoPM. No manual installation needed.

# When you install ClaudeAutoPM:
npm install -g claudeautopm
autopm init

# plugin-core is automatically included

Features

TDD Enforcement ✅

Always enabled - Enforces Test-Driven Development:

• Red-Green-Refactor cycle mandatory
• Tests MUST be written before implementation
• 100% test coverage for new code
• Zero tolerance policy

# Enforced by: rules/tdd.enforcement.md

Context7 Enforcement ✅

Always enabled - Enforces Context7 documentation queries:

• MUST query Context7 before ALL command/agent execution
• Live documentation verification
• API signature validation
• Zero tolerance policy

# Enforced by:
# - rules/context7-enforcement.md
# - hooks/pre-command-context7.js
# - hooks/pre-agent-context7.js

Agent Coordination ✅

Always enabled - Agent orchestration and coordination:

• Agent selection patterns
• Parallel vs sequential execution
• Error handling in agent workflows
• Context management between agents

# Enforced by: rules/agent-coordination.md

MCP Management ✅

Always enabled - MCP server management utilities:

• Add/enable/disable MCP servers
• List configured servers
• Sync MCP configuration

# Provided by: scripts/mcp/*.sh

Usage

Using Core Agents

# Invoke agents directly
@agent-manager create a new specialized agent for GraphQL
@code-analyzer review recent changes for bugs
@test-runner execute full test suite with analysis
@file-analyzer summarize large-log-file.log

Using Core Commands

# Process CodeRabbit reviews
/code-rabbit

# Handle complex prompts
/prompt

# Reinitialize framework
/re-init

Using Scripts

# Use utility libraries (sourced by other scripts)
source .claude/scripts/lib/github-utils.sh
source .claude/scripts/lib/logging-utils.sh

# MCP management
bash .claude/scripts/mcp/add.sh context7
bash .claude/scripts/mcp/list.sh
bash .claude/scripts/mcp/sync.sh

Dependencies

Peer Dependencies

None - this is the base plugin.

Required By

All other plugins depend on plugin-core:

• @claudeautopm/plugin-pm - PM workflows
• @claudeautopm/plugin-devops - DevOps automation
• @claudeautopm/plugin-cloud - Cloud infrastructure
• @claudeautopm/plugin-frameworks - Frontend frameworks
• @claudeautopm/plugin-databases - Databases
• @claudeautopm/plugin-languages - Programming languages
• @claudeautopm/plugin-data - Data engineering

Configuration

No configuration needed - all core features are always enabled.

Size and Performance

• Package size: ~8 KB (gzipped) / ~80 KB (uncompressed)
• Installation time: < 1 second
• Memory footprint: Minimal (utilities loaded on-demand)

Compatibility

• Minimum ClaudeAutoPM version: 3.0.0
• Node.js: >= 18.0.0
• Platform: Cross-platform (macOS, Linux, Windows)

License

MIT

Support

• Issues: https://github.com/rafeekpro/ClaudeAutoPM/issues
• Documentation: https://github.com/rafeekpro/ClaudeAutoPM#readme
• Changelog: See CHANGELOG.md

Part of ClaudeAutoPM v3.0.0 Plugin Architecture