forced-reading-protocol

Enforce sequential line-by-line reading and line-count verification for large documents.

2|Updated Sep 30, 2025
One-click install
npx skills add https://github.com/krzemienski/shannon-framework --skill forced-reading-protocol
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: forced-reading-protocol
Source: https://github.com/krzemienski/shannon-framework/tree/main/skills/forced-reading-protocol
Command: npx skills add https://github.com/krzemienski/shannon-framework --skill forced-reading-protocol

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents superficial reading by enforcing complete line-by-line comprehension and quantitative verification for critical documents, ensuring thorough understanding before synthesis.

Core Features & Use Cases

  • Mandatory complete reading: Read all lines of a file sequentially.
  • Line-count verification: Ensure lines_read equals total_lines before drawing conclusions.
  • Synthesis only after verification: Block conclusions until reading is complete.

Quick Start

Use the protocol on a target file to force full reading:

  • Trigger: /shannon:read_complete <file-path> to enforce complete reading
  • Or rely on automatic activation for large documents

Frequently Asked Questions about forced-reading-protocol

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

FAQPage Schema
How do I ensure I've read an entire document completely before analyzing it?

Complete line-by-line reading enforces sequential reading of all lines in a document, with line-count verification to confirm total_lines equals lines_read before you proceed to analysis or synthesis.

What documents require thorough line-by-line verification?

Markdown specifications and plans over 3000 lines, SPEC_* and PLAN_* critical files, /SKILL.md definitions, and prompts longer than ~500 words all require complete reading verification to prevent incomplete understanding from skim reading.

How do I trigger complete reading verification on a file?

Use the /shannon:read_complete <file-path> command to enforce complete line-by-line reading, or rely on automatic activation for large documents that exceed the defined thresholds.

Why is line-count verification important before drawing conclusions?

Quantitative verification that lines_read equals total_lines prevents superficial analysis by ensuring you've actually reviewed all content sequentially, blocking premature synthesis until reading is demonstrably complete.

Can I skip reading parts of critical specification files?

No—the protocol enforces complete sequential reading of SPEC_*, PLAN_*, and other critical files, blocking any analysis or conclusions until every line is verified as read.

What's the difference between this approach and standard document review?

Standard review often relies on skimming; this protocol enforces pre-counting total lines, sequential reading of every line, explicit verification of completeness, and synthesis only after confirmation—eliminating gaps from selective reading.