diegosouzapw Analyzing Specifications
Overview
shannon analyze invokes Shannon Framework spec-analysis skill to perform 8D complexity analysis with automatic caching.
Basic Usage
shannon analyze project_spec.md
shannon analyze spec.md --json > analysis.json
shannon analyze spec.md --project myapp # Context-aware
Output Interpretation
8D Complexity Score (0.00-1.00):
- 0.00-0.30: Simple (hours-1 day, 1-2 agents)
- 0.30-0.50: Moderate (1-2 days, 2-3 agents)
- 0.50-0.70: Complex (2-4 days, 3-7 agents)
- 0.70-0.85: High (1-2 weeks, 8-15 agents)
- 0.85-1.00: Critical (2+ weeks, 15-25 agents)
Domain Distribution: Frontend, Backend, Database, Mobile, DevOps percentages
Phase Plan: 5 phases with timelines and tasks
Caching
Automatic:
- First run: API call (~$0.02, 30-60s)
- Second run: Cache hit (<500ms, $0.00)
- TTL: 7 days
- Check: shannon cache stats
Context-Aware Mode
For existing projects:
# 1. Onboard project first
shannon onboard /path/to/project --project-id myapp
# 2. Analyze with context
shannon analyze new_feature.md --project myapp
With context: Mentions existing modules, patterns, tech stack. Without context: Generic recommendations.
Options
--json: JSON output for automation--project ID: Context-aware analysis--no-cache: Skip cache (force fresh analysis)--session-id ID: Custom session tracking