using-shannon

Enforce 8D complexity analysis and Shannon Framework workflows before implementation.

2|Updated Sep 30, 2025

Search Tags:#checkpointing #no mocks #Serena #wave-based execution #8D analysis

Ready to run

npx skills add https://github.com/krzemienski/shannon-framework --skill using-shannon

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: using-shannon
Source: https://github.com/krzemienski/shannon-framework/tree/main/skills/using-shannon
Command: npx skills add https://github.com/krzemienski/shannon-framework --skill using-shannon

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires serena.

What problem does it solve?

Enforces Shannon Framework workflows at session start, including mandatory 8D analysis before implementation, wave-based execution for higher complexity, and automatic Serena MCP checkpointing to prevent context loss.

Core Features & Use Cases

Automatic 8D complexity analysis to quantify task difficulty
Wave-based execution for complex tasks
Mandatory functional testing (NO MOCKS) guidance
Automatic Serena MCP checkpointing for context preservation
SITREP-style coordination for multi-agent work

Quick Start

Run at session start to enforce Shannon workflows and ensure rigorous analysis and checkpointing.

Frequently Asked Questions about using-shannon

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I enforce 8D analysis before implementing complex tasks?▼

8D complexity analysis quantifies task difficulty and ensures rigorous evaluation before implementation. Using Shannon Framework workflows automatically triggers this analysis at session start, preventing hasty decisions on high-complexity work.

What is wave-based execution and when should I use it?▼

Wave-based execution breaks multi-agent tasks into staged iterations for higher complexity. The Shannon Framework applies this pattern automatically when 8D analysis identifies tasks requiring structured, phased delivery.

How does automatic checkpointing prevent context loss in long sessions?▼

Serena MCP checkpointing automatically preserves session state and reasoning at key points, preventing context loss during multi-agent work. The Shannon Framework enforces mandatory checkpoints to maintain continuity across wave-based execution phases.

Why are functional tests mandatory and mocks prohibited under time pressure?▼

Mandatory functional testing without mocks ensures real behavior validation during time-constrained work. The Shannon Framework enforces this to catch integration issues early, preventing mock-hidden failures in production.

Can I use Shannon Framework for specification-driven development across multiple agents?▼

Yes. Shannon Framework enforces specification-driven workflows with automatic /shannon:spec invocation for subjective terms, SITREP coordination for multi-agent tasks, and red-flag keyword handling to maintain clarity across distributed work.

What happens when violations of Shannon workflow constraints are detected?▼

Violations are documented with counters and flagged for review. The framework tracks deviations from mandatory 8D analysis, checkpointing, and test requirements, providing visibility into workflow compliance issues.