| name | octave-compression |
| description | Workflow for transforming prose into semantic OCTAVE structures. Covers tier selection, transformation phases, loss accounting, and decision rules. REQUIRES octave-literacy. |
| allowed-tools | ["Read","Write","Edit"] |
| triggers | ["compress to octave","semantic compression","documentation refactoring","octave compression","compress documentation","knowledge artifact","semantic density","OCTAVE format conversion"] |
| version | 3.0.0 |
===OCTAVE_COMPRESSION===
META:
TYPE::SKILL
VERSION::"3.0.0"
STATUS::ACTIVE
PURPOSE::"Decision rules and workflow for transforming prose into semantic OCTAVE at the correct fidelity tier"
REQUIRES::octave-literacy
SPEC_REFERENCE::octave-data-spec.oct.md
§1::TIER_SELECTION
// Choose tier BEFORE reading source. Tier drives every subsequent decision.
TIERS:
LOSSLESS:
TARGET::"100%_fidelity"
PRESERVE::everything
DROP::nothing
USE::[
critical_reasoning,
legal_documents,
safety_analysis,
audit_trails
]
CONSERVATIVE:
TARGET::"85-90%_fidelity"
PRESERVE::explanatory_depth
DROP::redundancy
LOSS::"10-15%[repetition,verbose_phrasing,some_edge_cases]"
USE::[
research_summaries,
design_decisions,
technical_analysis
]
AGGRESSIVE:
TARGET::"70%_fidelity"
PRESERVE::[core_thesis∧conclusions]
DROP::[nuance∨narrative]
LOSS::"30%[explanatory_depth,tradeoff_narratives,edge_case_exploration]"
USE::[
context_window_scarcity,
quick_reference,
decision_support
]
ULTRA:
TARGET::"50%_fidelity"
PRESERVE::[facts∧structure]
DROP::all_narrative
LOSS::"50%[almost_all_explanatory_content,tradeoff_reasoning]"
USE::[
extreme_scarcity,
embedding_generation,
dense_reference
]
ULTRA_MYTHIC:
TARGET::"60%_compression"
PRESERVE::[soul∧constraints]
METHOD::mythological_atoms
USE::[agent_binding, identity_transfer]
REQUIRES::octave-ultra-mythic
// Specialized identity compression skill for agent binding and
// identity transfer contexts. See skills/octave-ultra-mythic.
DECISION_RULES::[
"IF[reconstruction_accuracy_critical]→CONSERVATIVE∨LOSSLESS",
"IF[context_window_scarce∧loss_acceptable]→AGGRESSIVE∨ULTRA",
"IF[decision_relevant_facts_must_survive]→CONSERVATIVE⊕mythology_domain_labels",
"DEFAULT→CONSERVATIVE"
]
§2::LOSS_ACCOUNTING
// I4::TRANSFORM_AUDITABILITY — every transformation must log what was preserved vs dropped.
// These META fields are MANDATORY for any compressed output.
REQUIRED_META_FIELDS::[COMPRESSION_TIER,LOSS_PROFILE]
LOSS_PROFILE_FORMAT::"[preserve:X,drop:Y]"
// LOSS_PROFILE must be explicit — never hidden
EXAMPLES:
CONSERVATIVE::"[preserve:causal_chains,drop:verbose_phrasing]"
AGGRESSIVE::"[preserve:core_thesis∧conclusions,drop:explanatory_depth∨edge_cases]"
ULTRA::"[preserve:facts∧structure,drop:all_narrative∨tradeoff_reasoning]"
META_BLOCK_TEMPLATE:
META: TYPE::DECISION VERSION::"1.0.0" COMPRESSION_TIER::CONSERVATIVE LOSS_PROFILE::"[preserve:causal_chains,drop:verbose_phrasing]"
I4_RULE::"If bits were dropped, the output must carry a receipt. No silent loss."
§3::TRANSFORMATION_WORKFLOW
PHASE_1_READ:
MAP::"Identify all causal chains (A causes B, X requires Y)"
IDENTIFY::[
Redundancy,
Verbosity,
Conditional_Qualifiers
]
NOTE::"Conditional qualifiers (when X, if Y, unless Z) carry material risk — never drop"
PHASE_2_EXTRACT:
PRESERVE::[
causal_chains,
BECAUSE_statements,
metrics,
conditional_qualifiers
]
COMPRESS::[
stopwords,
repetition,
verbose_phrasing,
narrative_connectives
]
ANCHOR::"One concrete example per major abstraction — anchors reconstruction fidelity"
PHASE_3_COMPRESS:
OPERATORS::"Apply ⊕ ⇌ → ∧ ∨ from octave-literacy §2"
HIERARCHY::"Group related concepts under parent BLOCK keys"
MYTHOLOGY::"Use domain label prefixes (ARTEMIS::, CHRONOS::) to anchor facts — see §5"
ARRAYS::"Convert parallel items to [item1,item2,item3]"
PHASE_4_VALIDATE:
FIDELITY::"Are all causal chains intact?"
LOSS_RECEIPT::"Does META carry COMPRESSION_TIER and LOSS_PROFILE?"
GROUNDING::"Is there at least one concrete example per major abstraction?"
WARNINGS::"Check octave_write warnings[] — W_BARE_LINE_DROPPED and W_NUMERIC_KEY_DROPPED are silent data loss. NOTE: warnings[] semantics change post ADR-0006 SR1-T4 (no-op normalisation default) and SR3-T2 (octave_fmt bifurcation) — see octave-literacy §6::FORTHCOMING_BEHAVIOR."
§4::COMPRESSION_RULES
R1::"Preserve CAUSALITY — X→Y because Z. Never flatten to X→Y alone."
R2::"Preserve CONDITIONAL QUALIFIERS — when X, if Y, unless Z carry material risk info"
R3::"Preserve EXPLICIT TRADEOFFS — GAIN⇌LOSS or GAIN vs LOSS"
R3a::"TELEGRAPHIC_PHRASE — quoted value, stopwords dropped, operators carry English connectives — e.g. 'security ⇌ usability' not 'security at odds with usability'"
R4::"One concrete example per major abstraction — minimum reconstruction anchor"
R5::"Use mythology as KEY PREFIXES (CHRONOS::audit_6wk) not embedded values — domain labels are reconstruction anchors"
R6::"Use mythology as PATTERN DESCRIPTORS (SISYPHEAN,ODYSSEAN) for single-token trajectory encoding"
R7::"Never drop numbers, IDs, thresholds, or named entities — these are irreplaceable"
§5::CONSERVATIVE_PLUS_MYTHOLOGY
// CONSERVATIVE compression + mythology domain labels = maximum fidelity at minimum tokens
WHEN::"Decision-relevant content where reconstruction accuracy matters more than minimum tokens"
METHOD::"Use mythology terms as KEY prefixes (CHRONOS::audit_6wk) not embedded values"
WHY::"Domain labels force agents to translate each labeled field separately — prevents fact merging"
RESULT::"11/11 decision-relevant facts preserved at 15% fewer tokens than original prose"
EVIDENCE::octave-mcp[docs/research/compression-fidelity-round-trip-study.md]
§6::ANTI_PATTERNS
AP1::"Markdown inside OCTAVE blocks — no bold, no headers, no bullet hyphens"
AP2::"JSON/YAML syntax — no curly braces, no trailing commas, no YAML bullet hyphens"
AP3::"Deep nesting beyond 3 levels — restructure with parent BLOCK keys"
AP4::"Silent loss — always declare COMPRESSION_TIER and LOSS_PROFILE in META"
AP5::"Paradigm drift — validate for LLM parse efficiency, not human readability"
===END===
