Reflexive Claude Code
English | 繁體中文
A Claude Code plugin marketplace for skills-driven Agentic Context Engineering (ACE) — build, analyze, and maintain agent systems with structured workflows.
What This Does
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
Installation
/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.
How It Works
Agent System Pipeline
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 |
Quality Checks
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
additionalContext so Claude can self-correct immediately
Component Writing Skills
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 |
Plugin Pipeline
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 |
Skill Assets
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.
Model Recommendations
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 |
Full Skill List
rcc (v13.0.1)
| 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 | Suggest candidate learnings, deepen the ones you pick |
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 |
aref (v0.2.1)
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.
Project Structure
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/ # reflection learnings
│ ├── 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
.rcc/config.yml
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.json vs .claude/settings.local.json vs ~/.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.
Credits
- 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.
License
MIT
