jedi-forge

⚔️ Jedi Order of Clean Code

"May thy types be strong, thy builds be green, and the Force flow eternal through thy logic."

A Star Wars-themed Claude Code plugin that audits and purifies Java/Spring codebases according to the laws of clean code. Parallel squads of specialist agents scan architecture, testing, security, and dependencies simultaneously.

---

Table of Contents

• What is it?
• Installation
• Commands
  • Sense (Audit) Commands
  • Force (Change) Commands
  • Holocron (Docs) Commands
  • Council Commands
• Agent Architecture
• Sith Anti-Patterns
• Usage Examples
• Project Structure

---

What is it?

Jedi Forge is a plugin that runs on Claude Code. It automatically analyzes and fixes Java/Spring projects across the following domains:

Domain	What it does
Architecture	Finds Clean Architecture violations, layer boundary leaks, and circular dependencies
Testing	Detects TDD discipline gaps, weak assertions, and flaky test risks
Security	Scans for hardcoded secrets, Dockerfile leakage, and config risks
Dependencies	Audits CVE vulnerabilities, version drift, and bloated dependencies
Docker	Applies multi-stage build, non-root user, and healthcheck optimizations

Every command spins up parallel specialist agent squads (via the Task tool) and produces a single consolidated Council report.

---

Installation

Step 1 — Add to Marketplace

/plugin marketplace add EmreCerrah/jedi-forge   

Step 2 — Install the Plugin

/plugin install EmreCerrah/jedi-forge   

Step 3 — Run the First Scan

/jedi:council-report

---

Commands

Sense (Audit) Commands

Mode: AUDIT ONLY — Does not modify files. Produces reports only.

---

/jedi:sense_architecture [path] [--domain <name>]

Audits architectural integrity. Detects Clean Architecture boundary violations, package cycles, and domain pollution.

# Scan the entire project
/jedi:sense_architecture

# Scan a specific domain
/jedi:sense_architecture src/main/java --domain order

Specialist agents deployed:

• Temple Boundary Sentinel — Finds domain/framework contamination
• Package Cycle Hunter — Detects circular dependencies
• Cross-Domain Smuggler Detector — Catches bounded context leaks
• Shadow Coupling Auditor — Exposes hidden static state coupling
• Pattern Integrity Master — Flags unjustified pattern usage

---

/jedi:sense_testing [path] [--target <ClassOrPackage>]

Measures test discipline and quality. Reports missing tests, weak assertions, and flaky test risks.

# Scan the entire test suite
/jedi:sense_testing

# Scan a specific class
/jedi:sense_testing --target com.example.order.OrderService

Specialist agents deployed:

• Red-Green Commander — Checks TDD discipline gaps and missing behavior tests
• Assertion Master (AssertJ) — Upgrades weak assertions to strong AssertJ form
• Integration Sentinel (Testcontainers) — Recommends integration tests for DB/HTTP/MQ adapters
• Test Hygiene Droid — Detects flaky/slow tests and over-mocking smells

---

/jedi:sense_security [path] [--history]

Scans for security risks: hardcoded secrets, config leakage, Docker vulnerabilities.

# Standard security scan
/jedi:sense_security

# Also scan git history for leaks
/jedi:sense_security --history

Specialist agents deployed:

• Holocron Scanner — Scans code and config for secrets/credentials
• Docker Vault Inspector — Audits Dockerfile/compose for secret leakage
• Git History Archaeologist — (with --history) Searches commit history for leaked secrets
• Rotation Marshal — Creates remediation and rotation plan

---

/jedi:sense_dependencies [path] [--scope java|node|all]

Analyzes dependency risks: CVE vulnerabilities, version drift, unused and bloated libraries.

# Scan Java dependencies only
/jedi:sense_dependencies --scope java

# Scan all dependencies (Java + Node)
/jedi:sense_dependencies --scope all

Specialist agents deployed:

• Maven/Gradle Warden — Audits dependency tree drift, conflicts, and unused deps
• Vulnerability Seer — Identifies CVE risks and mitigations
• Bloat Cutter — Finds heavy starters and removable libraries
• Lockfile Guardian — (if Node exists) Audits npm lockfile and dependency risks

---

/jedi:sense_readiness [path]