A Claude Code plugin marketplace for skills-driven Agentic Context Engineering (ACE) — build, analyze, and maintain agent systems with structured workflows.
Reflexive Claude Code gives Claude Code a complete toolkit for managing its own agent system: CLAUDE.md, rules, skills, subagents, and hooks. Every component follows a structured creation process with automated quality review.
Key capabilities:
- Build agent systems from scratch — detect project maturity, explore workflows, plan architecture, then create all components in dependency order
- Analyze existing systems — 11-category weakness checklist covering routing, context management, security, rules health, and cross-tool migration
- Validate on every edit — PostToolUse hook checks frontmatter, broken links, orphaned files, and invalid variables in real time
- Enforce quality gates — 5 specialized reviewer agents (skill, CLAUDE.md, rule, hook, subagent) run after every creation or modification
- Advanced security architecture — AI-specific security patterns, eight-layer defense system, 30-second performance constraints, and intelligent reflection-driven learning
/plugin marketplace add wayne930242/Reflexive-Claude-Code
/plugin install rcc@rcc # core ACE workflow
/plugin install aref@rcc # agentic refactoring pipeline (optional, independent)Both plugins live in the same marketplace. Install whichever you need; they coexist and are independently versioned.
The full pipeline runs through 6 stages, each a dedicated skill:
migrate → analyze → brainstorm → plan → apply → review → refactor
| Stage | Skill | What it does |
|---|---|---|
| Migrate | migrating-agent-systems |
Detect maturity (None/Seed/Partial/Established), propose rules refactoring, route to correct chain |
| Analyze | analyzing-agent-systems |
Scan all components, run 11-category weakness checklist, produce Rules Health Summary |
| Brainstorm | brainstorming-workflows |
Explore workflows with complexity ladder (L1-L6), map to Anthropic patterns |
| Plan | planning-agent-systems |
Architecture flowchart first, then dependency-driven component plan |
| Apply | applying-agent-systems |
Invoke writing-* skills in order: CLAUDE.md → rules → hooks → skills → agents |
| Review | reviewing-agent-systems |
Run all 5 reviewer agents, produce structured report |
11-category weakness analysis (via analyzing-agent-systems):
| # | Category | Key checks |
|---|---|---|
| 1 | Routing / Triggers | Vague descriptions, overlapping triggers, missing handoffs |
| 2 | Context Management | Oversized CLAUDE.md, eager loading, context pollution |
| 3 | Workflow Continuity | Broken chains, missing verification gates |
| 4 | Redundancy / Conflicts | Duplicate rules, contradicting instructions |
| 5 | Security / Safety | Unprotected sensitive files, excessive permissions |
| 6 | Observability | Missing structured output, opaque routing |
| 7 | Architecture / Scaling | Flat topology, over-orchestration |
| 8 | Constitution Stability | Procedures in CLAUDE.md, vague instructions |
| 9 | Project Context | Missing deployment docs, language coverage gaps |
| 10 | Cross-Tool Migration | Unimported .cursorrules, copilot instructions |
| 11 | Rules Health | Lines > 50, missing paths:, dead globs, session-start > 300 lines |
Rules Health Summary (produced during analysis):
| Metric | Threshold |
|---|---|
| CLAUDE.md lines | > 200 = warning |
| Session-start total (CLAUDE.md + global rules) | > 300 = warning |
| Individual rule lines | > 50 = warning |
| Path-scoped rule with 0 file matches | dead glob |
| Procedural content in rules | should be a skill |
Real-time validation hook (validate_frontmatter.py):
- Fires on every Edit/Write to skill, agent, or rule files
- Checks for invalid frontmatter fields against official spec
- Detects broken markdown links and orphaned files in skill directories
- Outputs
additionalContextso Claude can self-correct immediately
Each writing-* skill follows a structured process with a reviewer gate:
| Skill | Creates | Reviewer |
|---|---|---|
writing-claude-md |
CLAUDE.md |
claudemd-reviewer |
writing-rules |
.claude/rules/*.md |
rule-reviewer |
writing-hooks |
.claude/hooks/* |
hook-reviewer |
writing-skills |
.claude/skills/*/SKILL.md |
skill-reviewer |
writing-subagents |
.claude/agents/*.md |
subagent-reviewer |
Separate pipeline for creating and maintaining Claude Code plugins:
migrate-plugin → validate → refactor
↑
(or) create from scratch / convert from scripts
| Maturity | Detection | Route |
|---|---|---|
| None | No .claude-plugin/ |
→ creating-plugins (from scratch) |
| Pre-plugin | Script project without plugin structure | → Propose conversion table → creating-plugins (with proposal) |
| Minimal | Has manifest, missing components | → validating-plugins → refactoring-plugins |
| Complete | Full plugin | → validating-plugins → refactoring-plugins |
Each skill can bundle three types of supporting assets:
| Directory | Role | Example |
|---|---|---|
references/ |
Documentation Claude reads on demand | Checklists, pattern catalogs |
scripts/ |
Executable automation | Scaffolders, validators |
templates/ |
Reusable file skeletons | Report formats, config files |
The planner decides which assets each skill needs; the reviewer checks they exist; the refactorer creates missing ones directly.
Primary orchestrator: claude-opus-4-7 — per Anthropic's Opus 4.7 prompting best practices, Opus 4.7 is the recommended main model for long-horizon agentic work, subagent orchestration, and coding. Start at xhigh effort for coding/agentic use cases; minimum high for intelligence-sensitive work. Set max_tokens ≥ 64k at xhigh/max so the model has room to think and act.
| Use Case | Model | Effort |
|---|---|---|
| Main orchestrator, long-horizon agentic, planning | claude-opus-4-7 |
xhigh / high |
| Implementation, code generation | sonnet |
high |
| Read-only analysis, review | sonnet |
medium |
| Simple lookup, exploration | haiku |
low |
| Skill | Purpose |
|---|---|
migrating-agent-systems |
Maturity-graded routing with rules refactoring proposal |
migrating-plugins |
Plugin maturity detection (None/Pre-plugin/Minimal/Complete), script-to-plugin conversion |
analyzing-agent-systems |
Project scanning + 11-category weakness detection + actionable restructuring recommendations |
brainstorming-workflows |
Targeted exploration of pipeline modes, pain points, and routine tasks |
planning-agent-systems |
Architecture-first planning with dependency ordering |
applying-agent-systems |
Execute component plan via writing-* chain |
reviewing-agent-systems |
Run all 5 reviewer agents |
refactoring-agent-systems |
Fix issues from review report |
writing-skills |
Structured skill creation |
writing-claude-md |
CLAUDE.md with standard format |
writing-subagents |
Subagent config with model/isolation guide |
writing-rules |
Rules with decision tree and content validation |
writing-hooks |
Hooks for static analysis and quality gates |
reflecting |
Extract learnings, route to skills or rules |
improving-skills |
Optimize a single skill |
refactoring-skills |
Consolidate and deduplicate across skills |
advising-architecture |
Classify knowledge type, validate approach |
initializing-projects |
Bootstrap new project with agent system |
creating-plugins |
Scaffold a new Claude Code plugin |
refactoring-plugins |
Health-check plugins against official best practices |
validating-plugins |
Batch scan all plugin files for errors |
Agentic refactoring pipeline. Detects languages, analyzes hotspots, proposes phased refactor plans, scaffolds characterization tests, applies refactors on a dedicated branch with per-phase review, verifies against hard structural rules and mutation testing, then writes AGENTS.md per subproject for future AI coding agents.
Entry command: /aref
Pipeline: analyzing-codebases → planning-refactors → scaffolding-characterization-tests → applying-refactors → verifying-refactors → finalizing-refactors
Supported languages: TypeScript/JavaScript, Python, Rust, Go (deep). Other languages fall back to generic analysis.
See plugins/aref/README.md for full details.
Reflexive-Claude-Code/
├── .claude-plugin/
│ └── marketplace.json
├── .rcc/ # Per-project RCC artifacts (tracked)
│ ├── config.yml # Migration state + decisions log
│ ├── {timestamp}-*.md # analysis / plan / reflection / review outputs
│ ├── memory/ # learning-from-failures knowledge
│ ├── validation/ # validate_all.py reports
│ └── archive/ # refactor-sweep snapshots
├── plugins/
│ └── rcc/
│ ├── skills/ # 21 skills
│ ├── agents/ # 5 reviewer subagents
│ └── hooks/ # Frontmatter validation hook
├── release-please-config.json
├── .release-please-manifest.json
└── README.md
Every RCC-enabled project carries .rcc/config.yml recording:
- Migration state (when last migrated, which rcc version)
- Release automation decision (release-please / semantic-release / declined)
- Settings scope (where safety bypass / permission rules live:
.claude/settings.jsonvs.claude/settings.local.jsonvs~/.claude/settings.json) - Primary model assignments (orchestrator / implementer / reviewer)
- Append-only
decisions_log
Managed by migrating-agent-systems (creation) and reflecting (log append). See config schema.
- superpowers — TDD-based skill design and discipline-enforcing patterns adapted from Anthropic's superpowers plugin.
- Agentic Context Engineering (ACE):
Zhang, Q., et al. (2025). Agentic Context Engineering: Evolving Contexts for Self-Improving Language Models. arXiv:2510.04618.
MIT