Analyze Skill

When this skill activates, IMMEDIATELY invoke the script. The script IS the workflow.

Triggers

Trigger Phrase	Operation
`analyze this codebase`	analyze.py with architecture + quality focus
`review code quality`	analyze.py with quality focus
`run security assessment`	analyze.py with security focus
`architecture review of this system`	analyze.py with architecture focus
`find code smells`	analyze.py with quality focus

When to Use

Use this skill when:

A broad investigation is needed across multiple files or components
The analysis requires structured multi-step exploration
Findings need prioritization by severity and evidence

Use direct code reading instead when:

Checking a single file or function
The question has a known, specific location
A quick grep or symbol search answers the question

Anti-Patterns

Avoid	Why	Instead
Exploring the codebase before invoking the script	Script orchestrates exploration order	Run step 1 immediately, let script direct you
Skipping the Explore agent delegation	Misses broad codebase context	Follow step 1 REQUIRED ACTIONS to delegate
Passing empty thoughts to later steps	Loses accumulated context	Include all findings from previous steps
Reducing total-steps below 6	Skips verification and synthesis	Keep minimum 6, increase as script directs
Reporting findings without file:line evidence	Unverifiable claims	Always cite specific locations

Verification

After execution:

All priority areas investigated with file-level evidence
Findings include severity classification (critical/high/medium/low)
Each finding has specific file:line references
Synthesis step completed with prioritized recommendations
No investigation areas left unexplored from the plan

Scripts

Script	Purpose
`scripts/analyze.py`	Multi-step guided analysis with exploration, investigation, and synthesis

Invocation

python3 scripts/analyze.py \
  --step-number 1 \
  --total-steps 6 \
  --thoughts "Starting analysis. User request: <describe what user asked to analyze>"

Argument	Required	Description
`--step-number`	Yes	Current step (starts at 1)
`--total-steps`	Yes	Minimum 6; adjust as script instructs
`--thoughts`	Yes	Accumulated state from all previous steps

Process

The script outputs REQUIRED ACTIONS at each step. Follow them exactly.

Step 1: EXPLORATION         - Script tells you to delegate to Explore agent
Step 2: FOCUS SELECTION     - Classify areas, assign priorities
Step 3: INVESTIGATION PLAN  - Commit to specific files and questions
Step 4+: DEEP ANALYSIS      - Progressive investigation with evidence
Step N-1: VERIFICATION      - Validate completeness
Step N: SYNTHESIS           - Consolidate findings

Do NOT try to follow this workflow manually. Run the script and follow its output.

Example Sequence

# Step 1: Start - script will instruct you to explore first
python3 scripts/analyze.py --step-number 1 --total-steps 6 \
  --thoughts "Starting analysis of auth system"

# [Follow REQUIRED ACTIONS from output - delegate to Explore agent]

# Step 1 again with explore results
python3 scripts/analyze.py --step-number 1 --total-steps 6 \
  --thoughts "Explore found: Flask app, SQLAlchemy, auth/ dir..."

# Step 2+: Continue following script output
python3 scripts/analyze.py --step-number 2 --total-steps 7 \
  --thoughts "[accumulated state from step 1] Focus: security P1, quality P2"