From Dev10x
Audits project architecture: catalogs design patterns from sources, stress-tests domain models, maps JTBD from PR history to test coverage, produces prioritized improvement backlog. Use for health checks, inheritance, or releases.
npx claudepluginhub dev10x-guru/dev10x-claude --plugin Dev10xThis skill is limited to using the following tools:
Five-phase orchestration skill that audits a project's architecture,
Creates isolated Git worktrees for feature branches with prioritized directory selection, gitignore safety checks, auto project setup for Node/Python/Rust/Go, and baseline verification.
Executes implementation plans in current session by dispatching fresh subagents per independent task, with two-stage reviews: spec compliance then code quality.
Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.
Five-phase orchestration skill that audits a project's architecture, design patterns, domain model health, and test coverage. Produces a prioritized improvement backlog with milestones and blocking chains.
Use when:
Do NOT use for:
Dev10x:reviewDev10x:ticket-scopeDev10x:ddd-workshopDev10x:qa-scopeThis skill follows references/task-orchestration.md patterns.
Auto-advance: Complete each phase, immediately start the next. Only pause at the Phase 2 selection gate and Phase 4 synthesis review.
REQUIRED: Create tasks before ANY work. Execute these
TaskCreate calls at startup:
TaskCreate(subject="Phase 1: Detect project context", activeForm="Detecting context")TaskCreate(subject="Phase 2: Select audit phases", activeForm="Selecting phases")TaskCreate(subject="Phase 3: Execute audit phases", activeForm="Auditing")TaskCreate(subject="Phase 4: Synthesize findings", activeForm="Synthesizing")TaskCreate(subject="Phase 5: Create backlog", activeForm="Creating backlog")/Dev10x:project-audit # full audit (all phases)
/Dev10x:project-audit --phases B,C,E # selected phases only
/Dev10x:project-audit --skip-backlog # findings memo without tickets
/Dev10x:project-audit --memo-only # memo without tickets or backlog
Auto-detect project characteristics. Create subtasks per detection:
pyproject.toml, package.json,
Cargo.toml, go.mod, pom.xml. Identify Django, FastAPI, Rails,
Next.js, SvelteKit, etc.src/ bounded contexts, Clean
Architecture layers, service directories, DI containers.gh pr list --state merged --limit 200 --json title,body,labels
Extract JTBD patterns from titles and bodies.docs/adrs/, docs/decisions/,
adr/ directories.mcp__plugin_Dev10x_cli__detect_tracker.Store context as structured data for Phase 3 agent prompts.
If --phases argument provided: Skip the gate, use specified
phases.
Otherwise:
REQUIRED: Call AskUserQuestion (do NOT use plain text, call
spec: ask-phase-selection.md).
Present all 9 phases with descriptions. User selects which to run.
| Phase | Name | What it finds |
|---|---|---|
| A | Pattern Catalog | Maps 50+ patterns from 3 catalogs to codebase |
| B | Domain Model Health | Anemic models, Tell Don't Ask violations |
| C | Value Object Discovery | Primitives that should be Value Objects |
| D | Archetype Stress Test | Software Archetypes structural alignment |
| E | Concurrency Audit | Missing locks, transactions, race conditions |
| F | Behavioral Pattern Fit | Strategy, CoR, Template Method opportunities |
| G | JTBD Coverage Matrix | Feature JTBD vs test coverage gaps |
| H | Cross-Cutting Consistency | Inconsistent patterns across modules |
| I | Cross-Context Queries | Multi-protocol resolvers, N+1 patterns, API type leaks |
Dispatch one Explore agent per selected phase. All agents run
concurrently in a single tool-call block. Agent dispatch template
and rules are in references/agent-dispatch.md.
Create one subtask per phase under the Phase 3 parent task. Mark each completed as its agent returns.
Phase-specific instructions for each agent are in
references/phase-prompts.md. Detection heuristics are in
references/detection-heuristics.md.
Before dispatching, fetch pattern catalogs via WebFetch.
Fallback to hardcoded lists in references/pattern-catalogs.md.
https://martinfowler.com/eaaCatalog/https://refactoring.guru/design-patterns/cataloghttps://www.softwarearchetypes.com/After all agents return:
docs/memos/architecture-audit-YYYY-MM-DD.md
with full findings, priority matrix, and milestone proposals.Skill(Dev10x:adr).If --memo-only: Stop here. Present memo and skip Phase 5.
REQUIRED: Call AskUserQuestion (do NOT use plain text).
Present the findings summary and milestone groupings:
Options:
Delegate to Skill(Dev10x:project-scope) with the milestone
structure from Phase 4.
For each milestone:
audit:domain-health)If --skip-backlog: Skip this phase entirely.
Report final summary: milestones created, total issues, blocking chains established.
Explore type (read-only, no edits)references/finding-format.md is strictdocs/memos/